@sema-agent/client-core 0.77.0 → 0.77.2

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

@@ -1,97 +1,9 @@
-/**
- * ⇄ B3 批搬迁(2026-07-27,多端改造设计稿 §3 B3):cli src/seam/adapter/downstream/eventToSdkMessage.ts
- * **逐字整搬**(闭包实测 5 文件 / 零 Node 内建 / 零 react —— 本来就可移植,一个 import 都不用改)。
- */
-/**
- * DOWNSTREAM projector (T22): `AgentEvent` → CC `SDKMessage` arms, the contract
- * 02 §6 translation table run FORWARD, for the thin slice.
- *
- * Handled arms (contract 02 §2 / 08 CS-1..CS-7, CS-10, CS-11):
- *   reasoning      → assistant (thinking block)            §2.1 / CS-3
- *   text           → assistant (text block)               §2.2 / CS-1
- *   reasoning_delta→ stream_event (thinking_delta)         §2.3 / CS-4
- *   text_delta     → stream_event (text_delta)             §2.4 / CS-2
- *   tool_start     → assistant (tool_use block)            §2.5 / CS-5
- *   tool_end       → (internal) tool_use_result arm carrying the §E1 wire output  §2.6 / CS-6
- *   turn_end       → (folded into the terminal/usage rollup; no standalone arm)
- *   compacted      → system / compact_boundary             §2.8 / CS-8
- *   status         → (internal) retry_status arm (BrainStatus liveness → spinner row)  §E3/§E10
- *   done           → result / success                      §2.10 / CS-10
- *   failed         → result / error                        §2.11 / CS-11
- *
- * Leak guards (contract 02 §5): the `message`/`event` fields are CC's opaque
- * `z.unknown()` placeholders. We populate them with NEUTRAL, CC-native content
- * blocks the renderer reads — NEVER the raw Anthropic `APIAssistantMessage`
- * block array or `RawMessageStreamEvent` wire, never `signature`/
- * `redacted_thinking`/`signature_delta`.
- *
- * §E1 update (was STALE): `tool_end` DOES carry the model-facing `output` (the
- * action-card BODY) on the wire now (events.d.ts:75-86). We carry it through —
- * but NOT as a raw Anthropic `tool_result` wire block: a NEUTRAL internal arm
- * `{type:'tool_end_result', toolCallId, isError, output, truncated, eventId}` the
- * upstream bridge correlates to the open card by `toolCallId`. The output is
- * 🔴 UNTRUSTED / OBSERVABILITY-ONLY (events.d.ts:80-85): render it, never re-feed
- * a truncated body to a model.
- */
 import type { AgentEvent, CheckpointGate } from '@sema-agent/sdk';
 import { type SDKMessage, type EmitContext, type ModelUsage } from '../types.js';
 import { type McpLivenessView } from '../../mcpLiveness.js';
-/**
- * 本适配器铸出的**内部臂** `type` 全集(A-004.4 上游半场,2026-08-08)——「内部臂」= 桥面
- * (bridge-facing)消息,**不是** CC SDK stdout 联合体里的帧形(那些是 assistant/stream_event/
- * system 等真帧)。消费方(壳 REPL 桥、`-p` print 出口、web/desktop 座位层)对内部臂只有两种
- * 合法处置:**吞**(不外泄)或**转成真 CC 帧**;顺着兜底裸透传到 stdout/wire = 病族⑥投影缺口
- * (cli A-004.11/12 实翻:human_input/diagnostics/workspace_changed 曾漏进 `-p` stream-json)。
- *
- * 这张表是**唯一权威源**:消费方的吞/转名单必须对账本表(全覆盖,禁手抄子集——A-004.4 的病形
- * 就是壳手抄了 4 词的子集);本包 pure 门有源码对账腿(armBody 铸点抽取 ≡ 本表),加臂不登记
- * 即红。`turn_usage` 的铸点在 runStream.ts(usage 聚合腿),不在本文件的 switch 里,同属本表。
- */
 export declare const INTERNAL_SDK_ARM_TYPES: ReadonlySet<string>;
-/** 「本切片不投影这条臂」的**如实分类**(REF-CC-058 / xlate-04)。 */
-export type EventProjectionNoneReason = 
-/** `turn_end`:usage 折叠是 run driver 的活(`turnEndUsage`),本层无独立可渲染臂。 */
-'usage_only'
-/** `done`/`failed`:终帧由 `terminalToSdkResult` 投影。 */
- | 'terminal_delegated'
-/** `suspended`:HITL 登记是 run driver 的活(out of slice)。 */
- | 'hitl_out_of_slice'
-/** 已在 SDK union 里、但本切片**有意**不投影的臂(逐条理由见各 case 注释)。 */
- | 'not_in_slice'
-/**
- * 臂在本切片内、帧也不畸形,但**载荷筛完是空的**。两个来源:`suggestions` 全被空白过滤掉、
- * `diagnostics` 的 `files: []`(LSP 的「这一轮没有诊断」正常形,ADAPTER-F6 收平)。
- * 单列一档的理由与 REF-CC-058 本身同源:把它并进 `not_in_slice` 会说「这条臂我们不投影」——
- * 那是假话(我们投影它,只是这一帧没内容);并进 `dropped` 则是把引擎的正常空批诬告成丢帧。
- */
- | 'empty_payload';
-/** 「这条臂我看不懂/嫌它坏,丢了」的**如实分类**(REF-CC-057/058)。 */
-export type EventProjectionDropReason = 
-/** 帧在但必填位畸形(非串 runId / 非数组 files / 空 source …)—— 引擎发了,我们读不动。
- *  ⚠️ 「筛完是空的」不算畸形(那是 `empty_payload`,见上;ADAPTER-F6)。 */
-'malformed'
-/** 类型面根本不认识这条臂(引擎比本包新)。 */
- | 'unknown_arm'
-/**
- * 类型面**认得**这条臂、它也带着用户可见的决策内容,但本包**今天没有任何消费口**
- * (2026-08-08 对抗复审第 4/5 轮命中,首例 = `approval_request`)。
- *
- * 为什么不能并进 `not_in_slice`:那一档的语义是「本切片不投影,**因为别处接了/本来就没有可渲染物**」,
- * 它走 `kind:'none'` —— 而 `none` 是**静默**的,只有 `dropped` 会经 `reportDroppedFrame` 走宿主
- * sink + console 留痕。把一条「有内容、没人接」的帧塞进 `none`,等于把一个真实能力缺口做成静默
- * fail-open(本仓 P0 共性病的同款形)。判据方向:宁可每次都吼一行,也不要缺口无声。
- * 为什么也不能并进 `unknown_arm`:那是假话 —— 我们认得它,缺的是消费链,不是类型。
- */
- | 'unsupported_arm';
-/**
- * 投影结果三态(REF-CC-058 / xlate-04,A1 禁哨兵值双义 + C6 降级必须可分辨)。
- *
- * 收编前返回型是 `SDKMessage | null`,而那个 `null` 在 10 个 return 点上同时承载三种互不相同的
- * 语义:①设计内无可渲染臂;②帧畸形被丢弃;③未知新臂被吞。调用方拿到 null **无法分辨**「本来
- * 就没东西渲」和「引擎发了一帧但我看不懂」—— 本文件历史上所有「帧到了没人读」事故(suggestions
- * 死信、workflow lane 两键被剥)的载体就是这个塌缩。三态命名后,`dropped` 是可被上报的信号,
- * driver 侧据此闭合 REF-CC-057 的下泄口。
- */
+export type EventProjectionNoneReason = 'usage_only' | 'terminal_delegated' | 'hitl_out_of_slice' | 'not_in_slice' | 'empty_payload';
+export type EventProjectionDropReason = 'malformed' | 'unknown_arm' | 'unsupported_arm';
 export type EventProjection = {
     kind: 'message';
     message: SDKMessage;
@@ -103,280 +15,65 @@ export type EventProjection = {
     why: EventProjectionDropReason;
     type: string;
 };
-/**
- * Project one durable/live `AgentEvent` into a typed {@link EventProjection}.
- *
- * `tool_end` projects to a NEUTRAL internal `tool_end_result` arm (NOT a CC
- * SDKMessage the renderer reads) carrying the §E1 wire `output` so the bridge can
- * close the open card with the real body.
- *
- * Terminal `done`/`failed` are delegated to `terminalToSdkResult`.
- *
- * 🔴 BREAKING(REF-CC-058,0.13.0):返回型由 `SDKMessage | null` 改为三态 Result。
- * 迁移判据一句话:`const p = eventToSdkMessage(ev, ctx); if (p.kind === 'message') …` ——
- * 旧写法 `if (msg)` 在新返回型上恒真(对象永远 truthy),所以这是**必须点名**的一类改动。
- */
 export declare function eventToSdkMessage(ev: AgentEvent, ctx: EmitContext): EventProjection;
-/**
- * `engine_notice` → 中性内部通告臂(#310 / #318 件①,契约 = server `ASSISTANT-WIRE-CONTRACT` 附录 D
- * + openapi `Event_engine_notice`)。
- *
- * ── 这是什么 ────────────────────────────────────────────────────────────────────────────────
- * 引擎的**结构化通告**里,被 server 判为面向**本会话终端用户**的那一小撮,按 `sessionId` 路由到
- * 这条会话的流上。live 与 durable **两腿都有**(server 三条 run 腿都挂了口)⇒ 断连重连的重放里
- * 会**再看到它**,与 `workspace_changed` 同一条**幂等消费**纪律(附录 D.1 逐字)。
- *
- * ── 🔴 开集三条(本函数的全部判据,逐条都是「不许做什么」)────────────────────────────────
- *  ① **按 `code` + `detail` 消费,`message` 只作 fallback 展示**。core 明写
- *     `memory.session_polluted` 的 message 随 `memoryProvenance` 模式变文 ⇒ 按 message 文本匹配
- *     **必碎**(5.41 合流码形退役同教训)。所以本层把三者**分别**上臂,绝不把 detail 折进文案。
- *  ② **`code` 是开集,认不得也绝不丢帧**。server 的白名单会随 core 码册增长(起步三码 →
- *     core 5.47/5.48 的 hold 三码入册,附录 D.3 的表尚未跟上)。本层因此**一个码都不硬编**:
- *     没有识别表、没有 switch、没有「已知才投」——认不认得是**渲染面**的判断,不是投影面的门。
- *     ⇒ 本函数对 `code` 唯一的要求是「非空串」(判别键本身缺席才叫畸形)。
- *  ③ **能力位不当两值门**:本臂不读任何 caps、不问「引擎支不支持 engine_notice」。帧到了就投影
- *     (A-022「到帧即服务」先例)—— 拿一个探测位去 gate 一条**已经到手的事实**,只会在探测未判/
- *     失败时把真事实丢掉。
- *
- * ── 🔴 消费端纪律(写在臂上,因为三端各写一遍必漂)────────────────────────────────────────
- *  · `detail` 已过 server 的 `redactSecrets` + 尺寸 bound(自由文本 1000 字符;深 4 / 键 32 /
- *    数组 32),**仍按外部串处理**(呈现面字符处理走消费方自己的单源)。
- *  · `ts` 是 **server 观察时刻**(ms epoch),**不是**引擎铸造时刻 —— `EngineNotice` 自身不带时间戳。
- *  · 🔴 `memory.harvest_quarantined` 的 `moved` 与 `escalated` **不可相减**(就地墓碑同时计入两者,
- *    core 顶注):两个数各自读、并列呈现,任何减法都会得出一个**不存在的量**。本层原样透传 detail
- *    正是为了让这条纪律只在渲染面兑现一次,而不是被投影层先算一个差值出来。
- *  · **本帧的缺席不代表「没发生」**:非白名单码 / 缺 `sessionId` 的通告 server **如实不投**
- *    (宁缺席不串台),全族那一份始终在 server 的结构化日志里(运维面)。所以消费端**绝不许**
- *    从「没收到 engine_notice」反推「记忆姿态正常」。
- *
- * ── 畸形判据(fail-closed 方向)────────────────────────────────────────────────────────────
- * `code` 非串/空串 ⇒ `malformed`(判别键都没有的通告,渲出去只是一行没有主语的噪声,而 dropped
- * 至少会经 `reportDroppedFrame` 留痕)。其余四键**各自**按诚实缺席处理:`message` 非串 ⇒ 空串
- * (fallback 位缺席,渲染面据此走纯 code 呈现)、`detail` 非对象 ⇒ 空对象(**不是**丢帧:通告的
- * 承重物是 code,detail 坏了不该连带把「这件事发生过」一起吞掉)、`sessionId` / `ts` 非法 ⇒ 键不
- * stamp(绝不铸 `0` 这种看起来合法的假读数)。
- */
-/** {@link wiringManifestSupersetBody} 的 `modelGate` 段(core #524 / server S-86 的形)。 */
 export interface WiringManifestModelGate {
-    /** 门的类别词(core 开集,原样透传;例:模型族名)。 */
     class: string;
-    /** 本 run 被门卸掉的工具名(**非空**;空数组不是真读数,见投影函数头注)。 */
     removed: readonly string[];
-    /** 恢复办法的**逐字**提示(core 铸,例:环境变量赋值串)。渲染面原样呈现,不要自己拼。 */
     restore: string;
 }
-/** {@link wiringManifestSupersetBody} 的 `autoMode` 段(core 147③ 的形)。 */
 export interface WiringManifestAutoMode {
     armed: boolean;
-    /** core **六词逐字透传**。🔴 不映射 `/v1/capabilities.permissionModeAuto.reason` —— 见投影函数头注。 */
     reason: string;
-    /**
-     * 0.67.0(core 7.14.0 `AutoModeArmFact.deniedSource`,`wiring-manifest.d.ts:87`)——
-     * **哪一层设置面**的棘轮把 auto 模式关掉了(core `AUTO_MODE_DENY_SOURCES`:`org` / `local` /
-     * `settings`)。解析器**自己的词,原样带过来,从不推断**(合同顶注 `:79-82` 逐字)。
-     *
-     * 🔴 **只在 `reason === "denied"` 旁在场**;`denied` 却没有它 = 那个解析器**不记来源**
-     *    (一句正面事实,不是「不知道」的同义词);`resolver_fault` / `armed` / `no_intent` /
-     *    `no_face` 上**恒不在场**(屏掉一个它拒绝了的来源是 core 自己做的)。
-     * 🔴 **开集读**(与同段 `reason` 逐字同规):词表属主在 core,包在边界抄一份闭集只会在 core
-     *    加词那天把一个合法值判没。端的 `switch` 必须带 `default`。
-     * 🔴 **缺席不铸**:绝不折成空串,更不折成 `"settings"` 这种看起来最像的默认值 —— 那是替引擎
-     *    指认一个它没点名的设置面,而用户会照着去改错的那一层。
-     */
     deniedSource?: string;
 }
-/**
- * {@link wiringManifestSupersetBody} 的 `mcp[]` 一条目(S-124 / core 7.5.0,server ≥7.60.0 的形)。
- *
- * 「我这条腿**申报**的一台 MCP 服务器,连上了没有、挂了是哪一类、挂上来几个工具」。
- *
- * 🔴 **`name` + `status` 是必需两座**(与 server 侧 `wiringManifestEventData` 的 `mcp` 臂同判据:
- *    `if (name === undefined || status === undefined) continue`)—— 一条既没有名字也没有状态的行
- *    渲不出任何有用的话,而**坏一条只丢那一条**,绝不丢整张表(丢整表 = 用户以为「一台都没申报」)。
- * 🔴 **`errorCode` 不是纯闭集**(core 7.6.0 换代:`MCP_FAILURE_CODES` 十词表退役,继任者是
- *    `McpFailureKind` 十词;**`network` 与 `http_<status>` 两种拼法一并作废** —— HTTP 状态从此走
- *    结构位 {@link WiringManifestMcpEntryView.httpStatus},不再编进码里)⇒ 本包**照旧既不枚举那十个词、
- *    也不套形正则**(词的单一属主在 core;抄一份会把 core 加的新词吞成缺席),只判非空串。
- *    消费端按具名词写的 `switch` **必须带 default 臂**。
- * 🔴 **`delivered` 与 `errorCode` 合读才有判别力**(core 7.6.0 S6-B):同一个 `connection_closed`,
- *    `no` 可以直接重试(**可证**什么都没发出去)、`unknown` 必须先去查(请求**可能**已经执行了)。
- *    这条判别力单看码拿不到,所以这一位非透传不可。
- * 🔴 **`error` 自由文本上游就不投,本包更不铸**:它是这条面上唯一的**远端作者自由文本**,server
- *    侧的裁定逐字是「进来会同时破本段『无自由文本 ⇒ 不脱敏』的段内不变量,和 core 把远端 MCP 错误
- *    文本脱敏收敛成**一个**铸点的单铸律」。可操作的因由在 `errorCode`。
- */
 export interface WiringManifestMcpEntryView {
-    /** spec 声明名(引擎产的标识,非用户内容)。 */
     name: string;
-    /** 三词闭集(core 属主;**按开集读**,认不得的词照渲不丢行)。 */
     status: string;
-    /** 声明方自述的层级标签(core 已 single-line + 长度封顶后逐字回显)。缺席 = 没报。 */
     source?: string;
-    /** 失败因由的**机器码**(core 7.6.0 `McpFailureKind` 十词,**按开集读**)。缺席 = 这条没失败,
-     *  或引擎没给码。 */
     errorCode?: string;
-    /** 这台服务器挂上来的工具数(有限数)。缺席 = 没报,**不是** `0`。 */
     toolCount?: number;
-    /**
-     * 请求**到没到**那台服务器(core 7.6.0 S6-B;`yes` / `no` / `unknown`,**按开集读**)。
-     * 🔴 与 {@link errorCode} **合读**(见投影函数顶注)。缺席 = 引擎没给这一位。
-     * ⚠️ `no` 说的是**调用方的工具调用**没发出去,**不**保证「那台服务器一个字节都没收到」。
-     */
     delivered?: string;
-    /**
-     * 端点答的那个 HTTP 状态(core 7.6.0 S6-B),**只**与 `errorCode === "http_status"` 同行
-     * (401/403 去重新授权、5xx 是那头挂了)。
-     * 🔴 **缺席而不是 0**:一个编出来的 `0` 会被读成「服务器答了状态码 0」这句不存在的话。
-     * ⚠️ 本层**不校**「只与 http_status 同行」那条配对:它是 core 的段内规矩,server 已按它铸;
-     *    包再校一遍只会在上游合法演进的当天把一个真读数判没(与 `errorCode` 的开集纪律同规)。
-     */
     httpStatus?: number;
-    /**
-     * 引擎最后一次**活性观察**(CC-36;第六键,引擎侧自 core 7.24.3 / server 7.91.2 起)。判据、词表与
-     * 「缺席 = 没有可用观察记录」那四句话的单一铸点在 {@link readMcpLiveness} 的顶注。
-     * 🔴 **缺席不铸**,且缺席**不是** `unknown`:后者是一句更强的断言(引擎看了,看不出来)。
-     * 🔴 与同行的 {@link status} / re-dial 回执**各说各的**,三者不合并、不互证(`status:'failed'` 与
-     *    `liveness.state:'reachable'` 同行是真行:活着,且配错了)。
-     */
     liveness?: McpLivenessView;
-    /** never false:这一行的活性格**在场而读不出**(与整格缺席不是一句话 —— 「送来一份我读不懂的」要
-     *  能与「引擎没报」分开,否则腿级判词会拿读不出当可达的证据)。 */
     livenessUnreadable?: true;
 }
 export declare function projectMcpSection(raw: unknown): WiringManifestMcpEntryView[] | undefined;
-/** core 7.20.1(0.71.4):`wiring_manifest.writeProtection` 第七段 —— 写保护判官自报的目标视图(present-iff 这条腿编译出了判官)。 */
 export interface WiringManifestWriteProtectionView {
-    /** `spelling-only` = 只判拼写(别名写不拦;同 run 另发 `config.write_protection_target_view_absent`);`target` = 判真实目标。 */
     targetView: 'spelling-only' | 'target';
 }
-/**
- * core 7.21.0 #761 / server 7.82.0 S-362(0.72.4 CC-35):`wiring_manifest.autoConsolidation` 第八段 —— 这条腿所在部署有没有武装
- * 「记忆自动整理」(每个产生了整理建议的任务之后,为该 scope 起一次整库整理跑,记忆内容外流到整理模型)。
- * 契约 G.13:`{ onRecommendation: true }` **或整段缺席,没有第三种形**;**operator-only** 投影。
- */
 export interface WiringManifestAutoConsolidationView {
-    /** 恒 `true`(构造期门拒掉了「武装但跑不起来」);在场即武装。 */
     onRecommendation: true;
 }
-/**
- * core 7.22.0 #889 C-R60(0.72.7 CC-42):`wiring_manifest.readDeny` 第九段 —— 这条腿**内置敏感文件读 deny 表**的实质激活档位
- * (`READ_DENY_BUILTIN_TIERS` 顺序;每行都被排除掉的档位不列名)。挨着 `writeProtection`,按 operator / governance 投影;进 `configFingerprint`。
- */
 export interface WiringManifestReadDenyView {
-    /** 非空;档位词**开集**透传(闭集 `ReadDenyBuiltinTier` 五员归 core,本包不手抄 —— 上游加档位不判畸形)。 */
     builtinTiers: readonly string[];
 }
-/**
- * CC-08(0.71.0):`wiring_manifest.hooks[]` 一行(sdk 9.6.0 `WiringManifestHookEntry`)—— 这条腿挂了哪些 hook 族、
- * 由 spec 还是 deps 拥有、是否只是观察性的。开集透传 `family` / `owner`;`observational` never-false。
- */
 export interface WiringManifestHookEntryView {
     family: string;
     owner: string;
     observational?: true;
 }
-/** CC-08(0.71.0):`wiring_manifest.lsp`(sdk 9.6.0 `WiringManifestLspSeam`,core 7.18.0 #789):在场 iff 解析出了 manager 席;
- *  🔴 `mounted` 与 `lane` 互相独立、禁合读(`lane` 缺席 ≠ 没挂;`mounted: false` 时 `lane` 仍可在场)。 */
 export interface WiringManifestLspSeamView {
     mounted: boolean;
     lane?: string;
 }
-/** CC-08 ③(0.71.0):`context_usage.sections[]` 一行(sdk `ContextUsageSection`;core 7.18.0 #790)。`id` 与 `prompt_assembled` 同一张词表可 join;
- *  `tokens` 只在本段自己的坐标系里有意义(🔴 与 `usedTokens` 禁相减、禁拿一段比 `compactAtTokens`);`kind` 缺席 = 条目没声明槽,不是没语义。 */
 export interface ContextUsageSectionView {
     id: string;
     tokens: number;
     kind?: string;
 }
-/**
- * CC-91(0.76.0):`prompt_assembled.sections[]` 一行 —— 编译 IR 面的**一段**(core `prompt.assembled` 的 v2 面)。
- *
- * 🔴 **只有 `chars`,没有 `tokens`** —— 这不是本层的取舍,是上游真字节里就没有这一位:core 的臂声明
- *   (`core/trace.ts` `kind:"prompt.assembled"` 的 `sections?: Array<{id, slot, carrier, cadence, cacheClass, chars, hash, contentHash?}>`)
- *   与 server 的逐字段白名单(`observability/prompt-manifest.ts` `promptManifestRecordOf`)两面都是 `chars`。
- *   ⇒ 本层**不铸** `tokens`:拿 `chars / 系数` 编一个数就是把「不知道」渲成一个看起来精确的假值。
- *   要引擎自己的 token 估算,读 **`context_usage.sections[].tokens`**(core `prompt-assembly/section-usage.ts`
- *   `contextUsageSections` 就是拿同一份 `chars` 按引擎系数估的)。🔴 这条 join **只在两面的段视图都在场时成立**:
- *   那一面也是从同一份 manifest 段列投影的,段列缺席时它同样缺席 ⇒ v1-only 腿上没有这条 join,那时**别**拿
- *   `blocks` 当段的同名替代({@link PromptManifestBlockView}:两张词表不同,且段→块可多对一)。
- * 🔴 `id` 是 core pack 的 `core/<slot>.<name>` 命名空间**开集**(`core/role.base` / `core/harness.head` /
- *   `core/discovery.mcp-instructions` / `core/environment.context` / `core/memory.tail` …),**不是**任何端
- *   /context 面板的展示分类名;本层按开集读,认不得的 id 原词照带。
- * `slot` = 语义槽(让视图不必认识每个 id 就能分组),**逐字沿用上游的键名**:同一件事在 `context_usage.sections[]`
- *   那一面叫 `kind`,在本面叫 `slot`,两边各自跟自己的上游,本层**不改名**。改名看着整齐,代价是同一个事实在包内
- *   多一个只有本包知道的别名 —— 而本层有两个入口(投影口 / 直喂 `adapt()`),别名一多两条路就会读出不同的值。
- *   缺席 = 那个条目没声明槽,不是没语义。
- */
 export interface PromptManifestSectionView {
     id: string;
-    /** 这一段**渲染出来的字符数**(prepare 期冻结)。🔴 不是 token 数;别拿它与 `context_usage.usedTokens` 相减。 */
     chars: number;
     slot?: string;
 }
-/** CC-91(0.76.0):`prompt_assembled.blocks[]` 一行 —— v1 面的**带标签块**(`role.base` / `harness.context` /
- *  `env.context` / `memory.tail` …)。🔴 与 `sections[].id` 是**两张不同的词表**,而且**多对一**:多个段可折进
- *  同一个块(core `prompt-assembly/types.ts` 的 `blockId`)⇒ 块不是段的另一种写法,别把两面混着分组。
- *  v1-only 引擎上段视图整键缺席,这一面是那时唯一的组成视图 —— 🔴 **那时没有与 `context_usage` 的 token join**
- *  (那一面的段视图同样是从 manifest 段列投影的,段列缺席时它也缺席)⇒ 别拿块 id 去 join 段面。
- *  ⚠️ 两张词表**没有命名空间隔离的保证**:v1 块 id 不带前缀(`role.base`),而 operator 声明的段 id 是自由串
- *  (core 的 `EpochDeclaredSections.id`)⇒ 理论上能撞出同名。所以「join 不上」不是唯一的失败形,
- *  **按面各自分组**才是安全读法,别靠 id 形状猜自己在哪一面。
- *  `chars` 同律:不是 token 数。 */
 export interface PromptManifestBlockView {
     id: string;
     chars: number;
 }
-/** CC-91(0.76.0):`prompt_assembled.tools[]` 一行,**只留 wireName**(这一腿挂载了哪些工具;MCP 类按 server 分组渲染靠它)。
- *  🔴 上游那一行的其余位(`aliases` / `contractId` / `implementationRevision` / `cardId` / `shapeDigest` / `wireSchemaDigest`)
- *  是**内容寻址对账锚**、不是尺寸面,本层刻意不过境(要它们另立票,别顺手整只透传)。⚠️ 这一面**没有任何尺寸位** ——
- *  「工具 schema 占了多少」在这条 wire 上读不出来,缺席不是零。 */
 export interface PromptManifestToolView {
     wireName: string;
 }
-/**
- * CS-7 §2.7 — turn_end usage → CC `ModelUsage` (pinned name mapping;
- * costMicroUsd/1e6 → costUSD). Surfaced separately because the slice has no
- * standalone usage SDKMessage arm; the run driver folds it into the footer /
- * terminal rollup.
- *
- * ── 🔴 0.68.0 BREAKING(core 7.17.0 #711;异源对抗复审轮三实抓的**第五处**)──────────────────
- * 返回 `undefined` 的含义从「`usage` 这一格缺席」收窄成 **「这一轮的账不知道」**,两种入形都答它:
- *   ① `ev.usage` 整个缺席 —— #711 之后这**不再是一条合法形**(契约违约;`runStream` 那一层另有
- *      响亮留痕,本读器只如实答「不知道」);
- *   ② `usageMissing: true` **且六格全是 0** —— 那正是 core 的**占位**
- *      (`rs.turn.turnUsage ?? {六个 0}`,`run-harness-handlers.js:289-293`)。
- * 🔴 为什么必须改:#711 之前,「这一轮没量出账」这件事在 wire 上的形是**不发 usage** ⇒ 本函数答
- *    `undefined`;#711 之后同一件事的形变成六个 0,而本函数是**公面导出** —— 不改的话,同一个真实
- *    情形在引擎升级前后由同一个公开读器给出两个相反的答案(「不知道」变成「这一轮恰好花了 0」),
- *    而调用方**一个字都没改**。收窄之后跨引擎升级的答案**逐字不变**。
- * 🔴 **非零照交**:`usageMissing` 并不保证六格是零(core 在同一轮里可能已攒到真数字而另一次调用
- *    报了缺账 ⇒ 判别位与真数字同帧并存)。占位恒为全零,所以**任何一格非零**都说明这一轮真的量到过
- *    ⇒ 照交镜像(那些数字是**下界**,而「是不是下界」由帧上的 `usageMissing` / 终帧的
- *    `_sema_usage_lower_bound` 回答,不由本函数回答)。
- * ⚠️ 要**原样**的 wire 镜像(不做任何判断)请直接调 {@link turnUsageToModelUsage} —— 那一只是
- *    纯映射,本函数是**带缺席语义的读器**,两者刻意分开。
- */
 export declare function turnEndUsage(ev: Extract<AgentEvent, {
     type: 'turn_end';
 }>): ModelUsage | undefined;
-/**
- * Defensive open-set read of a `suspended` gate kind for the run driver's HITL
- * branch — known kinds plus a generic fallback (contract 02 §2.9 / §3: never
- * crash on an unknown kind). Kept here so the §6 mapping lives in one file.
- *
- * ⚠️ DEAD CODE — 不是「HITL 分支漏接」(2026-07-26 全树核查,task #81 顺带件):
- *   · 全树(src/ + mock/ + build/ + 测试)**零调用点**,adapter facade(src/seam/adapter/index.ts)
- *     也没把它再导出去 —— 没有任何一处「本该调它却没调」。
- *   · 它想服务的那条 HITL 分支**已经接好了**,只是没走这个函数(REF-CC-063:此处原为四个行号锚,
- *     今天全部已腐,改符号锚):
- *       - `suspended` 事件臂 → `hitl/hitlBridge.ts` 的 `HitlBridge.observe()` 就地做了**同款**防御
- *         回落(`ev.gate ? ev.gate : { kind: 'human' }`),而且 latch 的是整个 CheckpointGate 对象,
- *         壳侧 `currentGate()` 自己 branch `gate.kind`;
- *       - `done{status:'suspended', checkpointGate}` 终帧 → `liveHitlAskWire.ts` 的 ask 合成口 /
- *         `terminalToSdkResult.ts` 的 park 臂各自读 `checkpointGate.kind` **和** `.toolName`。
- *   · 关键:每个真实消费方都同时需要 `toolName`(挑 Ask overlay vs fs 写门三选卡),而本函数只吐
- *     一个 kind 字符串 —— 签名比任何真实需求都窄,接进去反而要再读一次 gate。
- *   结论 = 可删的死码(留档不擅删,按 task #81 口径只标记);真要收,连同 `CheckpointGate` 的
- *   type-only import 一起摘。
- */
 export declare function gateKind(gate: CheckpointGate | null | undefined): string;