@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/subagent/engineTaskHandleWire.d.ts

@@ -1,69 +1,39 @@
 export interface EngineTaskOutputResult {
-    /** 累积后的输出正文(游标两形兼容,见头注)。 */
     content: string;
-    /** wire output 投影原样的常用位(UI 一律以这些 flags 为准,别解析 content 猜状态)。 */
     status?: string;
     stoppedBy?: string;
     partialResult?: boolean;
 }
-/** 测试钩:清累积缓存。 */
 export declare function __resetTaskHandleWireForTests(): void;
-/**
- * 读一个引擎侧任务句柄的输出(新面 A)。null = 读不到(无 wire / caps 缺 / 无宿主 run / 404
- * 域外或已 reap / 网错)——调用方回落既有渲染(receipt/outputFile tail)。绝不 throw。
- */
 export declare function fetchEngineTaskOutput(handle: string, opts?: {
     signal?: AbortSignal;
 }): Promise<EngineTaskOutputResult | null>;
-/**
- * [1505] 契约标记判别(头注):spool 全量 → 替换;cursor 增量 → append;无标记 → 保守
- * append-if-changed(与上次逐字节相同视为幂等重读,不重复)。空 content 不动累积。
- * 🔴 B6 提出成具名纯函数 —— 它是这条读面唯一会「把输出显示成两遍」的地方,值得被直接断言。
- * 🔴 REF-CC-域词表-06:标记判读本身**提单源**到 `toolResult.ts` 的 `spoolMarkerOf`(它与本文件
- * 曾经各写一份 `.includes()` 判读,同一个协议标记有两处互不知情的判读点——现在两处判读结果
- * 对同一输入恒一致,因为已经是同一个函数)。
- */
-/** 0.73.3(CC-60 A-D3):`cursorSemantics` 机读位(server ≥7.77.0 `taskOutput` 面):"cursor" = 读了就消费 ⇒ append;"full" = 全量重读安全 ⇒ 替换。
- *  **缺席 / 认不出 ⇒ 现行文案标记臂兜底**(老 server 不发这个键;sdk 头注逐字「别把缺席当 full」)。 */
-export declare function mergeTaskOutput(prev: string, fresh: string, cursorSemantics?: string): string;
-export type EngineTaskStopOutcome = 
-/** 200:停止动作完成(status = wire 终态照实;重复 stop 幂等)。 */
-{
+export interface TaskOutputMergeHint {
+    readonly type?: string;
+    readonly retrieval_status?: string;
+}
+export declare function mergeTaskOutput(prev: string, fresh: string, cursorSemantics?: string, output?: TaskOutputMergeHint | null): string;
+export type EngineTaskStopOutcome = {
     ok: true;
     status?: string;
     stoppedBy?: string;
-}
-/** 409 stop.not_landed:kill 没落地,进程可能还在跑——UI 绝不能渲染成「已停止」。 */
- | {
+} | {
     ok: false;
     reason: 'not_landed';
     detail?: string;
-}
-/** 409 stop.not_local(server 1.250+ durable 臂):任务在**别的实例**上还在跑,此处没有 kill
- *  被尝试——「别处在跑,此处停不了」,非失败重试件([1518]§一)。UI 同样不翻行。 */
- | {
+} | {
     ok: false;
     reason: 'not_local';
     detail?: string;
-}
-/** 409 stop.parked(server 1.263 parked 状态机):子代停在待审批检查点——不是在跑,也不该被
- *  stop 杀(人先 /decide);409 stop.park_resume_won:复活赛跑输给了别处的 resume。两者 UI
- *  都不翻行(fleet 行渲染词汇已由 coerceTaskStatus 映射 'awaiting approval')。 */
- | {
+} | {
     ok: false;
     reason: 'parked' | 'park_resume_won';
     detail?: string;
-}
-/** 409 stop.park_arbiter_unreachable(core 1.397 三分,G13 补齐的第五形):仲裁店不可达 ⇒
- *  **真相未知**(既不是「停了」也不是「没落地」)。UI 同样不翻行,但文案必须说「状态未知」——
- *  塌进 not_landed 就是把「不知道」渲染成一个具体的失败原因。 */
- | {
+} | {
     ok: false;
     reason: 'park_arbiter_unreachable';
     detail?: string;
-}
-/** 未知/未来 `stop.*` 码(开集 default)。不翻行;`detail` 带原文供诊断。 */
- | {
+} | {
     ok: false;
     reason: 'unknown_conflict';
     detail?: string;
@@ -72,31 +42,7 @@ export type EngineTaskStopOutcome =
     reason: 'unavailable' | 'error';
     detail?: string;
 };
-/**
- * 🔴 **G13 删债(先红后绿)**:taskStop 的 409 冲突分类 —— 手抄 code 判 → typed
- * `TaskStopConflictError`(SDK 把**任何** `stop.*` 前缀码映到该类,errors.js:277-278;
- * SDK 自己的注释还点名了壳的手抄位置 `engineTaskHandleWire.ts:186-197`)。
- *
- * 手抄版的实际缺陷(pure 门先红实证):SDK 明列**五**形,手抄只认前四形 ⇒ 第五形
- * `stop.park_arbiter_unreachable`(core 1.397 三分:仲裁店不可达 ⇒ **真相未知**)静默塌进
- * `not_landed`。
- * 🔴 后果方向先定正负号([anchor-on-the-deciding-quantity]):门控的量 = 「UI 翻不翻这一行」,
- *    五形与 default **全都是不翻** ⇒ 这不是安全缺陷,是**诚实缺陷** —— 把「真相未知」渲染成
- *    「kill 没落地」,用户与诊断双双被误导。所以修法是给第五形一个自己的名字,而不是调整门。
- *
- * 开集纪律:`switch` 留 `default`(未来新 `stop.*` 码落 `unknown_conflict`,照样不翻行、
- * 照样带原始 `code`),绝不塌进任何一个已知形 —— 塌进去就等于替 server 编了一个它没说的原因。
- */
 export declare function classifyTaskStopConflict(e: unknown): EngineTaskStopOutcome;
-/**
- * 🟢 B8 ALLOW 清单登记(REF-CC-域词表-05,属主=client-core 规范重构轮,到期复议=SDK typed 错误类
- * 覆盖全部 `stop.*` 码后或 2026-Q4 复审以先到者为准):兜底字面认码,前置合取 = typed
- * `TaskStopConflictError` 缺席时才落到这里(见 `stopEngineTask` 的 `if (e instanceof
- * TaskStopConflictError || status === 409)`)。同批同表的另两处:`detachWire.ts`
- * `DETACH_DURABLE_OFF_400_ANCHOR`(server 契约话)、`classifierVerdictWire.ts`
- * `CLASSIFIER_DENY_SIGNATURE`(core lockstep 机器签名)——三处互指,理由逐条写在各自站点。
- */
-/** 停一个引擎侧任务句柄(新面 B)。只有 ok:true(=HTTP 200)算停了。绝不 throw。 */
 export declare function stopEngineTask(handle: string, opts?: {
     signal?: AbortSignal;
 }): Promise<EngineTaskStopOutcome>;

package/dist/subagent/engineTaskHandleWire.js

@@ -1,42 +1,3 @@
-/**
- * ⇄ B6 批搬迁(2026-07-27,设计稿 §3 B6):cli `src/sema/engineTaskHandleWire.ts` 整搬。
- *
- * 🔴 搬迁差分:`wireConfig()` → `engineWireTarget()`;`getActiveEngineTaskId()` →
- *    `activeEngineRunId()`;`logForDebugging` → `hostLog`;`process.env.SEMA_DEBUG` 前置判
- *    → `engineWireDebugEnabled()`。
- *
- * ── 以下为原文件的领域说明(逐字保留)────────────────────────────────────────────────────────
- *
- * engineTaskHandleWire — CC TaskOutput/TaskStop 人侧对位的 wire 消费([1501] server 1.246.0 /
- * SDK 0.0.67 提货)。
- *
- * Wire(两面都是出生即强制带 `?session=`,与 subagentOutput 同姿势;非阻塞、副本本地):
- *   · 读:`GET  /v1/runs/:id/tasks/:handle/output?session=` → SDK `runs.taskOutput`
- *   · 停:`POST /v1/runs/:id/tasks/:handle/stop?session=`   → SDK `runs.taskStop`
- *   · :id = 宿主 run;:handle = canonical 句柄 ONLY(b… bash / m… monitor / a… agent)——
- *     不收名字、不收 legacy shellId,传了就是 404;workflow(w…/wa…)恒 404(journal 是那边的
- *     读面,永不打这里)。
- *   · 能力门 = capabilities.taskHandles(engineCapsCache 通用缓存,[1501] 明令:用能力位判断,
- *     别 trial-by-501/404)。老引擎(≤1.245)缺该键 → 两动词都回落 null/不可用,version-safe。
- *
- * 读面游标语义([1501]§一 + [1505] must-fix 修正,UI 必须按此做):是否「读即消费」取决于句柄
- * 形态——spooled 腿全量可重读、GET 幂等;cursor-only 腿每次 GET 只出新字节、读走就没了。
- * 两形判别用 **wire 契约自带标记**(server [1505] 钉版承诺稳定,变更走 CHANGELOG+协作板;core
- * CC-verbatim 固定形):content 含 `--- stdout (full, re-readable) ---` = spool 全量形 → 整体
- * 替换;含 `--- new stdout ---` = cursor 增量形 → append。初版的「前缀延展」启发式被 [1505]
- * 否决——spool content 首行 `status: <displayStatus>` 在任务完成时刻从 running 翻 exited,
- * 前缀检测恰在最常见时刻失败 → 全量被 append = 输出重复。无标记(极端/未知形)按保守形
- * append-if-changed 处理;空 content 不动累积。绝不假设重拉能拿到同样字节。
- *
- * ⚠️ cursor-only 腿双消费者 caveat([1505]):同一 b* 句柄若同时被模型侧 TaskOutput 工具读,
- * 两个消费者互抢增量(工具读走的字节本读面拿不到,反之亦然),端侧累积在该形下不保证完整;
- * spool 腿(server 正常接线下的常态)无此问题。UI 在 cursor 形下不承诺完整性。
- *
- * 停面语义([1501]§二):**只有 200 算停了**;409 `stop.not_landed` = kill 没落地、进程可能
- * 还在跑(UI 绝不能渲染成「已停止」);终态句柄重复 stop 幂等诚实(200,状态照实)。
- *
- * `?filter=` 禁用(带了=400):CC 的 filter 语义由调用方拿回 content 后本地做,本模块不透传。
- */
 import { TaskStopConflictError } from '@sema-agent/sdk';
 import { hostLog } from '../host.js';
 import { makeEngineWireClient } from '../engineWireSdk.js';
@@ -45,23 +6,8 @@ import { engineSessionParamFor } from '../engineSessionParam.js';
 import { resolveOwnerContext } from './engineSubagentResume.js';
 import { engineTaskHandlesCapable } from './engineRowStopGate.js';
 import { noteBgOwnerAbsence } from './subagentOwnerAbsence.js';
-// REF-CC-域词表-06 提单源:spool 全量/增量判读的单一真源现在在 toolResult.ts(它也消费同一份
-// 协议标记表 PROTOCOL_MARKERS)—— 本文件不再自己 `.includes()` 抄一份判读。
 import { spoolMarkerOf } from '../toolResult.js';
-// G1 去字面化(2026-08-04):`stop.*` 五形的码字面收编进 `engineErrorCodes.ts` 单一真源。
-// 顺序敏感的兜底认码数组也一并搬过去(顺序即语义,见那边的头注),本文件只 import。
 import { STOP_CONFLICT_CODES, STOP_NOT_LANDED, STOP_NOT_LOCAL, STOP_PARKED, STOP_PARK_ARBITER_UNREACHABLE, STOP_PARK_RESUME_WON, } from '../engineErrorCodes.js';
-// 能力门同步读口:真源在零依赖叶 `engineRowStopGate`(batch-stop 同步分类不拉本模块 SDK 图)。
-// ⚠️ 此处**不再 re-export**——它与原定义同进 index.ts 的 `export *` barrel 会构成双出口,
-// esbuild 对 star-export 歧义直接 build 失败(tsc 同源 symbol 不报=假绿;0.8.0 壳收批实撞,
-// idle-terminal-settle 套逮住)。包内消费者直接 import 原叶。
-/** 宿主 run 解析:fleet 行/通知帧喂的 parent 映射(行 id=`${runId} ${handle}` 的 parentId 投影,
- *  engineSide bash/monitor 行的出生帧即带)。
- *  🔴 #242 批 3([4000] Q3=B 裁定执行,行为翻面):台账缺席即**诚实缺席**,绝不回落
- *  `activeEngineRunId()` —— 旧回落读的是 fetch 时刻的活跃 run,不是 register 时刻的宿主(头注
- *  旧说法与实现不符):跨 turn 读旧句柄时回落值必错(404 撞别的 run),stop 打错 run 更坏。
- *  缺席不静默(noteBgOwnerAbsence warn 留痕);两个消费口各自 fail-soft(output→null 回落
- *  receipt/outputFile 渲染,stop→unavailable + detail,UI 不翻行)。 */
 function resolveHostRun(handle) {
     const runId = resolveOwnerContext(handle).runId;
     if (!runId) {
@@ -70,35 +16,15 @@ function resolveHostRun(handle) {
     }
     return runId;
 }
-/**
- * 🔴 会话**二态**(design/285 批 3,与 tail / output / steer 三腿同一口径):
- *   · 句柄登记时**捕到了会话**(批 2 起 fleet 行帧腿经 ingress 三值同写)⇒ 用**行登记的**会话 ——
- *     它与本腿寻址用的 `runId` 同源同拍,是唯一自洽的组合;
- *   · 没有随行会话 ⇒ 退**本槽的**现势会话(遵 [1498]③ 无条件带 session 的双版本兼容纪律)。
- *
- * 🔴 **为什么本腿也改**(设计稿 D6 原本只点名 tail/output,施工轮扩到本腿,同形存量族扫):
- *    病形 = 「台账取的 runId 配现势 session」—— 两面出生即强制带 `?session=`(见文件头注),
- *    对 session-bound 的旧 run 是确定性 404。批 2 落地之前本腿的行**没有**随行会话,这一格不可达;
- *    批 2 让 fleet 行帧腿开始写 session 之后,它与 tail/output 变成同一个形。只修 tail/output 而
- *    留下本腿 = 同一根因只修当格。停行(`stopEngineTask`)尤其不能留:它是有副作用的动作。
- *    空串归一仍只在 `engineSessionParamFor` 一处,本函数不重铸。
- */
 function sessionOf(ctx) {
     const s = ctx.record?.sessionId ?? engineSessionParamFor(ctx.key);
     return s !== undefined ? { session: s } : {};
 }
-// 游标累积(按 handle;进程内存态,与查看态生命周期同级——端重启即空,重读从引擎再取)
 const accumulated = new Map();
-/** 测试钩:清累积缓存。 */
 export function __resetTaskHandleWireForTests() {
     accumulated.clear();
 }
-/**
- * 读一个引擎侧任务句柄的输出(新面 A)。null = 读不到(无 wire / caps 缺 / 无宿主 run / 404
- * 域外或已 reap / 网错)——调用方回落既有渲染(receipt/outputFile tail)。绝不 throw。
- */
 export async function fetchEngineTaskOutput(handle, opts) {
-    // design/285 批 3(D7b):wire target 与 caps 门都按**这条句柄所属的槽**取,不再写死默认槽。
     const owner = resolveOwnerContext(handle);
     const cfg = engineWireTargetFor(owner.key);
     if (!cfg || !engineTaskHandlesCapable(owner.key))
@@ -116,15 +42,13 @@ export async function fetchEngineTaskOutput(handle, opts) {
     try {
         const r = await client.runs.taskOutput(runId, handle, {
             ...(opts?.signal ? { signal: opts.signal } : {}),
-            // design/285 批 3:会话二态(行登记的优先,缺则退本槽现势)——判据本体见 sessionOf 头注。
             ...(sessionOf(owner)),
         });
         const fresh = typeof r?.content === 'string' ? r.content : '';
         const prev = accumulated.get(handle) ?? '';
-        // A-D3:机读位优先 —— sdk 9.7.1 `SubagentOutputResult.cursorSemantics` 是**回体顶层**键(与 `output` 并列;generic taskOutput 面才铸,
-        //    窄面 subagentOutput 不带 ⇒ 缺席走文案臂)。异源对抗复审:首版读成 `output.cursorSemantics`,正常回体恒回落文案臂。
         const cursorSemantics = r?.cursorSemantics;
-        const merged = mergeTaskOutput(prev, fresh, typeof cursorSemantics === 'string' ? cursorSemantics : undefined);
+        const output = r?.output;
+        const merged = mergeTaskOutput(prev, fresh, typeof cursorSemantics === 'string' ? cursorSemantics : undefined, output);
         accumulated.set(handle, merged);
         const out = r?.output ?? {};
         if (engineWireDebugEnabled()) {
@@ -143,23 +67,18 @@ export async function fetchEngineTaskOutput(handle, opts) {
         return null;
     }
 }
-/**
- * [1505] 契约标记判别(头注):spool 全量 → 替换;cursor 增量 → append;无标记 → 保守
- * append-if-changed(与上次逐字节相同视为幂等重读,不重复)。空 content 不动累积。
- * 🔴 B6 提出成具名纯函数 —— 它是这条读面唯一会「把输出显示成两遍」的地方,值得被直接断言。
- * 🔴 REF-CC-域词表-06:标记判读本身**提单源**到 `toolResult.ts` 的 `spoolMarkerOf`(它与本文件
- * 曾经各写一份 `.includes()` 判读,同一个协议标记有两处互不知情的判读点——现在两处判读结果
- * 对同一输入恒一致,因为已经是同一个函数)。
- */
-/** 0.73.3(CC-60 A-D3):`cursorSemantics` 机读位(server ≥7.77.0 `taskOutput` 面):"cursor" = 读了就消费 ⇒ append;"full" = 全量重读安全 ⇒ 替换。
- *  **缺席 / 认不出 ⇒ 现行文案标记臂兜底**(老 server 不发这个键;sdk 头注逐字「别把缺席当 full」)。 */
-export function mergeTaskOutput(prev, fresh, cursorSemantics) {
+export function mergeTaskOutput(prev, fresh, cursorSemantics, output) {
     if (fresh.length === 0)
         return prev;
     if (cursorSemantics === 'full')
         return fresh;
     if (cursorSemantics === 'cursor')
         return prev + fresh;
+    const hint = terminalOutputHint(output);
+    if (hint === 'not_output')
+        return prev;
+    if (hint === 'snapshot')
+        return fresh;
     const marker = spoolMarkerOf(fresh);
     if (marker === 'full')
         return fresh;
@@ -167,31 +86,21 @@ export function mergeTaskOutput(prev, fresh, cursorSemantics) {
         return prev + fresh;
     return fresh === prev ? prev : prev + fresh;
 }
-/**
- * 🔴 **G13 删债(先红后绿)**:taskStop 的 409 冲突分类 —— 手抄 code 判 → typed
- * `TaskStopConflictError`(SDK 把**任何** `stop.*` 前缀码映到该类,errors.js:277-278;
- * SDK 自己的注释还点名了壳的手抄位置 `engineTaskHandleWire.ts:186-197`)。
- *
- * 手抄版的实际缺陷(pure 门先红实证):SDK 明列**五**形,手抄只认前四形 ⇒ 第五形
- * `stop.park_arbiter_unreachable`(core 1.397 三分:仲裁店不可达 ⇒ **真相未知**)静默塌进
- * `not_landed`。
- * 🔴 后果方向先定正负号([anchor-on-the-deciding-quantity]):门控的量 = 「UI 翻不翻这一行」,
- *    五形与 default **全都是不翻** ⇒ 这不是安全缺陷,是**诚实缺陷** —— 把「真相未知」渲染成
- *    「kill 没落地」,用户与诊断双双被误导。所以修法是给第五形一个自己的名字,而不是调整门。
- *
- * 开集纪律:`switch` 留 `default`(未来新 `stop.*` 码落 `unknown_conflict`,照样不翻行、
- * 照样带原始 `code`),绝不塌进任何一个已知形 —— 塌进去就等于替 server 编了一个它没说的原因。
- */
+function terminalOutputHint(output) {
+    if (output === null || typeof output !== 'object' || Array.isArray(output))
+        return undefined;
+    const o = output;
+    const rs = Object.hasOwn(o, 'retrieval_status') ? o.retrieval_status : undefined;
+    if (typeof rs === 'string' && rs !== 'success')
+        return 'not_output';
+    const type = Object.hasOwn(o, 'type') ? o.type : undefined;
+    if (type === 'background_agent' || type === 'workflow')
+        return 'snapshot';
+    return undefined;
+}
 export function classifyTaskStopConflict(e) {
     const detail = e instanceof Error ? e.message : String(e);
     const raw = e?.errorCode;
-    // typed 优先:SDK typed 错误(APIError 族)的机器码属性是 **`errorCode`**(peer 地板 >=2.0.0 恒有)。
-    // 🔴 2026-07-30 提货批实锤:此前这里读 `.code` —— 那是 0.x SDK 的属性名,1.0.0 错误层级重做后
-    //   typed 类只带 `.errorCode`,于是五形分类整体塌 `unknown_conflict`。本仓 pure 门没抓到,因为
-    //   测试 fixture 也是手搓 `{status, code}` 老形 —— 实现与 fixture 同错互证(假绿)。壳的
-    //   run-bulk-stop-engine-rows 门用**真 SDK** 打假 HTTP 引擎才现形(跨仓交叉验证)。修后 fixture
-    //   改锚实装 SDK 的 TaskStopConflictError 真类,fixture 再也漂不动。
-    // 兜底(非 typed 抛点):errorCode 非串时从 message 里认字面 —— 回落,不是主判据。
     const code = typeof raw === 'string'
         ? raw
         : (STOP_CONFLICT_CODES.find(c => detail.includes(c)) ?? '');
@@ -207,24 +116,10 @@ export function classifyTaskStopConflict(e) {
         case STOP_NOT_LANDED:
             return { ok: false, reason: 'not_landed', detail };
         default:
-            // 开集:未知/未来 `stop.*`(以及 code 完全缺席的残破形)。诚实说「有冲突但我不认识它」,
-            // 不冒充 not_landed。UI 处置与其余五形相同(不翻行)。
             return { ok: false, reason: 'unknown_conflict', detail };
     }
 }
-/**
- * 🟢 B8 ALLOW 清单登记(REF-CC-域词表-05,属主=client-core 规范重构轮,到期复议=SDK typed 错误类
- * 覆盖全部 `stop.*` 码后或 2026-Q4 复审以先到者为准):兜底字面认码,前置合取 = typed
- * `TaskStopConflictError` 缺席时才落到这里(见 `stopEngineTask` 的 `if (e instanceof
- * TaskStopConflictError || status === 409)`)。同批同表的另两处:`detachWire.ts`
- * `DETACH_DURABLE_OFF_400_ANCHOR`(server 契约话)、`classifierVerdictWire.ts`
- * `CLASSIFIER_DENY_SIGNATURE`(core lockstep 机器签名)——三处互指,理由逐条写在各自站点。
- */
-/* 兜底字面认码用的已知集(顺序 = 长码优先,避免 `stop.parked` 抢走 `stop.park_resume_won`)
- * 已随 G1 去字面化搬到 `engineErrorCodes.ts` 的 `STOP_CONFLICT_CODES` —— 顺序即语义那条注也在那边。 */
-/** 停一个引擎侧任务句柄(新面 B)。只有 ok:true(=HTTP 200)算停了。绝不 throw。 */
 export async function stopEngineTask(handle, opts) {
-    // design/285 批 3(D7b):同 `fetchEngineTaskOutput` —— 停行是有副作用的动作,打错引擎更坏。
     const owner = resolveOwnerContext(handle);
     const cfg = engineWireTargetFor(owner.key);
     if (!cfg || !engineTaskHandlesCapable(owner.key))
@@ -242,7 +137,6 @@ export async function stopEngineTask(handle, opts) {
     try {
         const r = await client.runs.taskStop(runId, handle, {
             ...(opts?.signal ? { signal: opts.signal } : {}),
-            // design/285 批 3:会话二态(行登记的优先,缺则退本槽现势)——判据本体见 sessionOf 头注。
             ...(sessionOf(owner)),
         });
         const out = r?.output ?? {};
@@ -259,11 +153,6 @@ export async function stopEngineTask(handle, opts) {
         const status = e?.status;
         const detail = e instanceof Error ? e.message : String(e);
         hostLog('debug', `[task-handle] stop ${handle} via run ${runId}: ${typeof status === 'number' ? status : detail.slice(0, 160)}`);
-        // [1521]F2 订正:server 文案句里不含 errorCode 字面(message 判恒 miss=死分形),而 SDK
-        // APIError.code 一直透 errorCode——锚 code(对文案措辞变化免疫),message 兜底保留。
-        // 🔴 G13:判别锚从 `status===409` 换成 **typed 类**(`TaskStopConflictError`)—— SDK 把任何
-        //   `stop.*` 码都映到它,以后 server 换 HTTP 码(或同码复用别的语义)时这条腿不会失灵;
-        //   status 判保留为兜底(老 SDK 不抛 typed 类时仍要认)。
         if (e instanceof TaskStopConflictError || status === 409) {
             return classifyTaskStopConflict(e);
         }

package/dist/subagent/subagentOwnerAbsence.d.ts

@@ -1,4 +1,2 @@
-/** 台账缺席留痕(每 (leg, taskId) 至多一条 warn;绝不 throw)。 */
 export declare function noteBgOwnerAbsence(leg: string, taskId: string): void;
-/** 测试钩:清留痕去重集(同进程多组断言之间互不污染)。 */
 export declare function __resetBgOwnerAbsenceForTests(): void;

package/dist/subagent/subagentOwnerAbsence.js

@@ -1,27 +1,6 @@
-/**
- * subagentOwnerAbsence — #242 批 3(协作板 [4000] Q3=B 裁定落地):bg 子代宿主 run 台账缺席时的
- * **响亮留痕**单源。
- *
- * 三条读面腿(`engineSubagentTail` / `engineTaskHandleWire` / `engineSubagentOutput`)此前一律
- * `getBgParentRun(x) ?? activeEngineRunId()` 无条件回落 —— 与 resume 腿的 `resolveOwnerRunId`
- * (指名了行就诚实缺席,绝不回落)口径相反。Q3 裁定统一到 resume 口径:**台账缺席即诚实缺席,
- * 绝不回落**。理由(壳 `subagentOwnerLedger` 对抗复审结论,已入包表头注):进程级
- * `activeEngineRunId()` 被并发 main/fork 流互相覆写、又被每个 query 的 finally 清空,回落出来的
- * 宿主可能是**别的 run** —— 错值比缺席更坏(读面打到不相干的 run;stop 打错 run 甚至可能停掉
- * 别人的同名句柄)。
- *
- * 但缺席也不许**静默空转**(clay 原话「有问题必暴露」):本模块对每个 (腿, taskId) 组合 warn
- * **一次**(查看态 watcher / 面板 tick 会按拍重试同一缺席,逐次 warn = 刷屏;去重集有界 FIFO)。
- * 消费方照旧 fail-soft 返回缺席值(null/不开流)—— 响亮的是留痕,不是抛错。
- *
- * 🔴 独立小叶而不进 `subagentContentStore`(台账属主):那个 store 是**零 import 的内核闭包件**
- * (portability 门的 runStream 闭包文件数棘轮只许降),拉 `host.js` 进去会撑大内核闭包;三条腿
- * 都在 `subagent/`、都已依赖 host,落这里零新增图边。
- */
 import { hostLog } from '../host.js';
 const noted = new Set();
 const MAX_NOTED = 512;
-/** 台账缺席留痕(每 (leg, taskId) 至多一条 warn;绝不 throw)。 */
 export function noteBgOwnerAbsence(leg, taskId) {
     const key = `${leg}:${taskId}`;
     if (noted.has(key))
@@ -36,13 +15,9 @@ export function noteBgOwnerAbsence(leg, taskId) {
         hostLog('warn', `[subagent-owner] ${leg}: no host-run mapping for ${taskId} — not connecting (owner ledger absent ⇒ honest absence; active-run fallback removed per [4000] Q3)`);
     }
     catch {
-        // 诊断端口自己抛错(P-F4):①绝不向三腿调用方外溢(留痕是旁路,不是三腿的失败模式);
-        // ②撤销去重键 —— warn 没真发出去,留痕机会不许被一次坏端口永久烧掉,端口恢复后
-        // 下一次同键缺席仍会 warn 一次。
         noted.delete(key);
     }
 }
-/** 测试钩:清留痕去重集(同进程多组断言之间互不污染)。 */
 export function __resetBgOwnerAbsenceForTests() {
     noted.clear();
 }