@sema-agent/client-core 0.20.0 → 0.21.0

package/README.md

@@ -23,7 +23,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.20.0
+**Version:** 0.21.0
 
 - **Today** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
   B/D/E tool-card layers), the notification/caps/model families, the adapter kernel (stream driver
@@ -53,7 +53,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
     `SseIdleError`, `probeHealth`, `APIError` and `TaskStopConflictError` are imported as values in
     five modules, and the browser bundle really bundles the SDK through (the portability guard would
     exit 3 rather than quietly mark it external).
-  - The declared floor is `>=6.3.0`, and it is *witnessed*: the guard checks that an actually
+  - The declared floor is `>=6.9.0`, and it is *witnessed*: the guard checks that an actually
     installed SDK at that line still exports every value-level symbol this package imports and still
     declares `TaskStats.costMicroUsd` (the key `costOrNull` reads). A floor nobody ever ran is a
     promise, not a contract.

package/dist/adapt/arms.js

@@ -643,15 +643,29 @@ const retryStatusArm = function* (m, { ctx, flags }) {
     // #47 矩阵 #5:子代 lane 帧绝不骑主 spinner(无判别守卫的无条件 store 写=默认可疑)。
     if (typeof m.parentToolCallId === 'string')
         return;
-    yield chrome({
-        kind: 'retry_status',
-        laneProof: MAIN,
-        status: mapBrainStatusToRetry({
-            phase: typeof m.phase === 'string' ? m.phase : '',
-            ...(typeof m.detail === 'string' ? { detail: m.detail } : {}),
-            ...(typeof m.retryInSec === 'number' ? { retryInSec: m.retryInSec } : {}),
-        }, ctx.now()),
-    });
+    // 🔴 六键全转(#3004 跟修批 2026-08-08):此前这里只挑 phase/detail/retryInSec 三键,attempt /
+    //    maxRetries / retryInMs 被剥在本层 —— 而 server 两腿的 brainStatusEventData 是全发的,
+    //    `RetryStatus` 上也早就留好了 attempt/maxRetries 两位。键集真源 =
+    //    `BRAIN_STATUS_PAYLOAD_KEYS`(engine-vocab G2-c 对实装 core 对账)。
+    const status = mapBrainStatusToRetry({
+        phase: typeof m.phase === 'string' ? m.phase : '',
+        ...(typeof m.detail === 'string' ? { detail: m.detail } : {}),
+        ...(typeof m.retryInSec === 'number' ? { retryInSec: m.retryInSec } : {}),
+        ...(typeof m.retryInMs === 'number' ? { retryInMs: m.retryInMs } : {}),
+        ...(typeof m.attempt === 'number' ? { attempt: m.attempt } : {}),
+        ...(typeof m.maxRetries === 'number' ? { maxRetries: m.maxRetries } : {}),
+    }, ctx.now());
+    // `status === null` = 引擎直报 `recovered`(重试成功)。这一拍是**清除腿之一** —— 但间接腿
+    // (TurnFlags 的「主 lane 内容帧到达即清」)可能已经清过了:已安装 core 在内容流跑完的 finally
+    // 里发 `recovered`,所以 `retrying → 内容 → recovered` 才是常态顺序。故用 `takeRetryOverlay()`
+    // 的**原子读落**决定要不要发:旗还在 ⇒ 发这一发并落旗;旗已落 ⇒ 沉默(没有覆盖层可摘)。
+    // 首版写成「无条件发 + clearRetryOverlay」,在常态顺序上双清(codex 复审命中)。
+    if (status === null) {
+        if (flags.takeRetryOverlay())
+            yield chrome({ kind: 'retry_status', laneProof: MAIN, status: null });
+        return;
+    }
+    yield chrome({ kind: 'retry_status', laneProof: MAIN, status });
     // ⟨帧序耦合 6/7⟩ 挂旗;下一个主 lane 内容帧到达时由 TurnFlags 的帧前置清掉(恢复即清)。
     flags.noteRetryOverlay();
 };

package/dist/adapt/turnFlags.d.ts

@@ -33,5 +33,19 @@ export interface TurnFlags {
     emitResultEndIfNeeded(readOutputTokens: () => number | undefined): Generator<AdapterOutput>;
     /** A15 `retry_status`:挂旗(下一帧主 lane 内容到达即清)。 */
     noteRetryOverlay(): void;
+    /**
+     * A15 `retry_status` 的反向动作(#3004 跟修批 2026-08-08):**引擎直报恢复**(`recovered` 相)那一拍
+     * 调它 —— 返回「本次是否**仍需**发清除」并同时落旗(**原子**:读+落一步完成)。
+     *
+     * 🔴 为什么必须是「take」而不是「clear」(codex 复审命中的双清):两条清除腿共用同一个布尔位,
+     * 而它们的触发顺序两个方向都真实存在 ——
+     *   · `retrying → recovered`:直报腿先到,旗还在 ⇒ 本次要发清除,发完落旗;间接腿之后看不到旗。
+     *   · `retrying → 主lane内容 → recovered`:**间接腿先到**(已发过一次 null 并落了旗),直报腿这一拍
+     *     就**不该再发第二发** —— 已安装 core 在内容流跑完的 finally 里发 `recovered`,所以这个顺序
+     *     才是常态路径。首版写成无条件发 + `clearRetryOverlay()`,于是这条常态路径上双清。
+     * 返回 false ⇒ 本臂这一拍不 yield(没有覆盖层可摘,沉默才是诚实的);状态机仍只有本文件一处
+     * 持有那个布尔位。
+     */
+    takeRetryOverlay(): boolean;
 }
 export declare function createTurnFlags(ctx: AdapterContext, turnStartAt: number): TurnFlags;

package/dist/adapt/turnFlags.js

@@ -4,9 +4,15 @@ export function createTurnFlags(ctx, turnStartAt) {
     let endEmitted = false;
     /**
      * R1(clay 五报 07-31):retry 覆盖层的四个清除点全在 turn 边界,缺「重试成功→清」的转移 ——
-     * 引擎重试成功那一刻什么都不发(BrainStatusPhase 无恢复终态,候 core [2163]),所以恢复只能由
-     * 「主 lane 又有内容在流」这个事实来证明。挂旗后首个主 lane 内容帧即清,CC 同位 = 重试循环
-     * 退出即 onRetryStatus(null)(pretty220 finally 清)。
+     * 当时引擎重试成功那一刻什么都不发,所以恢复只能由「主 lane 又有内容在流」这个事实来证明。
+     * 挂旗后首个主 lane 内容帧即清,CC 同位 = 重试循环退出即 onRetryStatus(null)(pretty220 finally 清)。
+     *
+     * 🔴 现势更正(2026-08-08,#3004 跟修批):上面括号里原本写着「BrainStatusPhase 无恢复终态,候
+     * core [2163]」—— core 早已兑现,`BrainStatusPhase` 现有 `recovered` / `gave_up` 两个终态相。于是
+     * 本位这条**间接推断腿**不再是唯一证据:`retry_status` 臂拿到 `recovered` 时走 `takeRetryOverlay()`
+     * 直报清除。两条腿共用同一个布尔位、且都靠 take 的**原子读落**决定要不要发帧,所以无论到达顺序
+     * 如何(直报先 / 内容帧先),一次恢复合计**恰好一发** `status:null`(pure 门 R1b 段两个方向都钉)。
+     * 间接腿保留 —— 老引擎不发 `recovered`,它仍是那些部署上唯一的证据。
      */
     let retryOverlayActive = false;
     return {
@@ -20,7 +26,8 @@ export function createTurnFlags(ctx, turnStartAt) {
                 // stream_event 的子流标记在 event 里(thinking 臂同款判位),帧顶层没有。
                 typeof m.event?.parentToolCallId !== 'string') {
                 // 恢复即清:主 lane 内容帧到达 = 引擎那次重试已成功;子流帧(parentToolCallId)不算证据
-                // (主 brain 仍可能在退避等待,#47 矩阵 #5 同族判别)。
+                // (主 brain 仍可能在退避等待,#47 矩阵 #5 同族判别)。落旗后 `takeRetryOverlay()` 会对随后
+                // 到达的 `recovered` 直报帧返回 false ⇒ 不补第二发(两条腿合计恰好一发)。
                 retryOverlayActive = false;
                 yield chrome({ kind: 'retry_status', laneProof: MAIN, status: null });
             }
@@ -51,5 +58,10 @@ export function createTurnFlags(ctx, turnStartAt) {
         noteRetryOverlay: () => {
             retryOverlayActive = true;
         },
+        takeRetryOverlay: () => {
+            const wasActive = retryOverlayActive;
+            retryOverlayActive = false;
+            return wasActive;
+        },
     };
 }

package/dist/adapter/downstream/eventToSdkMessage.d.ts

@@ -58,7 +58,18 @@ export type EventProjectionDropReason =
  *  ⚠️ 「筛完是空的」不算畸形(那是 `empty_payload`,见上;ADAPTER-F6)。 */
 'malformed'
 /** 类型面根本不认识这条臂(引擎比本包新)。 */
- | 'unknown_arm';
+ | 'unknown_arm'
+/**
+ * 类型面**认得**这条臂、它也带着用户可见的决策内容,但本包**今天没有任何消费口**
+ * (2026-08-08 codex 复审第 4/5 轮命中,首例 = `approval_request`)。
+ *
+ * 为什么不能并进 `not_in_slice`:那一档的语义是「本切片不投影,**因为别处接了/本来就没有可渲染物**」,
+ * 它走 `kind:'none'` —— 而 `none` 是**静默**的,只有 `dropped` 会经 `reportDroppedFrame` 走宿主
+ * sink + console 留痕。把一条「有内容、没人接」的帧塞进 `none`,等于把一个真实能力缺口做成静默
+ * fail-open(本仓 P0 共性病的同款形)。判据方向:宁可每次都吼一行,也不要缺口无声。
+ * 为什么也不能并进 `unknown_arm`:那是假话 —— 我们认得它,缺的是消费链,不是类型。
+ */
+ | 'unsupported_arm';
 /**
  * 投影结果三态(REF-CC-058 / xlate-04,A1 禁哨兵值双义 + C6 降级必须可分辨)。
  *

package/dist/adapter/downstream/eventToSdkMessage.js

@@ -63,18 +63,21 @@ function assertNeverArm(_ev) {
  * 旧写法 `if (msg)` 在新返回型上恒真(对象永远 truthy),所以这是**必须点名**的一类改动。
  */
 export function eventToSdkMessage(ev, ctx) {
-    // ── raw 预分派 —— `human_input`(core 5.14.0 design/171 / server 7.4.0 SSE,黑板 [3017]/[3020])──
-    // 🔴 为什么必须在 switch **之前**:这条臂**还没进** SDK 6.3.0 的 `AgentEvent` union
-    //    (`dist/events.d.ts` 实扫:33 条臂里没有它),`case 'human_input'` 在 `ev.type` 上是编译错。
-    //    在 union 里的那天就把它搬进 switch —— 与 `workflow_complete` 当年那条 raw 预分派臂同样的
-    //    退役条件(那一条已于 sdk 6.2.0 兑现退役,先例在本文件 `case 'workflow_complete'` 头注)。
-    // 处置:server 侧对本帧的投影明写「**本帧不带正文**(core 的臂里就没有 text 字段),所以没有
-    //    内容脱敏面」。因此它是**生命周期账本帧**,不是转录物 —— 投成中性内部臂交给 chrome 面记账,
-    //    绝不铸 transcript 行(铸一行就是替引擎编一条它没说过的话)。
-    if (ev.type === 'human_input') {
-        return humanInputProjection(ev, ctx);
-    }
     switch (ev.type) {
+        // ── `human_input`(core 5.14.0 design/171 / server 7.4.0 SSE,黑板 [3017]/[3020])────────────
+        // 🔴 **到期复核已兑现(sdk 6.9.0 提货,2026-08-08)**:本臂此前是 switch **之前**的一条 raw
+        //    预分派(理由 = 它还没进 SDK 6.3.0 的 `AgentEvent` union,`case 'human_input'` 在 `ev.type`
+        //    上是编译错),头注写着「在 union 里的那天就把它搬进 switch」。sdk 6.9.0 的 events.d.ts
+        //    已声明该臂 ⇒ 按原定计划搬进来。这不是可选的整理:预分派用的是 `(ev as {type?:unknown})`
+        //    形,**不收窄** `ev`,所以臂一进 union,switch 的 `default` 就还看得见它 ⇒ B5 穷举断言
+        //    (assertNeverArm)编译期真红。搬进来后本函数重回「每一条臂都受编译期穷举保护」。
+        // 处置不变:server 侧对本帧的投影明写「**本帧不带正文**(core 的臂里就没有 text 字段),所以
+        //    没有内容脱敏面」。因此它是**生命周期账本帧**,不是转录物 —— 投成中性内部臂交给 chrome 面
+        //    记账,绝不铸 transcript 行(铸一行就是替引擎编一条它没说过的话)。
+        // `humanInputProjection` 仍按 raw 记录读(逐键防御 + 白名单),不改口径:wire 是 JSON,引擎可能
+        //    比本包类型新一版,类型收窄不构成「字段一定合法」的保证。
+        case 'human_input':
+            return humanInputProjection(ev, ctx);
         // service 1.75 — `workflow_complete`: an out-of-band background-workflow completion push, ridden onto
         // the session's next stream open (BEFORE the run's own events). Projects to a NEUTRAL internal arm;
         // the upstream bridge turns it into CC's `<task-notification>` injection.
@@ -189,20 +192,47 @@ export function eventToSdkMessage(ev, ctx) {
                     : {}),
             })));
         }
-        // §E3/§E10 — BrainStatus liveness (events.d.ts:44/:80 — rate_limited/retrying/reconnecting/
-        // circuit_open). LIVE-only + EPHEMERAL (never persisted/replayed). Project to a NEUTRAL internal
-        // `retry_status` arm forwarding the provider-neutral fields verbatim (phase/detail/retryInSec) —
+        // §E3/§E10 — BrainStatus liveness. Phases: rate_limited/retrying/reconnecting/circuit_open +
+        // (core 5.x) recovered/gave_up — the two TERMINAL phases; `recovered` means the retry SUCCEEDED,
+        // so the overlay must be TORN DOWN, not rendered as an error (see retryStatus.ts). Project to a
+        // NEUTRAL internal `retry_status` arm forwarding the provider-neutral fields verbatim —
         // NOT a renderable CC SDKMessage. The upstream bridge (sema layer) maps phase→SpinnerRetryStatus +
         // publishes to the sema retry-status store the spinner override reads (187's per-agent
         // `afa(agentId).retryStatus` app-state analog, ui-modules/0157_036_ui_Klo.js:31). The seam stays a
         // dumb forwarder: the provider-neutral→UI-shape mapping is the renderer layer's job (retryStatusStore).
-        case 'status':
+        case 'status': {
+            // 🔴 开集 + 防御读(#3004 跟修批 2026-08-08,与上面 `tool_end.errorCode` 同族姿势):core
+            //    `BrainStatus` 自 5.x 起还带 attempt / maxRetries / retryInMs 三键,server 两腿的
+            //    `brainStatusEventData`(dist/trace/project.js)照发,而 SDK 的 `status` 臂类型只声明
+            //    phase/detail/retryInSec(SDK 面尚未跟上 core)。类型面缺席不等于 wire 上缺席 —— 按
+            //    unknown 读、按 number 窄化后原样透传,否则引擎真发的量在这一层就被剥掉了。
+            //    键集真源 = retryStatus.ts 的 `BRAIN_STATUS_PAYLOAD_KEYS`(engine-vocab G2-c 对账)。
+            const st = ev;
+            const num = (v) => typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+            const attempt = num(st.attempt);
+            const maxRetries = num(st.maxRetries);
+            const retryInMs = num(st.retryInMs);
             return projected(stamp(ctx, armBody({
                 type: 'retry_status',
                 phase: ev.phase,
                 ...(ev.detail !== undefined ? { detail: ev.detail } : {}),
                 ...(ev.retryInSec !== undefined ? { retryInSec: ev.retryInSec } : {}),
+                ...(retryInMs !== undefined ? { retryInMs } : {}),
+                ...(attempt !== undefined ? { attempt } : {}),
+                ...(maxRetries !== undefined ? { maxRetries } : {}),
+                // 🔴 §E2 lane 身份必须透传(2026-08-08 codex 二轮复审命中的**跨 lane 状态破坏**)。
+                //    `status` 臂本来就是 `& EventIdentity`(SDK events.d.ts),server 两腿共用的
+                //    `brainStatusEventData` 也经 `identityFields` 发 eventId/parentToolCallId —— 而本层此前
+                //    把两键都剥掉了。后果:`arms.ts` 的 `retryStatusArm` 首行那条子代断闸
+                //    (`if (typeof m.parentToolCallId === 'string') return`,#47 矩阵 #5)在 wire 路径上**恒不命中**,
+                //    子代的 status 一直骑着主 spinner。旧代际下这只是显示噪声;`recovered` 相落地后它升级成
+                //    真状态破坏:**子代**的 recovered 会去 `takeRetryOverlay()` 消费掉**宿主**仍在重试的覆盖层,
+                //    向用户谎报「宿主已恢复」,而宿主随后真正的 recovered 反被判成「没有覆盖层」而沉默。
+                //    两键防御读(旧 server 缺席 ⇒ 键不 stamp,形状不变)。
+                ...(typeof ev.eventId === 'string' ? { eventId: ev.eventId } : {}),
+                ...(typeof ev.parentToolCallId === 'string' ? { parentToolCallId: ev.parentToolCallId } : {}),
             })));
+        }
         // MF-10 (design/99, events.d.ts task_progress) — a SUBAGENT PROGRESS TICK: the delegated sub-run's
         // CUMULATIVE usage at each turn boundary (LIVE/EPHEMERAL, never persisted/replayed). Project to a
         // NEUTRAL internal `task_progress` arm — NOT a renderable CC SDKMessage. The upstream bridge binds it
@@ -406,7 +436,44 @@ export function eventToSdkMessage(ev, ctx) {
         //   臂投)——本切片不投影。⚠️ 「压缩失败让用户看见」是 chrome/HUD 面的活,今天两端都还没接
         //   (adapt 臂表同样无此臂),缺口记 0.13.0 候选,不许由本切片顺手编一个假 transcript 形。
         case 'compaction_outcome':
+        // ── sdk 6.9.0 提货批(2026-08-08)新入 union 的四条臂 ─────────────────────────────────────
+        // `wiring_manifest`:引擎的接线自述(leg/ask/tools 指纹)—— 可观测面,CC transcript 无对位物。
+        case 'wiring_manifest':
+        // `tool_approval` / `tool_approval_complete`:HITL 审批帧。**#185a 起它们是 `AgentEvent` 的臂**
+        //   (此前只是 named SSE frame),但本切片不是它们的消费口 —— 它们由
+        //   `hitl/toolApprovalWire.isToolApprovalFrame` + `hitl/frameRouter` 走审批卡那条链。在这里投一
+        //   条 transcript 行只会让同一只 ask 出现两次;`nothing('not_in_slice')` 是如实陈述,不是丢帧。
+        //   ⚠️ 它们**必须**出现在这个 switch 里(而不是靠 default 兜):进 switch 才受 B5 编译期穷举
+        //   保护,才能在下一次 union 变形时把「谁不投影」这件事重新摆到人眼前。
+        case 'tool_approval':
+        case 'tool_approval_complete':
             return nothing('not_in_slice');
+        /**
+         * `approval_request`(design/172 流内审批协议,server ≥7.3.0、7.5.0 起默认开)。
+         *
+         * 🔴 与上面两条**不同源**,所以单列(2026-08-08 codex 复审第 4 轮命中:首版把三条并成一句
+         * 「都由 frameRouter 消费」—— 而 `isToolApprovalFrame` 只认 tool_approval/tool_approval_complete,
+         * 这条帧在**包内今天零消费口**,那句话是假的;pure 门 058⑬ 段把这个事实钉住了)。
+         *
+         * 🔴 分类 = `dropped/unsupported_arm` 而不是 `none/not_in_slice`(第 5 轮命中):`none` 是**静默**的,
+         * 只有 `dropped` 会经 `reportDroppedFrame` 走宿主 sink + console 留痕。本帧带着用户可见的决策内容
+         * (风险两轴 irreversible/egress/requiresRealApproval、窗口倒计时、`askId` 的持久 CAS 决策语义),
+         * 却没人接 —— 把这种缺口做成静默 none 就是本仓 P0 共性病那个形。宁可每次都吼一行。
+         * (本批之前它落 `default:` 的 `dropped/unknown_arm`,也是有痕的;#185a 把它加进 union 之后必须进
+         * switch 才编译得过,那一步不该顺手把痕迹弄丢。)
+         *
+         * 📋 缺口如实记账(**不**在本批修 —— 那是一条新卡链,是功能不是修复):
+         *   · 存量路径今天仍能决断:SDK 头注(tool-approvals.d.ts)载明开关打开时同一只 ask 出两帧、顺序
+         *     钉死「先 legacy `tool_approval`、后 `approval_request`」,两帧同带 `approvalId`,legacy 腿在。
+         *   · 但**降级路径不保证**:legacy respond 是 live-only + same-replica(错副本 404),而重连时
+         *     pending 卡是靠 `approval_request` preamble 对账的 —— 「收到 legacy 帧后断线、按 Last-Event-ID
+         *     重连只再看到 approval_request」以及非粘性多副本部署这两条路上,今天只能等窗口到期→park/deny。
+         *   · 接法(留给专门的一车):`isApprovalRequestFrameV1` 校形 → 按 approvalId/askId 去重并处理重连
+         *     preamble → 带幂等键的 `decideAsk` 持久 CAS → 仅在能力位关闭/新帧不可用时回落 legacy respond。
+         *   在那条链落地之前,**不许**由本切片顺手编一个假 transcript 形来假装接上了。
+         */
+        case 'approval_request':
+            return dropped('unsupported_arm', 'approval_request');
         default:
             // B5 穷举:SDK union 加成员必须在**编译期**打红这一行(而不是让新臂在用户面静默丢帧)。
             assertNeverArm(ev);

package/dist/hitl/toolApprovalWire.d.ts

@@ -128,6 +128,16 @@ export interface ApprovalCardRequest {
     /** wire 层降级说明(卡 content 上方 dim 行,ToolUseConfirm.wireNote 超集位)——argsOmitted 等
      *  不可注入 args 的提示走这里([1543]③ 记账的 note 位,2026-07-23 落位)。 */
     wireNote?: string;
+    /**
+     * 治理强制位(server ≥7.5.0,2026-08-08 补透传)——原样来自
+     * {@link ToolApprovalFrame.governanceForced}。**缺席 ≠ false**:只在为真时在场,缺席 = 无治理来源
+     * 的证据。壳应据此把门呈成**表态掀不掉**(而不是引导用户去改 `permissionMode`);呈现形是壳半场,
+     * 本包只保证这一位到得了卡口 —— 此前它在帧类型上就不存在,于是宿主无论怎么写都读不到。
+     */
+    governanceForced?: true;
+    /** 委派出处链(core 5.9.0 W1)——原样来自 {@link ToolApprovalFrame.delegation};只读展示增强,
+     *  `agentName` UNTRUSTED-for-display。子代 ask 才在场。 */
+    delegation?: ToolApprovalDelegation;
 }
 /**
  * 🔴 **拆缝口** —— 弹「三选卡」并等人的决断。壳 = vendored CC `PermissionRequest`;
@@ -190,13 +200,41 @@ export interface ToolApprovalFrame {
     fromSubagent?: boolean;
     /** core 1.378 RB-39②:展示身份(UNTRUSTED-for-display,server redact 后上帧)——徽章名一手源。 */
     sourceAgentName?: string;
+    /**
+     * server ≥7.5.0([2942]/[2943],ADDITIVE;≤7.4.0 恒缺席)——**治理强制**位:此门来自运维治理层
+     * (部署侧 `AUTONOMY` / `commandPolicy` / `MANUAL_MODE_SHELL_GATE` / `SENSITIVE_WRITE_PATTERNS`),
+     * 不是模型默认门、也不是本次请求的客户端表态。它回答「我都开了 `bypassPermissions` 为什么还在问」。
+     *
+     * 🔴 **缺席 ≠ `false`**(与风险两轴同族纪律):本键**只在为真时在场**。缺席 = 「没有治理来源的
+     * 证据」,它既覆盖真的非治理 ask,也覆盖 server 侧判据够不着的形(治理 shell 门停在 `classify`
+     * 档时,一次 shell ask 出自分类器还是别的门无从分辨——server 选择让键缺席而不是猜)。所以缺席
+     * **不得**被渲染成「这门可以用表态绕开」。
+     *
+     * 分工:本包只做**透传**(帧 → {@link ApprovalCardRequest.governanceForced}),徽标呈现是壳半场。
+     */
+    governanceForced?: true;
+    /**
+     * core 5.9.0 W1([2535],ADDITIVE):ask 的**委派出处链**(最内层孙代帧胜出)。与
+     * {@link fromSubagent} 同门在场(只有子代 ask 带)。只读展示增强 —— 卡可以说清这只 ask 是从哪
+     * 一层浮上来的。`agentName` 与 {@link sourceAgentName} 同属 UNTRUSTED-for-display。
+     */
+    delegation?: ToolApprovalDelegation;
+}
+/** {@link ToolApprovalFrame.delegation} 的形(命名形,不用内联匿名 —— typeshape 门 B4 棘轮口径)。 */
+export interface ToolApprovalDelegation {
+    /** 宿主侧那次委派调用的 tool-call id —— 卡的归属锚。 */
+    parentToolCallId: string;
+    /** 委派深度(宿主直接子代 = 1)。 */
+    depth: number;
+    /** 子代 agent 名。**UNTRUSTED**:spawning model 的自由文本(server 已脱敏+限长)。 */
+    agentName?: string;
 }
 /**
  * 本地值拷贝的**运行时键集镜像**([1950]② 建议形):对账测试拿它与 SDK 0.1.6+ 的同源锚
  * `TOOL_APPROVAL_FRAME_KEYS` 比对——SDK additive 增键时对账当天红,不再人肉追平。
  * 下面两个类型钉保证镜像与 interface 本身不可能漂移(少键/多键都是编译错)。
  */
-export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "outcome"];
+export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "delegation", "outcome"];
 /** 子代帧判别:显式键 fromSubagent(core 1.378 RB-39②)优先;缺席退 sourceTaskId 在场性权宜式
  *  (server 1.258 [1549]①3,旧代际兼容)。 */
 export declare function isFromSubagent(frame: ToolApprovalFrame): boolean;
@@ -243,7 +281,10 @@ export interface ToolApprovalFrameOutcome {
     /** server 的 200 ack。**缺席 = 未知**(注入面回 void / 旧 server / respond 失败),绝不当成 false。 */
     ack?: ToolApprovalRespondAck;
 }
-/** 结构性识别流上的 tool_approval 帧(named SSE frame,payload.type === 帧名;非 AgentEvent arm)。 */
+/** 结构性识别流上的 tool_approval 帧(named SSE frame,payload.type === 帧名)。
+ *  ⚠️ 口径更正(2026-08-08):此处原写「非 AgentEvent arm」—— SDK #185a 起这两个帧**是**
+ *  `AgentEvent` 的臂了(durable 腿也回放),所以结构识别与 union 收窄两条路都成立;本函数仍按
+ *  结构读(不依赖类型收窄),因为它同时服务 raw SSE 与 durable 回放两条入口。 */
 export declare function isToolApprovalFrame(ev: unknown): ev is ToolApprovalFrame;
 /**
  * 消费一张 `tool_approval` 帧:弹三选卡 → respond。引擎此刻同步阻塞在本帧上(fail-closed 全腿:

package/dist/hitl/toolApprovalWire.js

@@ -301,10 +301,39 @@ export const TOOL_APPROVAL_FRAME_KEYS_MIRROR = [
     'message',
     'args',
     'argsOmitted',
+    // sdk 6.9.0 追平(2026-08-08,#3004 跟修批):server 7.5.0 起真发 `governanceForced`,core 5.9.0 W1
+    // 起真发 `delegation` —— 镜像滞后了两代,于是这两键在包内**零消费面**(治理徽标端到端不可达,
+    // [1947] 那次 `toolCallId` 滞后的同款形)。本门(run-approval-frame-keys-test.mjs)对 SDK 运行期
+    // 锚逐元素相等,所以这次滞后是被门抓到的,不是人肉发现的。
+    'governanceForced',
+    'delegation',
     'outcome',
 ];
 const _mirrorPin = [true, true];
 void _mirrorPin;
+/**
+ * `delegation` 的结构读(wire 是 JSON:注入面/旧 server/比本包新一版的 server 都可能给别的形)。
+ * 坏形一律降**缺席** —— 与 `readToolApprovalRespondAck` 同族纪律:「拿到一个不好用的值」不如
+ * 「诚实地什么都没有」。`parentToolCallId` 是卡的归属锚、`depth` 决定「第几层」的措辞,两者任一
+ * 不成形就整体不透传(半个链比没有链更容易被渲成错话);`agentName` 非串时单独降缺席。
+ *
+ * **不导出**(2026-08-08 收货修):它是本模块的边界窄化器,唯一消费点就在下面那个卡口调用;导出会
+ * 给公面加一个 `unknown` 入参签名(typeshape 门的 unknown-出境棘轮 +1),而它的行为在 pure 门里由
+ * `surfaceToolApprovalFrameAndRespond` 的坏形/正形素材端到端覆盖 —— 真消费路径比直调守卫更强。
+ */
+function isToolApprovalDelegation(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    const d = v;
+    // 归属锚:必须是**非空白**串(`'  '` 当 tool-call id 用会让卡按一个空锚归属)。
+    if (typeof d.parentToolCallId !== 'string' || d.parentToolCallId.trim().length === 0)
+        return false;
+    // 深度:上游语义是「宿主直接子代 = 1」⇒ **正安全整数**。0 / 负数 / 小数都不是可渲染的层数,
+    // 而 `Number.isFinite` 会把它们全放过(codex 复审命中:`depth: 0` / `-1` / `1.5` 曾一律判真)。
+    if (typeof d.depth !== 'number' || !Number.isSafeInteger(d.depth) || d.depth < 1)
+        return false;
+    return d.agentName === undefined || typeof d.agentName === 'string';
+}
 /** 子代帧判别:显式键 fromSubagent(core 1.378 RB-39②)优先;缺席退 sourceTaskId 在场性权宜式
  *  (server 1.258 [1549]①3,旧代际兼容)。 */
 export function isFromSubagent(frame) {
@@ -348,7 +377,10 @@ export function readToolApprovalRespondAck(v) {
         ...(typeof o.updatedInputForwarded === 'boolean' ? { updatedInputForwarded: o.updatedInputForwarded } : {}),
     };
 }
-/** 结构性识别流上的 tool_approval 帧(named SSE frame,payload.type === 帧名;非 AgentEvent arm)。 */
+/** 结构性识别流上的 tool_approval 帧(named SSE frame,payload.type === 帧名)。
+ *  ⚠️ 口径更正(2026-08-08):此处原写「非 AgentEvent arm」—— SDK #185a 起这两个帧**是**
+ *  `AgentEvent` 的臂了(durable 腿也回放),所以结构识别与 union 收窄两条路都成立;本函数仍按
+ *  结构读(不依赖类型收窄),因为它同时服务 raw SSE 与 durable 回放两条入口。 */
 export function isToolApprovalFrame(ev) {
     const e = ev;
     return (!!e &&
@@ -426,6 +458,9 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
     // [1535]:子代的写审批浮到宿主卡(server 1.258 broker 腿)——卡头渲归属徽章(`· @name`),
     // 用户知道在替谁批。判别=fromSubagent 显式键(core 1.378)优先、sourceTaskId 在场性权宜式兜底;
     // 宿主自身 ask 两键恒缺席=徽章缺席,卡形不变。
+    // 🔴 治理位与委派链透传(2026-08-08):两键在帧上**只在为真/在场时**出现,所以这里也按在场性
+    //    条件 stamp —— 绝不 `governanceForced: frame.governanceForced === true`(那会把「缺席」折成
+    //    显式 `false`,而缺席的语义是「没有治理来源的证据」,不是「这门可以被表态掀掉」)。
     const card = await surfaceApprovalCard({
         toolName,
         args: args,
@@ -433,6 +468,15 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
         ...(signal ? { signal } : {}),
         ...(isFromSubagent(frame) ? { workerBadge: subagentBadgeFor(frame) } : {}),
         ...(wireNote !== undefined ? { wireNote } : {}),
+        ...(frame.governanceForced === true ? { governanceForced: true } : {}),
+        // 🔴 跨字段不变量(codex 复审命中):`delegation` 只在**子代 ask** 的门上在场(SDK 头注:
+        //    "Present on the same door as fromSubagent (child asks only)")。只校对象形不校这一条 ⇒
+        //    一个**宿主自己**的破坏性工具审批也能带着 delegation 到卡口,被呈成「某层子代发起的」——
+        //    把归属这件安全展示位渲错,正是本键存在的反面。`isToolApprovalFrame` 只验 type/approvalId,
+        //    所以 raw SSE / durable 回放里的坏形到得了这里,必须在本层挡住。
+        ...(isFromSubagent(frame) && isToolApprovalDelegation(frame.delegation)
+            ? { delegation: frame.delegation }
+            : {}),
     });
     const decision = card.kind === 'allow' ? (card.allowSession ? 'allow_session' : 'allow') : 'deny';
     if (card.kind === 'failed') {

package/dist/retryStatus.d.ts

@@ -6,16 +6,46 @@
  *   retrying     → error    → '✻ API error · Retrying in Ns'(非终态;187 硬编码 'API error')
  *   rate_limited → error    → '✻ Usage limit reached · Retrying in Ns'(rateLimits 真 ⇒ 终态)
  *   circuit_open → error    → '✻ <detail|Service temporarily unavailable> · Retrying in Ns'
- * 绝不捏造 attempt 计数——只用引擎真给的 phase/detail/retryInSec。
+ *   recovered    → null     → 覆盖层摘掉(重试**成功**,不是错误 —— 见下)
+ *   gave_up      → error+terminal → '✻ <detail>'(重试用尽的终态;与 recovered 反向。**打 terminal 位**,
+ *                                    渲染面据此不得再接「· Retrying in Ns」——已经没有下一次了)
+ * 绝不捏造 attempt 计数——只用引擎真给的 phase / detail / retryInSec / retryInMs / attempt / maxRetries。
+ *
+ * 🔴 员数与字段补全(2026-08-08,#3004 跟修批)。此前本文件只列 4 相 + 3 字段,而引擎侧
+ * (core `BrainStatusPhase` / `BrainStatus`,dist/core/types.d.ts)是 **6 相 + 6 字段**,server 两腿的
+ * `brainStatusEventData`(dist/trace/project.js)把 attempt/maxRetries/retryInMs 全发。两处后果:
+ *   · `recovered`(引擎重试**成功**的终态)落 `default:` 臂 ⇒ 被渲成 `kind:'error'`,即
+ *     「刚刚恢复」被渲成「API error · Retrying」—— 方向完全相反的谎报;
+ *   · attempt/maxRetries/retryInMs 在本层被剥掉 ⇒ `RetryStatus` 上早就留好的 attempt/maxRetries
+ *     两位恒缺席。这不是「不许编造」(那条纪律没错),是**供给方给了却没接**。
+ * 反漂移腿:`scripts/run-engine-vocab-floor-test.mjs` G2-b/G2-c 拿下面两张运行期镜像对**实装
+ * @sema-agent/core** 的 `BrainStatusPhase` / `BrainStatus` 逐词逐键对账 —— 引擎再加相/加键,那边先红。
  */
-export type RetryStatus = {
+export type RetryStatus = 
+/** 等 API 响应(`reconnecting`)。**计数两位在场**:实装 core 的 reconnecting 帧与 retrying/
+ *  rate_limited 同形,六字段全发(`stream-engine.js` 三处 `sleepAnnouncingRetry` 逐处实测)——
+ *  丢掉它们正好是在「用户最需要看重连进度」的那一刻把进度藏起来(2026-08-08 codex 复审命中)。 */
+{
     kind: 'stalled';
     deadline: number;
+    attempt?: number;
+    maxRetries?: number;
 } | {
     kind: 'error';
     deadline: number;
     attempt?: number;
     maxRetries?: number;
+    /**
+     * 🔴 **终态位**(2026-08-08 codex 复审命中):`true` ⇔ 引擎**不会再重试了**(`gave_up` 相)。
+     * 缺席 = 仍在重试循环里(retrying / rate_limited / circuit_open)。
+     *
+     * 为什么必须有这一位:`deadline` 的语义是「距下次重试」,而 gave_up 根本没有下次 —— 实装 core
+     * 的 finally 只发 `{phase:'gave_up', detail:'retries exhausted'}`(**不带** attempt/maxRetries,
+     * 所以消费方也无法靠「3/3」推出耗尽)。没有这一位,187 那套「<detail> · Retrying in Ns」句式
+     * 会把一次**已经放弃**渲成「正在重试,还剩 0 秒」——终帧稍有延迟,这句谎就一直挂着。
+     * 渲染措辞是壳半场(本包不渲染),本位只保证那个事实到得了壳。
+     */
+    terminal?: true;
     error: {
         formatted: string;
         isNetworkDown?: boolean;
@@ -28,9 +58,38 @@ export type RetryStatus = {
         } | null;
     };
 };
+/**
+ * core `BrainStatusPhase` 的**运行期值拷贝**(engine-vocab 门 G2-b 拿它对实装 core 对账)。
+ * 引擎侧是闭集,**读时按开集处理** —— 一个部署可以在自己的通道上冒出别的相,认得的分支照走,
+ * 认不得的落 `default:` 兜底(见 {@link mapBrainStatusToRetry} 末臂)。
+ */
+export declare const BRAIN_STATUS_PHASES: readonly ["rate_limited", "retrying", "reconnecting", "circuit_open", "recovered", "gave_up"];
+export type BrainStatusPhase = (typeof BRAIN_STATUS_PHASES)[number];
+/** wire 上 `status` 臂的载荷(= core `BrainStatus`;server 两腿白名单原样转发这 6 键)。 */
 export interface BrainStatusPayload {
-    phase: string;
+    /** 闭集 + `(string & {})`:未知相仍可携带(开集读),不必先改类型再解析。 */
+    phase: BrainStatusPhase | (string & {});
+    /** 中性人话提示(无 provider/HTTP 细节;server 已脱敏 + 限 300 字)。 */
     detail?: string;
+    /** 距下次重试的秒数(= `ceil(retryInMs/1000)`,core circuit-breaker 与 ms 位同发)。 */
     retryInSec?: number;
+    /** 距下次重试的毫秒数 —— **更精的同一个量**,在场时优先于 `retryInSec`。 */
+    retryInMs?: number;
+    /** 引擎真实的第几次尝试(1-based)。缺席 = 引擎没给,绝不折成 0。 */
+    attempt?: number;
+    /** 引擎这一轮的重试上限。与 `attempt` 一起才能渲「2/5」。 */
+    maxRetries?: number;
 }
-export declare function mapBrainStatusToRetry(p: BrainStatusPayload, nowMs: number): RetryStatus;
+/**
+ * 上面那个 interface 的**运行期键镜像**(照 `TOOL_APPROVAL_FRAME_KEYS_MIRROR` 先例):
+ * engine-vocab 门 G2-c 拿它与 core `BrainStatus` 的键集逐元素比 ⇒ 引擎 additive 增键当天红。
+ * 下面两个类型钉保证镜像与 interface 之间不可能漂移(少键/多键都是编译错)。
+ */
+export declare const BRAIN_STATUS_PAYLOAD_KEYS: readonly ["phase", "detail", "retryInSec", "retryInMs", "attempt", "maxRetries"];
+/**
+ * BrainStatus 载荷 → spinner 行状态。
+ *
+ * 返回 **`null` = 没有覆盖层**(不是「不知道」):今天只有 `recovered` 走这条 —— 引擎明说这次重试
+ * 已经成功,行就该摘掉。此前本函数返回型钉死非空,于是 `recovered` 只能被塞进 error 臂。
+ */
+export declare function mapBrainStatusToRetry(p: BrainStatusPayload, nowMs: number): RetryStatus | null;

package/dist/retryStatus.js

@@ -6,23 +6,87 @@
  *   retrying     → error    → '✻ API error · Retrying in Ns'(非终态;187 硬编码 'API error')
  *   rate_limited → error    → '✻ Usage limit reached · Retrying in Ns'(rateLimits 真 ⇒ 终态)
  *   circuit_open → error    → '✻ <detail|Service temporarily unavailable> · Retrying in Ns'
- * 绝不捏造 attempt 计数——只用引擎真给的 phase/detail/retryInSec。
+ *   recovered    → null     → 覆盖层摘掉(重试**成功**,不是错误 —— 见下)
+ *   gave_up      → error+terminal → '✻ <detail>'(重试用尽的终态;与 recovered 反向。**打 terminal 位**,
+ *                                    渲染面据此不得再接「· Retrying in Ns」——已经没有下一次了)
+ * 绝不捏造 attempt 计数——只用引擎真给的 phase / detail / retryInSec / retryInMs / attempt / maxRetries。
+ *
+ * 🔴 员数与字段补全(2026-08-08,#3004 跟修批)。此前本文件只列 4 相 + 3 字段,而引擎侧
+ * (core `BrainStatusPhase` / `BrainStatus`,dist/core/types.d.ts)是 **6 相 + 6 字段**,server 两腿的
+ * `brainStatusEventData`(dist/trace/project.js)把 attempt/maxRetries/retryInMs 全发。两处后果:
+ *   · `recovered`(引擎重试**成功**的终态)落 `default:` 臂 ⇒ 被渲成 `kind:'error'`,即
+ *     「刚刚恢复」被渲成「API error · Retrying」—— 方向完全相反的谎报;
+ *   · attempt/maxRetries/retryInMs 在本层被剥掉 ⇒ `RetryStatus` 上早就留好的 attempt/maxRetries
+ *     两位恒缺席。这不是「不许编造」(那条纪律没错),是**供给方给了却没接**。
+ * 反漂移腿:`scripts/run-engine-vocab-floor-test.mjs` G2-b/G2-c 拿下面两张运行期镜像对**实装
+ * @sema-agent/core** 的 `BrainStatusPhase` / `BrainStatus` 逐词逐键对账 —— 引擎再加相/加键,那边先红。
+ */
+/**
+ * core `BrainStatusPhase` 的**运行期值拷贝**(engine-vocab 门 G2-b 拿它对实装 core 对账)。
+ * 引擎侧是闭集,**读时按开集处理** —— 一个部署可以在自己的通道上冒出别的相,认得的分支照走,
+ * 认不得的落 `default:` 兜底(见 {@link mapBrainStatusToRetry} 末臂)。
+ */
+export const BRAIN_STATUS_PHASES = [
+    'rate_limited',
+    'retrying',
+    'reconnecting',
+    'circuit_open',
+    'recovered',
+    'gave_up',
+];
+/**
+ * 上面那个 interface 的**运行期键镜像**(照 `TOOL_APPROVAL_FRAME_KEYS_MIRROR` 先例):
+ * engine-vocab 门 G2-c 拿它与 core `BrainStatus` 的键集逐元素比 ⇒ 引擎 additive 增键当天红。
+ * 下面两个类型钉保证镜像与 interface 之间不可能漂移(少键/多键都是编译错)。
+ */
+export const BRAIN_STATUS_PAYLOAD_KEYS = [
+    'phase',
+    'detail',
+    'retryInSec',
+    'retryInMs',
+    'attempt',
+    'maxRetries',
+];
+const _brainStatusKeyPin = [true, true];
+void _brainStatusKeyPin;
+/**
+ * BrainStatus 载荷 → spinner 行状态。
+ *
+ * 返回 **`null` = 没有覆盖层**(不是「不知道」):今天只有 `recovered` 走这条 —— 引擎明说这次重试
+ * 已经成功,行就该摘掉。此前本函数返回型钉死非空,于是 `recovered` 只能被塞进 error 臂。
  */
 export function mapBrainStatusToRetry(p, nowMs) {
-    const deadline = nowMs + Math.max(0, p.retryInSec ?? 0) * 1000;
+    // 退避剩余量:ms 位在场就用 ms(1200ms 用 sec 位会被 ceil 成 2s,行上少一秒多一秒都是谎)。
+    const remainingMs = typeof p.retryInMs === 'number' ? p.retryInMs : (p.retryInSec ?? 0) * 1000;
+    const deadline = nowMs + Math.max(0, remainingMs);
+    /** 引擎真给的计数才落位;缺席 ⇒ 键不 stamp(诚实缺席,不造 0)。 */
+    const counts = {
+        ...(typeof p.attempt === 'number' ? { attempt: p.attempt } : {}),
+        ...(typeof p.maxRetries === 'number' ? { maxRetries: p.maxRetries } : {}),
+    };
     switch (p.phase) {
+        // 🔴 引擎直报「恢复」:摘行。绝不落 error 臂 —— 那是把成功渲成失败。
+        case 'recovered':
+            return null;
         case 'reconnecting':
-            return { kind: 'stalled', deadline };
+            return { kind: 'stalled', deadline, ...counts };
         case 'rate_limited':
-            return { kind: 'error', deadline, error: { formatted: '', rateLimits: {} } };
+            return { kind: 'error', deadline, ...counts, error: { formatted: '', rateLimits: {} } };
         case 'circuit_open':
             return {
                 kind: 'error',
                 deadline,
+                ...counts,
                 error: { formatted: p.detail ?? 'Service temporarily unavailable', isNetworkDown: true },
             };
+        // 重试用尽:仍是错误行(与 recovered 反向,绝不许一起归成「结束了 ⇒ 清行」),但**打终态位** ——
+        // 实装 core 的 finally 只发 `{phase, detail}`(detail = 'retries exhausted' / 'cancelled while
+        // retrying'),既没有计数也没有 retryIn*,所以「不会再重试了」这件事**只能**由本位表达;
+        // 靠 attempt===maxRetries 去推是错的(供给方根本不发那两位)。
+        case 'gave_up':
+            return { kind: 'error', deadline, terminal: true, ...counts, error: { formatted: p.detail ?? '' } };
         case 'retrying':
         default:
-            return { kind: 'error', deadline, error: { formatted: '' } };
+            return { kind: 'error', deadline, ...counts, error: { formatted: '' } };
     }
 }

package/dist/seatContract.d.ts

@@ -75,6 +75,7 @@
 import type { ReasoningEffort } from "./effortWire.js";
 import type { LaneProof } from "./seam.js";
 import type { QuestionAnswer } from "./liveQuestionStore.js";
+import type { ToolApprovalDelegation } from "./hitl/toolApprovalWire.js";
 /** 一次门校验的失败说明。 */
 export interface SeatValidationFailure {
     /** 人可读的失败原因,恒在场且非空(宿主日志里那一行的正文)。 */
@@ -222,6 +223,18 @@ export interface ToolPermissionRequest {
      *  与转录里的引擎时间戳不可直接相减)。缺席 = wire 那一行没带时间(旧 server 的 durable 行)⇒
      *  消费端渲「刚刚」或不渲时间,**绝不**回落成 0(那会渲成 1970)。 */
     createdAtMs?: number;
+    /** 治理强制位([C130] 补键,2026-08-08;server ≥7.5.0,语义原样来自
+     *  `ApprovalCardRequest.governanceForced`):此门来自部署治理层,「permission-mode overrides
+     *  do not apply」。🔴 缺席 ≠ `false`:键**只在为真时在场**,缺席 = 无治理来源证据(真的非治理
+     *  ask 与 server 判据够不着的形共用缺席)⇒ 渲染端绝不渲「可用表态绕开」,也绝不合成治理徽标。
+     *  唯一合法供给 = 宿主(session-host)从已过 hitl wire 门的 `ApprovalCardRequest` **透传**,
+     *  绝不自铸;为 `false` 的值不该出现在座位面上(条件 stamp 纪律与 wire 门同款)。 */
+    governanceForced?: true;
+    /** 委派出处链([C130] 补键;core 5.9.0 W1,原样来自 `ApprovalCardRequest.delegation`,形 =
+     *  hitl 的命名类型,单一真源)。只读展示增强——卡说清这只 ask 从哪一层子代浮上来;`agentName`
+     *  UNTRUSTED-for-display(纯文本渲染,零注入面)。缺席 = 非子代 ask 或 wire 没给 ⇒ 不渲委派行。
+     *  坏形处置与 hitl wire 门同款纪律:**读坏形降缺席**,绝不因展示键拒掉整条审批行。 */
+    delegation?: ToolApprovalDelegation;
 }
 /**
  * 座位事件名的**闭集**(REF-CC-065):这是三端唯一的事件名真源。
@@ -451,6 +464,14 @@ export interface SendMessageRequest {
     /** Per-turn settings sub-object → `TaskRequest.settings`. Closed shape (`SeatTurnSettings`);
      *  today's only member is the `ultracode` preset boolean. */
     settings?: SeatTurnSettings;
+    /** 本轮 scenario 拨盘选择([C131] 补载体,2026-08-08)→ `TaskRequest.scenario`。**开集**(SDK
+     *  `Scenario = KnownScenario | (string & {})` 同姿态——部署可注册自有场景,座位面不替它闭集)。
+     *  缺席 = 不 stamp,由部署解析默认场景(assignment 链)。错误面是响亮的 typed 400:名字不在
+     *  部署词表 ⇒ `scenario_unknown`(body 带 live 词表 `known`);在词表但不在本 principal
+     *  allowlist ⇒ `scenario_not_allowed`(带 allowlist)——渲染端可据此渲有效选项,不猜不折叠。
+     *  此前的结构性缺席与 `reasoningEffort` 同款:闭集载体就是 lane 本身,不在集里 = 拨盘的选择
+     *  在座位 lane 上没有位置可放(web [C131]① 记账的九键无载体形)。 */
+    scenario?: string;
 }
 /** `uploadAttachment` 入参(REF-CC-074:此前是导出方法签名里的 3 成员内联匿名形,直接命中 B4)。 */
 export interface AttachmentUploadRequest {
@@ -665,9 +686,9 @@ export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedS
 /** 事件式(main→renderer push)的 verb —— SPEC 里 `kind: "event"` 的那一撮,门里逐元素对账。 */
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "messages", "error", "errorCategory", "code", "request", "data", "sources", "permissionMode", "session", "userMessageUuid", "hasPreClearSession", "requestId", "outcome", "chrome"];
-export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs"];
+export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation"];
 export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
-export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "settings"];
+export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "settings", "scenario"];
 export declare const TOOL_PERMISSION_DECISION_KEYS: readonly ["sessionId", "requestId", "decision", "answer", "updatedInput", "remember"];
 export declare const START_SESSION_OPTION_KEYS: readonly ["model", "title", "cwd", "excludeTools"];
 /**
@@ -707,6 +728,12 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly unchecked: readonly [{
             readonly key: "input";
             readonly why: "UNTRUSTED service-redacted 工具参数 / 问题载荷:形状由工具自己定(CC request-args 姿态),渲染端只读不回喂;缺席/畸形的渲染义务写在字段注释里。";
+        }, {
+            readonly key: "governanceForced";
+            readonly why: "展示增强位,权威门在 hitl wire 卡口(条件 stamp,false 不上 wire);座位门再裁一次=配对机制前提不共享的雷,且拒整条 request 会为一个徽标键把安全 ask 丢给引擎 TTL deny。消费端按 `=== true` 读,其余一律当缺席。";
+        }, {
+            readonly key: "delegation";
+            readonly why: "展示增强位,权威结构门在 hitl wire 卡口(结构读+仅子代 ask 在场,坏形降缺席);座位门同款理由不设第二判官。消费端坏形降缺席,绝不拒行。";
         }];
     };
     readonly LocalSessionEvent: {

package/dist/seatContract.js

@@ -657,6 +657,10 @@ export const TOOL_PERMISSION_REQUEST_KEYS = [
     "message",
     "toctouBinding",
     "createdAtMs",
+    // [C130] 补键(2026-08-08):治理徽标+委派行的座位载体——desktop 座位 lane 此前无键可透传,
+    // 「治理徽标可开工」只在浏览器 lane 成立(半场口径,[C130] 修正)。
+    "governanceForced",
+    "delegation",
 ];
 export const LOCAL_SESSION_RECORD_KEYS = [
     "sessionId",
@@ -681,6 +685,8 @@ export const SEND_MESSAGE_REQUEST_KEYS = [
     "reasoningEffort",
     "retainBackgroundProcesses",
     "settings",
+    // [C131] 补载体(2026-08-08):scenario 拨盘的座位 lane 席位(同上结构性缺席形)。
+    "scenario",
 ];
 export const TOOL_PERMISSION_DECISION_KEYS = [
     "sessionId",
@@ -730,6 +736,14 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 key: "input",
                 why: "UNTRUSTED service-redacted 工具参数 / 问题载荷:形状由工具自己定(CC request-args 姿态),渲染端只读不回喂;缺席/畸形的渲染义务写在字段注释里。",
             },
+            {
+                key: "governanceForced",
+                why: "展示增强位,权威门在 hitl wire 卡口(条件 stamp,false 不上 wire);座位门再裁一次=配对机制前提不共享的雷,且拒整条 request 会为一个徽标键把安全 ask 丢给引擎 TTL deny。消费端按 `=== true` 读,其余一律当缺席。",
+            },
+            {
+                key: "delegation",
+                why: "展示增强位,权威结构门在 hitl wire 卡口(结构读+仅子代 ask 在场,坏形降缺席);座位门同款理由不设第二判官。消费端坏形降缺席,绝不拒行。",
+            },
         ],
     },
     LocalSessionEvent: {

package/dist/skillsWireCaps.d.ts

@@ -8,17 +8,44 @@
  * loader graph (loadSkillsDir / loadPluginCommands pull analytics/signals/fs). It imports ONLY the `SkillSpec`
  * type (erased at build), so a test can esbuild-bundle THIS file alone — no runtime side effects.
  *
- * The caps mirror the SDK `TaskRequest.skills` server caps (types.ts:82): ≤10 items, name ≤64, description
- * ≤1024, content ≤32768 — a violation is a 400, so we truncate/limit HERE to make the live request well-formed
+ * The caps mirror the server's `validateUserSkills` hard limits: ≤10 items, name ≤64, description ≤1024,
+ * content ≤1MB — a violation is a 400, so we truncate/limit HERE to make each FIELD well-formed
  * by construction.
+ *
+ * 🔴 措辞收窄(2026-08-08 codex 复审命中):原文写「make the live request well-formed by construction」——
+ * 那是**过头的承诺**,本模块只管每个字段的**逐字段**帽,管不到整请求。server 那边 10 项 × 1MB 与
+ * 它自己 8MB 的 `MAX_BODY` 是两个互不知情的帽,所以极端技能集仍可能整请求 400/413。本层不加
+ * 「按剩余预算偷偷多截一点」的聚合补偿:那恰好把一个响亮的 400 换回一次静默截断(= 本次修掉的病)。
+ * 该治的是 server 两帽的一致性;此处只把承诺说准。
  */
 import type { SkillSpec } from '@sema-agent/sdk';
-/** Server caps for `TaskRequest.skills` (SDK types.ts:82 — violations are a 400). */
+/**
+ * Server caps for `TaskRequest.skills` — violations are a 400 (server `validateUserSkills`).
+ *
+ * 🔴 对照坐标(2026-08-08 修正,#3004 跟修批;取证方式 = 直读 shipped 产物,不信任何注释):
+ *   · `items` / `name` / `description` —— server `dist/http/server.js` `validateUserSkills`:
+ *     `MAX_USER_SKILLS = 10`、name 上限字面量 `64`、description 上限字面量 `1024`(7.5.0 实测)。
+ *   · `content` —— server `MAX_SKILL_CONTENT_CHARS = 1_048_576`(`dist/http/server.js`),它自己的
+ *     头注点名这是 core `SKILL_CONTENT_MAX_CHARS` 的同值孪生(core `dist/core/runner/synthetic-tools.js`
+ *     的 `SKILL_CONTENT_MAX_CHARS = 1024 * 1024`);core 1.293 起技能正文**零截断、超 1MB 整拒**。
+ *
+ * 🔴 此前这一键钉 `32768` —— 那不是「上游改小了」,而是**一开始就抄错**:32768 是 server 的
+ * `MAX_OUTPUT_SCHEMA_CHARS`(另一个量)。错值的后果不是 400、是**静默截到 1/32**:`toCappedSpec`
+ * 在发请求前就把技能正文切掉,模型看见的 SKILL.md 少一大截,而链上任何一层都不会响一声。
+ *
+ * 反漂移腿:`scripts/run-engine-vocab-floor-test.mjs` 的 G2-a 段拿本键对**实装 @sema-agent/core**
+ * 的 `SKILL_CONTENT_MAX_CHARS` 逐值对账(devDep 钉在本仓,不靠兄弟树物料)——上游改门,那边先红。
+ *
+ * ⚠️ 留给上游的一处**上游内部张力**(如实记录,本层不代偿):server 允许 10 条 × 1MB = 10MB 技能,
+ * 而它自己的整体 body 帽是 8MB(`MAX_BODY`)—— 极端组合会整请求 400/413。这是 server 两个帽之间的
+ * 事,壳侧不做「按剩余预算偷偷多截一点」的补偿:那正好会把一个**响亮的 400** 换回一次**静默截断**,
+ * 即本次修的这个病。真要治,治在 server 的两帽一致性上。
+ */
 export declare const SKILL_CAPS: {
     readonly items: 10;
     readonly name: 64;
     readonly description: 1024;
-    readonly content: 32768;
+    readonly content: 1048576;
 };
 /** The minimal shape of a loaded skill `Command` this projection reads (a structural subset of CC's Command,
  *  cast at the call site so we stay decoupled from the wide Command union). */

package/dist/skillsWireCaps.js

@@ -1,5 +1,26 @@
-/** Server caps for `TaskRequest.skills` (SDK types.ts:82 — violations are a 400). */
-export const SKILL_CAPS = { items: 10, name: 64, description: 1024, content: 32768 };
+/**
+ * Server caps for `TaskRequest.skills` — violations are a 400 (server `validateUserSkills`).
+ *
+ * 🔴 对照坐标(2026-08-08 修正,#3004 跟修批;取证方式 = 直读 shipped 产物,不信任何注释):
+ *   · `items` / `name` / `description` —— server `dist/http/server.js` `validateUserSkills`:
+ *     `MAX_USER_SKILLS = 10`、name 上限字面量 `64`、description 上限字面量 `1024`(7.5.0 实测)。
+ *   · `content` —— server `MAX_SKILL_CONTENT_CHARS = 1_048_576`(`dist/http/server.js`),它自己的
+ *     头注点名这是 core `SKILL_CONTENT_MAX_CHARS` 的同值孪生(core `dist/core/runner/synthetic-tools.js`
+ *     的 `SKILL_CONTENT_MAX_CHARS = 1024 * 1024`);core 1.293 起技能正文**零截断、超 1MB 整拒**。
+ *
+ * 🔴 此前这一键钉 `32768` —— 那不是「上游改小了」,而是**一开始就抄错**:32768 是 server 的
+ * `MAX_OUTPUT_SCHEMA_CHARS`(另一个量)。错值的后果不是 400、是**静默截到 1/32**:`toCappedSpec`
+ * 在发请求前就把技能正文切掉,模型看见的 SKILL.md 少一大截,而链上任何一层都不会响一声。
+ *
+ * 反漂移腿:`scripts/run-engine-vocab-floor-test.mjs` 的 G2-a 段拿本键对**实装 @sema-agent/core**
+ * 的 `SKILL_CONTENT_MAX_CHARS` 逐值对账(devDep 钉在本仓,不靠兄弟树物料)——上游改门,那边先红。
+ *
+ * ⚠️ 留给上游的一处**上游内部张力**(如实记录,本层不代偿):server 允许 10 条 × 1MB = 10MB 技能,
+ * 而它自己的整体 body 帽是 8MB(`MAX_BODY`)—— 极端组合会整请求 400/413。这是 server 两个帽之间的
+ * 事,壳侧不做「按剩余预算偷偷多截一点」的补偿:那正好会把一个**响亮的 400** 换回一次**静默截断**,
+ * 即本次修的这个病。真要治,治在 server 的两帽一致性上。
+ */
+export const SKILL_CAPS = { items: 10, name: 64, description: 1024, content: 1_048_576 };
 /** Build one capped `SkillSpec`, or null when there is no usable name/body. description folds in `whenToUse`
  *  (CC's progressive-disclosure metadata is name+description+whenToUse) so the engine's Skill tool can select
  *  it. All three fields are truncated to the server caps. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",
@@ -28,12 +28,12 @@
   },
   "peerDependencies": {
     "@sema-agent/agent-types": ">=0.2.0",
-    "@sema-agent/sdk": ">=6.3.0"
+    "@sema-agent/sdk": ">=6.9.0"
   },
   "devDependencies": {
     "@sema-agent/agent-types": "^0.2.0",
     "@sema-agent/core": "^5.10.0",
-    "@sema-agent/sdk": "^6.3.0",
+    "@sema-agent/sdk": "^6.9.0",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"
   }