@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/adapt.js

@@ -1,12 +1,4 @@
-// 本文件只剩台账 import/export 那四个方法要用的四个口;15 条臂的全部依赖已随臂表落 adapt/arms.ts。
 import { isEngineWorkflowNotified, isWorkflowCompletionCardEnqueued, listNotifiedRuns, listWorkflowCompletionCardsEnqueued, markEngineWorkflowNotified, noteWorkflowCompletionCardEnqueued, parseTranscriptNotificationSeeds, } from './notifications.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';
 import { IDLE_FLUSH_MS } from './adapt/wireShapes.js';
 import { chrome, mainLane, makeIdOf } from './adapt/ids.js';
@@ -16,9 +8,7 @@ import { createPanelTaskLedger } from './adapt/panelTasks.js';
 import { createAdapterInstanceLedger } from './adapt/instanceLedger.js';
 import { createTurnFlags } from './adapt/turnFlags.js';
 import { ARMS } from './adapt/arms.js';
-/** 本批覆盖清单——差分守卫按它区分「已覆盖臂必须逐字段等价」与「已声明未覆盖臂」。 */
 export const ADAPTER_COVERAGE = {
-    /** 已落码的帧臂。 */
     frames: [
         'assistant',
         'user',
@@ -31,28 +21,15 @@ export const ADAPTER_COVERAGE = {
         'diagnostics',
         'steering_injected',
         'workspace_changed',
-        // FIX⑦(2026-08-07):`human_input` 账本帧 —— 投 chrome 记账,**不铸 transcript 行**(不带正文)。
         'human_input',
-        // B-072 ④(0.65.0):`message_committed` 定位账本帧 —— 同 human_input 归 chrome(不带正文,
-        // 绝不铸 transcript 行);端拿它自建 entryId→已渲消息 映射,解析压缩分割线的保留段锚。
         'message_committed',
-        // #318 件①(2026-08-21):`engine_notice` 引擎结构化通告 —— 投 chrome(开集,一个码都不判)。
         'engine_notice',
-        // #323 / core #447 + L-310(0.68.1 改口):assistant 散文段边界 → **整段替换文本缓冲** +
-        // chrome text_segment_end(子流断闸在替换之前)。修前这里写「本批**不**动文本缓冲」——
-        // server 7.75.3 起 `text_end.content` 经脱敏器而 `text_delta` 仍逐字,不动缓冲 = 未脱敏字节
-        // committed 进本地转录;替换语义见 `adapt/textStream.ts` 的 `replaceAnswerSegment` 头注。
         'text_end',
         'prompt_suggestions',
         'retry_status',
         'task_progress',
-        // ⚠️ ADAPT-F10 事实纠正(2026-08-02):括注原写「不铸 tool_result」,而 B5 起这条臂**正是**
-        // 铸卡本体的地方(`arms.ts` tool_end 臂 → `cards.close()` → `toolCards.ts` yield 一条
-        // `{type:'user', content:[{type:'tool_result'…}]}`)。pure 门只按子串断言臂名在场,对括注里的
-        // 假话全盲 —— 存量假话不是本窗引入的,但它就长在本域文件上,顺手纠。
         'tool_end_result(label 补位 + 关卡 settle + response-id 复位 + 开卡台账出栈 + 经 cards.close 铸 tool_result)',
     ],
-    /** 已落码臂产出的 transcript 消息类目(差分守卫的比对域)。 */
     transcriptKinds: [
         'assistant_text',
         'assistant_thinking',
@@ -61,7 +38,6 @@ export const ADAPTER_COVERAGE = {
         'user_task_notification',
         'system_passthrough',
     ],
-    /** B3(0.5.0)新落码的臂/半场 —— 从 todo 移过来的,别再在 todo 里留同名条目。 */
     b3: [
         'T38 三清第三清 + T57 第五处断闸:prompt_suggestions(turn 开场作废 + 子流断闸)',
         'T40 IDLE-FLUSH 1.5s 竞速(需 ctx.setTimer;缺席=不启用)',
@@ -69,7 +45,6 @@ export const ADAPTER_COVERAGE = {
         'T59 abort 半场(ctx.signal;中断后不产终答)',
         'T60 无 result 收尾腿(泄尾增量 → 清 liveness → 尾思考 → 尾文本段)',
     ],
-    /** B4(0.6.0)新落码的臂/半场 —— A 层收官批,同样别再在 todo 里留同名条目。 */
     b4: [
         '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)',
@@ -77,7 +52,6 @@ export const ADAPTER_COVERAGE = {
         'task_notification 的两件宿主义务收回库内自持:dropQueuedNotificationsForRun + clearEnginePanelTaskResident;stop hook 的 if-started 门由库解',
         'T8 flattenWireOutput 提为独立导出(A 层 settle 报告与 B 层卡体同一份)',
     ],
-    /** B5(0.7.0)新落码的臂/半场 —— B/D/E 层收批,同样别再在 todo 里留同名条目。 */
     b5: [
         '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 正则退位,缺席保回落',
@@ -86,13 +60,11 @@ export const ADAPTER_COVERAGE = {
         'task/task-list structured → chrome task_ledger_sync{source:"structured"}(判定归一在库、落盘留宿主)',
         'T7 诚实缺席(§8-4:不搬 mock 合成器,改 degraded 标记)· T20 diff hunks 进包(src/diff/patch.ts)',
     ],
-    /** 如实留白——写不动/依赖未搬运资产的臂,#52b 起分批接。 */
     todo: [
         'T13 的 **D 层** 半场(taskoutput block content)未随 structured 退位:退位会改 block content 形状(cli 那里是裸对象 = 件1 隐患),属行为面改动,无真实需求驱动 ⇒ 见 DIVERGENCE-8',
         'macrotask 让渡(cli 在提交前让出宏任务给 Ink;宿主渲染策略,不进库)',
     ],
 };
-/** 本批**已知的、有意的**行为分歧(差分守卫显式登记,绝不当等价) */
 export const ADAPTER_DIVERGENCES = [
     'DIVERGENCE-1:`user` 帧透传——cli 的 switch 无 user 臂(default 丢弃),adapt 原样透传。' +
         '现役 wire 不产 user 帧(eventToSdkMessage 无该出口),故对真流是惰性的;保留是为了 desktop 重放存量转录。',
@@ -132,33 +104,18 @@ export const ADAPTER_DIVERGENCES = [
     'DIVERGENCE-9(B5):`tool_result` 消息的 uuid —— cli 在缺 `eventId` 时铸随机 v4,本包派生 ' +
         '`wtc_<toolUseId>`(DIVERGENCE-2 同族:同流重放 ⇒ 同 id 序列,[1653])。守卫按别名结构比,不比字面。',
 ];
-/**
- * 适配器实例 —— **台账**(通知去重/跨通道记账)挂实例,`adapt()` 每 turn 调一次,turn 级状态在
- * 调用内。跨 turn 语义(进程级去重)因此靠「同一个实例贯穿 session」保证,重启靠 import/export。
- */
 class WireToCcAdapterImpl {
-    /**
-     * 三个**实例级** Set 的持有者(A 族 FIX-05:收成一个显式对象,消 `self.`/`this.` 双路径)——
-     * renderedNotifications / seenWorkflowToolCallIds / firedSubagentStartHookTaskIds,
-     * 逐条语义见 adapt/instanceLedger.ts 头注(含 DIVERGENCE-6 的实例级 vs module 级分界)。
-     * 🔴 B5 ①:`notifiedRuns` / `cardEnqueuedRuns` **不在实例上** —— 它们的配对半场(清账的
-     *   dropQueuedNotificationsForRun、记账的两个 enqueue、idle watcher)全在 notifications.ts 的
-     *   module 台账上,放实例 = 前提不共享 = 双卡/零显示/模型二收(0.6.0 真缺口,[1857])。
-     *   适配器一律经 notifications.ts 的四个口读写,别在这里再长一份影子副本。
-     */
     ledger = createAdapterInstanceLedger();
     exportLedger() {
         return {
             version: 1,
             renderedNotifications: this.ledger.listRenderedNotifications(),
-            // B5 ①:这两项是 module 台账的快照(不是实例私有),跨实例一致。
             notifiedRuns: listNotifiedRuns(),
             cardEnqueuedRuns: listWorkflowCompletionCardsEnqueued(),
         };
     }
     importLedger(state) {
         let n = 0;
-        /** B5 ①:module 台账那两项经真源写口回植(has 判重 = 与实例台账那条同样只数新增)。 */
         const takeModule = (v, has, add) => {
             if (!Array.isArray(v))
                 return;
@@ -170,7 +127,6 @@ class WireToCcAdapterImpl {
             }
         };
         const s = state;
-        // 单次快照(对抗复审 #2 收货修):拆分前这里对 `renderedNotifications` 恰一次属性读。
         const rendered = s.renderedNotifications;
         if (Array.isArray(rendered))
             n += this.ledger.takeRenderedNotifications(rendered);
@@ -178,38 +134,18 @@ class WireToCcAdapterImpl {
         takeModule(s.cardEnqueuedRuns, isWorkflowCompletionCardEnqueued, noteWorkflowCompletionCardEnqueued);
         return n;
     }
-    /**
-     * #63 —— completion inbox 是 at-least-once 而去重面纯内存,重启即蒸发;「通知 user-turn 已落盘、
-     * ack 未落」的 crash 窗口重放 = 同一完成二次喂模型。落盘转录里的 `<task-notification>` 块携
-     * task-id/status/type="external",恰可重建**无 seq 键形**;Monitor 的 `:seq` 批键形不同,绝不误伤。
-     */
     importLedgerFromTranscript(messages) {
-        // 🔴 B7(T3):解析半场收成 `notifications.parseTranscriptNotificationSeeds`(**唯一一份**)。
-        //    此前本方法与 cli `seedEngineTaskNotificationDedupFromTranscript` 各写了一遍同样的
-        //    XML 反解 —— 两份手写解析里任何一份漂了,resume 回植就在那一侧静默失效(而两边代码
-        //    看着都对)。壳侧 shim 化后两个入口都落到同一个解析器上。
         const { renderedKeys, notifiedKeys, seeded } = parseTranscriptNotificationSeeds(messages);
         for (const k of renderedKeys)
             this.ledger.addRenderedNotification(k);
         for (const taskId of notifiedKeys) {
-            // cli seedEngineTaskNotificationDedupFromTranscript 同位:回植走 module 台账
-            // (outstanding 药丸 / idle watcher 收摊那半场读的就是它)。
             markEngineWorkflowNotified(taskId);
         }
         return seeded;
     }
     noteCardEnqueued(runId) {
-        // B5 ①:写 module 台账(与 dropQueuedNotificationsForRun 的清账半场共享前提)。
-        // 壳 B4 的队列端口回钩仍可调它 —— 三条入队链本来就写同一个集合,回钩因此变成幂等 no-op。
         noteWorkflowCompletionCardEnqueued(runId);
     }
-    /**
-     * CC-01(0.68.2):`adapt()` 的**出口单点** —— 每条产出过境时由 M1 盖段身份
-     * ({@link TextStream.stampSegmentIdentity};只盖 committed assistant 文本行,其余原样)。
-     * 放在出口而不放在各铸点:durable 整条消息(`assistant` 臂)与流式分段(M1 提交口)是两条腿,
-     * 归属键必须两条腿都盖,而「过境」是它们唯一的公共点(壳此前也正是在自己的过境口盖的)。
-     * 🔴 只包一层转发,不改内层的手动 `next()` 竞速与 abort 语义(T40/T58 全在内层)。
-     */
     async *adapt(frames, ctx) {
         const slot = {};
         for await (const out of this.adaptUnstamped(frames, ctx, slot)) {
@@ -217,48 +153,26 @@ class WireToCcAdapterImpl {
         }
     }
     async *adaptUnstamped(frames, ctx, slot) {
-        // FIX-05:实例台账走**唯一一条**显式路径(拆分前是 `self.` / `this.` 两条)。
         const inst = this.ledger;
         const turnStartAt = ctx.now();
-        // ── id 派生(实现落 adapt/ids.ts;工厂形只为把 ctx 绑进去)────────────────────────────────
         const idOf = makeIdOf(ctx);
-        // ── M1 流合并器(矩阵 §1.1 的 12 行状态整体落 adapt/textStream.ts)────────────────────────
         const text = createTextStream(ctx, idOf);
         slot.text = text;
-        // ── M2 工具卡台账(矩阵 §1.2 的 3 行状态整体落 adapt/toolCards.ts)────────────────────────
         const cards = createToolCardLedger(ctx, idOf);
-        // ── M3 面板行台账(矩阵 §1.3 的 6 行状态 + 五个闭包整体落 adapt/panelTasks.ts)──────────
-        //    依赖只有两件:M2 的**只读**开卡视图、实例台账。反过来 M2 不依赖 M3(单向边)。
         const panel = createPanelTaskLedger(ctx, cards, inst);
-        // ── M6a 响应度量 + M6b 重试覆盖层(两个小状态机;矩阵 §3.3:必须连驱动壳那一半一起搬)────
         const flags = createTurnFlags(ctx, turnStartAt);
-        /** 臂表的注入面 —— 矩阵 §3.5 的六件 **+ `flags`(七件,理由见 `ArmDeps` 头注 / ADAPT-F7)**,
-         *  不做全量注入(全量注入 = 封闭性声明失去判别力)。 */
         const deps = { ctx, idOf, text, cards, panel, flags, inst };
-        // turn 开场卫生(T38 三清,cli 逐条同序):清上一 turn 的 retry 覆盖层 + **上一轮的建议批** +
-        // 思考活动行,再发 request-start(T39)。三清缺一都是"上一轮的东西挂着不掉"。
         yield chrome({ kind: 'retry_status', laneProof: mainLane(), status: null });
         yield chrome({ kind: 'prompt_suggestions', laneProof: mainLane(), suggestions: null });
         yield chrome({ kind: 'thinking_activity', laneProof: mainLane(), active: false });
         yield chrome({ kind: 'request_start', laneProof: mainLane() });
-        // ── T40/T58/T59:手动 iterator + IDLE-FLUSH 竞速 + abort 断流 ────────────────────────────────
-        // `for await` 换成手动 next():① 才能与 idle 计时器 race(T40);② 才能在 abort 时立刻停;
-        // 代价是失去 for-await 的隐式 cleanup ⇒ finally 里手动 return()(T58,少了它 = SSE 不拆)。
         const iterator = frames[Symbol.asyncIterator]();
         let iteratorDone = false;
         try {
             for (;;) {
                 const nextPromise = iterator.next();
                 let step;
-                // 🔴 件 A 跟修的**留钉**(2026-08-25,一次证伪留档,免得下一棒再走一遍):判据收紧后同一个
-                //    `nextPromise` 会被 race **多圈**(判据没过就让位),曾疑心「每圈现造的派生 promise 没人
-                //    await ⇒ 上游 reject 时 unhandledRejection」。**实测证伪**:`Promise.race` 会给每个入参
-                //    挂反应,让位那些圈的派生 promise 因此都是 handled 的;上游的错照常经这一圈 await 抛出去。
-                //    对应常驻断言 = pure 门 B3 T40「上游 reject 照常抛给调用方」。所以这里**不改**(改成
-                //    只派生一次是纯分配面的微优化,零行为差,不值一处 diff)。
                 while (step === undefined) {
-                    // 缓冲全空 ⇒ 零开销路径;宿主没给定时器 ⇒ 竞速整条不启用(绝不 setTimeout 兜底)。
-                    // 判据本体(四项 or)已随 12 行状态收进 M1 —— 这里读的是它的具名形。
                     if (!text.hasPendingContent() || ctx.setTimer === undefined) {
                         step = await nextPromise;
                         break;
@@ -278,96 +192,63 @@ class WireToCcAdapterImpl {
                     else {
                         if (ctx.signal?.aborted)
                             break;
-                        // Idle ≥1.5s 且有已生成未提交的内容:现在就上屏(活体预览在前,再按 思考→文本 的
-                        // committed 序 —— 与工具卡前的边界 flush 逐字同序,只是提前发生)。
                         yield* text.drainLive();
                         yield* text.takeThinking();
-                        // 🔴 件 A(#323 症状①,2026-08-25):文本段走**专用入口** `takeAnswerSegmentOnIdle`
-                        //    (每段一刀 + 只在句末/段末提交),不是通用的 `takeAnswerSegment`。
-                        //    病:慢模型每 1.5s 一卡顿 = 一刀,一轮回复被切成 N 条 assistant 消息(屏上 N 个 ⏺)。
-                        //    适用域:本竞速的原意只是「大 Write 的静默窗别把已生成的开场白押着」,不是
-                        //    「每停 1.5s 就切一段」。终局 flush(工具卡前 / turn 收口)那条路**零改动**。
                         yield* text.takeAnswerSegmentOnIdle();
-                        // 缓冲(可能)已空 ⇒ 下一圈直接 plain-await;判据没过时段缓冲还在,下一拍再race。
                     }
                 }
                 if (step === undefined)
-                    break; // abort while idle-waiting
+                    break;
                 if (step.done) {
                     iteratorDone = true;
                     break;
                 }
                 const rawFrame = step.value;
-                // T59 — 信号一跳就停止投影(后续任何臂都不再渲染)。
                 if (ctx.signal?.aborted)
                     break;
                 const m = rawFrame;
                 if (m === null || typeof m !== 'object')
                     continue;
-                // ── 帧前置(M6a/M6b 两个小状态机的驱动壳那一半;两半同文件,见 turnFlags.ts 头注)──
-                //    ① R1 重试覆盖层「恢复即清」;② 首个 stream_event 的 TTFT 起拍。次序与拆分前逐字一致。
                 yield* flags.onFrameBeforeDispatch(m);
-                // 持久臂之前先把活体增量泄干净(活体预览恒先于它 settle 成的 committed 消息)。
-                // 🔴 矩阵 §2.4(a)留钉:`result` 臂**自己不带 drainLive**,靠的就是这一拍 ——
-                //    臂表化时若把「非 stream_event 先泄活体」的责任也挪进臂里,result 会漏泄。
                 if (m.type !== 'stream_event')
                     yield* text.drainLive();
-                // ── 分派(拆分前是一个 600 行的 switch;`default:` 空臂 = 表里查不到,行为同)────────────
-                //    单读快照(对抗复审 #1 收货修):旧 switch 对 `m.type` 恰一次属性读,`typeof m.type
-                //    ? m.type` 是两读 —— 对 accessor 形帧可观测,降回一读。
                 const rawType = m.type;
                 const armKey = typeof rawType === 'string' ? rawType : undefined;
                 const arm = armKey !== undefined ? ARMS.get(armKey) : undefined;
                 if (arm !== undefined)
                     yield* arm(m, deps);
-                // COALESCER 节拍尾(判据 + lastFlushAt 已收进 M1;`ctx.now()` 仍**只在 stream_event 那一拍**
-                // 取,与拆分前逐字同一处时钟读点)。
                 if (m.type === 'stream_event')
                     yield* text.maybeFlushOnBeat(ctx.now());
             }
         }
         finally {
-            // T58 — 手动 iterator 没有 for-await 的隐式 cleanup:early break(abort)或抛错都必须关上游
-            // 生成器(SSE 拆链)。正常跑完(done)不用关,上游自己结束了。
             if (!iteratorDone) {
                 try {
                     void iterator.return?.();
                 }
                 catch {
-                    // best-effort close — 绝不遮蔽原本的退出路径
                 }
             }
         }
-        // T59 — abort 后到此为止:不发合成终答、不做兜底(这个 turn 被打断了;CC 自己的 abort 路径
-        // 渲 InterruptedByUser chrome,那是宿主的事)。但**瞬态覆盖层必须收干净**,否则 Esc 之后
-        // 上一轮的 retry 行/思考活动行会一直挂着。
         if (ctx.signal?.aborted) {
             yield chrome({ kind: 'retry_status', laneProof: mainLane(), status: null });
             yield chrome({ kind: 'thinking_activity', laneProof: mainLane(), active: false });
-            // 复审修 #2a:被打断的 turn 也**必须**结掉自己的面板行,否则 Esc 之后 footer 药丸永远
-            // 显示 "1 local agent"(sweep 点 3/4;四点各有正控,见 pure 门 SPLIT 段钉①)。
             yield* panel.settle(null, false);
             ctx.log?.('debug', 'turn aborted (Esc) — no terminal answer emitted');
             return;
         }
-        // T60 —— turn 收口(cli 尾部同序,覆盖"流结束了但没有 result 臂"的路径):
-        // 泄尾增量 → 清 liveness → 提交尾思考 → 提交尾文本段。
         yield* text.drainLive();
         yield chrome({ kind: 'retry_status', laneProof: mainLane(), status: null });
-        // 复审修 #2a 孪生:没有 `result` 臂的收尾路径同样 sweep(sweep 点 4/4)。
         yield* panel.settle(null, false);
-        // B5:无 `result` 收尾腿同样关掉还开着的卡(cli 同位;abort 路径**不做**,见上)。
         yield* cards.sweep();
         yield* text.takeThinking();
         yield* text.takeAnswerSegment();
         ctx.log?.('debug', `turn done · emittedAssistantText=${text.emittedAssistantText} answerLen=${text.answerLength}`);
     }
 }
-/** 造一个带台账的适配器实例(**一个 session 一个**——跨 turn 去重靠实例存活,重启靠 import/export)。 */
 export function createWireToCcAdapter() {
     return new WireToCcAdapterImpl();
 }
-/** 一次性(无跨 turn 台账)投影:`frames → AdapterOutput`。多 turn 请用 createWireToCcAdapter()。 */
 export function adapt(frames, ctx) {
     return createWireToCcAdapter().adapt(frames, ctx);
 }