@sema-agent/client-core 0.74.2 → 0.74.3

package/dist/fleet/fleetProjection.js

@@ -373,6 +373,7 @@ function wireNumberKey(key, v) {
 export function projectWorkflows(rows) {
     return rows.map(r => {
         const startedCount = wireStartedCount(r);
+        const errorCode = wireErrorCode(r);
         return {
             id: r.id,
             // 187 workflow label = `e.summary ?? e.description`(短 label);折成单行,空 → 187 占位符。
@@ -385,9 +386,15 @@ export function projectWorkflows(rows) {
             ...wireNumberKey('tokens', wireCount(r.tokens)),
             ...wireNumberKey('failedCount', wireCount(r.failedCount)),
             ...(startedCount !== undefined ? { startedCount } : {}),
+            ...(errorCode !== undefined ? { errorCode } : {}),
         };
     });
 }
+/** CC-72:sdk 未声明的 run 级码,按结构读 —— 非空串才算在场;空串 / 非串 / null 一律缺席(不折串)。 */
+function wireErrorCode(r) {
+    const v = r.errorCode;
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
 // ── 键集契约(`run-fleet-view-keys-test.mjs` 的运行期锚)─────────────────────────────────────
 //
 // 两跳链条,一跳都断不了(形与 `seatContract.ts` 的座位门同款):
@@ -436,6 +443,7 @@ const FLEET_WORKFLOW_VIEW_KEY_TUPLE = [
     'tokens',
     'failedCount',
     'startedCount',
+    'errorCode',
 ];
 /** `FleetWorkflowView` 的键名清单(同上)。 */
 export const FLEET_WORKFLOW_VIEW_KEYS = FLEET_WORKFLOW_VIEW_KEY_TUPLE;

package/dist/fleetAgentPanelProjection.d.ts

@@ -38,6 +38,8 @@ export interface FleetAgentRowLike {
     startedAt?: number;
     /** 0.74.0 —— 行的代际号(fleet 视图 `FleetTaskView.cycleSeq` 原样交)。缺席 = 这一行没有代际概念,不是第一代。 */
     cycleSeq?: number;
+    /** 0.74.3 CC-70:行帧上的委派卡 id(sdk `FleetTaskRow.parentToolCallId`);身份归一的退路键,在场才投影。 */
+    parentToolCallId?: string;
 }
 /** 行从投影集消失多久之后上报 `absent`(0.72.12 起不再 settle;重连空窗 / snapshot 清表远小于此)。名字沿用(公面导出)。 */
 export declare const ABSENT_SETTLE_MS = 30000;

package/dist/fleetAgentPanelProjection.js

@@ -141,6 +141,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
         // 🔴 三态直取:`row.toolUses` 缺席就是 undefined,这里**不许**兜 0(见 FleetAgentRowLike 注)。
         const toolUses = typeof row.toolUses === 'number' ? row.toolUses : undefined;
         const transcriptId = row.transcriptId || undefined;
+        const parentToolCallId = typeof row.parentToolCallId === 'string' && row.parentToolCallId.length > 0 ? row.parentToolCallId : undefined;
         const startedAt = typeof row.startedAt === 'number' && row.startedAt > 0 ? row.startedAt : undefined;
         // 0.74.0:代际号(正整数才算;坏形 / 缺席 ⇒ undefined,绝不补 1)。
         const cycleSeq = typeof row.cycleSeq === 'number' && Number.isInteger(row.cycleSeq) && row.cycleSeq >= 1 ? row.cycleSeq : undefined;
@@ -191,6 +192,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
                     (tokens !== undefined && prev?.tokens !== tokens) ||
                     (toolUses !== undefined && prev?.toolUses !== toolUses) ||
                     (transcriptId !== undefined && prev?.transcriptId !== transcriptId) ||
+                    (parentToolCallId !== undefined && prev?.parentToolCallId !== parentToolCallId) ||
                     (startedAt !== undefined && prev?.startedAt !== startedAt)) {
                     publishEngineAgentPanelEvent({
                         kind: 'fleet-row',
@@ -200,6 +202,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
                         ...(knownTokens !== undefined ? { totalTokens: knownTokens } : {}),
                         ...(toolUses !== undefined ? { toolUses } : {}),
                         ...(transcriptId !== undefined ? { transcriptId } : {}),
+                        ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
                         ...(knownStartedAt !== undefined ? { startedAt: knownStartedAt } : {}),
                         ...(knownCycleSeq !== undefined ? { cycleSeq: knownCycleSeq } : {}),
                     });
@@ -221,6 +224,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
                 tokens: knownTokens,
                 toolUses: toolUses !== undefined ? toolUses : prev?.toolUses,
                 transcriptId: transcriptId !== undefined ? transcriptId : prev?.transcriptId,
+                parentToolCallId: parentToolCallId !== undefined ? parentToolCallId : prev?.parentToolCallId,
                 startedAt: knownStartedAt,
                 cycleSeq: knownCycleSeq,
                 currentToolKey: currentToolKey !== undefined ? currentToolKey : prev?.currentToolKey,
@@ -243,6 +247,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
             prev.tokens !== knownTokens ||
             (toolUses !== undefined && prev.toolUses !== toolUses) ||
             (transcriptId !== undefined && prev.transcriptId !== transcriptId) ||
+            (parentToolCallId !== undefined && prev.parentToolCallId !== parentToolCallId) ||
             (startedAt !== undefined && prev.startedAt !== startedAt) ||
             (cycleSeq !== undefined && prev.cycleSeq !== cycleSeq) ||
             (currentToolKey !== undefined && prev.currentToolKey !== currentToolKey)) {
@@ -255,6 +260,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
                 // 🔴 缺席即不落键(消费端据「键在不在」判三态)。
                 ...(toolUses !== undefined ? { toolUses } : {}),
                 ...(transcriptId !== undefined ? { transcriptId } : {}),
+                ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
                 ...(knownStartedAt !== undefined ? { startedAt: knownStartedAt } : {}),
                 ...(knownCycleSeq !== undefined ? { cycleSeq: knownCycleSeq } : {}),
                 ...(currentTool !== undefined ? { currentTool } : {}),
@@ -266,6 +272,7 @@ export function projectFleetAgentRowsFor(sessionKey, rows, nowMs = Date.now()) {
             tokens: knownTokens,
             toolUses: toolUses !== undefined ? toolUses : prev?.toolUses,
             transcriptId: transcriptId !== undefined ? transcriptId : prev?.transcriptId,
+            parentToolCallId: parentToolCallId !== undefined ? parentToolCallId : prev?.parentToolCallId,
             startedAt: knownStartedAt,
             cycleSeq: knownCycleSeq,
             currentToolKey: currentToolKey !== undefined ? currentToolKey : prev?.currentToolKey,

package/dist/hitl/hitlBridge.d.ts

@@ -67,6 +67,7 @@
  */
 import type { AgentEvent, ApprovalDecision, ApprovalStaleError, PendingCheckpoint, CheckpointGate, PlanReviewRequest, AssistantTaskStatus } from '@sema-agent/sdk';
 import type { ApprovalsListEnvelope } from './crashConverged.js';
+import { type SuspendedReopenReading } from './suspendedReopen.js';
 /** durable `/decide` 腿的既有缺省拒因(不带归因时逐字不变 —— 0.27.0 及之前的 wire 字节)。 */
 export declare const DEFAULT_DENY_REASON = "The user rejected this tool use";
 /**
@@ -300,6 +301,8 @@ export interface ActiveGate {
     gate: CheckpointGate;
     /** The durable seq of the `suspended` event, for rewind/dedup correlation (types.ts:48 eventSeq). */
     seq?: string | undefined;
+    /** 0.74.3 CC-73:这条挂起是不是一次 reopen(`suspended.reopened` 三态,见 {@link suspendedReopenOf});每条 suspended 重读,不粘上一条。 */
+    reopened: SuspendedReopenReading;
 }
 /** Outcome of {@link findPendingForTask}. */
 export type FindPendingOutcome = {
@@ -394,6 +397,12 @@ export declare class HitlBridge {
     observe(ev: AgentEvent): void;
     /** The gate currently awaiting a human, if any. The shell branches on `gate.kind` to pick the chrome. */
     currentGate(): CheckpointGate | null;
+    /**
+     * 0.74.3 CC-73:当前挂起是不是一次 reopen(`suspended.reopened` 三态);没挂起 ⇒ `null`。
+     * 消费方据此把「真 reopen 成功、重试会重放」那半句说出来:`reopened` 在场码 ⇒ 卡仍 pending、决定没被消费、可再决;
+     * `not_reopened` / `unstated` ⇒ 普通挂起,一个字都不多说。
+     */
+    currentGateReopen(): SuspendedReopenReading | null;
     /**
      * Fetch the `PendingCheckpoint` this decide/answer is about to resolve, for the callers that do NOT
      * already have one in hand (see `decideTool`/`answerQuestion`'s `preResolvedPending` param — the wire

package/dist/hitl/hitlBridge.js

@@ -2,6 +2,7 @@ import { askParkForeignGateKind } from '../adapter/activeRunSelfHeal.js';
 import { eventSeq } from '../adapter/types.js';
 import { hostLog } from '../host.js';
 import { abortableSleep } from '../abortableSleep.js';
+import { suspendedReopenOf } from './suspendedReopen.js';
 // ── deny/plan-review 归因的 wire 窄化(0.28.0 发版扫描 F1/F2/F3 收编;单源,三条腿共用)──────
 //
 // server 对 `/decide` 与 plan-review 两条腿的 `reason` 同限 `MAX_APPROVAL_REASON_CHARS`(4096 字符,
@@ -417,10 +418,10 @@ export class HitlBridge {
             case 'suspended':
                 // gate may be null (Event_suspended 'null' arm) → a generic "needs you" pause (contract/08 CS-9).
                 if (ev.gate) {
-                    this.active = { gate: ev.gate, seq: eventSeq(ev) };
+                    this.active = { gate: ev.gate, seq: eventSeq(ev), reopened: suspendedReopenOf(ev) };
                 }
                 else {
-                    this.active = { gate: { kind: 'human' }, seq: eventSeq(ev) };
+                    this.active = { gate: { kind: 'human' }, seq: eventSeq(ev), reopened: suspendedReopenOf(ev) };
                 }
                 break;
             case 'done':
@@ -439,6 +440,14 @@ export class HitlBridge {
     currentGate() {
         return this.active?.gate ?? null;
     }
+    /**
+     * 0.74.3 CC-73:当前挂起是不是一次 reopen(`suspended.reopened` 三态);没挂起 ⇒ `null`。
+     * 消费方据此把「真 reopen 成功、重试会重放」那半句说出来:`reopened` 在场码 ⇒ 卡仍 pending、决定没被消费、可再决;
+     * `not_reopened` / `unstated` ⇒ 普通挂起,一个字都不多说。
+     */
+    currentGateReopen() {
+        return this.active?.reopened ?? null;
+    }
     /**
      * Fetch the `PendingCheckpoint` this decide/answer is about to resolve, for the callers that do NOT
      * already have one in hand (see `decideTool`/`answerQuestion`'s `preResolvedPending` param — the wire

package/dist/hitl/suspendedReopen.d.ts

@@ -0,0 +1,30 @@
+/**
+ * suspendedReopen — durable `suspended` 事件上 server 的**重开侧记键** `reopened` 的三态读口(0.74.3 CC-73;
+ * 契约 reopen 族段:`GET /v1/runs/{taskId}/events` 的 `suspended` 事件带 `reopened: <errorCode>`,「缺席 / null =
+ * 这次 park 不是重开」;sdk `events.d.ts` `reopened?: string | null`,普通挂起帧不带此键)。
+ *
+ * ── 🔴 为什么是三态而不是「是 / 不是」两态 ─────────────────────────────────────────────────
+ * 契约把「缺席」和「null」判成同一句话,但两者的**说话人不同**:`null` 是新 server 明说「不是重开」;键缺席既可能是
+ * 新 server 的普通挂起帧,也可能是根本没有这个键的老 server。把两者折成一个值,消费方就再也分不出「server 说了不是」
+ * 与「server 什么都没说」。读口把它们分开带出,消费方按契约把 `unstated` **当作**不是重开即可,但不替 server 说那句话。
+ *
+ * 码是**开集原词**(词表属主在 server:今天三员 `resume.env_failed` / `resume.tool_unavailable` /
+ * `resume.tool_contract_mismatch`,见 `engineErrorCodes.ts` `RESUME_REOPEN_CODES`),本读口不过滤;要文案的消费方拿码去查表。
+ */
+/** `suspended.reopened` 的读数。 */
+export type SuspendedReopenReading = 
+/** 键在场且是非空串:这条挂起是一次**重开**,`code` = server 给的 errorCode 原词。 */
+{
+    readonly kind: 'reopened';
+    readonly code: string;
+}
+/** 键在场且显式 `null`:server 明说这次 park 不是重开。 */
+ | {
+    readonly kind: 'not_reopened';
+}
+/** 键缺席(或值读不出):server 没说;按契约当作不是重开,但不冒充 `null`。 */
+ | {
+    readonly kind: 'unstated';
+};
+/** 任意事件体 → 三态读数;非对象 / 坏形一律 `unstated`,永不抛。 */
+export declare function suspendedReopenOf(ev: unknown): SuspendedReopenReading;

package/dist/hitl/suspendedReopen.js

@@ -0,0 +1,27 @@
+/**
+ * suspendedReopen — durable `suspended` 事件上 server 的**重开侧记键** `reopened` 的三态读口(0.74.3 CC-73;
+ * 契约 reopen 族段:`GET /v1/runs/{taskId}/events` 的 `suspended` 事件带 `reopened: <errorCode>`,「缺席 / null =
+ * 这次 park 不是重开」;sdk `events.d.ts` `reopened?: string | null`,普通挂起帧不带此键)。
+ *
+ * ── 🔴 为什么是三态而不是「是 / 不是」两态 ─────────────────────────────────────────────────
+ * 契约把「缺席」和「null」判成同一句话,但两者的**说话人不同**:`null` 是新 server 明说「不是重开」;键缺席既可能是
+ * 新 server 的普通挂起帧,也可能是根本没有这个键的老 server。把两者折成一个值,消费方就再也分不出「server 说了不是」
+ * 与「server 什么都没说」。读口把它们分开带出,消费方按契约把 `unstated` **当作**不是重开即可,但不替 server 说那句话。
+ *
+ * 码是**开集原词**(词表属主在 server:今天三员 `resume.env_failed` / `resume.tool_unavailable` /
+ * `resume.tool_contract_mismatch`,见 `engineErrorCodes.ts` `RESUME_REOPEN_CODES`),本读口不过滤;要文案的消费方拿码去查表。
+ */
+const UNSTATED = Object.freeze({ kind: 'unstated' });
+const NOT_REOPENED = Object.freeze({ kind: 'not_reopened' });
+/** 任意事件体 → 三态读数;非对象 / 坏形一律 `unstated`,永不抛。 */
+export function suspendedReopenOf(ev) {
+    if (ev === null || typeof ev !== 'object' || Array.isArray(ev))
+        return UNSTATED;
+    const o = ev;
+    if (!Object.hasOwn(o, 'reopened'))
+        return UNSTATED;
+    const v = o.reopened;
+    if (v === null)
+        return NOT_REOPENED;
+    return typeof v === 'string' && v.length > 0 ? { kind: 'reopened', code: v } : UNSTATED;
+}

package/dist/index.d.ts

@@ -161,6 +161,8 @@ export * from './deviceExecutorManagementCapability.js';
 export * from './mcpReconnect.js';
 export * from './leaderConflict.js';
 export * from './runTerminal.js';
+export * from './runCancelContext.js';
+export * from './argvFlagValue.js';
 export * from './readFacePosture.js';
 export * from './mcpPanel.js';
 export * from './effectiveFacts.js';
@@ -253,6 +255,7 @@ export * from './hooksWireCaps.js';
 export * from './liveInitToolFace.js';
 export * from './model/providerPresets.js';
 export * from './hitl/hitlBridge.js';
+export * from './hitl/suspendedReopen.js';
 export { toolEndOutputText, ENGINE_ABORT_TOOL_RESULT } from './hitl/frameRouter.js';
 export { isAskTool } from './hitl/frameRouter.js';
 export * from './hitl/hitlHostSurface.js';

package/dist/index.js

@@ -202,6 +202,10 @@ export * from './mcpReconnect.js';
 export * from './leaderConflict.js';
 // 0.60.0(engine ≥7.64.0 / sdk 8.4.0):终局因由与门记录两只**判定归包**的读器。
 export * from './runTerminal.js';
+// 0.74.3 CC-71:run 记录 cancelContext 读口 + turn_aborted{engine_error} 后的成因闭集四词(cli L-212 (a) 消费半场归包)
+export * from './runCancelContext.js';
+// 0.74.3 CC-80(core 交叉扫 X-5 / cli L-R1):argv 末次旗值扫描原语上公面 —— 包内四消费者早已收编,端还在造第 N 份手写循环
+export * from './argvFlagValue.js';
 // 0.61.0(engine ≥7.65.0 / sdk 8.5.0 / S-167):READ 容纳面档位 + 来源的 operator 面窄读器
 // (`WiringDiagnostics.readFace`)。与 `writeProtectionCapability` / `gateOutcome` 同构同纪律
 // (防御读 / 唯一措辞铸点 / UNTRUSTED-for-display);与租户面 `capabilities.readFace` 刻意不合流,
@@ -438,6 +442,8 @@ export * from './model/providerPresets.js';
 //    共享宿主通知面 + cancel-by-deny 有界观察 —— `askGateWire.ts` 已 import `toolApprovalWire.ts`,
 //    反向 import 会成环,所以两条腿共用的那一组挪进一个两边都能到达的独立模块。
 export * from './hitl/hitlBridge.js';
+// 0.74.3 CC-73:durable suspended.reopened 三态读口(cli L-56 ②)
+export * from './hitl/suspendedReopen.js';
 // [C93] P0 直讨(0.17.1):toolEndOutputText 单一真源导出——web/desktop 被点名「两端务必接」的
 // 6.0.0 output content-block 归一,此前 frameRouter 内私有,两端手抄=漂移温床。frameRouter 只
 // 挑名导出这一件(整星导出会把路由内部面全泄进公面)。

package/dist/runCancelContext.d.ts

@@ -0,0 +1,49 @@
+/**
+ * runCancelContext — run 记录上 server 自铸的**取消现场**侧记键 `cancelContext`(server ≥7.87.3 `PersistedTaskResult =
+ * TaskResult & { cancelContext? }`,`dist/plugins/store-contracts.d.ts` `RunCancelContext` 四座)的三端共用读面,与
+ * `turn_aborted{reason:'engine_error'}` 之后「到底是谁把这条 run 结掉的」的**成因判定**(0.74.3 CC-71;cli L-212 (a) 消费半场归包)。
+ * sdk 9.7.1 对该键无型 ⇒ 按契约结构读。
+ *
+ * ── 🔴 读法 ─────────────────────────────────────────────────────────────────────────────────
+ *  ① `cancelContext` 缺席 = 老 server / 这条 run 不是被取消的 / 记录形不带 —— **不折成「未取消」**,读数是 `not_reported`。
+ *  ② 四座各自可缺席、各自防御读:`lastEventKind`(串)/ `lastEventAgeMs`(≥0 有限数)/ `elapsedMs`(≥0 有限数;绝不折 0)/
+ *     `lastBrainStatus`(对象,原样带出不窄读)。「有 age 无 kind」是合法读数。
+ *  ③ 成因判定 {@link classifyRunAbortCause}:只由 run 记录上的**机读证据**得出 —— `errorCode` ∈ 取消码 ⇒ `cancelled_by_user`;
+ *     `cancelContext` 在场而码不是取消码 ⇒ 仍按码判(现场只是附注);码缺席 / 认不出 ⇒ `unknown`。**缺席不猜**。
+ */
+/** 四座读数(在场才带)。 */
+export interface RunCancelContextView {
+    readonly lastEventKind?: string;
+    readonly lastEventAgeMs?: number;
+    readonly elapsedMs?: number;
+    readonly lastBrainStatus?: Readonly<Record<string, unknown>>;
+}
+export type RunCancelContextReading = {
+    kind: 'not_reported';
+} | {
+    kind: 'present';
+    context: RunCancelContextView;
+};
+/** run 记录(`runs.get` 回体 / `done.result`)→ 取消现场读数;记录非对象 ⇒ `undefined`(判不出,与 not_reported 分开)。 */
+export declare function readRunCancelContext(record: unknown): RunCancelContextReading | undefined;
+import { type RunTerminalRead } from './runTerminal.js';
+export type RunAbortCause = {
+    kind: 'cancelled';
+    context?: RunCancelContextView;
+} | {
+    kind: 'engine_error';
+    code?: string;
+    message?: string;
+}
+/** run 记录仍非终态:流断了而 run 还在(壳这一端的事实,不是 run 的成因)。`status` 原词。 */
+ | {
+    kind: 'run_still_live';
+    status?: string;
+} | {
+    kind: 'unknown';
+    terminal?: RunTerminalRead['kind'];
+};
+/** 取消码常量(server `CANCELLED_CODE` / sdk runs.d.ts 逐字)。 */
+export declare const RUN_CANCELLED_CODE: "cancelled";
+/** 壳带 `engineTaskId` 去 `runs.get` 拿回的记录 ⇒ 成因。只由机读证据得出;缺席不猜。 */
+export declare function classifyRunAbortCause(record: unknown): RunAbortCause;

package/dist/runCancelContext.js

@@ -0,0 +1,81 @@
+/**
+ * runCancelContext — run 记录上 server 自铸的**取消现场**侧记键 `cancelContext`(server ≥7.87.3 `PersistedTaskResult =
+ * TaskResult & { cancelContext? }`,`dist/plugins/store-contracts.d.ts` `RunCancelContext` 四座)的三端共用读面,与
+ * `turn_aborted{reason:'engine_error'}` 之后「到底是谁把这条 run 结掉的」的**成因判定**(0.74.3 CC-71;cli L-212 (a) 消费半场归包)。
+ * sdk 9.7.1 对该键无型 ⇒ 按契约结构读。
+ *
+ * ── 🔴 读法 ─────────────────────────────────────────────────────────────────────────────────
+ *  ① `cancelContext` 缺席 = 老 server / 这条 run 不是被取消的 / 记录形不带 —— **不折成「未取消」**,读数是 `not_reported`。
+ *  ② 四座各自可缺席、各自防御读:`lastEventKind`(串)/ `lastEventAgeMs`(≥0 有限数)/ `elapsedMs`(≥0 有限数;绝不折 0)/
+ *     `lastBrainStatus`(对象,原样带出不窄读)。「有 age 无 kind」是合法读数。
+ *  ③ 成因判定 {@link classifyRunAbortCause}:只由 run 记录上的**机读证据**得出 —— `errorCode` ∈ 取消码 ⇒ `cancelled_by_user`;
+ *     `cancelContext` 在场而码不是取消码 ⇒ 仍按码判(现场只是附注);码缺席 / 认不出 ⇒ `unknown`。**缺席不猜**。
+ */
+function nonNegFinite(v) {
+    return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : undefined;
+}
+/** run 记录(`runs.get` 回体 / `done.result`)→ 取消现场读数;记录非对象 ⇒ `undefined`(判不出,与 not_reported 分开)。 */
+export function readRunCancelContext(record) {
+    if (record === null || typeof record !== 'object')
+        return undefined;
+    const r = record;
+    // 记录形两种:顶层 `result.cancelContext`(PersistedTaskResult)或已经是 result 本身。
+    const holder = r.result !== null && typeof r.result === 'object' ? r.result : r;
+    if (!Object.hasOwn(holder, 'cancelContext') || holder.cancelContext === undefined)
+        return { kind: 'not_reported' };
+    const c = holder.cancelContext;
+    if (c === null || typeof c !== 'object' || Array.isArray(c))
+        return undefined;
+    const o = c;
+    const kind = typeof o.lastEventKind === 'string' && o.lastEventKind.length > 0 ? o.lastEventKind : undefined;
+    const age = nonNegFinite(o.lastEventAgeMs);
+    const elapsed = nonNegFinite(o.elapsedMs);
+    const brain = o.lastBrainStatus !== null && typeof o.lastBrainStatus === 'object' && !Array.isArray(o.lastBrainStatus) ? o.lastBrainStatus : undefined;
+    return {
+        kind: 'present',
+        context: {
+            ...(kind !== undefined ? { lastEventKind: kind } : {}),
+            ...(age !== undefined ? { lastEventAgeMs: age } : {}),
+            ...(elapsed !== undefined ? { elapsedMs: elapsed } : {}),
+            ...(brain !== undefined ? { lastBrainStatus: brain } : {}),
+        },
+    };
+}
+// ── 成因判定(闭集四词;cli L-212 (a) 对齐)────────────────────────────────────────────────
+//
+// 字节出处(cli 亲 grep server 7.87.3 dist):
+//   · 被取消 = 唯一铸点 `run-cancel-context.js` `mintCancelledResult` ⇒ `terminal:{kind:"failed", code:"cancelled"}`,
+//     且**只有这条路**挂 `cancelContext`;
+//   · 引擎错 = `terminal.kind === "failed"` 且 code !== "cancelled";code 是 core 的**开集**(network / brain.* / limits.* …)⇒ 只渲原码,不枚举;
+//   · 客户端断连**没有独立字节**:server 走的是 detach / park(durable run 继续跑、在等的 ask 停驻),run 记录不会因此失败 ⇒
+//     它不是 run 的成因,是壳这一端的事实 —— 判法 = run 记录仍非终态(running / queued / suspended / needs_review)⇒ `run_still_live`。
+//   · 别的(完成 / 挡住 / 读不出终态词)⇒ `unknown`,不猜。
+import { readRunTerminal } from './runTerminal.js';
+/** 取消码常量(server `CANCELLED_CODE` / sdk runs.d.ts 逐字)。 */
+export const RUN_CANCELLED_CODE = 'cancelled';
+const LIVE_STATUSES = new Set(['running', 'queued', 'suspended', 'needs_review']);
+/** 壳带 `engineTaskId` 去 `runs.get` 拿回的记录 ⇒ 成因。只由机读证据得出;缺席不猜。 */
+export function classifyRunAbortCause(record) {
+    if (record === null || typeof record !== 'object')
+        return { kind: 'unknown' };
+    const r = record;
+    const status = typeof r.status === 'string' && r.status.length > 0 ? r.status : undefined;
+    const holder = r.result !== null && typeof r.result === 'object' ? r.result : record;
+    const read = readRunTerminal(holder);
+    if (read !== null && read.kind === 'failed') {
+        if (read.code === RUN_CANCELLED_CODE) {
+            const cc = readRunCancelContext(record);
+            return { kind: 'cancelled', ...(cc?.kind === 'present' ? { context: cc.context } : {}) };
+        }
+        return { kind: 'engine_error', ...(read.code !== undefined ? { code: read.code } : {}), ...(read.message !== undefined ? { message: read.message } : {}) };
+    }
+    // 非终态 = run 还活着:嵌套 paused 臂 / 平面 paused 词 / 行上 status 仍是在飞词(平面读器对 running / queued 答 unknown{word},
+    // 那不是「读不出」,是「还没结」—— 所以先看 status 再落 unknown)。
+    if (read !== null && read.kind === 'paused')
+        return { kind: 'run_still_live', ...(status !== undefined ? { status } : {}) };
+    // 异源复审 R2 [medium]:result 已是终态(completed / blocked)而行上 status 还是在飞词 = 两处证据矛盾 ⇒ unknown(带观测到的终态词),
+    // 不按外层 status 说「还活着」——result 是终局记录,行状态可能滞后;矛盾不是 liveness 的证据。
+    if ((read === null || read.kind === 'unknown') && status !== undefined && LIVE_STATUSES.has(status))
+        return { kind: 'run_still_live', status };
+    return { kind: 'unknown', ...(read !== null ? { terminal: read.kind } : {}) };
+}

package/dist/sqlEngineCapability.js

@@ -173,8 +173,8 @@ export function sqlEngineDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
             // 0.59.2(cli B-038):不点名任何端的命令 —— 「去哪里看」是端的事,包只说事实。
-            return ('not observed — the engine reports it on /v1/capabilities; this process has not received ' +
-                'a capabilities response from the engine yet');
+            return ('not observed — the engine reports it on /v1/capabilities; this process has no usable ' +
+                'capabilities reading cached for it (none received, or the last one was unreadable)');
         case 'not_reported':
             return 'not reported by this engine — the capability position needs a newer engine';
         case 'none':

package/dist/webSearchBackendCapability.js

@@ -126,7 +126,7 @@ export function webSearchBackendDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
             return ('deployment default backend not observed — the engine reports it on /v1/capabilities; ' +
-                'this process has not received a capabilities response from the engine yet');
+                'this process has no usable capabilities reading cached for it (none received, or the last one was unreadable)');
         case 'not_reported':
             return ('deployment default backend not reported by this engine — only newer engines advertise it; ' +
                 'this does not say whether the deployment has a search backend');

package/dist/writeProtectionCapability.js

@@ -176,8 +176,8 @@ const WP_DETAIL_MAX = 40;
 export function writeProtectionDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
-            return ('not observed — the engine reports it on /v1/capabilities; this process has not received ' +
-                'a capabilities response from the engine yet');
+            return ('not observed — the engine reports it on /v1/capabilities; this process has no usable ' +
+                'capabilities reading cached for it (none received, or the last one was unreadable)');
         case 'not_reported':
             return ('not reported by this engine — the capability position needs a newer engine; this says ' +
                 'nothing about whether a protected-name table is in effect (an absent seat is the engine ' +