@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/systemReminderTag.d.ts

@@ -1,52 +1,3 @@
-/**
- * systemReminderTag — `<system-reminder>` 包裹的**单一识别闸口**(件⑥⑦,2026-08-22,[4974])。
- *
- * ## 为什么要有这个文件
- *
- * core ≥5.46 起,引擎铸的每一个 `<system-reminder>` **开标签**都带一个 `mark` 属性。真字节直证
- * (core 5.52.0 `dist/core/reminder-mint.js`,逐行):
- * ```js
- * const MARK_SHAPE = /^[A-Za-z0-9_-]{22}$/            // randomBytes(16).toString("base64url")
- * export function openSystemReminder(mark) {
- *   return mark === undefined ? "<system-reminder>" : `<system-reminder mark="${mark}">`
- * }
- * export function mintSystemReminder(body, mark) {
- *   return `${openSystemReminder(mark)}\n${body}\n</system-reminder>`
- * }
- * ```
- * 闭标签**没有**属性,只有开标签变了。而包内两处判定当时都锚着**裸开标签**,于是同一个根因
- * 长出两个座位([4974] 双 CONFIRMED):
- *   · `classifierVerdictWire.unwrapSystemReminder` —— 剥不掉壳 ⇒ 裁决原文前面顶着一整个开标签 ⇒
- *     `startsWith(签名)` 恒不成立 ⇒ auto-deny 的通知行与 Recent Denials 记账**静默失效**;
- *   · `subagent/engineDelegatedPrompt.stripEnvelopes` —— 信封整段剥不掉 ⇒ Fleet 详情页的
- *     「Prompt」又变回 ~1330 字符的技能清单(那个函数头注自陈 2026-08-01 修过的 bug 原样复发)。
- *
- * 两处各写一份正则正是这条缺陷能长出**两个**座位的原因,所以收成这一个闸口:识别口径只有一处,
- * 下次 core 再动标签形也只有一处要跟。
- *
- * ## 口径(刻意写窄,不做 HTML 解析)
- *
- * · 开标签 = `<system-reminder>` 或 `<system-reminder` + **空白起头**的属性段 + `>`;属性段用
- *   `[^>]*` —— 它跨不过 `>`,所以没有回溯爆炸面,也不会把后面的正文吃进标签里。
- * · 刻意**不校验** `mark` 的值形:本模块的职责是「认出这是引擎的信封壳」并把它剥掉/跳过,
- *   **不是**信任判定。真正的信任判据是壳里的 mark 比对(core 的 `reminderMarkDeclaration` 明说
- *   「带不带 mark 都可能是数据」),那是另一层的事;这里若按 mark 值放行/拒绝,等于把一个安全
- *   判定藏在一个显示层的剥壳函数里。
- * · 闭标签逐字 `</system-reminder>`(core 就是这么铸的,不给它加属性容忍 = 不给伪造面留口子)。
- * · **不处理嵌套**:配对用非贪婪,遇到第一个闭标签就收 —— 与件⑥⑦ 修之前逐字同语义
- *   (core 不铸嵌套 reminder;真出现嵌套时残留的是外层闭标签,不是把正文吃掉,方向仍是保守的)。
- *
- * 🔴 零 import(端无关叶件):纯字符串处理,不碰 Node、不碰 wire 类型。
- */
-/**
- * 整条文本就是一个 `<system-reminder>` 包裹时,返回**里面的正文**;否则原样返回。
- * (`formatHookFeedback` = `mintSystemReminder` 的逆变换。)
- */
 export declare function unwrapSystemReminder(text: string): string;
-/**
- * 把文本里**所有**成对的 `<system-reminder>…</system-reminder>` 段整段删掉(不配对的原样留着 ——
- * 截断的信封宁可多渲一点,也不能把正文吃掉)。
- */
 export declare function stripSystemReminderBlocks(text: string): string;
-/** 这段文本**以**一个 system-reminder 开标签起头吗(诊断/判定用的轻量读口)。 */
 export declare function startsWithSystemReminderOpenTag(text: string): boolean;

package/dist/systemReminderTag.js

@@ -1,73 +1,12 @@
-/**
- * systemReminderTag — `<system-reminder>` 包裹的**单一识别闸口**(件⑥⑦,2026-08-22,[4974])。
- *
- * ## 为什么要有这个文件
- *
- * core ≥5.46 起,引擎铸的每一个 `<system-reminder>` **开标签**都带一个 `mark` 属性。真字节直证
- * (core 5.52.0 `dist/core/reminder-mint.js`,逐行):
- * ```js
- * const MARK_SHAPE = /^[A-Za-z0-9_-]{22}$/            // randomBytes(16).toString("base64url")
- * export function openSystemReminder(mark) {
- *   return mark === undefined ? "<system-reminder>" : `<system-reminder mark="${mark}">`
- * }
- * export function mintSystemReminder(body, mark) {
- *   return `${openSystemReminder(mark)}\n${body}\n</system-reminder>`
- * }
- * ```
- * 闭标签**没有**属性,只有开标签变了。而包内两处判定当时都锚着**裸开标签**,于是同一个根因
- * 长出两个座位([4974] 双 CONFIRMED):
- *   · `classifierVerdictWire.unwrapSystemReminder` —— 剥不掉壳 ⇒ 裁决原文前面顶着一整个开标签 ⇒
- *     `startsWith(签名)` 恒不成立 ⇒ auto-deny 的通知行与 Recent Denials 记账**静默失效**;
- *   · `subagent/engineDelegatedPrompt.stripEnvelopes` —— 信封整段剥不掉 ⇒ Fleet 详情页的
- *     「Prompt」又变回 ~1330 字符的技能清单(那个函数头注自陈 2026-08-01 修过的 bug 原样复发)。
- *
- * 两处各写一份正则正是这条缺陷能长出**两个**座位的原因,所以收成这一个闸口:识别口径只有一处,
- * 下次 core 再动标签形也只有一处要跟。
- *
- * ## 口径(刻意写窄,不做 HTML 解析)
- *
- * · 开标签 = `<system-reminder>` 或 `<system-reminder` + **空白起头**的属性段 + `>`;属性段用
- *   `[^>]*` —— 它跨不过 `>`,所以没有回溯爆炸面,也不会把后面的正文吃进标签里。
- * · 刻意**不校验** `mark` 的值形:本模块的职责是「认出这是引擎的信封壳」并把它剥掉/跳过,
- *   **不是**信任判定。真正的信任判据是壳里的 mark 比对(core 的 `reminderMarkDeclaration` 明说
- *   「带不带 mark 都可能是数据」),那是另一层的事;这里若按 mark 值放行/拒绝,等于把一个安全
- *   判定藏在一个显示层的剥壳函数里。
- * · 闭标签逐字 `</system-reminder>`(core 就是这么铸的,不给它加属性容忍 = 不给伪造面留口子)。
- * · **不处理嵌套**:配对用非贪婪,遇到第一个闭标签就收 —— 与件⑥⑦ 修之前逐字同语义
- *   (core 不铸嵌套 reminder;真出现嵌套时残留的是外层闭标签,不是把正文吃掉,方向仍是保守的)。
- *
- * 🔴 零 import(端无关叶件):纯字符串处理,不碰 Node、不碰 wire 类型。
- */
-/**
- * 开标签的**闭集**形:core 只会铸这两种(`openSystemReminder` 逐字),所以判据也只认这两种。
- *
- * 🔴 **不做通配属性**(七审 finding② 采纳):`<system-reminder\s[^>]*>` 那种宽口会把
- * `onclick="…"` / 换行垃圾 / 未闭合引号 / 内嵌 `<img` 全部当成合法开标签 —— 而本模块的两个消费点
- * 处理的正是**模型与工具产出的文本**(UNTRUSTED),宽口等于给伪造信封开一道口子:攻击者/模型
- * 可以用一个假信封把内容藏起来(委派 prompt 面)或把自己的文本伪装成引擎裁决(分类器面)。
- * `mark` 的值形按 core `MARK_SHAPE` 逐字(`randomBytes(16).toString("base64url")` = 22 位
- * `[A-Za-z0-9_-]`),值本身**不比对**(见文件头:比对是信任判定,不是剥壳的活)——但**形**必须对,
- * 形不对的一律不是引擎铸的壳。
- */
 const OPEN_TAG_SOURCE = '<system-reminder(?: mark="[A-Za-z0-9_-]{22}")?>';
-/** 整段配对(开标签 + 正文 + 闭标签)。捕获组 1 = 正文。 */
 const WRAPPED_RE = new RegExp(`^\\s*${OPEN_TAG_SOURCE}\\s*\\n?([\\s\\S]*?)\\n?\\s*<\\/system-reminder>\\s*$`);
-/**
- * 整条文本就是一个 `<system-reminder>` 包裹时,返回**里面的正文**;否则原样返回。
- * (`formatHookFeedback` = `mintSystemReminder` 的逆变换。)
- */
 export function unwrapSystemReminder(text) {
     const m = WRAPPED_RE.exec(text);
     return m ? m[1] : text;
 }
-/**
- * 把文本里**所有**成对的 `<system-reminder>…</system-reminder>` 段整段删掉(不配对的原样留着 ——
- * 截断的信封宁可多渲一点,也不能把正文吃掉)。
- */
 export function stripSystemReminderBlocks(text) {
     return text.replace(new RegExp(`${OPEN_TAG_SOURCE}[\\s\\S]*?<\\/system-reminder>`, 'g'), '');
 }
-/** 这段文本**以**一个 system-reminder 开标签起头吗(诊断/判定用的轻量读口)。 */
 export function startsWithSystemReminderOpenTag(text) {
     return new RegExp(`^\\s*${OPEN_TAG_SOURCE}`).test(text);
 }

package/dist/toolResult.d.ts

@@ -1,66 +1,21 @@
 import type { TaskResult, TaskStats } from '@sema-agent/sdk';
 import { type ModelFallbackReason } from './engineErrorCodes.js';
-/**
- * 引擎会在 `tool_end.structured` 顶层 `type` 上发的**全部**取值。
- * 用途**不是**「只处理这些」——下面的 switch 只认得其中一部分,认不得的照旧走 text 回落;
- * 用途是「**structured 在场**」这个判据本身:顶层 type 命中白名单 ⇒ 引擎这一版是发结构化的,
- * 于是模型面正文的**正则反解**(T11 bash / T13+T24 task-output / T14 后台回执三代文案)退位。
- * 反过来,一个 `{type:'something-else'}` 或裸对象**不算** structured 在场 —— 宁可回落到正则,
- * 也不许把「有个对象」当成「引擎发了结构化」(判据锚在决定结果的量上:决定的是「该不该信正则」)。
- * ⚠️ 与设计稿的口径差:任务书写「29 项」,[1840] 清单逐条数是 **30 项**(见交接报告「设计稿错漏」)。
- *
- * 🔴 **本表是 core `CC_DETAIL_TYPES` 的镜像,不是本包自铸的词表**(core
- * `dist/core/runner/tool-output-projection.js`)。等值由 `scripts/run-engine-vocab-floor-test.mjs` ⑤ 段
- * 对**实装 core** 双向钉(漏一词 / 多一词都红),对账物 = 本仓 devDep `@sema-agent/core`。
- * ⇒ **core 提货窗必须跟车对表**:每次抬 devDep core 版本,先跑 engine-vocab 门看这张表红不红,
- * 红了按 core 那一版的铸点逐词补/删,别改门去迁就表。历史上两次恒绿(5.10 前停 devDep 5.1、
- * 5.43 前停 devDep 5.20)的病根都不在表本身,在**对账物没跟着抬** —— 表漏一词的实际后果是
- * 那一类卡永远退回正则解模型面文本,而任何一层都不会响。
- */
 export declare const STRUCTURED_DETAIL_TYPES: ReadonlySet<string>;
-/** structured 在场判别:顶层 `type` ∈ 白名单 ⇒ 返回该 type,否则 undefined(= 不在场)。 */
 export declare function structuredDetailType(structured: unknown): string | undefined;
 export declare const PROTOCOL_MARKERS: {
-    /** T11 bash 框架:退出码行头(core tools/fs/index.ts runShell)。 */
-    /** 0.73.3(CC-60 A-D5):认 core 两个发货变体 —— exit1 注记形 `exit code: 1 (<note>)` 与图片形(首行后**没有** `--- stdout ---` 行,
-     *  紧跟 `[Image data detected …]`)。第 2 组 = 括号注记(缺席 = undefined),第 3 组 = 老形的 stdout 分隔行(图片形缺席)。 */
     readonly bashHead: RegExp;
-    /** T11 bash 框架:stderr 分隔行。 */
     readonly bashStderrSep: "\n--- stderr ---\n";
-    /** T11 bash 框架:空 stdout 哨兵。 */
     readonly bashEmptySentinel: "(empty)";
-    /** T12:`delimitUntrusted` 围栏(core untrusted-text.ts:118)。REF-CC-域词表-09 回炉车补齐——
-     *  此前这条正则仍内联在 `stripUntrustedFence` 里,是原始「8 处文案协议解析点」普查(P1 lens-lexicon
-     *  域词表-09 evidence)唯一没进表的一条(`stripUntrustedFence`/`untrustedFence` 单源消费)。 */
     readonly untrustedFence: RegExp;
-    /** T13 TaskOutput:`<<<UNTRUSTED TaskOutput <id> …>>>` label 里的任务 id。 */
     readonly taskOutputLabel: RegExp;
-    /** T13 TaskOutput:`status: …` 行。 */
     readonly taskOutputStatus: RegExp;
-    /** T13 TaskOutput:空段哨兵。 */
     readonly taskOutputNoneSentinel: "(none)";
-    /** T13 TaskOutput:stdout 分隔行(全量/增量两形共用一条正则——区分交给下面的 spool 判别)。 */
     readonly taskOutputStdoutLine: RegExp;
-    /** T13 TaskOutput:stderr 分隔行。 */
     readonly taskOutputStderrLine: RegExp;
-    /** T13 TaskOutput:agent 结果分隔行。 */
-    /** 0.73.3(CC-60 A-D4):认可选括号注记 `--- result (partial) ---`(core 被 stop 打断的子代任务此前正文整段切不出)。 */
     readonly taskOutputResultLine: RegExp;
-    /** [1505] spool 协议:全量可重读形(`engineTaskHandleWire.ts` mergeTaskOutput 单源消费点)。 */
     readonly spoolStdoutFull: "--- stdout (full, re-readable) ---";
-    /** [1505] spool 协议:增量新字节形。 */
     readonly spoolStdoutIncremental: "--- new stdout ---";
 };
-/**
- * [1505] spool 标记判别(REF-CC-域词表-06 提单源):判「读游标该整体替换还是追加」这一件事,
- * 唯一真源在此——`engineTaskHandleWire.ts` 的 `mergeTaskOutput` 消费它,此前是各写一份
- * `.includes()` 的独立判读,现在改成两处调用同一个函数,不再靠两份手抄字面量碰巧对齐。
- * ⚠️ 措辞收窄(opus/对抗复审,回炉车):本函数**不**是"表里任何 stdout/stderr 分隔行判读的
- * 单源"——`parseModelFacingTaskOutput` 里的 `taskOutputStdoutLine` 是解**另一件事**(T13
- * TaskOutput 模型面正文里 stdout 段的边界在哪),两者字面量近似但语义不同、输入来源也不同
- * (读游标累积 vs 单次模型面文本反解),存在能让两者给出不同答案的输入(如带前导垃圾字节的
- * 文本)。它们只是共享同一张 `PROTOCOL_MARKERS` 登记表,不是同一个判据。
- */
 export declare function spoolMarkerOf(text: string): 'full' | 'incremental' | null;
 export declare function modelFacingParseCalls(): number;
 export declare function _resetModelFacingParseCountForTest(): void;
@@ -70,24 +25,10 @@ export declare function parseModelFacingBash(text: string): {
     exitCode: number | null;
     note?: string;
 } | null;
-/**
- * T12 —— 剥引擎的 `delimitUntrusted` 围栏(core untrusted-text.ts:118)**仅供渲染**。
- * 围栏是给模型看的注入防护,人类转录卡显示正文(clay 07-03 审计 #1/#9 视觉 bug 的修)。
- */
 export declare function stripUntrustedFence(text: string): {
     label: string;
     body: string;
 } | null;
-/**
- * T13 回落解析结果(REF-CC-TYPESHAPE-14:命名 discriminated union —— 此前是 4 成员内联匿名形,
- * 三个构造点各自手写、`'unknown'` 分支「没有 output」原来只是注释里的一句话,现在类型强制)。
- * 🔴 抽 DU **不改运行时形**(二次回炉,复审 #4):`taskId`/`status` 缺值时**键照样在、值是
- * `undefined`**(与 main 逐字节一致)——本函数是 npm 公面导出,`Object.keys()` / `'taskId' in r` /
- * JSON 序列化都是下游看得见的契约,类型重构无权改它。eopt 收官(E-seat 卡裁定):「公面键恒在」
- * 形不许被本批翻回条件展开——三键改 `| undefined` 显式并集,继续如实描述「键恒在、值可能 undefined」
- * 这个已裁定的公面契约(不是收窄成条件展开,那会静默改变 `Object.keys()` 的下游可见形)。
- * 常驻钉见 `run-client-core-pure-test.mjs` ⑪ 段「公面形(复审 #4 回卷钉)」三条。
- */
 export type ModelFacingTaskOutput = {
     kind: 'bash';
     taskId?: string | undefined;
@@ -103,216 +44,65 @@ export type ModelFacingTaskOutput = {
     taskId?: string | undefined;
     status?: string | undefined;
 };
-/**
- * T13 回落 —— 引擎 TaskOutput 的模型面正文(core task-registry.ts 的 bash/agent 两形,整体
- * delimitUntrusted 包裹、label = `TaskOutput <id>`)反解回卡片槽位。`kind` 报哪一形命中,
- * 'unknown' ⇒ 调用方回落原文(该分支类型上就没有 `output` 字段,不是「值恰好是 undefined」)。
- */
 export declare function parseModelFacingTaskOutput(text: string): ModelFacingTaskOutput;
 export declare function backgroundReceiptParseCalls(): number;
 export declare function _resetBackgroundReceiptParseCountForTest(): void;
-/**
- * T8 —— 压平非均匀 §E1 `output`(`string` | `(Text|Image)[]`)。
- * ⚠️ 真源在 adapt.ts(A 层 settle 报告也用同一份),本文件只 import,别再写第二份。
- */
 export type FlattenWireOutput = (output: unknown) => string;
-/** wire 没带 output 时的降级原因码(UI 显示决策留端;客户端绝不编造执行结果)。 */
 export declare const TOOL_RESULT_DEGRADED_WIRE_NO_OUTPUT: "wire_carried_no_output";
 export interface ToolResultBody {
     content: unknown;
     isError: boolean;
     toolUseResult?: unknown;
-    /** 只在「wire 没带正文」时出现;在场 = 这张卡**没有真实执行结果**,不是空结果。 */
     degraded?: typeof TOOL_RESULT_DEGRADED_WIRE_NO_OUTPUT;
 }
-/**
- * T7 —— `tool_end.output === undefined`(events.d.ts:79 文档化的「工具没有正文」情形)时的卡体。
- *
- * cli 旧形:调 mock 注册表 `synthesizeToolIO(name, input)` **反造**一个结果体(stdout/hunks/匹配列表),
- * 卡片于是显示「看起来像真的、但根本不是这次执行产物」的内容。§8-4 按宪法「诚实优先于产出」裁定
- * 搬的时候就改掉:**输出诚实缺席 + degraded 标记**,由 UI 决定显示「结果不可用」。
- * 🔴 `content` 保持**字符串**(件1:tool_result block content 恒字符串,裸对象经 /compact 直发
- * provider = 400 invalid_request);空串 = 无正文,`degraded` 才是判别位。
- */
 export declare function degradedToolResultBody(isError: boolean): ToolResultBody;
-/**
- * 真实 §E1 `tool_end.output` → 卡片读的 typed 正文。
- *
- * B5 新增第 5 个入参 `structured`:**structured 在场 ⇒ 正则退位**(①)。
- * 三臂:`bash`(T11/T14)· `taskoutput|task_output`(T13,无 structured 的老腿)· 泛化兜底。
- * 🔴 `truncated` 只做中性提示,截断正文**绝不**回喂模型(events.d.ts:80-85)。
- */
 export declare function wireOutputToBody(toolName: string, output: unknown, isError: boolean, truncated: boolean, flatten: FlattenWireOutput, structured?: unknown): ToolResultBody;
-/**
- * design/64 CC-parity `toolUseResult`:引擎结构化细节 → 各卡 outputSchema **精确** typed 形
- * (safeParse 过了才渲富卡,不过就回落 12 行文本兜底)。
- * `structuredPatch` 在**这里**算(T20,core 裁定:引擎发 originalFile、客户端算 hunks)。
- * 全部**防御读**:形状不认得 ⇒ null ⇒ 调用方回落 text 路径(降保真,绝不炸)。
- */
-export declare function structuredToToolUseResult(structured: unknown, 
-/** 压平后的模型面正文 —— 有些形(task-output)只带 identity/status,正文仍在模型面。 */
-modelText?: string): {
+export declare function structuredToToolUseResult(structured: unknown, modelText?: string): {
     toolUseResult: unknown;
     isError?: boolean;
 } | null;
-/**
- * #117a / #158 —— **模型发起**的后台回执探测器。引擎侧秒关这张卡、从不进壳的 LocalShellTask
- * registry,只能从回执文案桥过去。
- * 🔴 **按 `toolName` 正向枚举分臂**(#158;开集入参,认不出的工具名一律 `null` = 不铸行,
- * 安全方向是漏检不是误检):
- *   · `Bash` 臂 —— 三形回执首句 + **刻意**要求 INPUT 上 `run_in_background === true`:ctrl+B 的
- *     detach lane(「Command moved to background」)归 engineToolDetach 管(它的行生命周期是有意的
- *     settle-on-detach),在这里重复登记会长出双行。
- *   · `Monitor` 臂 —— 第四形回执首句 `Monitoring in background; task_id=…`,**没有**
- *     run_in_background 门:Monitor 天然后台,它的参数里根本没有这个键(此前三重门全拒 ⇒
- *     引擎 Monitor 任务在 ctrl+B 面板零行)。
- * 产物上的 `source: 'bash' | 'monitor'` 是行家族判别位(闭集),消费端按它分流行形,别按 command
- * 文本猜;新工具要进面板必须显式加臂 + 扩这个闭集。
- * 判定在库、**执行留宿主**(面板 store 写入 + 宿主 run 映射)—— 走 chrome `bgshell_register` 臂。
- * 🔴 Bash 臂正则复用 `THREE_GEN_BG_RECEIPT_RE`(见上方 T14 `parseBackgroundReceipt` 头注,
- * REF-CC-域词表-04 dedupe)—— 此前这里另抄了一份逐字节相同的字面量,两份手抄件靠"碰巧没人改坏"
- * 对齐;Monitor 臂用**分开的** `MONITOR_BG_RECEIPT_RE`(职责不交叉:THREE_GEN 还被
- * `parseBackgroundReceipt` 的 bash structured 回落共用,Monitor 不属那条链)。
- */
 export interface EngineBgShellRegistration {
     kind: 'register';
-    /** 回执上的**引擎** task id(`task_id=…`,TaskOutput/TaskStop 的句柄)。 */
     taskId: string;
-    /** tool_use input 的 command(面板行的命令行;Bash 与 Monitor 同键)。 */
     command: string;
-    /** 模型给了 description 才有(Monitor 的 schema 里必填,恒在)。 */
     description?: string;
-    /** 引擎模型面回执原文,逐字 —— 详情视图显示它(里面的 output-file 路径因此可见可复制)。 */
     receipt: string;
-    /** #158 行家族判别:'bash'=run_in_background Bash;'monitor'=Monitor 长跑监视(事件流语义,
-     *  终局才 settle)。消费端按此分流行形;闭集,新工具要进面板必须显式加臂。 */
     source: 'bash' | 'monitor';
 }
 export declare function detectEngineBgShellReceipt(toolName: string, rawInput: unknown, outputText: string | undefined): EngineBgShellRegistration | null;
-/**
- * TodoWrite 清单卡:引擎不发 todo structured,全量新表骑在 tool_use INPUT 上 ⇒ 从它合成 typed 结果。
- * `oldTodos` = 上一次的活体清单(调用方持:一个 session 一份,正是划删线 diff 要的粒度)。
- */
 export declare function todoWriteToolUseResult(rawInput: unknown, oldTodos: unknown[], isError: boolean): {
     toolUseResult: unknown;
     isError: boolean;
     newTodos: unknown[];
 } | null;
-/**
- * ReportFindings(core 1.288 [811]b,引擎侧执行的合成回声工具):details 是 `{count, level?, findings}`
- * **没有 type 判别位**(core synthetic-tools.js)⇒ B 层的 type-keyed switch 认领不了,按**工具名**认。
- * 双腿:优先 wire structured;引擎没发就从 tool_use INPUT 合成(回声工具:input.findings ≡ output.findings)。
- */
 export declare function reportFindingsToolUseResult(structured: unknown, rawInput: unknown): {
     toolUseResult: unknown;
 } | null;
-/**
- * 后台(async)子代的**启动回执**上那两位「身份」—— `type:"agent"` 两形里 `async_launched` 那一形。
- *
- * 只带**身份**,不带可渲染性:`description`/`prompt` 是富卡的必填位(缺了要回落 text 路径),
- * 与「这条回执宣告了哪个子代」无关,故不进本读口 —— 见 {@link structuredToToolUseResult} 的
- * `case 'agent'`。
- */
 export interface AsyncLaunchedAgentReceipt {
-    /** 引擎子代任务 id(注意:**启动回执是 snake_case `task_id`**,完成卡是 camelCase `taskId`)。 */
     readonly taskId: string;
-    /** bg 子代生命周期号(SendMessage 复活即 +1)。wire 今天未必带 ⇒ 缺席按首周期解释,绝不铸 0。 */
     readonly seq?: number;
 }
-/**
- * 把一张 `tool_end.structured` 窄化成 {@link AsyncLaunchedAgentReceipt} —— **仅当**它是
- * `type:"agent"` 的 **`async_launched` 启动回执**臂时;完成着陆报告 / 别的族 / 缺身份 ⇒ `null`。
- *
- * 🔴 分臂判据 = `status`(core 原话:"Branch on `status`, never on which keys are present"),
- *    与姊妹读口 {@link readCompletedAgentCard} 互为反面。本函数是这条纪律在**回执**侧的单一实现点:
- *    本包现在有两个消费点 —— 富卡投影(`structuredToToolUseResult`)与 adapt 的 bg 子代 alias 登记
- *    (`adapt/arms.ts` 的 `tool_end_result` 臂,#158②)—— 两处不得各抄一遍键名与 `'async_launched'`。
- * 🔴 `task_id` 要**非空**串:空串是「有这个键但没有身份」,拿它当 taskId 会在内容账本里铸一条
- *    键为 `''` 的映射(读口那侧的 `?? ''` 兜底会当场把它认成命中)。诚实拒,不铸空 id ——
- *    与 {@link readCompletedAgentCard} 对 `taskId` 的同款判据一致。
- */
 export declare function readAsyncLaunchedAgentReceipt(structured: unknown): AsyncLaunchedAgentReceipt | null;
-/**
- * 子代**完成着陆报告**卡(core `agents/subagent.ts#completedAgentCard` 的 wire 形)。
- *
- * 沿革:5.10.0 之前这张卡被 core 的投影白名单在上 wire 前整张丢掉 —— `tool_end.structured` 自己的
- * 契约点名了它,而实际只有 `async_launched` 回执到得了消费方。5.10.0 修好了那条白名单,于是
- * `type:"agent"` 从「只有一形」变成「两形按 `status` 分」({@link structuredToToolUseResult} 的
- * `case 'agent'` 头注写了为什么本包不把它投成 CC 卡)。
- *
- * 🔴 **本读口只做窄化,不做解释**:每个键要么原样带出,要么(类型不符时)当缺席。绝不为缺席的量
- *    造零值([honest-absence-not-fabricated-zero])—— `stats` 取不到就是 `undefined`,不是 `{}`。
- * 🔴 **白名单不是闭集断言**:core 明写这张卡是「显式字段白名单」而非 spread(`checkpointToken` /
- *    `checkpointGate` 这两个**能力**位永不上 wire)。未来 core 往卡上加字段时,本读口读不到它们 ——
- *    那是**加一个字段**的跟车工单,不是错误;宿主要原始全量随时可读 `structured` 本身。
- */
 export interface CompletedAgentCard {
-    /** 子代**真实终态**(`completed` / `failed` / `blocked` / `suspended.*` …)。判别位;开集。 */
     readonly status: string;
-    /** 子代任务 id(注意:完成卡是 camelCase `taskId`,启动回执是 snake_case `task_id`)。 */
     readonly taskId: string;
-    /** 子代 transcript 句柄 —— 查询键,**不是**能力(续跑要部署侧的 resume 句柄)。 */
     readonly sessionId?: string;
-    /** 子代类型名(roster 上的名字)。 */
     readonly subagentType?: string;
-    /** 着陆报告正文 = 子代最终助手文本,**不含**模型面那层导向尾注。 */
     readonly result?: string;
-    /** 到限截断时抢救出的最后模型文本。 */
     readonly salvagedOutput?: string;
-    /** `outputSchema` 任务的结构化产出(不解释,原样)。 */
     readonly structuredOutput?: unknown;
-    /** 失败归因三件之一:agent 自报无法推进的理由。 */
     readonly blockedReason?: string;
-    /** 失败归因三件之二:人话。 */
     readonly errorMessage?: string;
-    /** 失败归因三件之三:机器码(开集;词表见 `engineErrorCodes.ts`)。 */
     readonly errorCode?: string;
-    /**
-     * 🆕 core 5.10.0 —— `errorCode` 的**机器可执行配对**:refusal 什么时候解除。
-     * 🔴 与 `retryable` 是**两个不同的问题**,可能同时出现且看起来矛盾(core 亲注):
-     *    `retryable` = 「现在原样重发行不行」(`usage.window_exhausted` 上它是 false,且是对的);
-     *    `retryAfterMs` = 「什么时候不再被拒」。调度器读前者+后者,立即重发的决策只读 `retryable`。
-     *    在场条件 = `usage.window_exhausted` 终局;**别拿它的在场性去判别的事**([2575] 自查③)。
-     */
     readonly retryAfterMs?: number;
-    /**
-     * 🆕 core 5.10.0 —— 降级实录(from/to/reason/atTurn)。形状与 `TaskResult.degraded` **同一个**
-     * (core 把子代 TaskResult 的这一位原样搬上卡),故直接借 SDK 的类型而不是再开一个 `unknown` 出口。
-     * 窄化 = 对象守卫(与 `terminalToSdkResult.degradedOf` 同一姿势):非对象一律当缺席。
-     */
     readonly degraded?: NonNullable<TaskResult['degraded']>;
-    /** 失败分类:错误种类。 */
     readonly errorKind?: string;
-    /** 失败分类:原样重发是否可行(见 `retryAfterMs` 的配对说明)。 */
     readonly retryable?: boolean;
-    /**
-     * run 总账(CC `AgentToolCompletedOutput` 对位)。同 `degraded`:core 搬的就是子代
-     * `TaskResult.stats`,所以借 SDK 的 `TaskStats`(它自带 `[key: string]: unknown` 开集索引,
-     * 新键不会因此被类型面挡住)。数值重算是渲染层的活,本层只窄化不解释。
-     */
     readonly stats?: TaskStats;
-    /** 实际服务该子代的模型 id(与 `resolvedModel` 同值,core 两个键都发)。 */
     readonly model?: string;
-    /** 同上 —— core 的显式别名键;两键择一读即可,本读口都带出以免宿主二次猜。 */
     readonly resolvedModel?: string;
-    /**
-     * 🆕 core 5.10.0 / [2577] —— **闭集单成员**:请求的模型词没绑上,子代跑在继承来的默认模型上。
-     * 🔴 **这不是错误**(回落行为本身没变,只是现在说出来了);缺席 = 正常绑定或压根没请求过词。
-     *    渲染建议(core 给的语义,UI 语言各端自裁):在生效 model 旁加「requested word did not bind /
-     *    inherited」注记,**不因它的在场性改变别的渲染**。加成员 = BREAKING,见 {@link ModelFallbackReason}。
-     */
     readonly modelFallback?: ModelFallbackReason;
-    /** 子代跑在哪个 worktree(`isolation:'worktree'` 时)。 */
     readonly worktreePath?: string;
-    /** 子代的逐工具调用统计。原样带出。 */
     readonly toolStats?: unknown;
 }
-/**
- * 把一张 `tool_end.structured` 窄化成 {@link CompletedAgentCard} —— **仅当**它是 `type:"agent"` 的
- * **完成**臂时。不是 agent 卡 / 是 `async_launched` 回执 / 缺 `status` 或 `taskId` ⇒ `null`。
- *
- * 🔴 分臂判据 = `status`(core 原话:"Branch on `status`, never on which keys are present")。
- *    本函数是那条纪律在包内的**单一实现点**:三端(TUI / web / desktop)按同一份窄化读,
- *    而不是各自抄一遍键名与 `!== 'async_launched'`。
- */
 export declare function readCompletedAgentCard(structured: unknown): CompletedAgentCard | null;