@sema-agent/client-core 0.77.0 → 0.77.2

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

@@ -1,116 +1,21 @@
-/**
- * ⇄ B3 批搬迁(2026-07-27,多端改造设计稿 §3 B3):cli src/seam/adapter/downstream/turnUsageToModelUsage.ts
- * **逐字整搬**(闭包 2 文件)。名字映射是 load-bearing 的,一个字节都别动。
- */
-/**
- * CS-7 §2.7 (08 CS-7 / UC-1): `turn_end.usage` → CC `ModelUsage`, with the
- * PINNED, load-bearing name mapping. Micro-USD is the wire unit.
- *
- *   inputTokens       → inputTokens
- *   outputTokens      → outputTokens
- *   cacheReadTokens   → cacheReadInputTokens      (rename is load-bearing)
- *   cacheWriteTokens  → cacheCreationInputTokens  (rename is load-bearing)
- *   costMicroUsd      → costUSD  (= costMicroUsd / 1_000_000)
- *
- * DROPPED (no wire datum): `webSearchRequests`, `contextWindow`,
- * `maxOutputTokens` — the missing `contextWindow` denominator is mock-fill from
- * a static per-model table (contract 02 §2.7 VERIFY). Defaulted to 0 to satisfy
- * the CC `ModelUsage` shape without inventing a number.
- * 🔴 0.66.0 / D-2:这三格里的 `webSearchRequests` 现在**开集宽读**(读得出就是真账),读不出时
- * 值仍 0 但同行立 `_sema_web_search_requests_absent` —— 「这一格是 0」与「这一格没有账」在
- * CC 形上此前不可分。另两格维持 0 且**不立判别位**,理由见 {@link SemaModelUsage} 的该位注释。
- *
- * core 3.0.0 语义翻转注(2026-08-02,[2318] 提货):wire 的 `inputTokens` 从「含 cache 总量」
- * 翻为「归一化未命中分量(cache-MISS)」。本映射**一个字节没动**,但语义上恰好从错变对 ——
- * CC `ModelUsage.inputTokens` 的本义就是不含 cache 的 input_tokens(Anthropic API 同义),
- * 旧协议下这里灌总量其实是跨层同名不同义病([C7] 家族)。总量(含 cache)自 3.0.0 起走
- * `totalInputTokens`,在本文件的 CC 镜像里**没有座位**(CC 形状不承载非 CC 语义,[2295]),
- * 消费方要总量请走逐字通道 {@link EngineTurnUsage}(runStream `engineUsage` 键)。
- */
 import type { AgentEvent } from '@sema-agent/sdk';
 import type { ModelUsage } from '../types.js';
-/**
- * 引擎 `turn_end.usage` 的**逐字原形**(SDK 3.0.0 六键全必填,含 `totalInputTokens`)。
- * [2295] 裁 ②(2026-08-02):sema 自有 usage 通道逐字透传这个对象,不做再策展的子集映射 ——
- * 这次断链的根因就是「中间层五键定型丢多余键」。导出类型 = 通道的契约面(runStream 折叠点
- * 的 `engineUsage` 键与宿主消费端同用这一个名字)。
- */
 export type EngineTurnUsage = NonNullable<Extract<AgentEvent, {
     type: 'turn_end';
 }>['usage']>;
 type TurnUsage = EngineTurnUsage;
-/**
- * 引擎侧 usage 的**读形**(wire 名,全可选)—— `toCcModelUsage` 的入参。
- * 全可选是有理由的:本形状同时承接三种来源(`turn_end.usage` 六键必填 / `stats.modelUsage`
- * 开集 map 里的一行 / 扁平 `TaskStats` 折出来的当前模型行),后两者的键在旧引擎上真的会缺席。
- * 缺席语义 = **该量在 wire 上没有**,统一折 0(CC `ModelUsage` 的形状不承载 `null`);
- * 非有限值(NaN/Infinity)同样折 0 —— 见 {@link toCcModelUsage} 头注。
- */
 export interface EngineUsageLike {
     readonly inputTokens?: number | undefined;
     readonly outputTokens?: number | undefined;
     readonly cacheReadTokens?: number | undefined;
     readonly cacheWriteTokens?: number | undefined;
     readonly costMicroUsd?: number | undefined;
-    /**
-     * D-2 / L-192②(0.66.0):CC 同名格的宽读位。今天 wire 上**没有**任何一条腿发它
-     * (core 的 `TaskStats` / per-model 行都没有这一格)⇒ 恒缺席、镜像上的 `webSearchRequests`
-     * 恒 0 + 判别位;开集读是为了上游真发那天**照读**而不是继续硬编(退出条件在门里)。
-     */
     readonly webSearchRequests?: number | undefined;
 }
-/**
- * B-073 ②(0.65.0)—— CC `ModelUsage` 的 sema 超集形:多一个**成本缺席判别位**。
- *
- * 🔴 **为什么这一位必须长在 CC 镜像上,而 `totalInputTokens` 不可以**(与本文件头注引的 [2295]
- *    「CC 形状不承载非 CC 语义」**不矛盾**,差别有出处,写在这里免得下一棒读成漂移):
- *    · `totalInputTokens` 有**另一条逐字通道**(`EngineTurnUsage` / runStream 的 `engineUsage` 键),
- *      要总量的消费面去那儿取即可 ⇒ 镜像不必长第二个座位;
- *    · **成本缺席没有任何别的载体**:CC 的 `costUSD` 型面上是**必填 number**,「这笔花销没定价」
- *      在 CC 形里**根本不可表达**。不加这一位,唯一的写法就是 `costUSD: 0` —— 那正是 core 逐字
- *      禁止的 `a fabricated 0`(它把「没有价表」和「声明免费」两件事折成同一个字节)。
- * 🔴 **两键合读**,这一位单独没有意义:
- *    · `costUSD === 0` 且本位**缺席** ⇒ 引擎显式报了 0 = **声明免费**;
- *    · `costUSD === 0` 且本位 `true` ⇒ 引擎**没报** = 没定价,这一行的账**不知道**,别进总计。
- *    只读 `costUSD` 的旧消费者行为**逐字不变**(它仍是那个 0)—— 这是 additive 的全部含义。
- * 🔴 **只在缺席时铸,绝不铸 `false`**(本包 additive 一贯纪律:诚实缺席 = 键不在场;
- *    「键在值假」会让消费端以为这是一个三态位)。
- */
 export type SemaModelUsage = ModelUsage & {
-    /** 在场且为 `true` ⇒ 这一行的 `costUSD: 0` 是「**没定价**」,不是「免费」。 */
     readonly _sema_cost_absent?: true;
-    /**
-     * D-2 / L-192②(0.66.0)—— 在场且为 `true` ⇒ 这一行的 `webSearchRequests: 0` 是
-     * 「**wire 上没有这本账**」,不是「这一轮一次网搜都没做」。与 `_sema_cost_absent` 同一条
-     * 两键合读纪律;同形第二处在终帧的扁平 usage(`SemaFlatUsage`),两处一个规矩。
-     * 🔴 `contextWindow` / `maxOutputTokens` 那两格**刻意不给判别位**:它们是**模型的静态元数据**
-     * 而不是这一轮的账,权威来源是模型目录(`/v1/models[].contextWindow`),不是 usage 面;
-     * 给它们立位会把「去目录里取」误导成「等 usage 面补上」(登记见 INTEGRATION §31d)。
-     */
     readonly _sema_web_search_requests_absent?: true;
 };
-/**
- * 🔴 **CC `ModelUsage` 八键形状的唯一 mint 点**(REF-CC-062 / xlate-08,E1 单源构造)。
- *
- * 收编前本仓有四个构造点(本文件 + `terminalToSdkResult` 的 `mapModelUsage`、合成当前模型行、
- * `failedToSdkResult` 内联零 usage),四份各写一遍同一套 load-bearing 改名,而 core 3.0.0 的
- * 语义翻转注只挂在其中一处 —— 「同名不同义」在这种分裂下没有任何一层拦得住([2292] 的 cli HUD
- * 双算 cache 就是这一族)。收编后:名字映射与语义注都只有这一份。
- *
- * 名字映射(**load-bearing,一个字节都别动**):
- *   inputTokens      → inputTokens
- *   outputTokens     → outputTokens
- *   cacheReadTokens  → cacheReadInputTokens
- *   cacheWriteTokens → cacheCreationInputTokens
- *   costMicroUsd     → costUSD(/1e6;micro-USD 是 wire 单位,字段名即单位)
- *   webSearchRequests→ webSearchRequests(0.66.0 / D-2 起开集宽读;读不出 ⇒ 0 + 判别位)
- * DROPPED(wire 无此数,填 0 而不是编一个):contextWindow / maxOutputTokens。
- *
- * 收编时的**一处语义统一**(REF-CC-062,记在这里以免被读成无意的漂移):cost 的换算此前两份
- * 写法不同 —— 本文件是裸 `/1e6`(非有限值原样传播出 Infinity/NaN),`terminalToSdkResult` 是
- * `microUsdToUsd() ?? 0`(非有限即 0)。统一取后者:Infinity 会被下游当成真数字参与求和,把一条
- * 离谱账静默摊进总计,比 0 更糟(与 SDK `taskCostMicroUsd()` 的规约同义)。
- */
 export declare function toCcModelUsage(raw: EngineUsageLike): SemaModelUsage;
 export declare function turnUsageToModelUsage(usage: TurnUsage): SemaModelUsage;
 export {};

package/dist/adapter/downstream/turnUsageToModelUsage.js

@@ -1,36 +1,8 @@
-/** wire 数值 → CC 形状里的数值:非数/非有限一律 0(Infinity 会被当真数字摊进总计,比 0 更糟)。 */
 function finiteOrZero(v) {
     return typeof v === 'number' && Number.isFinite(v) ? v : 0;
 }
-/**
- * 🔴 **CC `ModelUsage` 八键形状的唯一 mint 点**(REF-CC-062 / xlate-08,E1 单源构造)。
- *
- * 收编前本仓有四个构造点(本文件 + `terminalToSdkResult` 的 `mapModelUsage`、合成当前模型行、
- * `failedToSdkResult` 内联零 usage),四份各写一遍同一套 load-bearing 改名,而 core 3.0.0 的
- * 语义翻转注只挂在其中一处 —— 「同名不同义」在这种分裂下没有任何一层拦得住([2292] 的 cli HUD
- * 双算 cache 就是这一族)。收编后:名字映射与语义注都只有这一份。
- *
- * 名字映射(**load-bearing,一个字节都别动**):
- *   inputTokens      → inputTokens
- *   outputTokens     → outputTokens
- *   cacheReadTokens  → cacheReadInputTokens
- *   cacheWriteTokens → cacheCreationInputTokens
- *   costMicroUsd     → costUSD(/1e6;micro-USD 是 wire 单位,字段名即单位)
- *   webSearchRequests→ webSearchRequests(0.66.0 / D-2 起开集宽读;读不出 ⇒ 0 + 判别位)
- * DROPPED(wire 无此数,填 0 而不是编一个):contextWindow / maxOutputTokens。
- *
- * 收编时的**一处语义统一**(REF-CC-062,记在这里以免被读成无意的漂移):cost 的换算此前两份
- * 写法不同 —— 本文件是裸 `/1e6`(非有限值原样传播出 Infinity/NaN),`terminalToSdkResult` 是
- * `microUsdToUsd() ?? 0`(非有限即 0)。统一取后者:Infinity 会被下游当成真数字参与求和,把一条
- * 离谱账静默摊进总计,比 0 更糟(与 SDK `taskCostMicroUsd()` 的规约同义)。
- */
 export function toCcModelUsage(raw) {
-    // B-073 ②:成本这一格与其余七格**判据不同** —— 其余格的缺席在 wire 上与真 0 同义(token 计数
-    // 没报就是没花),而成本的缺席是 core **刻意**造出来的一档语义(`ABSENT when any spend was
-    // unpriced … rather than a fabricated 0`)。故这里单独判一次,而不是继续走 `finiteOrZero`。
     const costPriced = typeof raw.costMicroUsd === 'number' && Number.isFinite(raw.costMicroUsd);
-    // D-2 / L-192②(0.66.0):`webSearchRequests` 与成本那一格同族 —— 修前是**字面量 0**,
-    // 把「wire 上没有这本账」渲成「做了零次」。值仍留 0(CC 形必填 number),判别位说真话。
     const webSearchKnown = typeof raw.webSearchRequests === 'number' && Number.isFinite(raw.webSearchRequests);
     return {
         inputTokens: finiteOrZero(raw.inputTokens),
@@ -38,10 +10,9 @@ export function toCcModelUsage(raw) {
         cacheReadInputTokens: finiteOrZero(raw.cacheReadTokens),
         cacheCreationInputTokens: finiteOrZero(raw.cacheWriteTokens),
         webSearchRequests: webSearchKnown ? raw.webSearchRequests : 0,
-        // CC 形不破:值仍是 number。「不知道」由同行的判别位说,见 {@link SemaModelUsage}。
         costUSD: costPriced ? raw.costMicroUsd / 1_000_000 : 0,
-        contextWindow: 0, // dropped on the wire → mock-fill (static per-model table)
-        maxOutputTokens: 0, // dropped on the wire → mock-fill
+        contextWindow: 0,
+        maxOutputTokens: 0,
         ...(costPriced ? {} : { _sema_cost_absent: true }),
         ...(webSearchKnown ? {} : { _sema_web_search_requests_absent: true }),
     };

package/dist/adapter/runStream.d.ts

@@ -1,244 +1,38 @@
-/**
- * ⇄ B3 批搬迁(2026-07-27,多端改造设计稿 §3 B3 / §2.5 末行):cli `src/seam/adapter/runStream.ts`
- * 整文件搬入。**这个文件是本批的主角** —— 搬迁前它的传递闭包是 **1,571 个文件 / 26 种 Node 内建 /
- * 412 个 react 文件**(实测,设计稿 §5.2 表),整棵 CC 树都在里面;搬迁后是 5 个文件、零 Node
- * 内建、零 react。根因链只有三跳,两条外向边(REF-CC-063 同款:原文是两个裸行号锚,已改符号锚):
- *   · 终帧前的 plan-review park 臂 `await import('../../sema/planReviewWire.js')` → 该模块的
- *     `utils/debug` 值级 import → 整棵树;
- *   · turn_end 折叠点的 `void import('../../sema/lastTurnUsageStore.js')`(闭包本身干净,但同样
- *     是壳内向的边)。
- * 本批把这两条边改成 **chrome 事件**(`plan_review_park` / `last_turn_usage`,见 seam.ts 臂注释),
- * 由宿主注入 `ctx.emitChrome` 消费 —— 库侧再也不 import 壳。
- *
- * 🔴 **时序逐点对齐**(搬迁不许顺手改语义):cli 原本 `await` 的那一处(plan_review park,终帧
- * 之前)这里照样 `await`;原本 fire-and-forget 的那一处(last turn usage)照样不 await。
- *
- * ── 以下为原文件头(逐字保留)────────────────────────────────────────────────────────────────
- * Stream driver (T24, slice): consume an `AgentEvent` async-iterable (the SDK's
- * `runs.events` durable generator OR `tasks.stream` live generator — both yield
- * `AsyncIterable<AgentEvent>`) and re-emit the renderable CC `SDKMessage`
- * sequence (contract 02 §1.1/§7; 08 CS-12/IH-3).
- *
- * Responsibilities for the slice:
- *  - event-id idempotency: a replayed durable `id:` (resume / 416 full-sync)
- *    is deduped so no SDKMessage is double-rendered (contract 02 §1.1, sse.ts:5-6);
- *  - pipe each non-terminal arm through `eventToSdkMessage`;
- *  - fold `turn_end.usage` into the latest-usage handle (no standalone arm);
- *  - project the terminal `done`/`failed` via `terminalToSdkResult`, then END
- *    the generator (mirrors sse.ts:62 / tasks.ts:52).
- *
- * The SDK owns resume/416 INTERNALLY (sse.ts) — this driver only consumes the
- * already-normalized AgentEvent iterable and guards against re-seen ids.
- */
 import type { AgentEvent } from '@sema-agent/sdk';
 import { type SDKMessage, type EmitContext, type ModelUsage } from './types.js';
 import { type EngineTurnUsage } from './downstream/turnUsageToModelUsage.js';
-/**
- * 409 body 的 pendingGate 材料(A-028.1,2026-08-12 具名化并补 `governanceForced` 位 ——
- * 此前包侧只有 {kind, decidePath} 两位,壳侧抄件已多出该位 = 同一 wire 位两份解析器形不同,
- * 以超集形归一进包)。
- */
 export interface ActiveRunPendingGate {
-    /** 在等哪一种门;引擎对未知 kind 自己返 null。 */
     readonly kind: string | null;
-    /** 兑现那个决定的**真路由**(wire 给的,消费方绝不按 kind 硬编码一张表)。 */
     readonly decidePath: string | null;
-    /**
-     * 这道门的**出身**是运维治理层(AUTONOMY / commandPolicy / 守卫集)强制的
-     * (server ≥7.12 / SDK 6.15.0 `PendingGateMaterial`,ADDITIVE)。
-     * 🔴 **只在为真时在场,server 恒不写 false**;缺席 ≠「这不是治理门」,只是「没有治理来源的
-     * 证据」。消费方只做**在场才说**的加法:纯归因一句,不参与任何分诊/动作。
-     */
     readonly governanceForced?: true;
-    /**
-     * 这道 park 门的**非秘密稳定身份**(#285 件2,0.36.0;server ≥7.33.0 `PendingGateMaterial.checkpointId`
-     * / core 5.42.0 `Checkpoint.checkpointId`,`mintCheckpointId` 铸 = `cp_`+uuid)。逐字过境,本层零加工。
-     *
-     * 🔴 **它补的是一个真实的空洞**:park 门此前在 wire 上**没有任何稳定身份** —— 唯一单射的键是
-     * `token`,而 token 是秘密能力、永不上 wire,于是消费端只能拿 `(sessionId, kind)` 这种非单射组合
-     * 去猜「这次的门」和「上次的门」是不是同一道。本键是为此存在的非秘密孪生身份(identification vs
-     * capability,两条独立的轴;**独立铸造,不是 token 摘要**)。
-     *
-     * 🔴 **缺席是三成因合流的一个形**(server 逐条成文,别只记第一条):① 该键诞生前 park 的 legacy 行;
-     * ② 行上有值但没过 server 的信任边界校验(空串/超长/**含 token**)⇒ 数据污染,而它在运维面上
-     * 与 ① **不可分辨**(server 自己登记的残留);③ 整只 `pendingGate` 读取失败(那时本键连位置都没有)。
-     * ⇒ 读作「**不知道这道门叫什么**」,**不是**「这道门没有身份」,更**不是**「这一定是条老行」。
-     *
-     * 🔴 **不是跨调用的稳定去重键**(逐条出自 server 侧 `PendingGateMaterial.checkpointId` 的顶注 ——
-     * 那段是上游自己的对抗复审验真后如实登记的,不是本包的推测):
-     * 同 session 可并存两条 pending checkpoint(表上**没有** per-session 唯一约束),
-     * 而 server 选行是**无序 `LIMIT 1`** ⇒ 同一情形连续两次 409 完全可能报出**不同**的 id(选中了另一行),
-     * 也可能 id 不变而 `activeTaskId` 已换。本材料的**每一格**(kind/decidePath/governanceForced/本键)
-     * 共享这条归属不确定性,本键是**继承**它、不是引入它。
-     * ⇒ 可安全用于:落日志/排障关联,以及 {@link pendingGateIsProvablyDifferent} 那个**单向**判断。
-     * **不可**用于:跨 turn 的卡去重键、「id 相同 ⇒ 同一道门」的反向推理。
-     *
-     * ⚠️ **辖域如实**:上游本批只把这一位投到**这一个载体**(409 `conflict.session_active_run` 体 +
-     * 其 SSE done 帧)。另外三条 park 读面(`/v1/assistant/inbox`、`GET /v1/approvals`、
-     * `/v1/approvals/stream`)今天**都没有**这一格,且补它们的代价不同(后两条要给 checkpoint 表反范式
-     * 一列 = SQL 面双库门)。⇒ **别在消费码里预支「两面能对上」** —— 拿本键去 join durable 队列行必然
-     * 落空,而落空与 legacy 行同形。
-     */
     readonly checkpointId?: string;
 }
-/**
- * `pendingGate` 的**单向**同一性判断(#285 件2,0.36.0):「我现在看到的这道门,能不能**证明**它
- * 不是刚才那一道?」
- *
- * `true` ⇔ 两侧都带 {@link ActiveRunPendingGate.checkpointId} **且**两者不等。其余一律 `false`。
- *
- * 🔴 **`false` 的语义是「证不出」,不是「同一道门」** —— 这不是措辞洁癖,是上游写死的可用性边界:
- * server 选行是无序 `LIMIT 1` 且同 session 可并存多条 pending 行,所以「id 相同」推不出「同一道门」
- * (id 不变而 `activeTaskId` 已换是成文的可能形),「id 缺席」更只是「不知道它叫什么」(三成因合流)。
- * 上游明确只背书**这一个方向**:「id 变了 ⇒ 我看到的确实不是刚才那一行」。
- *
- * 🔴 **为什么归包而不是让三端各写一遍**:这个谓词的价值全在**它拒绝回答的那一半**。三端各自手搓时,
- * 「两个 id 相等就当同一张卡去重」是最自然、也最容易写出来的一行 —— 而它恰恰是上游明说买不到的那个
- * 方向,写出来就是一条按错误前提去重的卡链。把可答的那半做成唯一入口,不可答的那半就没有顺手的写法。
- *
- * ⚠️ 它**不做**任何 kind/decidePath 比较:那两位回答的是「哪种门/去哪决议」,与「是不是同一行」正交
- * (同一行的 kind 不会变,不同行的 kind 完全可能相同)。要判种类变化请直接读 `kind`。
- */
 export declare function pendingGateIsProvablyDifferent(prev: ActiveRunPendingGate | null | undefined, next: ActiveRunPendingGate | null | undefined): boolean;
-/** #114/[C65] 单源化:三端共用的 409 active-run 拒收终帧判别(富信号形,包级唯一权威)。
- *  🔧 2026-08-02 事实纠正([C77]③):原文写的是「与壳/desktop **各自**照抄件同义……各端换包
- *  导入删本地抄件」,而 desktop 全树扫描(`activeRunBusySignal` / `session_active_run` /
- *  `activeTaskId` 的 409 判别族)**零命中** —— 那边根本没有抄件,「各端」是句不实的话。
- *  删掉不实的那半:今天的抄件只有壳一份。
- *  🔧 A-028.1(2026-08-12):抄件漂移收口 —— 壳侧那份的 pendingGate 已多出 `governanceForced`
- *  位,本形按超集归一(见 {@link ActiveRunPendingGate});分诊树/结局文案层同批落
- *  `adapter/activeRunSelfHeal.ts`,壳侧换包导入在提货批。 */
 export interface ActiveRunBusySignal {
-    /** 占锁 run 的 id;wire 没带 ⇒ null(诚实缺席,绝不铸造)。 */
     readonly activeTaskId: string | null;
-    /** server 3.21+ 真发的占锁 run 状态;缺席 ⇒ null(由调用方走 runs.get 一级)。
-     *  🔴 [4664] 成文的可信度边界(2026-08-19,四个洞逐条在案):park 态不在 reapStale 射程 /
-     *  `updated_at` 误杀窗 / 409 与 poll 口径短暂相左 / LOCAL(file)车道无周期自愈腿 ——
-     *  **别把这一位的 `running` 当绝对真值**;SQL 车道死 run 的自愈上界 ≈180s(心跳 30s +
-     *  REAP_RUN_STALE_SEC 120 + tick 60),LOCAL 车道**无上界**。消费方出卡前的存活对账腿见
-     *  `activeRunSelfHeal.runningChoiceArm`。 */
     readonly activeTaskStatus: string | null;
-    /** 409 body 的 pendingGate(wire 给的真路由,不自造);缺席 ⇒ null。 */
     readonly pendingGate: ActiveRunPendingGate | null;
-    /**
-     * 409 体上的占锁 run **最近活动距今毫秒数**(Inkglow-1085 P0b,[4664]:这一格是 409 体内唯一
-     * 可消费的活性证据位)。在场 = 有限非负数;缺席 = 老 server / 坏形(两者同形,不猜)——
-     * **缺席 ≠「没有活动」**。展示判别位:端据此渲「该 run 已 N 分钟无活动」类提示;
-     * 不参与本包的分诊动作(存活对账腿的判据仍是 runs.get 读回的状态词)。
-     * ⚠️ 结构视图读(SDK 7.2.0 类型面尚无此键)—— probeCause 同款「领先锚」姿势,锚补上跟批。
-     */
     readonly msSinceLastActivity?: number;
 }
-/**
- * 判别一个**原始 AgentEvent** 是不是 409 active-run 拒收终帧;非 busy ⇒ null。
- * 判据=结构两腿(canonical `errorCode` 优先 → `activeTaskId` 在场);人话文案腿已随 #117 提货
- * 退役(§B8 禁按错误文案判别)。两种 wire 真形:
- *   ① `done{result:{status:'failed', errorCode|activeTaskId,…}}`(交互 tasks/stream 腿,409 骑终帧);
- *   ② `failed{errorCode|activeTaskId,…}`(任何把它投影成 failed 臂的上游形)。
- */
 export declare function activeRunBusySignal(ev: unknown): ActiveRunBusySignal | null;
-/**
- * 中性终态行的前缀。**刻意不是 `API Error`** —— 这一行说的是「这条 run 被本部署的治理旋钮停了」
- * (轮数/预算/墙钟/token 到限、结构化输出重试耗尽),不是 provider 或 HTTP 层出了故障。
- *
- * 事故形(台账 api C1/C2 逐坐标坐实):`sema -p --max-turns N` 的 STDERR 逐字是
- * `API Error: max turns exceeded`,交互面同一构造点也渲成红色「API 错误」行。用户读到 API Error
- * 会去查网络/密钥/额度,而真正的把手是他自己传的 `--max-turns`。CC 对同一件事写的是
- * `Error: Reached max turns (N)` —— 一个字的 `API` 都没有,本前缀与那条身份声明同向。
- */
 export declare const RUN_STOPPED_MESSAGE_PREFIX = "Run stopped";
-/** blocked 终态自带的前缀(`Run blocked: <reason>`,见 errText 构造)。 */
 export declare const RUN_BLOCKED_MESSAGE_PREFIX = "Run blocked";
-/**
- * 这条终态行是不是「治理/契约终态」而非 provider 故障 —— 渲染层据此给中性行同样的错误行 chrome
- * (它仍然是一条终态错误行,只是**身份**不是 API 错误),而不必按前缀猜。
- *
- * 🔴 与产出侧同一个真源:产出在 {@link runStream} 的 governance 臂,判别在这里,端只 import。
- * 各写一份正则必漂(记忆 `machine-readable-signal-not-visual-anchor`)。
- */
 export declare function isGovernanceStopRowText(text: string): boolean;
-/**
- * 第二条中性臂的前缀(0.72.8 CC-43;cli L-372 ③ 包侧正位):**模型这一轮的输出**坏了 —— core 三个 brain
- * (anthropic / openai / open-responses)把 `tool_use` 参数不是合法 JSON(最常见成因 = 输出被 max_tokens
- * 截断在参数中间)/ tool call 没带工具名 收成一句错误、run 以 `done{status:'failed', errorMessage}` 收口。
- * 这一族**没有一个 provider 请求失败过**:渲成 `API Error:` 把人指去查网络 / key / 配额,而该做的是调小请求、
- * 抬 output cap 或换个说法重问。与治理臂同律:身份换,行类旗(`isApiErrorMessage`)不换。
- */
 export declare const MODEL_OUTPUT_ERROR_PREFIX = "Model output error";
-/**
- * 这条终态错误文本是不是「模型输出问题」(⇒ 中性行 `Model output error:`)。
- * 🔴 **只锚 core 原句的共同前缀,不做模糊匹配**:三个 brain 各带各的终止原因字段名(`stop_reason` /
- *    `finish_reason` / `status`)⇒ 只锚括号前那一段;`JSON` / `not valid` 这类词在别的错误里到处都是,放宽一个字
- *    就会把真的传输 / 服务端错误改渲成「模型输出问题」—— 方向相反、代价一样大。core 换句子 ⇒ 本锚当场失效 ⇒
- *    行回落 `API Error:`(开集兜底,不误报)。两句锚 = 同一铸点的两个分支(参数非 JSON / 无工具名),brain 用 ` | ` 连。
- */
 export declare function isModelOutputErrorText(text: string): boolean;
-/** 这一行是不是「模型输出问题」行(渲染面 / 归约面的谓词;与铸点同源,端别自抄前缀字面)。与 {@link isGovernanceStopRowText} 互斥。 */
 export declare function isModelOutputErrorRowText(text: string): boolean;
-/**
- * 0.72.12 CC-50:第三条中性终局行身份 —— **结局不知道**(done 帧无终态记录 / 认不出的终态词)。
- * 三端渲染面按行首认它(与 `Model output error:` / `Run stopped:` 同律);它不是 API 错误、不是失败判决,
- * 是「别把这次结果当已验证」。铸点单源在 runStream 终局臂(读结果帧 `_sema_outcome`)。
- */
 export declare const OUTCOME_UNKNOWN_ROW_PREFIX = "Outcome unknown";
-/** 这一行是不是「结局不知道」终局行(只认行首)。 */
 export declare function isOutcomeUnknownRowText(text: string): boolean;
-/**
- * 终态是不是治理/契约面的(⇒ 中性行),而不是 provider/HTTP 面的(⇒ 保留 `API Error:`)。
- *
- * 🔴 **开集纪律**:只有**认得出**的治理码才走中性臂;认不出的码一律落回 `API Error:` 原臂
- * (原样透传引擎的话)。反过来做 = 替引擎断言「这不是 API 错误」,而那正是本修在骂的那类错档。
- *
- * 成员:
- *  · `status:'blocked'`(ReportBlocked 契约终态 —— agent 自己说它无法继续,零 provider 参与);
- *  · `limits.*` 全族(开集前缀,{@link isLimitsExceededCode});
- *  · `output.invalid`(结构化输出重试耗尽 —— CC 自己也有专门 subtype,同样不叫 API 错误)。
- */
 export declare function isGovernanceTerminal(input: {
     status: string | undefined;
     errorCode: string | undefined;
 }): boolean;
-/** 🔴 **按自有属性查表**(本仓对措辞表的既定纪律):`Object.freeze` 不移除原型,裸下标会让一个
- *  叫 `constructor` / `toString` 的判词命中 `Object.prototype` 上的**函数**并被拼进日志行。 */
-/**
- * CC-13(0.69.2)**出公面**:一条丢帧判词(`why` 开集进、缺省句兜底)。此前只在 console 兜底腿拼进日志,
- * `ctx.onDroppedFrame` 只收 `{ type, why }` ⇒ 自渲运维面的端只能手抄本表。现在载荷同时带 `sentence`,
- * 本函数给宿主在别处(存量留痕 / 别的 why 来源)复用同一份措辞。
- */
 export declare function droppedWhySentence(why: string): string;
-/** 测试钩:清空「已上报过的臂」去重表(去重是**跨调用**状态,不清就只有第一条用例看得见)。 */
 export declare function _resetDroppedFrameReportForTest(): void;
-/** 测试钩:去重表当前条数 —— ADAPTER-F5 的上限断言要读的**决定结果的量**(行数只证「吼了几次」,
- *  证不了「表有没有涨」;两者在到顶之后恰好分道扬镳,所以必须直接读表)。 */
 export declare function _droppedFrameMemoSizeForTest(): number;
 export interface RunStreamHandle {
-    /**
-     * The latest folded turn usage (footer counters).
-     *
-     * 🔴 **0.68.0 收窄成「最近一次**已测量**的 turn」**(core 7.17.0 #711 的跟车修;异源对抗复审实抓):
-     *    #711 之后,一轮没量出账时引擎发的是**六个 0 + `usageMissing:true`**(不再是「不发 usage」)。
-     *    修前这里是无条件覆盖 ⇒ 那种轮会把一份**占位全零**盖进来,而本形上**没有任何判别位** ——
-     *    只吃这个出口的 footer 于是把「不知道」渲成一笔精确的零账(消息臂与 chrome 臂上的判别位
-     *    保护不到这个出口)。⇒ 未测量的那一轮**不覆盖**(保留上一次真读数,与 #711 之前的行为逐字
-     *    相同),并由 {@link latestUsageMissing} 说出「最新那一轮没测出账」。
-     */
     latestUsage?: ModelUsage;
-    /**
-     * [2295] 裁 ② 逐字通道:与 latestUsage 同拍更新的引擎 `turn_end.usage` **原形**(六键含
-     * `totalInputTokens`)。镜像键求和≠总量(仅 cache 族一致时相等),总量消费面吃这份。
-     * 旧引擎(core <3.0.0)wire 缺形时为 undefined —— 诚实缺席,不造零值。
-     * 🔴 0.68.0:与 {@link latestUsage} **同拍同律** —— 未测量的轮不覆盖。
-     */
     latestEngineUsage?: EngineTurnUsage | undefined;
-    /**
-     * 🔴 0.68.0 —— **最新那一轮的账知不知道**。在场(恒 `true`)= 最近走过的那个 `turn_end`
-     * **没测出账**(`usageMissing:true`),或者它是一条**契约违约**帧(连 usage 都没有);
-     * 此时上面两份读数属于**更早的**那一轮,别当成最新那一轮的账。
-     *
-     * 🔴 **never false**:测量到账的那一轮**把这一位删掉**(键不在场 ⇔ 上面两份就是最新那一轮的账)。
-     *    它是**逐轮**的判别位,不是「这条流上曾经有过缺口」的单调位 —— 后者在终帧上
-     *    (`_sema_usage_lower_bound`),两者答的是两个问题。
-     */
     latestUsageMissing?: true;
 }
 export declare function isRunStreamActive(): boolean;