@sema-agent/client-core 0.12.1 → 0.13.0

package/dist/adapt/toolCards.js

@@ -0,0 +1,100 @@
+import { deriveTranscriptId } from '../seam.js';
+import { degradedToolResultBody, detectEngineBgShellReceipt, reportFindingsToolUseResult, structuredToToolUseResult, todoWriteToolUseResult, wireOutputToBody, } from '../toolResult.js';
+import { chrome, MAIN, transcript } from './ids.js';
+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 回执 → ctrl+B 面板行(判定在库、执行留宿主)。
+        if (p.name === 'Bash' && !isError && end?.output !== undefined) {
+            const reg = detectEngineBgShellReceipt(p.rawInput, flattenWireOutput(end.output));
+            if (reg) {
+                yield chrome({ kind: 'bgshell_register', laneProof: MAIN, 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) {
+                rich = { toolUseResult: todo.toolUseResult, isError: todo.isError };
+                lastLiveTodos = todo.newTodos;
+            }
+        }
+        if (rich === null && !isError && p.name === 'ReportFindings') {
+            rich = reportFindingsToolUseResult(end?.structured, p.rawInput);
+        }
+        const eventId = end?.eventId ?? p.eventId;
+        const parentToolCallId = end?.parentToolCallId ?? p.parentToolCallId;
+        yield transcript({
+            type: 'user',
+            message: {
+                role: 'user',
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: p.id,
+                        content: body.content,
+                        is_error: rich?.isError === true || body.isError,
+                    },
+                ],
+            },
+            // 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 } : {}),
+        });
+    }
+    /** 关一张卡的**唯一**实现:出栈 + 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),
+        entries: () => pending.entries(),
+        open: (p) => {
+            pending.set(p.id, p);
+        },
+        close: closeCard,
+        *sweep() {
+            for (const [, p] of pending) {
+                // 走同一个 closeCard:出栈 + S1 复位 + 铸卡三步与显式关卡**逐字同一段代码**
+                // (拆分前这里把那三步又抄了一遍 —— 抄的那份就是「时序会漂」的第二个构造点)。
+                yield* closeCard(p);
+            }
+        },
+        mintResponseId: (frame) => (assistantResponseId ??= `msg_sema_${idOf(frame, 'resp')}`),
+        resetResponseId: () => {
+            assistantResponseId = null;
+        },
+    };
+}

package/dist/adapt/turnFlags.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 到了就是有人把状态机又劈开了。
+ */
+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>;
+    /** A7 `result`:只有还没发过 end 且这帧真带了 outputTokens 时才补发(`!endEmitted` 门)。 */
+    /** `readOutputTokens` 惰性:只在真的要发 end 度量时才读 usage(与拆分前「`!endEmitted`
+     *  门内才读 `m.usage`」逐字同语义 —— codex 复审 #3 收货修)。 */
+    emitResultEndIfNeeded(readOutputTokens: () => number | undefined): Generator<AdapterOutput>;
+    /** A15 `retry_status`:挂旗(下一帧主 lane 内容到达即清)。 */
+    noteRetryOverlay(): void;
+}
+export declare function createTurnFlags(ctx: AdapterContext, turnStartAt: number): TurnFlags;

package/dist/adapt/turnFlags.js

@@ -0,0 +1,55 @@
+import { chrome, MAIN } from './ids.js';
+export function createTurnFlags(ctx, turnStartAt) {
+    let messageStartEmitted = false;
+    let endEmitted = false;
+    /**
+     * R1(clay 五报 07-31):retry 覆盖层的四个清除点全在 turn 边界,缺「重试成功→清」的转移 ——
+     * 引擎重试成功那一刻什么都不发(BrainStatusPhase 无恢复终态,候 core [2163]),所以恢复只能由
+     * 「主 lane 又有内容在流」这个事实来证明。挂旗后首个主 lane 内容帧即清,CC 同位 = 重试循环
+     * 退出即 onRetryStatus(null)(pretty220 finally 清)。
+     */
+    let retryOverlayActive = false;
+    return {
+        *onFrameBeforeDispatch(m) {
+            if (retryOverlayActive &&
+                (m.type === 'stream_event' ||
+                    m.type === 'assistant' ||
+                    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 同族判别)。
+                retryOverlayActive = false;
+                yield chrome({ kind: 'retry_status', laneProof: MAIN, status: null });
+            }
+            if (m.type === 'stream_event' && !messageStartEmitted) {
+                messageStartEmitted = true;
+                yield chrome({
+                    kind: 'response_metrics',
+                    laneProof: MAIN,
+                    phase: 'start',
+                    ttftMs: ctx.now() - turnStartAt,
+                });
+            }
+        },
+        *emitTurnUsageEnd(outputTokens) {
+            yield chrome({ kind: 'response_metrics', laneProof: MAIN, phase: 'end', outputTokens });
+            endEmitted = true;
+            messageStartEmitted = false; // 下一 model round 重新压基线
+        },
+        *emitResultEndIfNeeded(readOutputTokens) {
+            if (endEmitted)
+                return;
+            const outputTokens = readOutputTokens();
+            if (outputTokens === undefined)
+                return;
+            yield chrome({ kind: 'response_metrics', laneProof: MAIN, phase: 'end', outputTokens });
+            endEmitted = true;
+        },
+        noteRetryOverlay: () => {
+            retryOverlayActive = true;
+        },
+    };
+}

package/dist/adapt/wireShapes.d.ts

@@ -0,0 +1,93 @@
+/**
+ * adapt/wireShapes.ts — A 层的**帧形词表 + 纯投影助手**(A 族拆分 REF-CC-SPLIT-01)。
+ *
+ * 这里全是**纯函数与常量**:零可变量、零 module 台账、零 ctx 依赖。所以它既不出现在
+ * 读写矩阵(ADAPT-RW-MATRIX §1)的任何一行里,也不需要任何时序约束 —— 判据锚在
+ * 「本文件没有 `let`,也不 import 任何台账」,拆分后的状态归属讨论永远绕开它。
+ *
+ * 🔴 公面纪律:下面标了「公面」的六件在 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 逐字同行为。
+ *
+ * 公面。
+ */
+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 事件上),两处必须同一份实现。
+ *
+ * 公面。
+ */
+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;
+    eventId?: string;
+    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

@@ -0,0 +1,167 @@
+/**
+ * 活体增量攒批节拍的**默认值**(时钟从 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 逐字同行为。
+ *
+ * 公面。
+ */
+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) {
+        const cp = c.codePointAt(0) ?? 0;
+        t +=
+            (cp >= 0x2e80 && cp <= 0x9fff) ||
+                (cp >= 0x3000 && cp <= 0x30ff) ||
+                (cp >= 0xac00 && cp <= 0xd7a3) ||
+                (cp >= 0xf900 && cp <= 0xfaff) ||
+                (cp >= 0xff00 && cp <= 0xffef) ||
+                (cp >= 0x20000 && cp <= 0x3ffff)
+                ? 0.6
+                : 0.25;
+    }
+    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 事件上),两处必须同一份实现。
+ *
+ * 公面。
+ */
+export function flattenWireOutput(output) {
+    if (typeof output === 'string')
+        return output;
+    if (Array.isArray(output)) {
+        const parts = [];
+        for (const block of output) {
+            if (block && typeof block === 'object') {
+                const b = block;
+                if (b.type === 'text' && typeof b.text === 'string')
+                    parts.push(b.text);
+                else if (b.type === 'image')
+                    parts.push('[image]');
+            }
+        }
+        return parts.join('');
+    }
+    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;
+    delete out.parentToolCallId;
+    if (out.input && typeof out.input === 'object') {
+        const cleaned = {};
+        for (const [k, val] of Object.entries(out.input)) {
+            if (!k.startsWith('_sema_'))
+                cleaned[k] = val;
+        }
+        out.input = cleaned;
+    }
+    if (out.input && typeof out.input === 'object') {
+        const inp = out.input;
+        const looksEngineSubagent = typeof inp.task === 'string' && inp.prompt === undefined && inp.description === undefined;
+        if (looksEngineSubagent) {
+            const task = inp.task;
+            const taskName = typeof inp.taskName === 'string' ? inp.taskName.trim() : '';
+            const label = taskName || shortTaskLabel(task);
+            const remapped = { description: label, prompt: task };
+            if (typeof inp.agent === 'string')
+                remapped.subagent_type = inp.agent;
+            if (typeof inp.model === 'string')
+                remapped.model = inp.model;
+            out.input = remapped;
+        }
+    }
+    if (SUBAGENT_TOOL_NAMES.has(out.name) && out.input && typeof out.input === 'object') {
+        const inp = out.input;
+        if (typeof inp.subagent_type === 'string' &&
+            !['fork', 'general-purpose', 'worker'].includes(inp.subagent_type)) {
+            delete inp.subagent_type;
+        }
+    }
+    return {
+        block: out,
+        rawInput,
+        ...(eventId !== undefined ? { eventId } : {}),
+        ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
+        ...(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;
+    return d === 'reject' || d === 'cancel' || d === 'error' ? d : undefined;
+}

package/dist/adapt.d.ts

@@ -1,69 +1,42 @@
-import type { AdapterContext, AdapterOutput, WireToCcAdapter } from './seam.js';
 /**
- * 活体增量攒批节拍的**默认值**(时钟从 ctx.now() 取;宿主可用 `ctx.coalesceIntervalMs` 覆盖)。
+ * adapt.ts — L3 适配管线首批落码(#52a,2026-07-25)。
  *
- * 取值依据(两个都是实测,别把其中一个当"唯一真相"):
- *  · **100ms** = 我们对标的 CC 2.1.207 CLI 口径(187 时代是 16ms,207 提到 100ms 降重绘频率,
- *    长回答滚动更稳)—— 壳是 207 fork,所以库的默认值取它,壳消费本包时行为零变化;
- *  · **16ms** = CC **桌面端**宿主 `makeStreamDeltaCoalescer` 的单帧攒批节拍(设计稿 R1 实测)。
- * ⇒ 结论:**节拍是宿主渲染策略,不是 wire 语义** —— CC 自己两个端就是两个值。web/桌面宿主
- *   想要 16ms 就传 `coalesceIntervalMs: 16`,合并**语义**(思考先于文本、段边界重开块、
- *   committed 恒随后)在库里,一份。
+ * 真源 = 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` 注入。
  *
- * 🔴 顺带钉一句反面事实(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` 逐字同值)。
+ * ⚠️ 本批**故意只做一半**(cli 迁移消费 = #52b)。未覆盖臂见 `ADAPTER_COVERAGE.todo`,差分守卫
+ * (scripts/run-client-core-diff-test.mjs)把「cli 有、adapt 无」的清单钉死,防止悄悄漏臂。
  *
- * 病:模型转入长工具参数生成(大 Write 的 input_json 不经本桥)时 SSE 增量停摆,而 thinking/
- * answerSegment 里**已经生成**的内容还押着陪等(pty 确证:11s 整屏 hash 恒定)。
- * 修:增量停 ≥1.5s 且缓冲非空 ⇒ 先 drainLive()(活体预览语义不变),再提交思考+文本段
- * (段序铁律不破:本来就该在下一张工具卡前 flush,这里只是提前)。
- * 🔴 这是**过渡修**,正解在 core [817](wire 侧给事件);且**需要宿主定时器**:
- * `ctx.setTimer` 缺席 ⇒ 整条竞速不启用(纯等下一帧),与 0.4.0 逐字同行为。
- */
-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>;
-/**
- * CC 自己的 reject/cancel 哨兵串(**数据**,非 CC 逻辑;cli src/utils/messages.ts:210-212 逐字)。
- * CC 的 UserToolResultMessage 按 content 串前缀路由到 reject/cancel 卡,不看 is_error 位。
+ * ── 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、MAIN、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 段钉②/钉③ 把它们钉住了 —— 别归一。
  */
-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;
-/** 引擎 subagent 卡的短标签(cli shortTaskLabel 逐字)。 */
-/**
- * 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 事件上),两处必须同一份实现。
- */
-export declare function flattenWireOutput(output: unknown): string;
-export declare function shortTaskLabel(task: string): string;
+import type { AdapterContext, AdapterOutput, WireToCcAdapter } from './seam.js';
 /**
- * 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。
+ * ── 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 declare function sanitizeToolUseBlock(block: Record<string, unknown>): {
-    block: Record<string, unknown>;
-    rawInput: unknown;
-    eventId?: string;
-    parentToolCallId?: string;
-    label?: string;
-};
+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;