@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/adapt/toolCards.js

@@ -5,35 +5,21 @@ import { flattenWireOutput } from './wireShapes.js';
 export function createToolCardLedger(ctx, idOf) {
     const pending = new Map();
     let assistantResponseId = null;
-    /**
-     * TodoWrite 划删线 diff 的 `oldTodos`。
-     * 🔴 **turn 级**(cli 同:`let lastLiveTodos` 声明在 generator 体内,不是 module 级 ——
-     *    cli 的注释写着「module-level, per-process」但代码不是,以**代码**为准,差分守卫认代码)。
-     */
     let lastLiveTodos = [];
-    /**
-     * 一张开卡的收口(cli `buildToolResult` + 它内联的 #117a 桥)。产出顺序与 cli 的
-     * 「副作用先于 yield」一致:先 chrome(bg shell 建行),再 transcript(tool_result 卡)。
-     */
     function* buildToolResult(p, end) {
         const isError = end?.isError ?? false;
-        // D 层 / T7:wire 带正文 ⇒ 真身投影;没带 ⇒ **诚实缺席**(§8-4,不再 mock 反造)。
         const body = end && end.output !== undefined
             ? wireOutputToBody(p.name, end.output, isError, end.truncated === true, flattenWireOutput, end.structured)
             : degradedToolResultBody(isError);
-        // ── E 层 ③:#117a 模型发起的后台 Bash/Monitor 回执 → ctrl+B 面板行(判定在库、执行留宿主;
-        //    #158:Monitor 此前被工具名门拒 ⇒ 面板盲区,现同臂分 source)。
         if ((p.name === 'Bash' || p.name === 'Monitor') && !isError && end?.output !== undefined) {
             const reg = detectEngineBgShellReceipt(p.name, p.rawInput, flattenWireOutput(end.output));
             if (reg) {
                 yield chrome({ kind: 'bgshell_register', laneProof: mainLane(), taskId: reg.taskId, registration: reg });
             }
         }
-        // B 层:structured → 逐工具 typed toolUseResult(卡的 outputSchema safeParse 过才渲富卡)。
         let rich = end?.structured !== undefined
             ? structuredToToolUseResult(end.structured, end.output !== undefined ? flattenWireOutput(end.output) : undefined)
             : null;
-        // E 层 ④/⑤:两条按**工具名**的补位(引擎不发 type 判别位,B 层 switch 认领不了)。
         if (rich === null && p.name === 'TodoWrite') {
             const todo = todoWriteToolUseResult(p.rawInput, lastLiveTodos, isError);
             if (todo !== null) {
@@ -59,25 +45,18 @@ export function createToolCardLedger(ctx, idOf) {
                     },
                 ],
             },
-            // DIVERGENCE-2:cli 在缺 eventId 时铸随机 v4,本包一律**稳定键派生**
-            // (`wtc_<toolUseId>` —— 一张卡一个结果,天然唯一;同流重放 ⇒ 同 id 序列,[1653])。
             uuid: eventId ?? deriveTranscriptId({ toolCallId: p.id }, ctx),
             session_id: ctx.sessionId,
             ...(parentToolCallId !== undefined ? { parent_tool_use_id: parentToolCallId } : {}),
-            // CC 结果卡读 sidecar 上的 typed 输出(不是 block content)。
             toolUseResult: rich !== null ? rich.toolUseResult : (body.toolUseResult ?? body.content),
-            // T7:wire 没带正文的诚实标记 —— 在场 = 这张卡没有真实执行结果(UI 显示决策留端)。
             ...(body.degraded !== undefined ? { _sema_degraded: body.degraded } : {}),
         }, ctx.now());
     }
-    /** 关一张卡的**唯一**实现:出栈 + S1 复位 + 铸卡,前两步恒在第一个 yield 之前。 */
     function* closeCard(p, end) {
         pending.delete(p.id);
         assistantResponseId = null;
         yield* buildToolResult(p, end);
     }
-    // 🔴 FIX-05 同族纪律:本模块**零 `this`** —— 全部走闭包变量与具名函数,
-    //    所以「同一个台账有两条访问路径」这件事在这里结构上不可能发生。
     return {
         has: (id) => pending.has(id),
         peek: (id) => pending.get(id),
@@ -88,8 +67,6 @@ export function createToolCardLedger(ctx, idOf) {
         close: closeCard,
         *sweep() {
             for (const [, p] of pending) {
-                // 走同一个 closeCard:出栈 + S1 复位 + 铸卡三步与显式关卡**逐字同一段代码**
-                // (拆分前这里把那三步又抄了一遍 —— 抄的那份就是「时序会漂」的第二个构造点)。
                 yield* closeCard(p);
             }
         },

package/dist/adapt/turnFlags.d.ts

@@ -1,65 +1,11 @@
-/**
- * adapt/turnFlags.ts — M6a **响应度量** + M6b **重试覆盖层**两个小状态机(A 族拆分;矩阵 §1.4)。
- *
- * 🔴 为什么这两件必须在**同一个文件**、而且必须**连驱动壳那一半一起搬**(矩阵 §3.3):
- *   它们各自只有三行代码,但每一件的两半都分居在「驱动壳的帧前置」与「某一条臂」里:
- *     · `messageStartEmitted`:D4 的 TTFT 门写它,`turn_usage` 臂(A6)把它复位成 false
- *       (下一个 model round 重新压基线);
- *     · `endEmitted`:A6 置位,`result` 臂(A7)读它当「别重复发 end」的门;
- *     · `retryOverlayActive`:`retry_status` 臂(A15)挂旗,D4 的「恢复即清」判位清旗。
- *   按「臂」切会切出**只有半个状态机**的边 —— 那正是 R1 五报里那条修最容易漂回去的地方。
- *   所以本文件的对外面是**动作**(onFrameBeforeDispatch / noteRetryStatus / …),而不是三个布尔位。
- *
- * 判据留给下一个人:本文件之外的任何地方都不该出现 `messageStartEmitted` / `endEmitted` /
- * `retryOverlayActive` 这三个名字**的代码引用**。grep 到了就是有人把状态机又劈开了。
- * ⚠️ ADAPT-F5 判据纠偏(2026-08-02):原文没排除注释面,而它在落码当天就已被同批文件证伪 ——
- * `arms.ts` 的帧序耦合注释(`⟨帧序耦合 7/7⟩` 那一处与臂序总表)按名字点这两个位是**有意的交叉
- * 索引**,不是状态机被劈开。一条恒假阳性的判据等于没有判据([probe-must-prove-it-speaks] 同族),
- * 所以判据锚在「代码引用」:grep 后先剔注释行,剩下的才算命中。
- */
 import type { AdapterContext, AdapterOutput } from '../seam.js';
 import { type Frame } from './ids.js';
 export interface TurnFlags {
-    /**
-     * 每帧**分派之前**的两道前置(顺序与拆分前逐字一致:先恢复即清,再 TTFT 起拍):
-     *  ① R1 重试覆盖层「恢复即清」;② 首个 `stream_event` 的 `response_metrics{phase:'start'}`。
-     */
     onFrameBeforeDispatch(m: Frame): Generator<AdapterOutput>;
-    /** A6 `turn_usage`:发 end 度量 + 压下一轮基线。 */
     emitTurnUsageEnd(outputTokens: number): Generator<AdapterOutput>;
-    /**
-     * A6 `turn_usage` 的**无数字那一支**(0.68.0;异源对抗复审轮五实抓)——
-     * **只压下一轮基线,不发任何帧**。
-     *
-     * 🔴 为什么必须把它拆出来:`emitTurnUsageEnd` 一直在做**两件事** —— 发 end 度量 **与** 把
-     * `messageStartEmitted` 复位(下一个 model round 重新压 TTFT 基线)。而 #711 之后,一轮没量出账时
-     * 这一拍**没有数字可发**(占位零不许当读数,见 `adapter/runStream.ts` 的那条判据)⇒ 若整条跳过
-     * `emitTurnUsageEnd`,**连模型轮边界也一起跳过了**:下一轮不再发 `response_metrics{start}`,
-     * 它的用量于是按**上一轮**的基线对账(实测:首轮 400 字符缺账、次轮 4 字符 + 50 tokens,
-     * 计数从 150 掉到 101,且下一轮的 TTFT 记录一并丢失)。
-     * 🔴 判据分家:**「这一轮结束了」是一件事,「这一轮花了多少」是另一件事** —— 前者与有没有数字
-     * 无关,后者才受占位零那条判据管。合成一个动作,过滤数字就会顺手把边界也过滤掉。
-     */
     noteModelRoundBoundary(): void;
-    /** A7 `result`:只有还没发过 end 且这帧真带了 outputTokens 时才补发(`!endEmitted` 门)。 */
-    /** `readOutputTokens` 惰性:只在真的要发 end 度量时才读 usage(与拆分前「`!endEmitted`
-     *  门内才读 `m.usage`」逐字同语义 —— 对抗复审 #3 收货修)。 */
     emitResultEndIfNeeded(readOutputTokens: () => number | undefined): Generator<AdapterOutput>;
-    /** A15 `retry_status`:挂旗(下一帧主 lane 内容到达即清)。 */
     noteRetryOverlay(): void;
-    /**
-     * A15 `retry_status` 的反向动作(#3004 跟修批 2026-08-08):**引擎直报恢复**(`recovered` 相)那一拍
-     * 调它 —— 返回「本次是否**仍需**发清除」并同时落旗(**原子**:读+落一步完成)。
-     *
-     * 🔴 为什么必须是「take」而不是「clear」(对抗复审命中的双清):两条清除腿共用同一个布尔位,
-     * 而它们的触发顺序两个方向都真实存在 ——
-     *   · `retrying → recovered`:直报腿先到,旗还在 ⇒ 本次要发清除,发完落旗;间接腿之后看不到旗。
-     *   · `retrying → 主lane内容 → recovered`:**间接腿先到**(已发过一次 null 并落了旗),直报腿这一拍
-     *     就**不该再发第二发** —— 已安装 core 在内容流跑完的 finally 里发 `recovered`,所以这个顺序
-     *     才是常态路径。首版写成无条件发 + `clearRetryOverlay()`,于是这条常态路径上双清。
-     * 返回 false ⇒ 本臂这一拍不 yield(没有覆盖层可摘,沉默才是诚实的);状态机仍只有本文件一处
-     * 持有那个布尔位。
-     */
     takeRetryOverlay(): boolean;
 }
 export declare function createTurnFlags(ctx: AdapterContext, turnStartAt: number): TurnFlags;

package/dist/adapt/turnFlags.js

@@ -2,18 +2,6 @@ import { chrome, mainLane } from './ids.js';
 export function createTurnFlags(ctx, turnStartAt) {
     let messageStartEmitted = false;
     let endEmitted = false;
-    /**
-     * R1(clay 五报 07-31):retry 覆盖层的四个清除点全在 turn 边界,缺「重试成功→清」的转移 ——
-     * 当时引擎重试成功那一刻什么都不发,所以恢复只能由「主 lane 又有内容在流」这个事实来证明。
-     * 挂旗后首个主 lane 内容帧即清,CC 同位 = 重试循环退出即 onRetryStatus(null)(pretty220 finally 清)。
-     *
-     * 🔴 现势更正(2026-08-08,#3004 跟修批):上面括号里原本写着「BrainStatusPhase 无恢复终态,候
-     * core [2163]」—— core 早已兑现,`BrainStatusPhase` 现有 `recovered` / `gave_up` 两个终态相。于是
-     * 本位这条**间接推断腿**不再是唯一证据:`retry_status` 臂拿到 `recovered` 时走 `takeRetryOverlay()`
-     * 直报清除。两条腿共用同一个布尔位、且都靠 take 的**原子读落**决定要不要发帧,所以无论到达顺序
-     * 如何(直报先 / 内容帧先),一次恢复合计**恰好一发** `status:null`(pure 门 R1b 段两个方向都钉)。
-     * 间接腿保留 —— 老引擎不发 `recovered`,它仍是那些部署上唯一的证据。
-     */
     let retryOverlayActive = false;
     return {
         *onFrameBeforeDispatch(m) {
@@ -23,11 +11,7 @@ export function createTurnFlags(ctx, turnStartAt) {
                     m.type === 'tool_end_result' ||
                     m.type === 'turn_usage') &&
                 typeof m.parentToolCallId !== 'string' &&
-                // stream_event 的子流标记在 event 里(thinking 臂同款判位),帧顶层没有。
                 typeof m.event?.parentToolCallId !== 'string') {
-                // 恢复即清:主 lane 内容帧到达 = 引擎那次重试已成功;子流帧(parentToolCallId)不算证据
-                // (主 brain 仍可能在退避等待,#47 矩阵 #5 同族判别)。落旗后 `takeRetryOverlay()` 会对随后
-                // 到达的 `recovered` 直报帧返回 false ⇒ 不补第二发(两条腿合计恰好一发)。
                 retryOverlayActive = false;
                 yield chrome({ kind: 'retry_status', laneProof: mainLane(), status: null });
             }
@@ -44,7 +28,7 @@ export function createTurnFlags(ctx, turnStartAt) {
         *emitTurnUsageEnd(outputTokens) {
             yield chrome({ kind: 'response_metrics', laneProof: mainLane(), phase: 'end', outputTokens });
             endEmitted = true;
-            messageStartEmitted = false; // 下一 model round 重新压基线(与 noteModelRoundBoundary 同一件事)
+            messageStartEmitted = false;
         },
         noteModelRoundBoundary: () => {
             messageStartEmitted = false;

package/dist/adapt/wireShapes.d.ts

@@ -1,104 +1,14 @@
-/**
- * adapt/wireShapes.ts — A 层的**帧形词表 + 纯投影助手**(A 族拆分 REF-CC-SPLIT-01)。
- *
- * 这里全是**纯函数与常量**:零可变量、零 module 台账、零 ctx 依赖。所以它既不出现在
- * 读写矩阵(ADAPT-RW-MATRIX §1)的任何一行里,也不需要任何时序约束 —— 判据锚在
- * 「本文件零 **module 级**可变绑定,也不 import 任何台账」,拆分后的状态归属讨论永远绕开它。
- * ⚠️ ADAPT-F6 判据纠偏(2026-08-02):原文写的是「本文件没有 `let`」,而 `estimateCjkTokens` 的
- * 累加器就是一个 `let t = 0`(函数体局部,进不了任何跨调用状态)。结论(零 turn 级状态)没错,
- * 写下的判据是错的:照它 grep 当场红,而真要防的东西(module 级 `let`)它一个字没说。
- *
- * 🔴 公面纪律:下面标了「公面」的六件在 0.1.x 起就是 `@sema-agent/client-core` 的导出名,
- * `adapt.ts` 用**具名再导出**把它们原样送出门(不是 `export *` —— 那会把 `TASK_TOOL_NAMES` /
- * `decisionOf` 这两件内部件一起推上公面,public-export-baseline 双向门当场红)。
- */
 import type { Frame } from './ids.js';
-/**
- * 活体增量攒批节拍的**默认值**(时钟从 ctx.now() 取;宿主可用 `ctx.coalesceIntervalMs` 覆盖)。
- *
- * 取值依据(两个都是实测,别把其中一个当"唯一真相"):
- *  · **100ms** = 我们对标的 CC 2.1.207 CLI 口径(187 时代是 16ms,207 提到 100ms 降重绘频率,
- *    长回答滚动更稳)—— 壳是 207 fork,所以库的默认值取它,壳消费本包时行为零变化;
- *  · **16ms** = CC **桌面端**宿主 `makeStreamDeltaCoalescer` 的单帧攒批节拍(设计稿 R1 实测)。
- * ⇒ 结论:**节拍是宿主渲染策略,不是 wire 语义** —— CC 自己两个端就是两个值。web/桌面宿主
- *   想要 16ms 就传 `coalesceIntervalMs: 16`,合并**语义**(思考先于文本、段边界重开块、
- *   committed 恒随后)在库里,一份。
- *
- * 🔴 顺带钉一句反面事实(R1 证伪,别再写进任何注释/文档):**"UI 从不见裸 token" 是错的** ——
- * CC 攒批后 flush 的载荷仍是 `stream_event` 增量 delta,CC 的 UI 照样消费增量;
- * 完整 assistant 消息是 SDK 另发的一路。我们这里的 `stream_delta` chrome 臂同构。
- *
- * 公面。
- */
 export declare const FLUSH_INTERVAL_MS = 100;
-/**
- * T40 IDLE-FLUSH 竞速窗(cli upstreamBridge `IDLE_FLUSH_MS` 逐字同值)。
- *
- * 病:模型转入长工具参数生成(大 Write 的 input_json 不经本桥)时 SSE 增量停摆,而 thinking/
- * answerSegment 里**已经生成**的内容还押着陪等(pty 确证:11s 整屏 hash 恒定)。
- * 修:增量停 ≥1.5s 且缓冲非空 ⇒ 先 drainLive()(活体预览语义不变),再提交思考+文本段
- * (段序铁律不破:本来就该在下一张工具卡前 flush,这里只是提前)。
- * 🔴 这是**过渡修**,正解在 core [817](wire 侧给事件);且**需要宿主定时器**:
- * `ctx.setTimer` 缺席 ⇒ 整条竞速不启用(纯等下一帧),与 0.4.0 逐字同行为。
- *
- * 🔴 **适用域收紧**(#323 症状①,2026-08-25 clay 裁 (a)+(b) 合取):上面这条「缓冲非空就提交」
- * 的原文**外溢**到了它没打算管的场景 —— 慢模型的正常吐字节奏本身就带 >1.5s 的卡顿,于是每卡一次
- * 切一刀,一轮回复碎成 N 条 assistant 消息(屏上 N 个 ⏺;离线复现:1600ms 间隔 ⇒ 19 条)。
- * 段提交因此改走 `textStream.takeAnswerSegmentOnIdle` 的**两条准入**:
- *   (a) 每个 answer segment 至多一刀(用掉之后要等一次正常边界重开新段);
- *   (b) 只在段尾是句末字符(`。！？…` / `.!?`)或换行时提交,否则跳过本拍等下一拍。
- * 原意(大 Write 静默窗:开场白句末收尾 + 长静默 ⇒ 开场白先上屏)在两条准入下**原样成立**。
- *
- * 公面。
- */
 export declare const IDLE_FLUSH_MS = 1500;
-/** cli SUBAGENT_TOOL_NAMES / WORKFLOW_TOOL_NAMES 同源(判别资产,别各自重写)。公面。 */
 export declare const SUBAGENT_TOOL_NAMES: ReadonlySet<string>;
 export declare const WORKFLOW_TOOL_NAMES: ReadonlySet<string>;
-/** 引擎 task 族工具(ctrl+t 面板台账同步的侧信道触发名;cli handleEngineTaskToolUse 受理的三名:
- *  TodoWrite 全量表 upsert + TaskCreate/TaskUpdate;其余工具该函数直接 return)。**内部件**。 */
 export declare const TASK_TOOL_NAMES: ReadonlySet<string>;
-/**
- * CC 自己的 reject/cancel 哨兵串(**数据**,非 CC 逻辑;cli src/utils/messages.ts:210-212 逐字)。
- * CC 的 UserToolResultMessage 按 content 串前缀路由到 reject/cancel 卡,不看 is_error 位。
- *
- * 公面。
- */
 export declare const REJECT_MESSAGE = "The user doesn't want to proceed with this tool use. The tool use was rejected (eg. if it was a file edit, the new_string was NOT written to the file). STOP what you are doing and wait for the user to tell you how to proceed.";
 export declare const CANCEL_MESSAGE = "The user doesn't want to take this action right now. STOP what you are doing and wait for the user to tell you how to proceed.";
-/** CJK 加权 token 估算(cli estimateCjkTokens 逐字:CJK≈0.6,其余≈0.25 tok/char)。公面。 */
 export declare function estimateCjkTokens(s: string): number;
-/**
- * T8 —— 压平 §E1 wire `output`(**非均匀**:`string` | `(TextContent|ImageContent)[]`,events.d.ts:78)
- * 成一条纯文本(cli `flattenWireOutput` 逐字)。text 块贡献 `.text`,image 块贡献中性占位 `[image]`
- * (转录卡是文本粒度),裸字符串直通。
- * 🔴 载荷 UNTRUSTED + 仅供观测(events.d.ts:80-85):渲染可以,**绝不回喂模型**;`truncated` 的更不行。
- * B4 把它从 B 层(`wireOutputToBody`)提到独立导出:A 层的 `settlePanelTasks(report)` 也要用它
- * (关卡时把子代最终报告串到面板行 end 事件上),两处必须同一份实现。
- *
- * 🔴 **包内另有一份块数组展平**(0.30.0 发包扫描登记,2026-08-14):`subagentContentStore.ts` 的
- * `coerceOutput`(子代查看态结果栏那一位)。它**不能** import 本文件 —— 那个 store 在 `runStream.ts`
- * 内核可移植闭包(`MAX_CLOSURE_FILES`,只许降)之内且以 dep-free 立身。两份由 **pure 门 ⑨b 段的
- * 等值断言**逐形对拍钉住(六形 + 逐字面值);改本函数的块数组语义 ⇒ 同批改那一份并看那条断言。
- * ⚠️ 两者只在**块数组与裸串**这两形上等值:非串非数组时本函数按「转录卡是文本粒度」返回 `''`,
- * 而 `coerceOutput` 走 `JSON.stringify`(它服务的是诚实缺席/原型不保的对象形),这一分叉是刻意的。
- *
- * 公面。
- */
 export declare function flattenWireOutput(output: unknown): string;
-/** 引擎 subagent 卡的短标签(cli shortTaskLabel 逐字)。公面。 */
 export declare function shortTaskLabel(task: string): string;
-/**
- * tool_use 块的渲染面消毒(cli assistant 臂逐条搬运,**纯函数**,不改入参):
- *  ① 摘 §E2 wire 身份(eventId/parentToolCallId)并从渲染块剥掉;
- *  ② 剥所有 `_sema_*` 保留哨兵(CC 的 per-tool 渲染器 safeParse strictObject,多一个键就降级成通用卡);
- *  ③ 引擎 subagent 参数名 {agent,task,taskName} → CC 名 {subagent_type,description,prompt}
- *     (strict schema 拒绝多余键 ⇒ REPLACE 不 merge;taskName 缺席时从 task 派生短标签);
- *  ④ 件8 类型标签诚实化:引擎通道兑现不了的 subagent_type 值一律删(只留 fork/general-purpose/worker),
- *     否则卡头会显示 `Plan(…)` 而实跑 general-purpose。
- *
- * 公面。
- */
 export declare function sanitizeToolUseBlock(block: Record<string, unknown>): {
     block: Record<string, unknown>;
     rawInput: unknown;
@@ -106,6 +16,4 @@ export declare function sanitizeToolUseBlock(block: Record<string, unknown>): {
     parentToolCallId?: string;
     label?: string;
 };
-/** seam 的 reserved decision 哨兵(cli decisionOf 逐字)。**内部件**;入参用具名 `Frame` 而不是
- *  再写一遍 `Record<string, unknown>`(同一个 unknown 边界只该有一个名字)。 */
 export declare function decisionOf(block: Frame): 'reject' | 'cancel' | 'error' | undefined;

package/dist/adapt/wireShapes.js

@@ -1,57 +1,10 @@
-/**
- * 活体增量攒批节拍的**默认值**(时钟从 ctx.now() 取;宿主可用 `ctx.coalesceIntervalMs` 覆盖)。
- *
- * 取值依据(两个都是实测,别把其中一个当"唯一真相"):
- *  · **100ms** = 我们对标的 CC 2.1.207 CLI 口径(187 时代是 16ms,207 提到 100ms 降重绘频率,
- *    长回答滚动更稳)—— 壳是 207 fork,所以库的默认值取它,壳消费本包时行为零变化;
- *  · **16ms** = CC **桌面端**宿主 `makeStreamDeltaCoalescer` 的单帧攒批节拍(设计稿 R1 实测)。
- * ⇒ 结论:**节拍是宿主渲染策略,不是 wire 语义** —— CC 自己两个端就是两个值。web/桌面宿主
- *   想要 16ms 就传 `coalesceIntervalMs: 16`,合并**语义**(思考先于文本、段边界重开块、
- *   committed 恒随后)在库里,一份。
- *
- * 🔴 顺带钉一句反面事实(R1 证伪,别再写进任何注释/文档):**"UI 从不见裸 token" 是错的** ——
- * CC 攒批后 flush 的载荷仍是 `stream_event` 增量 delta,CC 的 UI 照样消费增量;
- * 完整 assistant 消息是 SDK 另发的一路。我们这里的 `stream_delta` chrome 臂同构。
- *
- * 公面。
- */
 export const FLUSH_INTERVAL_MS = 100;
-/**
- * T40 IDLE-FLUSH 竞速窗(cli upstreamBridge `IDLE_FLUSH_MS` 逐字同值)。
- *
- * 病:模型转入长工具参数生成(大 Write 的 input_json 不经本桥)时 SSE 增量停摆,而 thinking/
- * answerSegment 里**已经生成**的内容还押着陪等(pty 确证:11s 整屏 hash 恒定)。
- * 修:增量停 ≥1.5s 且缓冲非空 ⇒ 先 drainLive()(活体预览语义不变),再提交思考+文本段
- * (段序铁律不破:本来就该在下一张工具卡前 flush,这里只是提前)。
- * 🔴 这是**过渡修**,正解在 core [817](wire 侧给事件);且**需要宿主定时器**:
- * `ctx.setTimer` 缺席 ⇒ 整条竞速不启用(纯等下一帧),与 0.4.0 逐字同行为。
- *
- * 🔴 **适用域收紧**(#323 症状①,2026-08-25 clay 裁 (a)+(b) 合取):上面这条「缓冲非空就提交」
- * 的原文**外溢**到了它没打算管的场景 —— 慢模型的正常吐字节奏本身就带 >1.5s 的卡顿,于是每卡一次
- * 切一刀,一轮回复碎成 N 条 assistant 消息(屏上 N 个 ⏺;离线复现:1600ms 间隔 ⇒ 19 条)。
- * 段提交因此改走 `textStream.takeAnswerSegmentOnIdle` 的**两条准入**:
- *   (a) 每个 answer segment 至多一刀(用掉之后要等一次正常边界重开新段);
- *   (b) 只在段尾是句末字符(`。！？…` / `.!?`)或换行时提交,否则跳过本拍等下一拍。
- * 原意(大 Write 静默窗:开场白句末收尾 + 长静默 ⇒ 开场白先上屏)在两条准入下**原样成立**。
- *
- * 公面。
- */
 export const IDLE_FLUSH_MS = 1500;
-/** cli SUBAGENT_TOOL_NAMES / WORKFLOW_TOOL_NAMES 同源(判别资产,别各自重写)。公面。 */
 export const SUBAGENT_TOOL_NAMES = new Set(['Task', 'Agent', 'Fork']);
 export const WORKFLOW_TOOL_NAMES = new Set(['Workflow', 'RunWorkflow', 'run_workflow']);
-/** 引擎 task 族工具(ctrl+t 面板台账同步的侧信道触发名;cli handleEngineTaskToolUse 受理的三名:
- *  TodoWrite 全量表 upsert + TaskCreate/TaskUpdate;其余工具该函数直接 return)。**内部件**。 */
 export const TASK_TOOL_NAMES = new Set(['TodoWrite', 'TaskCreate', 'TaskUpdate']);
-/**
- * CC 自己的 reject/cancel 哨兵串(**数据**,非 CC 逻辑;cli src/utils/messages.ts:210-212 逐字)。
- * CC 的 UserToolResultMessage 按 content 串前缀路由到 reject/cancel 卡,不看 is_error 位。
- *
- * 公面。
- */
 export const REJECT_MESSAGE = "The user doesn't want to proceed with this tool use. The tool use was rejected (eg. if it was a file edit, the new_string was NOT written to the file). STOP what you are doing and wait for the user to tell you how to proceed.";
 export const CANCEL_MESSAGE = "The user doesn't want to take this action right now. STOP what you are doing and wait for the user to tell you how to proceed.";
-/** CJK 加权 token 估算(cli estimateCjkTokens 逐字:CJK≈0.6,其余≈0.25 tok/char)。公面。 */
 export function estimateCjkTokens(s) {
     let t = 0;
     for (const c of s) {
@@ -68,23 +21,6 @@ export function estimateCjkTokens(s) {
     }
     return Math.round(t);
 }
-/**
- * T8 —— 压平 §E1 wire `output`(**非均匀**:`string` | `(TextContent|ImageContent)[]`,events.d.ts:78)
- * 成一条纯文本(cli `flattenWireOutput` 逐字)。text 块贡献 `.text`,image 块贡献中性占位 `[image]`
- * (转录卡是文本粒度),裸字符串直通。
- * 🔴 载荷 UNTRUSTED + 仅供观测(events.d.ts:80-85):渲染可以,**绝不回喂模型**;`truncated` 的更不行。
- * B4 把它从 B 层(`wireOutputToBody`)提到独立导出:A 层的 `settlePanelTasks(report)` 也要用它
- * (关卡时把子代最终报告串到面板行 end 事件上),两处必须同一份实现。
- *
- * 🔴 **包内另有一份块数组展平**(0.30.0 发包扫描登记,2026-08-14):`subagentContentStore.ts` 的
- * `coerceOutput`(子代查看态结果栏那一位)。它**不能** import 本文件 —— 那个 store 在 `runStream.ts`
- * 内核可移植闭包(`MAX_CLOSURE_FILES`,只许降)之内且以 dep-free 立身。两份由 **pure 门 ⑨b 段的
- * 等值断言**逐形对拍钉住(六形 + 逐字面值);改本函数的块数组语义 ⇒ 同批改那一份并看那条断言。
- * ⚠️ 两者只在**块数组与裸串**这两形上等值:非串非数组时本函数按「转录卡是文本粒度」返回 `''`,
- * 而 `coerceOutput` 走 `JSON.stringify`(它服务的是诚实缺席/原型不保的对象形),这一分叉是刻意的。
- *
- * 公面。
- */
 export function flattenWireOutput(output) {
     if (typeof output === 'string')
         return output;
@@ -103,34 +39,17 @@ export function flattenWireOutput(output) {
     }
     return '';
 }
-/** 引擎 subagent 卡的短标签(cli shortTaskLabel 逐字)。公面。 */
 export function shortTaskLabel(task) {
     const firstLine = (task.split('\n').find(l => l.trim()) ?? task).trim();
     const words = firstLine.split(/\s+/).slice(0, 6).join(' ');
     const label = words.length > 48 ? words.slice(0, 47) + '…' : words;
     return label || 'subagent';
 }
-/**
- * tool_use 块的渲染面消毒(cli assistant 臂逐条搬运,**纯函数**,不改入参):
- *  ① 摘 §E2 wire 身份(eventId/parentToolCallId)并从渲染块剥掉;
- *  ② 剥所有 `_sema_*` 保留哨兵(CC 的 per-tool 渲染器 safeParse strictObject,多一个键就降级成通用卡);
- *  ③ 引擎 subagent 参数名 {agent,task,taskName} → CC 名 {subagent_type,description,prompt}
- *     (strict schema 拒绝多余键 ⇒ REPLACE 不 merge;taskName 缺席时从 task 派生短标签);
- *  ④ 件8 类型标签诚实化:引擎通道兑现不了的 subagent_type 值一律删(只留 fork/general-purpose/worker),
- *     否则卡头会显示 `Plan(…)` 而实跑 general-purpose。
- *
- * 公面。
- */
 export function sanitizeToolUseBlock(block) {
     const out = { ...block };
     const rawInput = out.input;
     const eventId = typeof out.eventId === 'string' ? out.eventId : undefined;
     const parentToolCallId = typeof out.parentToolCallId === 'string' ? out.parentToolCallId : undefined;
-    // 🔴 B4 补漏(0.5.0 真缺口,差分守卫此前无 fixture 携 label ⇒ 漏得静默):core 的**展示名**
-    // `tool_start.label` 同样是侧信道,必须在渲染前摘掉 —— tool_use block 会进壳 transcript,
-    // /compact 时原样直发 provider,多一个键 = 400 invalid_request(cli 头注记的「件1 事故同款」)。
-    // 摘下来的值由调用方交给 engineToolLabelStore(纯函数不做副作用),unknown-tool 卡按
-    // toolCallId 查。今天唯一的真命中族 = MCP 远端工具(name=mcp__srv__tool / label=srv:tool)。
     const label = typeof out.label === 'string' ? out.label : undefined;
     delete out.label;
     delete out.eventId;
@@ -173,8 +92,6 @@ export function sanitizeToolUseBlock(block) {
         ...(label !== undefined ? { label } : {}),
     };
 }
-/** seam 的 reserved decision 哨兵(cli decisionOf 逐字)。**内部件**;入参用具名 `Frame` 而不是
- *  再写一遍 `Record<string, unknown>`(同一个 unknown 边界只该有一个名字)。 */
 export function decisionOf(block) {
     const input = block.input;
     const d = input?._sema_decision;

package/dist/adapt.d.ts

@@ -1,80 +1,25 @@
-/**
- * adapt.ts — L3 适配管线首批落码(#52a,2026-07-25)。
- *
- * 真源 = sema-cli `src/sema/upstreamBridge.ts` 的 `sdkMessagesToCcEvents`(~1500 行 generator,
- * 几十批 bug 修的结晶)。本文件把其中**纯投影**的臂搬成与宿主无关的双平面产出:
- *   · transcript 平面 = 重启后还该看得见的(committed assistant 文本/思考、tool_use 卡、
- *     task-notification user turn、compact 分界),载体 = CC `SDKMessage` 词汇;
- *   · chrome 平面 = 纯瞬态 + 宿主副作用(活体增量、spinner 计量、attachment 行、面板/队列/hook
- *     记账),载体 = `ChromeEvent`(每臂的宿主消费义务写在 seam.ts 臂注释里)。
- * 判据成文见 seam.ts 头注([1652]);id 一律走 `deriveTranscriptId`([1653] 不变量:同流重放
- * ⇒ 同 id 序列),**零 Math.random / 零 Date.now**——时钟与铸号全从 `AdapterContext` 注入。
- *
- * ⚠️ 本批**故意只做一半**(cli 迁移消费 = #52b)。未覆盖臂见 `ADAPTER_COVERAGE.todo`,差分守卫
- * (scripts/run-client-core-diff-test.mjs)把「cli 有、adapt 无」的清单钉死,防止悄悄漏臂。
- *
- * ── A 族拆分后的地图(REF-CC-SPLIT-01~05 / FIX-05,2026-08-02;设计=docs/refactor/ADAPT-RW-MATRIX.md)
- * `adapt()` 曾是 1139 行单方法(26 个 turn 级可变量 + 14 个闭包 + 15 个 case)。现在:
- *   本文件  = 公面契约表 + 适配器实例(台账)+ **驱动壳**(迭代器竞速 / abort / finally / 收口三形)
- *   adapt/ids.ts          零状态共用件(双平面包装、Frame、主车道证明出厂口、id 派生工厂)
- *   adapt/wireShapes.ts   帧形词表 + 纯投影助手(公面十件由本文件具名再导出)
- *   adapt/textStream.ts   M1 流合并器(矩阵 §1.1 十二行状态 + 竞速/节拍两处判据)
- *   adapt/toolCards.ts    M2 工具卡台账(§1.2 三行;S1 复位收进 close() 第一个 yield 前)
- *   adapt/panelTasks.ts   M3 面板行台账(§1.3 六行;通知臂那半场收成 settleFromNotification)
- *   adapt/turnFlags.ts    M6a 响应度量 + M6b 重试覆盖层(两个小状态机,两半必须同文件)
- *   adapt/instanceLedger.ts  三个实例级 Set(FIX-05:消 self/this 双路径)
- *   adapt/arms.ts         15 条帧臂的注册表(Map,不是对象 —— `{type:'__proto__'}` 会污染原型)
- * 🔴 最高不变量(拆分不许动):**段序铁律**(活体增量 → 思考 committed → 文本段 committed → 工具卡)
- *    与**重放确定性**(同流同 id)。收口三形(result 臂 / abort 尾 / T60 尾)**次序不同**,
- *    逐格差异见矩阵 §2.4,pure 门 SPLIT 段钉②/钉③ 把它们钉住了 —— 别归一。
- */
 import type { AdapterContext, AdapterOutput, WireToCcAdapter } from './seam.js';
-/**
- * ── A 族拆分(REF-CC-SPLIT-01,2026-08-02)—— 帧形词表与双平面共用件已落 `src/adapt/` ─────────
- * 本文件从此只留:公面契约表(coverage/divergences/ledger 形)+ 适配器实例(台账)+ **驱动壳**。
- * 词表与纯助手在 `adapt/wireShapes.ts`,双平面包装与 id 派生在 `adapt/ids.ts`。
- * 🔴 公面用**具名再导出**(不是 `export *`):`TASK_TOOL_NAMES` / `decisionOf` 是内部件,
- *    `export *` 会把它们推上 npm 公面,public-export-baseline 双向门当场红。
- */
 export { CANCEL_MESSAGE, estimateCjkTokens, flattenWireOutput, FLUSH_INTERVAL_MS, IDLE_FLUSH_MS, REJECT_MESSAGE, sanitizeToolUseBlock, shortTaskLabel, SUBAGENT_TOOL_NAMES, WORKFLOW_TOOL_NAMES, } from './adapt/wireShapes.js';
-/** 台账序列化形(#63 回植:重启恢复 = 台账加载 + 纯重放)。 */
 export interface AdapterLedgerState {
     version: 1;
-    /** 已渲染过的通知去重键(`[external:]taskId:status[:seq]`)。 */
     renderedNotifications: string[];
-    /** 已「跨通道通知过」的 run(收到终态推送帧后,补发通道不得再注入模型一遍)。 */
     notifiedRuns: string[];
-    /** 完成卡已入队的 run(probe 合成先发时,后到的推送帧只记账不再渲第二条)。 */
     cardEnqueuedRuns: string[];
 }
-/** 本批覆盖清单——差分守卫按它区分「已覆盖臂必须逐字段等价」与「已声明未覆盖臂」。 */
 export declare const ADAPTER_COVERAGE: {
-    /** 已落码的帧臂。 */
     readonly frames: readonly ["assistant", "user", "stream_event", "turn_usage", "result", "system", "task_notification", "workflow_complete", "diagnostics", "steering_injected", "workspace_changed", "human_input", "message_committed", "engine_notice", "text_end", "prompt_suggestions", "retry_status", "task_progress", "tool_end_result(label 补位 + 关卡 settle + response-id 复位 + 开卡台账出栈 + 经 cards.close 铸 tool_result)"];
-    /** 已落码臂产出的 transcript 消息类目(差分守卫的比对域)。 */
     readonly transcriptKinds: readonly ["assistant_text", "assistant_thinking", "assistant_tool_use", "user_tool_result_decision", "user_task_notification", "system_passthrough"];
-    /** B3(0.5.0)新落码的臂/半场 —— 从 todo 移过来的,别再在 todo 里留同名条目。 */
     readonly b3: readonly ["T38 三清第三清 + T57 第五处断闸:prompt_suggestions(turn 开场作废 + 子流断闸)", "T40 IDLE-FLUSH 1.5s 竞速(需 ctx.setTimer;缺席=不启用)", "T58 手动 iterator 的 finally cleanup(early break/throw 都要关上游生成器)", "T59 abort 半场(ctx.signal;中断后不产终答)", "T60 无 result 收尾腿(泄尾增量 → 清 liveness → 尾思考 → 尾文本段)"];
-    /** B4(0.6.0)新落码的臂/半场 —— A 层收官批,同样别再在 todo 里留同名条目。 */
     readonly b4: readonly ["A 层第 14 臂 task_progress:workflow lane 三级门 + 判据④ belt 回植 + C1 alias + bindTaskCard(显式父/FIFO/含糊即 unbound)+ inline stats + T50 双形读 + SubagentStart + #6 resident 台账 + 面板 tick", "settlePanelTasks 三处 sweep 全接线(tool_end 显式关卡带报告 / result 防御 sweep / turn 末 + abort sweep)", "P0-2 tool label 侧信道(sanitizeToolUseBlock 摘 label + engineToolLabelStore 登记;0.5.0 真缺口,label 会随 tool_use block 落转录 → /compact 直发 provider 400)", "task_notification 的两件宿主义务收回库内自持:dropQueuedNotificationsForRun + clearEnginePanelTaskResident;stop hook 的 if-started 门由库解", "T8 flattenWireOutput 提为独立导出(A 层 settle 报告与 B 层卡体同一份)"];
-    /** B5(0.7.0)新落码的臂/半场 —— B/D/E 层收批,同样别再在 todo 里留同名条目。 */
     readonly b5: readonly ["B 层 structuredToToolUseResult 14 case(ask-user-question/bash/edit/create/update/text/grep/glob/notebook-edit/cron-create/cron-delete/cron-list/agent/task-output)+ workflow-run 登记副作用", "D 层 wireOutputToBody 3 臂(bash / taskoutput / 泛化);structured 白名单在场时 T11+T14 正则退位,缺席保回落", "E 层 4 臂:#117a bg Bash 回执 + #158 Monitor 回执(同臂按工具名分,registration.source 判别;判定在库→chrome bgshell_register)· TodoWrite oldTodos 富卡 · ReportFindings 按名认领 · Remember→memory_saved 系统消息", "tool_end_result → user tool_result 正常路径(卡本体);result 与 turn 末两处开卡兜底关闭(abort 不兜底,cli 同)", "task/task-list structured → chrome task_ledger_sync{source:\"structured\"}(判定归一在库、落盘留宿主)", "T7 诚实缺席(§8-4:不搬 mock 合成器,改 degraded 标记)· T20 diff hunks 进包(src/diff/patch.ts)"];
-    /** 如实留白——写不动/依赖未搬运资产的臂,#52b 起分批接。 */
     readonly todo: readonly ["T13 的 **D 层** 半场(taskoutput block content)未随 structured 退位:退位会改 block content 形状(cli 那里是裸对象 = 件1 隐患),属行为面改动,无真实需求驱动 ⇒ 见 DIVERGENCE-8", "macrotask 让渡(cli 在提交前让出宏任务给 Ink;宿主渲染策略,不进库)"];
 };
-/** 本批**已知的、有意的**行为分歧(差分守卫显式登记,绝不当等价) */
 export declare const ADAPTER_DIVERGENCES: readonly [string, string, string, string, string, string, string, string, string];
-/** 有台账序列化位的适配器(seam 的 WireToCcAdapter 只定了 exportLedger——见 SEAM-GAP-1)。 */
 export interface WireToCcAdapterWithLedger extends WireToCcAdapter {
     exportLedger(): AdapterLedgerState & Record<string, unknown>;
-    /** 台账回植:返回真正吃进去的键数。 */
     importLedger(state: Partial<AdapterLedgerState> | Record<string, unknown>): number;
-    /** #63 resume 回植:从落盘转录里的 `<task-notification>` 块重建终态去重键。 */
     importLedgerFromTranscript(messages: ReadonlyArray<unknown>): number;
-    /** 宿主把「完成卡已入队」的事实喂回来(双通道反向去重;见 SEAM-GAP-3)。 */
     noteCardEnqueued(runId: string): void;
 }
-/** 造一个带台账的适配器实例(**一个 session 一个**——跨 turn 去重靠实例存活,重启靠 import/export)。 */
 export declare function createWireToCcAdapter(): WireToCcAdapterWithLedger;
-/** 一次性(无跨 turn 台账)投影:`frames → AdapterOutput`。多 turn 请用 createWireToCcAdapter()。 */
 export declare function adapt(frames: AsyncIterable<unknown>, ctx: AdapterContext): AsyncGenerator<AdapterOutput>;