@sema-agent/client-core 0.41.0 → 0.43.0

package/dist/attachmentsWireCaps.d.ts

@@ -29,7 +29,7 @@
  *     false」—— 对这一族,发 `false` 是违约(核心根本没有「显式关」这个语义位),所以本模块对
  *     它们**永不产出 false**:OFF ⇒ 键不出现。
  *
- *  ② **explicit-false 族**(2 员:agentListing / skillsListing):
+ *  ② **explicit-false 族**(3 员:agentListing / skillsListing / **backgroundTasks**):
  *     它们在 core 里是 **DEFAULT-ON**,SDK 头注写死「`agentListing`/`skillsListing` 是 core
  *     DEFAULT-ON —— **explicit false 才关**(1.254 起 false 真透传;更老 server 静默丢)」。
  *     于是「删键」在这一族上的含义是**保持开着**,而不是关掉。旧的 `AttachmentsSpec` 把全部键
@@ -37,6 +37,29 @@
  *     路径可以关闭**(不是「难关」,是类型层封死)。本批把这两键的类型放宽成 `boolean` 并给出
  *     产出 `false` 的路径。
  *
+ * ══ 🔴 [4982] 候选①(P0-KPI,0.42.0)—— **第三员漏族:`backgroundTasks`** ════════════════════
+ *
+ * core **5.12.0 (BREAKING)** 把 `attachments.backgroundTasks` 与 `agentListing`/`skillsListing`
+ * **同批**翻成 DEFAULT-ON(core `types.d.ts` 逐字:「Post-compact background-task restatement —
+ * DEFAULT ON since 5.12.0 (**boolean, not `true`**: explicit `false` is the opt-out; **same contract
+ * as the listing family below**)」)。三兄弟同批翻转,本模块**跟修了后两个、漏了第一个** ——
+ * `backgroundTasks` 一直留在 ① 族(off = 删键,永不发 false)。
+ * 后果是这个旋钮上最坏的一种失效:`SEMA_ATTACHMENTS=off`(文件自称「真·全关」)对这一位与
+ * **什么都不配**逐字节同效(两条路都不发这个键 = 都是「开」),**且零报错** —— 用户以为关掉了,
+ * 附件照进上下文,没有任何一处会说出来。与 ② 族当初那个洞是同一个病形的第三例。
+ *
+ * ── 修法:把「能不能显式打开」与「能不能显式关掉」拆成**两条正交的轴** ────────────────────────
+ * `backgroundTasks` 同时住两族,这不是分类含糊,这**就是**它的契约:
+ *   · **轴 A(可显式开)** = `full` 会全开的那 7 员 —— `backgroundTasks` 在内,**membership 不动**;
+ *   · **轴 B(可显式关)** = core DEFAULT-ON 的 3 员 —— `backgroundTasks` 新入。
+ * 只把它整个搬进 ② 族(= 从轴 A 里删掉)是**错的修法**,两条理由都是硬的:
+ *   ① `full` / `default` / `+backgroundTasks` 三条既有路会当场少发一个 `backgroundTasks: true`
+ *      —— 对 core ≥5.12.0 行为等价(默认就是开),但对**更老引擎**那是真的从「开」变成「关」,
+ *      而本模块手里没有 server 版本这个量(见下面 §能力边界),没资格替用户做那个降级;
+ *   ② 空 env 的默认产出 `{backgroundTasks: true, toolsDelta: true}` 是 [487]② CC-parity 那一对的
+ *      字面承诺,删掉它就是把「默认逐字节不变」这条本模块的立身纪律自己破了。
+ * ⇒ 本批**只加一条出路**(`off` 与 `-backgroundTasks` 产出 `false`),其余取值逐字节不变。
+ *
  * ── env 面(`SEMA_ATTACHMENTS`)的取值语法,以及为什么选这一种 ────────────────────────────────
  * 目标是「**默认行为逐字节不变** + 有路可关 DEFAULT-ON 两键」,所以选了**在既有值上加逗号 token
  * 列表**,而不是新开一个 env:
@@ -45,8 +68,9 @@
  *   · 逗号 token 列表对**存量取值零影响**:`unset` / `full` / `all` / off 拼法四种老写法解析结果
  *     逐字节不变(FIX7 段 ⑤ 有正面钉),新语法只在用户真写了逗号 token 时才被触发。
  * 语法(逗号分隔,大小写不敏感,允许空白):
- *   · `off|0|false|no|none`(整值)     ⇒ **真·全关**:literal-true 族一个不发(那一族的 off 就是
- *                                        删键)+ DEFAULT-ON 两键发 `false`。
+ *   · `off|0|false|no|none`(整值)     ⇒ **真·全关**:只可显式开的那一族一个不发(它们的 off 就是
+ *                                        删键)+ DEFAULT-ON **三键**(agentListing / skillsListing /
+ *                                        backgroundTasks)发 `false`。
  *     🔴 对抗复审 [medium](2026-08-07)判的真病:这一支此前直接 `return undefined`(不发字段),
  *     而「不发字段」对 DEFAULT-ON 两键的含义**恰恰是保持开着** —— 一个叫 off 的总开关关不掉十件里
  *     的两件,且用户没有任何办法察觉。旧行为在 <1.254 的 server 上与新行为**逐字节等价**(那些
@@ -60,8 +84,9 @@
  *   · `full` / `all`                   ⇒ literal-true 族 7 员全开(**不含** DEFAULT-ON 两键 ——
  *                                        不发 = 保持 core 默认开,壳不替 core 做那个决定)
  *   · `default`                        ⇒ CC-parity 那一对(显式写出「默认」这个意思)
- *   · `<key>` / `+<key>`               ⇒ 单点打开一个 literal-true 族成员
- *   · `-agentListing` / `-skillsListing` ⇒ 产出 **`false`**(explicit-false 族唯一的关法)
+ *   · `<key>` / `+<key>`               ⇒ 单点打开一个「可显式开」族成员(轴 A 的 7 员)
+ *   · `-agentListing` / `-skillsListing` / `-backgroundTasks` ⇒ 产出 **`false`**(DEFAULT-ON 三键
+ *                                        唯一的关法;`-backgroundTasks` 是 [4982] 候选① 补的那条)
  *   · `todoReminderMode=baseline|off`  ⇒ 取值型键
  * 🔴 未登记 token / 对 literal-true 族用 `-` / todoReminderMode 取闭集外的值 ⇒ **fail-loud 抛错**。
  *    静默忽略是这条链上最坏的失效形:用户以为自己关掉了 agentListing,而请求照发、附件照进上下文,
@@ -88,7 +113,12 @@ export interface AttachmentsSpec {
     };
     planModeReminder?: true;
     budgetUsd?: true;
-    backgroundTasks?: true;
+    /**
+     * 🔴 **两族兼属**([4982] 候选①,0.42.0):它在轴 A(`full` 会开)也在轴 B(core ≥5.12.0
+     * DEFAULT-ON,`false` 才是关)。类型因此是 `boolean` 而不是 `true` —— 钉成 `true` 正是
+     * 「关不掉」那个洞的类型层根因。
+     */
+    backgroundTasks?: boolean;
     toolsDelta?: true;
     mcpInstructions?: true;
     agentListing?: boolean;
@@ -96,8 +126,13 @@ export interface AttachmentsSpec {
 }
 /** 键面台账(机读位):加键必须同批登记,否则下方 `Covers` 双向钉编译红。 */
 export declare const ATTACHMENTS_SPEC_KEYS: readonly ["todoReminder", "todoReminderMode", "changedFiles", "planModeReminder", "budgetUsd", "backgroundTasks", "toolsDelta", "mcpInstructions", "agentListing", "skillsListing"];
-/** ② 族(core DEFAULT-ON,explicit false 才关)。 */
-export declare const ATTACHMENTS_DEFAULT_ON_KEYS: readonly ["agentListing", "skillsListing"];
+/**
+ * **轴 B —— 可显式关**(core DEFAULT-ON,`false` 才是关;`-<key>` 与总开关 `off` 的作用面)。
+ * 🔴 [4982] 候选①(0.42.0):`backgroundTasks` 补入 —— core 5.12.0 与另两员**同批**翻 DEFAULT-ON,
+ *    本模块当时只跟修了两员。这张表**不是** ① 族的补集(`backgroundTasks` 两族兼属,见 AttachmentsSpec
+ *    上的键注与文件头注的「两条正交的轴」段)。
+ */
+export declare const ATTACHMENTS_DEFAULT_ON_KEYS: readonly ["agentListing", "skillsListing", "backgroundTasks"];
 /**
  * ENV source → the `TaskRequest.attachments` stamp.
  *

package/dist/attachmentsWireCaps.js

@@ -29,7 +29,7 @@
  *     false」—— 对这一族,发 `false` 是违约(核心根本没有「显式关」这个语义位),所以本模块对
  *     它们**永不产出 false**:OFF ⇒ 键不出现。
  *
- *  ② **explicit-false 族**(2 员:agentListing / skillsListing):
+ *  ② **explicit-false 族**(3 员:agentListing / skillsListing / **backgroundTasks**):
  *     它们在 core 里是 **DEFAULT-ON**,SDK 头注写死「`agentListing`/`skillsListing` 是 core
  *     DEFAULT-ON —— **explicit false 才关**(1.254 起 false 真透传;更老 server 静默丢)」。
  *     于是「删键」在这一族上的含义是**保持开着**,而不是关掉。旧的 `AttachmentsSpec` 把全部键
@@ -37,6 +37,29 @@
  *     路径可以关闭**(不是「难关」,是类型层封死)。本批把这两键的类型放宽成 `boolean` 并给出
  *     产出 `false` 的路径。
  *
+ * ══ 🔴 [4982] 候选①(P0-KPI,0.42.0)—— **第三员漏族:`backgroundTasks`** ════════════════════
+ *
+ * core **5.12.0 (BREAKING)** 把 `attachments.backgroundTasks` 与 `agentListing`/`skillsListing`
+ * **同批**翻成 DEFAULT-ON(core `types.d.ts` 逐字:「Post-compact background-task restatement —
+ * DEFAULT ON since 5.12.0 (**boolean, not `true`**: explicit `false` is the opt-out; **same contract
+ * as the listing family below**)」)。三兄弟同批翻转,本模块**跟修了后两个、漏了第一个** ——
+ * `backgroundTasks` 一直留在 ① 族(off = 删键,永不发 false)。
+ * 后果是这个旋钮上最坏的一种失效:`SEMA_ATTACHMENTS=off`(文件自称「真·全关」)对这一位与
+ * **什么都不配**逐字节同效(两条路都不发这个键 = 都是「开」),**且零报错** —— 用户以为关掉了,
+ * 附件照进上下文,没有任何一处会说出来。与 ② 族当初那个洞是同一个病形的第三例。
+ *
+ * ── 修法:把「能不能显式打开」与「能不能显式关掉」拆成**两条正交的轴** ────────────────────────
+ * `backgroundTasks` 同时住两族,这不是分类含糊,这**就是**它的契约:
+ *   · **轴 A(可显式开)** = `full` 会全开的那 7 员 —— `backgroundTasks` 在内,**membership 不动**;
+ *   · **轴 B(可显式关)** = core DEFAULT-ON 的 3 员 —— `backgroundTasks` 新入。
+ * 只把它整个搬进 ② 族(= 从轴 A 里删掉)是**错的修法**,两条理由都是硬的:
+ *   ① `full` / `default` / `+backgroundTasks` 三条既有路会当场少发一个 `backgroundTasks: true`
+ *      —— 对 core ≥5.12.0 行为等价(默认就是开),但对**更老引擎**那是真的从「开」变成「关」,
+ *      而本模块手里没有 server 版本这个量(见下面 §能力边界),没资格替用户做那个降级;
+ *   ② 空 env 的默认产出 `{backgroundTasks: true, toolsDelta: true}` 是 [487]② CC-parity 那一对的
+ *      字面承诺,删掉它就是把「默认逐字节不变」这条本模块的立身纪律自己破了。
+ * ⇒ 本批**只加一条出路**(`off` 与 `-backgroundTasks` 产出 `false`),其余取值逐字节不变。
+ *
  * ── env 面(`SEMA_ATTACHMENTS`)的取值语法,以及为什么选这一种 ────────────────────────────────
  * 目标是「**默认行为逐字节不变** + 有路可关 DEFAULT-ON 两键」,所以选了**在既有值上加逗号 token
  * 列表**,而不是新开一个 env:
@@ -45,8 +68,9 @@
  *   · 逗号 token 列表对**存量取值零影响**:`unset` / `full` / `all` / off 拼法四种老写法解析结果
  *     逐字节不变(FIX7 段 ⑤ 有正面钉),新语法只在用户真写了逗号 token 时才被触发。
  * 语法(逗号分隔,大小写不敏感,允许空白):
- *   · `off|0|false|no|none`(整值)     ⇒ **真·全关**:literal-true 族一个不发(那一族的 off 就是
- *                                        删键)+ DEFAULT-ON 两键发 `false`。
+ *   · `off|0|false|no|none`(整值)     ⇒ **真·全关**:只可显式开的那一族一个不发(它们的 off 就是
+ *                                        删键)+ DEFAULT-ON **三键**(agentListing / skillsListing /
+ *                                        backgroundTasks)发 `false`。
  *     🔴 对抗复审 [medium](2026-08-07)判的真病:这一支此前直接 `return undefined`(不发字段),
  *     而「不发字段」对 DEFAULT-ON 两键的含义**恰恰是保持开着** —— 一个叫 off 的总开关关不掉十件里
  *     的两件,且用户没有任何办法察觉。旧行为在 <1.254 的 server 上与新行为**逐字节等价**(那些
@@ -60,8 +84,9 @@
  *   · `full` / `all`                   ⇒ literal-true 族 7 员全开(**不含** DEFAULT-ON 两键 ——
  *                                        不发 = 保持 core 默认开,壳不替 core 做那个决定)
  *   · `default`                        ⇒ CC-parity 那一对(显式写出「默认」这个意思)
- *   · `<key>` / `+<key>`               ⇒ 单点打开一个 literal-true 族成员
- *   · `-agentListing` / `-skillsListing` ⇒ 产出 **`false`**(explicit-false 族唯一的关法)
+ *   · `<key>` / `+<key>`               ⇒ 单点打开一个「可显式开」族成员(轴 A 的 7 员)
+ *   · `-agentListing` / `-skillsListing` / `-backgroundTasks` ⇒ 产出 **`false`**(DEFAULT-ON 三键
+ *                                        唯一的关法;`-backgroundTasks` 是 [4982] 候选① 补的那条)
  *   · `todoReminderMode=baseline|off`  ⇒ 取值型键
  * 🔴 未登记 token / 对 literal-true 族用 `-` / todoReminderMode 取闭集外的值 ⇒ **fail-loud 抛错**。
  *    静默忽略是这条链上最坏的失效形:用户以为自己关掉了 agentListing,而请求照发、附件照进上下文,
@@ -88,10 +113,20 @@ export const ATTACHMENTS_SPEC_KEYS = [
     'agentListing',
     'skillsListing',
 ];
-/** ② 族(core DEFAULT-ON,explicit false 才关)。 */
-export const ATTACHMENTS_DEFAULT_ON_KEYS = ['agentListing', 'skillsListing'];
-/** ① 族里 `full` 会全开的那 7 员(`todoReminderMode` 是取值型,不搭 full 的车)。 */
-const LITERAL_TRUE_KEYS = [
+/**
+ * **轴 B —— 可显式关**(core DEFAULT-ON,`false` 才是关;`-<key>` 与总开关 `off` 的作用面)。
+ * 🔴 [4982] 候选①(0.42.0):`backgroundTasks` 补入 —— core 5.12.0 与另两员**同批**翻 DEFAULT-ON,
+ *    本模块当时只跟修了两员。这张表**不是** ① 族的补集(`backgroundTasks` 两族兼属,见 AttachmentsSpec
+ *    上的键注与文件头注的「两条正交的轴」段)。
+ */
+export const ATTACHMENTS_DEFAULT_ON_KEYS = ['agentListing', 'skillsListing', 'backgroundTasks'];
+/**
+ * **轴 A —— 可显式开**:`full` 会全开的那 7 员(`todoReminderMode` 是取值型,不搭 full 的车)。
+ * 🔴 `backgroundTasks` **留在本表**([4982] 候选① 的取舍,理由见文件头注):把它从这里删掉会让
+ *    `full`/`default`/`+backgroundTasks` 三条既有路少发一个 `true`,对 core <5.12.0 是真的从
+ *    「开」变成「关」,而本模块手里没有 server 版本这个量。
+ */
+const OPT_IN_KEYS = [
     'todoReminder',
     'changedFiles',
     'planModeReminder',
@@ -100,9 +135,15 @@ const LITERAL_TRUE_KEYS = [
     'toolsDelta',
     'mcpInstructions',
 ];
+/**
+ * **只可显式关、不可显式开**的那两员(轴 B ∖ 轴 A)。`+agentListing` 这类写法的 fail-loud 判据
+ * 锚在**本表**而不是整个轴 B —— 锚轴 B 会把 `+backgroundTasks` / `full` 一起误拒([4982] 候选①
+ * 修复批的判别力所在:两条轴各判各的,不许拿一条去代另一条)。
+ */
+const DEFAULT_ON_ONLY_KEYS = ['agentListing', 'skillsListing'];
 /** CC-parity 默认对(TOC live 路径,[487]②)。 */
 const DEFAULT_PAIR = ['backgroundTasks', 'toolsDelta'];
-const _attachmentsKeyPins = [true, true, true, true];
+const _attachmentsKeyPins = [true, true, true, true, true, true];
 void _attachmentsKeyPins;
 const TODO_REMINDER_MODES = ['baseline', 'off'];
 /** fail-loud 的统一措辞:说清**哪个 token 坏了**、以及合法形是什么(判词要指得出下一步)。 */
@@ -156,7 +197,7 @@ export function attachmentsForRequest(env = hostEnv()) {
             if (!isDefaultOnKey(key)) {
                 refuse(token, `"${key}" belongs to the literal-true family whose OFF is "delete the key", not "send false" ` +
                     '(core wire contract, board [479] ask-2) — simply do not turn it on. ' +
-                    'Only the core DEFAULT-ON keys (agentListing / skillsListing) accept an explicit false');
+                    `Only the core DEFAULT-ON keys (${ATTACHMENTS_DEFAULT_ON_KEYS.join(' / ')}) accept an explicit false`);
             }
             spec[key] = false;
             continue;
@@ -174,7 +215,10 @@ export function attachmentsForRequest(env = hostEnv()) {
         const key = canonicalKey(lhs.startsWith('+') ? lhs.slice(1) : lhs);
         if (key === undefined)
             refuse(token, 'unknown attachments key');
-        if (isDefaultOnKey(key)) {
+        // 🔴 判据锚 `DEFAULT_ON_ONLY_KEYS`(轴 B ∖ 轴 A),**不是**整个轴 B:0.42.0 起
+        //    `backgroundTasks` 两族兼属,拿轴 B 判会把 `+backgroundTasks` 一起误拒(而它在
+        //    `full` 里本来就开得出来,拒它等于同一件事有两个答案)。
+        if (isDefaultOnOnlyKey(key)) {
             refuse(token, `"${key}" is core DEFAULT-ON — turning it "on" is a no-op that would send a redundant true; ` +
                 `use "-${key}" to turn it OFF`);
         }
@@ -184,7 +228,8 @@ export function attachmentsForRequest(env = hostEnv()) {
     }
     return spec;
 }
-/** 总开关 off 的产出:literal-true 族一个不发(删键即关)+ DEFAULT-ON 两键显式 `false`。 */
+/** 总开关 off 的产出:只可显式开的那族一个不发(删键即关)+ DEFAULT-ON **三键**显式 `false`
+ *  ([4982] 候选①:`backgroundTasks` 从 0.42.0 起真的在这条路上被关掉)。 */
 function allDefaultOnOff() {
     const out = {};
     for (const k of ATTACHMENTS_DEFAULT_ON_KEYS)
@@ -193,7 +238,7 @@ function allDefaultOnOff() {
 }
 function allLiteralTrue() {
     const out = {};
-    for (const k of LITERAL_TRUE_KEYS)
+    for (const k of OPT_IN_KEYS)
         out[k] = true;
     return out;
 }
@@ -206,9 +251,14 @@ function splitAssign(token) {
 function canonicalKey(lower) {
     return ATTACHMENTS_SPEC_KEYS.find(k => k.toLowerCase() === lower);
 }
+/** 轴 B:可显式关(`-<key>` 的合法作用面)。 */
 function isDefaultOnKey(k) {
     return ATTACHMENTS_DEFAULT_ON_KEYS.includes(k);
 }
+/** 轴 B ∖ 轴 A:只可关不可开(`+<key>` 的 fail-loud 作用面)。 */
+function isDefaultOnOnlyKey(k) {
+    return DEFAULT_ON_ONLY_KEYS.includes(k);
+}
 /** 单 token 形的历史回落判据(见 `attachmentsForRequest` 里那段注释)。 */
 function isKnownToken(token) {
     if (token === 'full' || token === 'all' || token === 'default')

package/dist/hitl/askGateWire.d.ts

@@ -52,8 +52,10 @@
  *      从 `GET /v1/approvals` 拿 pending 行(input=questions + boundCallId/boundInputHash 绑定)、
  *      合成 QuestionFrame 借既有 AskUserQuestion overlay(planReviewWire 同款 local-responder 姿势,
  *      CC 原生对话框,零新 UI)、等用户作答。
- *   3. 决断走 T23 HitlBridge(答案 ride `ApprovalDecision.answer`,D-1 绑定 verbatim 回显;拒答=
- *      cancel-by-deny,contract/04 §2.4)。decide 是 SYNC 驱动的:引擎跑到下一个 park 或终态才返
+ *   3. 决断走 T23 HitlBridge(答案 ride `ApprovalDecision.answer`,D-1 绑定 verbatim 回显;拒答 =
+ *      一次 **TOOL 级 deny** 应答,把这只 ask 结算掉 —— server `ASSISTANT-WIRE-CONTRACT.md` §4a。
+ *      🔴 **0.42.0 撤稿**:原文写的是「拒答=cancel-by-deny,contract/04 §2.4」;§4a 逐字反对把
+ *      deny 读成 run kill,逐条撤稿见 `hitlBridge.decideTool` 头注)。decide 是 SYNC 驱动的:引擎跑到下一个 park 或终态才返
  *      (实测 4-5s+),返回体 `{status}` 即下一状态。
  *   4. 续流:attach `GET /v1/runs/:taskId/events`(durable leg;实证 durable log 从 park 点才开始,
  *      无挂起前重放)。重放的 tool_start/tool_end 按 toolCallId 去重;被 gate 的 call 在重放里带来
@@ -71,6 +73,7 @@
 import type { AgentEvent } from '@sema-agent/sdk';
 import { type AskGateWireDeps } from './frameRouter.js';
 export { HITL_REJECT_MESSAGE, ENGINE_ABORT_TOOL_RESULT } from './frameRouter.js';
+export { HITL_INTERRUPT_MESSAGE_FOR_TOOL_USE } from './frameRouter.js';
 export type { AskGateWireDeps } from './frameRouter.js';
 export type { AskAnsweredOutput } from './gateLedger.js';
 export { SEMA_COLLATERAL_ABORT_KEY } from './gateLedger.js';

package/dist/hitl/askGateWire.js

@@ -1,5 +1,5 @@
 import { createGateLedger } from './gateLedger.js';
-import { isHostProgressFrame, routeFrame, } from './frameRouter.js';
+import { flushHeldWithInterruptRewrite, isHostProgressFrame, routeFrame, } from './frameRouter.js';
 import { resolvePark } from './parkResolver.js';
 // ── 宿主面口(搬迁差分 3)────────────────────────────────────────────────────────────────────
 //
@@ -19,6 +19,9 @@ import { resolvePark } from './parkResolver.js';
 //    `toAnsweredOutput` / 下方 `bridgeAskUserQuestionGates`)、类型四个。定义搬去了实现所在的
 //    那一刀,本文件是它们对外的**唯一门牌**——下游 import 路径不变,public-export 基线不变。
 export { HITL_REJECT_MESSAGE, ENGINE_ABORT_TOOL_RESULT } from './frameRouter.js';
+// 件 B(#323 症状②,2026-08-25):CC 中断形的**单一真源**导出(与 SEMA_COLLATERAL_ABORT_KEY 同款
+// 理由 —— 三端各自手抄同一句 CC 文案 = 漂移温床)。壳/web/desktop 认这个常量。
+export { HITL_INTERRUPT_MESSAGE_FOR_TOOL_USE } from './frameRouter.js';
 // #324 / [4907]:连坐 abort 机读位的**单一真源**导出([C93] `toolEndOutputText` 同款理由 ——
 // 三端各自手抄键名 = 漂移温床)。壳/web/desktop 认这个常量,不认文案。
 export { SEMA_COLLATERAL_ABORT_KEY } from './gateLedger.js';
@@ -58,8 +61,14 @@ export async function* bridgeAskUserQuestionGates(source, deps, opts) {
             led.noteSeq(ev);
             // HOLD 只护 park 窗口:host lane 的模型推进帧一到就放行扣留帧(触发集的来龙去脉见
             // `frameRouter.isHostProgressFrame` 上方长注)。
-            if (led.heldCount() > 0 && isHostProgressFrame(ev))
-                yield* led.flushHeld();
+            // 件 B(异源复审 finding 采纳):这个中途出口**也**要走中断感知的那一个。病形 = 用户按了
+            // Esc(signal 已 aborted)之后,源流里还有一条**已缓冲**的推进帧到达 ⇒ 扣留帧从这里放行,
+            // 绕开收口出口的改写 ⇒ 用户照旧看到红 `Error: Operation aborted`。
+            // 🔴 这里**没有终帧**可读,所以只有宿主腿(signal)能命中;引擎还在推进而 signal 没 abort 的
+            //    正常情形下,判据两腿全不命中 ⇒ 与本件之前逐字节相同。
+            if (led.heldCount() > 0 && isHostProgressFrame(ev)) {
+                yield* flushHeldWithInterruptRewrite(led, { signal: opts?.signal });
+            }
             const action = await routeFrame(ev, ctx);
             if (action.kind === 'skip')
                 continue;
@@ -83,7 +92,9 @@ export async function* bridgeAskUserQuestionGates(source, deps, opts) {
         }
         if (!park) {
             // 源流走完没终帧(disconnect/abort)——flush 后结束,与现状一致。
-            yield* led.flushHeld();
+            // 件 B(#323 症状②):没有终帧 ⇒ 出口证据只剩宿主腿(`signal.aborted` = 用户按了 Esc);
+            // 缺席时包装恒走原路,与本行修前逐字节相同。
+            yield* flushHeldWithInterruptRewrite(led, { signal: opts?.signal });
             return;
         }
         hops++;

package/dist/hitl/editedRuleTextPrecheck.d.ts

@@ -0,0 +1,102 @@
+/**
+ * editedRuleTextPrecheck.ts — 编辑臂的「边打字边校验」判官**转出口**(#225 / [5076] 自领件,0.42.0)。
+ *
+ * ## 这一格要解决的问题
+ * 卡上的规则编辑框想在人还在打字的时候就说「这条能不能提交」。唯一合法的判官是引擎自己那只 ——
+ * core 5.57.0 导出的纯函数 `precheckEditedRuleText(text, command)`,它与 `confirmRuleApproval` 的
+ * fresh-edit 臂**跑同一个函数体**(`checkEditedRuleText`),所以预检面与真裁判**结构性不可分歧**。
+ * 在边界上复读一遍 `parseAllowRuleText` 是**装第二个更严的判官**:`Bash(adb *)` 这类肌肉记忆形
+ * 会被它当场误杀,而编辑面本来先跑拼写归一(`normalizeEditedSpelling`)再接受
+ * ——[5071] 定界②的原话,core [5075] 复核确认。
+ *
+ * ## 🔴 为什么是**端口注入**而不是 `export { precheckEditedRuleText } from '@sema-agent/core'`
+ * [5076] 的自领件原话是「re-export + 类型面」。**逐字照做在本包里是不可能的**,而且不是口味问题,
+ * 是本仓门族的硬约束(0.42.0 施工时实测,证据两条):
+ *   · `scripts/run-client-core-portability-test.mjs` 的 `EXPECTED_PACKAGES_INDEX` 是**等值门**
+ *     ——包总入口闭包的外部包集合恒等于 `{diff, @sema-agent/sdk}`,多一个当场红;
+ *   · 同门 ③ 段拿 esbuild `--platform=browser` **真打一次包**。`@sema-agent/core` 的 barrel 值级
+ *     拉进 `node:crypto`(`engine/session/log-digest.js`)、`node:fs`/`node:path`
+ *     (`core/skills-directory.js`)…… 浏览器腿当场打不成。
+ * ⇒ 一个 value 级 re-export 会把**整台引擎**焊进每一个装 client-core 的端(web/desktop 首当其冲),
+ *   换来一只纯函数。本包的存在理由正是「三端共用的**客户端**运行时」,这条边不能连。
+ *
+ * 于是转出口取**同等效力的第二形**:
+ *   ① **类型面**逐形转出({@link EditedRuleTextPrecheck} / {@link EditedRuleTextPrechecker}),
+ *      三端从此对着同一份形写代码,谁都不用自己抄一份返回型;
+ *   ② **注入口**({@link installEditedRuleTextPrechecker}):Node 宿主(TUI / desktop 主进程 /
+ *      server 侧渲染)在启动时把 core 那只函数原样装进来 —— **原样装,不许包一层判断**;
+ *   ③ **读口**({@link precheckEditedRuleText}):没装 ⇒ 返 `undefined`(**诚实缺席**),
+ *      绝不返一个编出来的 `{ok:true}`。缺席时呈现面的正解是退「提交后才知道」的往返形
+ *      ——[5076] 施工要点③ 已经把这两段写成互不阻塞的两腿。
+ * 🔴 浏览器 lane(web)结构上装不了这只函数(引擎不在那一侧),它**本就该**留缺席走往返形;
+ *   本口的缺席语义因此不是「宿主忘了装」的同义词,别拿它去判部署形态。
+ *
+ * ## 🔴 两点语义预披露(core [5075],消费侧写文案前必读;[5076] 已落账为 #225 施工要点)
+ *   · `ok` = **可提交**,不是「confirm 必成」。记录级闸(binding 回声 / 记录 owner 与 state /
+ *     scope 继承 / 部署开关)**不在**预检覆盖面,由 `confirmRuleApproval` 对着记录重判。
+ *     ⇒ UI 文案只许写「可提交」,**绝不**写「将被批准」。
+ *   · `canonicalRule` 可能与输入**字节不同**(拼写归一)。它是真正会落库的那一形,所以内联反馈
+ *     应当显示 **canonical 形**,而不是把人的输入原样回显。
+ *
+ * ## 调用面契约(core 逐字,注入口不许替它软化)
+ *   · `text` 是**人**的输入 ⇒ 任何畸形拼写都是一个**答案**(refusal),永不抛;
+ *   · `command` 是**调用方**的上下文(卡所依据的被裁决命令)⇒ 缺席/非串是**调用方 bug**,
+ *     core 响亮抛(`config.invalid_argument`)。本包的读口**不吞这个抛**(见 {@link precheckEditedRuleText}
+ *     的 `@throws`):把它折成一个 refusal 会让人读到「你的规则不接受空命令」——把调用方的错
+ *     误归到人头上,正是 core 那段头注点名要避免的事。
+ *   · 卡上**压根没有被裁决命令**(老记录 / 店丢了这一列)⇒ 那是**记录级**拒绝,不该问本函数;
+ *     宿主此时的正解是**根本不给编辑框**。
+ */
+/**
+ * `text × command` 三步门(拼写归一 → 语法门 → coverage 闸)的判决 —— core 5.57.0
+ * `EditedRuleTextPrecheck` 的**逐形镜像**(结构等价,故 core 那只函数可直接装进
+ * {@link EditedRuleTextPrechecker} 而无需任何适配)。
+ *
+ * 🔴 `code` 的**在场规则**与提交面的 `edit_rejected.detail` 同源:验证器自己拒时**在场**,
+ *    coverage 闸拒时**缺席** —— 同一具函数体出来的同一批值。缺席不许被读成「没有理由」。
+ * 🔴 `code` 是**开集串**:core 的 `RuleRejectCode` 词表属主是引擎,本包**刻意不镜像那张枚举**
+ *    (镜像 = 引擎加员当天把一个合法值判没,#157 词表纪律的反面)。要分支就按串比,未知值原样呈现。
+ */
+export type EditedRuleTextPrecheck = {
+    ok: true;
+    /** 真正会落库的那一形(可能与输入字节不同 —— 拼写归一)。内联反馈显示**这一形**。 */
+    canonicalRule: string;
+} | {
+    ok: false;
+    /** 验证器自己拒时在场;coverage 闸拒时缺席(开集串,见类型注)。 */
+    code?: string;
+    /** 拒绝措辞(与 `edit_rejected.detail` 同词汇)。原样呈现,包边界零加工。 */
+    message: string;
+};
+/**
+ * 判官的形:`(text, command) => 判决`。**唯一合法的实参** = core 5.57.0 导出的
+ * `precheckEditedRuleText`,原样装,不许在外面包一层自己的判断
+ * ——包一层就是把「同一函数体」这条唯一的抗漂移保证亲手拆掉。
+ */
+export type EditedRuleTextPrechecker = (text: string, command: string) => EditedRuleTextPrecheck;
+/**
+ * 装/卸判官。返回**还原函数**(装口族统一姿势:还原到装之前那一只,不是无脑清空 —— 嵌套装载
+ * 时无脑清空会把外层那只一起抹掉)。
+ *
+ * Node 宿主的装法(**逐字**,别加工):
+ * ```ts
+ * import { precheckEditedRuleText } from '@sema-agent/core'
+ * installEditedRuleTextPrechecker(precheckEditedRuleText)
+ * ```
+ */
+export declare function installEditedRuleTextPrechecker(fn: EditedRuleTextPrechecker | null): () => void;
+/**
+ * 装没装(存在性读口哨兵:`boolean` 形 —— 见 `docs/INTEGRATION-CLIENTS.md` §5a 的三形分野)。
+ * 呈现面据它决定**给不给编辑框的内联反馈**;`false` 时编辑框本身仍然可用(走往返形)。
+ */
+export declare function hasEditedRuleTextPrechecker(): boolean;
+/**
+ * 预检一段编辑过的规则文本。**没装判官 ⇒ 返 `undefined`**(诚实缺席,不是 `{ok:true}`
+ * 也不是 `{ok:false}` —— 两者都是在替一只不在场的判官发言)。
+ *
+ * @throws core 判官对**调用方 bug**(`command` 缺席/非串/不可渲染)的响亮拒**原样上抛**
+ *         ——本包不吞它:吞掉会让一个调用方错误变成一句对人的判决(见模块头注「调用面契约」)。
+ */
+export declare function precheckEditedRuleText(text: string, command: string): EditedRuleTextPrecheck | undefined;
+/** 测试钩:卸口。 */
+export declare function _resetEditedRuleTextPrecheckerForTest(): void;

package/dist/hitl/editedRuleTextPrecheck.js

@@ -0,0 +1,91 @@
+/**
+ * editedRuleTextPrecheck.ts — 编辑臂的「边打字边校验」判官**转出口**(#225 / [5076] 自领件,0.42.0)。
+ *
+ * ## 这一格要解决的问题
+ * 卡上的规则编辑框想在人还在打字的时候就说「这条能不能提交」。唯一合法的判官是引擎自己那只 ——
+ * core 5.57.0 导出的纯函数 `precheckEditedRuleText(text, command)`,它与 `confirmRuleApproval` 的
+ * fresh-edit 臂**跑同一个函数体**(`checkEditedRuleText`),所以预检面与真裁判**结构性不可分歧**。
+ * 在边界上复读一遍 `parseAllowRuleText` 是**装第二个更严的判官**:`Bash(adb *)` 这类肌肉记忆形
+ * 会被它当场误杀,而编辑面本来先跑拼写归一(`normalizeEditedSpelling`)再接受
+ * ——[5071] 定界②的原话,core [5075] 复核确认。
+ *
+ * ## 🔴 为什么是**端口注入**而不是 `export { precheckEditedRuleText } from '@sema-agent/core'`
+ * [5076] 的自领件原话是「re-export + 类型面」。**逐字照做在本包里是不可能的**,而且不是口味问题,
+ * 是本仓门族的硬约束(0.42.0 施工时实测,证据两条):
+ *   · `scripts/run-client-core-portability-test.mjs` 的 `EXPECTED_PACKAGES_INDEX` 是**等值门**
+ *     ——包总入口闭包的外部包集合恒等于 `{diff, @sema-agent/sdk}`,多一个当场红;
+ *   · 同门 ③ 段拿 esbuild `--platform=browser` **真打一次包**。`@sema-agent/core` 的 barrel 值级
+ *     拉进 `node:crypto`(`engine/session/log-digest.js`)、`node:fs`/`node:path`
+ *     (`core/skills-directory.js`)…… 浏览器腿当场打不成。
+ * ⇒ 一个 value 级 re-export 会把**整台引擎**焊进每一个装 client-core 的端(web/desktop 首当其冲),
+ *   换来一只纯函数。本包的存在理由正是「三端共用的**客户端**运行时」,这条边不能连。
+ *
+ * 于是转出口取**同等效力的第二形**:
+ *   ① **类型面**逐形转出({@link EditedRuleTextPrecheck} / {@link EditedRuleTextPrechecker}),
+ *      三端从此对着同一份形写代码,谁都不用自己抄一份返回型;
+ *   ② **注入口**({@link installEditedRuleTextPrechecker}):Node 宿主(TUI / desktop 主进程 /
+ *      server 侧渲染)在启动时把 core 那只函数原样装进来 —— **原样装,不许包一层判断**;
+ *   ③ **读口**({@link precheckEditedRuleText}):没装 ⇒ 返 `undefined`(**诚实缺席**),
+ *      绝不返一个编出来的 `{ok:true}`。缺席时呈现面的正解是退「提交后才知道」的往返形
+ *      ——[5076] 施工要点③ 已经把这两段写成互不阻塞的两腿。
+ * 🔴 浏览器 lane(web)结构上装不了这只函数(引擎不在那一侧),它**本就该**留缺席走往返形;
+ *   本口的缺席语义因此不是「宿主忘了装」的同义词,别拿它去判部署形态。
+ *
+ * ## 🔴 两点语义预披露(core [5075],消费侧写文案前必读;[5076] 已落账为 #225 施工要点)
+ *   · `ok` = **可提交**,不是「confirm 必成」。记录级闸(binding 回声 / 记录 owner 与 state /
+ *     scope 继承 / 部署开关)**不在**预检覆盖面,由 `confirmRuleApproval` 对着记录重判。
+ *     ⇒ UI 文案只许写「可提交」,**绝不**写「将被批准」。
+ *   · `canonicalRule` 可能与输入**字节不同**(拼写归一)。它是真正会落库的那一形,所以内联反馈
+ *     应当显示 **canonical 形**,而不是把人的输入原样回显。
+ *
+ * ## 调用面契约(core 逐字,注入口不许替它软化)
+ *   · `text` 是**人**的输入 ⇒ 任何畸形拼写都是一个**答案**(refusal),永不抛;
+ *   · `command` 是**调用方**的上下文(卡所依据的被裁决命令)⇒ 缺席/非串是**调用方 bug**,
+ *     core 响亮抛(`config.invalid_argument`)。本包的读口**不吞这个抛**(见 {@link precheckEditedRuleText}
+ *     的 `@throws`):把它折成一个 refusal 会让人读到「你的规则不接受空命令」——把调用方的错
+ *     误归到人头上,正是 core 那段头注点名要避免的事。
+ *   · 卡上**压根没有被裁决命令**(老记录 / 店丢了这一列)⇒ 那是**记录级**拒绝,不该问本函数;
+ *     宿主此时的正解是**根本不给编辑框**。
+ */
+let installed = null;
+/**
+ * 装/卸判官。返回**还原函数**(装口族统一姿势:还原到装之前那一只,不是无脑清空 —— 嵌套装载
+ * 时无脑清空会把外层那只一起抹掉)。
+ *
+ * Node 宿主的装法(**逐字**,别加工):
+ * ```ts
+ * import { precheckEditedRuleText } from '@sema-agent/core'
+ * installEditedRuleTextPrechecker(precheckEditedRuleText)
+ * ```
+ */
+export function installEditedRuleTextPrechecker(fn) {
+    const prev = installed;
+    installed = fn;
+    return () => {
+        installed = prev;
+    };
+}
+/**
+ * 装没装(存在性读口哨兵:`boolean` 形 —— 见 `docs/INTEGRATION-CLIENTS.md` §5a 的三形分野)。
+ * 呈现面据它决定**给不给编辑框的内联反馈**;`false` 时编辑框本身仍然可用(走往返形)。
+ */
+export function hasEditedRuleTextPrechecker() {
+    return installed !== null;
+}
+/**
+ * 预检一段编辑过的规则文本。**没装判官 ⇒ 返 `undefined`**(诚实缺席,不是 `{ok:true}`
+ * 也不是 `{ok:false}` —— 两者都是在替一只不在场的判官发言)。
+ *
+ * @throws core 判官对**调用方 bug**(`command` 缺席/非串/不可渲染)的响亮拒**原样上抛**
+ *         ——本包不吞它:吞掉会让一个调用方错误变成一句对人的判决(见模块头注「调用面契约」)。
+ */
+export function precheckEditedRuleText(text, command) {
+    const fn = installed;
+    if (fn === null)
+        return undefined;
+    return fn(text, command);
+}
+/** 测试钩:卸口。 */
+export function _resetEditedRuleTextPrecheckerForTest() {
+    installed = null;
+}

package/dist/hitl/frameRouter.d.ts

@@ -24,6 +24,20 @@ import type { GateLedger } from './gateLedger.js';
  * 🔴 pure 门 B7 段:包内冻结字面量(无条件)+ 壳树全树扫描「每一处声明都逐字节相同」(壳树缺席=跳过)。
  */
 export declare const HITL_REJECT_MESSAGE = "The user doesn't want to proceed with this tool use. The tool use was rejected (eg. if it was a file edit, the new_string was NOT written to the file). STOP what you are doing and wait for the user to tell you how to proceed.";
+/**
+ * CC `utils/messages.ts` 的 `INTERRUPT_MESSAGE_FOR_TOOL_USE` **逐字**(件 B,#323 症状②,2026-08-25)。
+ *
+ * 🔴 CC 语料直证的两条事实(壳侧勘察,cli `src/utils/messages.ts:216-217` 逐字节同):
+ *   ① `"Operation aborted"` 在 CC 只在 transport 层 throw,**从不上屏** —— 它是我们这条引擎链
+ *      特有的产物,渲成红 `Error: Operation aborted` 是 CC 里根本不存在的形;
+ *   ② CC 的**唯一**中断呈现形就是本串:壳的 `UserToolErrorMessage` 对
+ *      `content.includes(INTERRUPT_MESSAGE_FOR_TOOL_USE)` 渲 dim `Interrupted`(CC 2.1.223 逐字判据)。
+ * ⇒ 用户中断批的 tool_result 文案在**呈现向**归一到本串,三端就天然拿到 CC 的 Interrupted 形,
+ *   不必各自再抄一份「Operation aborted 也算中断」的手工判据(那正是漂移温床)。
+ * 🔴 **呈现向,不是模型面**:本包这条链是转录/渲染链;喂回模型的那一份由引擎自己的 wire 承载,
+ *   这里一个字节都不碰它。
+ */
+export declare const HITL_INTERRUPT_MESSAGE_FOR_TOOL_USE = "[Request interrupted by user for tool use]";
 /**
  * core 对**被 gate park 的那个 call**(gate 主角)铸的 tool_end 载体(逐字;desktop session-host
  * 真引擎实测同款)。HOLD 谓词锚它做**精确等值** —— 普通工具错的输出是各自的错误文案,永不进 HOLD。
@@ -60,7 +74,14 @@ export interface AskGateWireDeps {
     respondToolApproval?: RespondToolApprovalFn;
     /** #229 respond-note 供给链(0.29.0 发包扫描门修,2026-08-12):帧腿车道参数(能力位读数),
      *  宿主从自己的 caps 缓存供给。缺席 = note 门 fail-closed 到「不发」侧(决断照常,现状字节
-     *  不变)—— 此前包内唯一生产调用点(routeFrame 的 tool_approval 臂)无此位,note 恒不发。 */
+     *  不变)—— 此前包内唯一生产调用点(routeFrame 的 tool_approval 臂)无此位,note 恒不发。
+     *  ⚠️ **本位早已不只管 note**(0.43.0 订正,异源对抗复审五轮 [medium]:上句的「note 门」措辞
+     *  是 0.29.0 的历史射程,再留着会让宿主以为不接这个字段只损失一条备注)。`ToolApprovalFrameLaneOpts`
+     *  今天携带**四位**,缺席各有各的后果:`approvalDecisionNoteCapable`(备注不发)·
+     *  `respondFreeFormRulesCapable`(**编辑臂**整条不发)· `respondBatchRuleOffersCapable`
+     *  (**批臂**整条不发)· `windowIsCurrent`(窗三键不过境 ⇒ 卡上无倒计时)。后两位缺席时,人在卡上
+     *  按下的「不再询问」会被整条丢弃(决断照送 + 一条 `surfaceRuleArmNotSent` 通知)—— 逐位语义见
+     *  各自的 JSDoc 与 `docs/INTEGRATION-CLIENTS.md` §5b。 */
     approvalLane?: ToolApprovalFrameLaneOpts;
 }
 /** 两族 gate:AskUserQuestion 走问答 overlay(原路);其余(fs 写三件 / Bash / 一等
@@ -113,6 +134,43 @@ export interface FrameRouterCtx {
 export declare function isAskTool(toolName: string | undefined): boolean;
 /** 这一帧是不是「host lane 的模型推进」= 扣留帧的放行信号。 */
 export declare function isHostProgressFrame(ev: AgentEvent): boolean;
+/** {@link flushHeldWithInterruptRewrite} 的出口证据(三腿,全是结构事实;缺席即不改写)。 */
+export interface HeldFlushInterruptEvidence {
+    /** 本出口手上的终帧(有就读它的 cancel 码);中途出口/无终帧路径传 `undefined`。 */
+    terminal?: AgentEvent | undefined;
+    /** 宿主的 turn 中断信号。 */
+    signal?: AbortSignal | undefined;
+    /**
+     * **这张 park 是被用户中断掉的**(`GateOutcome.kind === 'aborted'`)—— 唯一写者 =
+     * `parkResolver` 的 fail-soft 出口。该 outcome 在包内的语义就是逐字的「turn 被中断(Esc/Ctrl+C)」
+     * (见 `toolApprovalWire` 同臂:它顺带用一次 TOOL 级 deny `reason:'Interrupted by user'` 把
+     * 挂着的门结算掉),所以它是**关于这张 park 本身**的一手中断证据,不是推断。
+     */
+    gateAbortedByUser?: boolean | undefined;
+}
+/**
+ * `led.flushHeld()` 的**唯一**排水出口包装:用户中断批把毒化帧的 `output` 归一成 CC 的中断形
+ * ({@link HITL_INTERRUPT_MESSAGE_FOR_TOOL_USE}),其余一切原样。
+ *
+ * ── 判词(两模,别合并;方向一律 fail-safe:证据不足就走原路)──────────────────────────────
+ *  · **模 A —— 纯用户中断批**(证据 = cancel 终帧码 / 宿主 `signal.aborted`):要求 **本批零 park
+ *    登记**(`hasBatchPark() === false`),且帧上 `errorCode !== "gate.parked"`。两道门都是同一件事
+ *    的两个面 ——「这一批背后没有任何门」才谈得上纯中断;有门而我们只看见 abort 帧 = 判不出,不改。
+ *  · **模 B —— 门被用户中断**(证据 = {@link HeldFlushInterruptEvidence.gateAbortedByUser}):
+ *    park 在场是**前提**而不是障碍,所以模 A 的两道门在这一模下**都让位** —— 包括
+ *    `gate.parked` 那一票。理由:该码回答的是「这次调用为什么中止 =被门 park 了」,回答不了
+ *    「这一批为什么收场 = 用户按了 Esc」,两者正交;拿它做否决会把这一格里**最该显形的那张
+ *    主角卡**留成红 `Error: Operation aborted`(真机复现:审批卡挂着按 Esc,主角与连坐帧同文案)。
+ * 🔴 **gate deny 语义零变**:deny 走的是 `decided` 分支(→ 续流重放 → `denied-call`/`deny-stamp-next`
+ *    两臂 stamp CC REJECT 文案),那两臂排在 hold-poison **之前**、帧根本不进扣留表,本包装够不着。
+ *    fail-soft 的其余原因(no_pending / 传输失败 / hop 用尽)三腿全不命中 ⇒ 诚实红照旧。
+ *
+ * 🔴 **只改 `output` 一个键**:`isError` / `errorCode` / `toolCallId` / `toolName` / `settledBy` /
+ * `approver` / `resolution` / `structured` 以及 `flushHeld` 自己盖的
+ * `_sema_collateral_abort` 机读位全部原样过境(展开赋值只覆盖 `output`)—— 端侧的连坐折叠锚的是
+ * 机读位不是文案,所以折叠语义不受影响,只是被折那一行的正文换成了 CC 中断形。
+ */
+export declare function flushHeldWithInterruptRewrite(led: GateLedger, evidence: HeldFlushInterruptEvidence): Generator<AgentEvent>;
 /**
  * 一帧 → 一个处置。手柄的**先后**与原文逐条同序:tool_approval 帧 → tool_start → tool_end →
  * suspended → done → failed → 透传。