@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/seam.js

@@ -1,11 +1,3 @@
-/**
- * chrome 臂**覆盖率断言出口**的编译期底座(REF-CC-154,midband-02,gate)。
- *
- * 🔴 为什么是 `Record<ChromeArmKind, …>` 不是数组字面量:此前 `CHROME_ARMS` 直接手写成数组,
- * `ChromeEvent` 新增一个判别值时,漏补这张表**编译期零信号**——18 个判别值与表项手数对齐纯靠
- * 人工核对。`Record` 强制**每个** `ChromeArmKind` 成员都有一条目,少一个 = tsc 报错,新臂想不进表
- * 都不行(§B5「union 加成员必须打红全部消费 switch」的同族纪律)。
- */
 const CHROME_ARM_TABLE = {
     retry_status: { required: false, duty: '渲/清 spinner 的重试覆盖层' },
     panel_task: { required: true, duty: 'publishEngineAgentPanelEvent(event) 原样转发' },
@@ -20,22 +12,15 @@ const CHROME_ARM_TABLE = {
     subagent_lifecycle: { required: true, duty: 'fire SubagentStart/Stop hooks(去重已由库解)' },
     workflow_notification_enqueue: {
         required: true,
-        // 门/notified 记账/cardEnqueued 记号三件已由库在发臂前做完 ⇒ 宿主只投递,且必须用**裸入队**口。
         duty: 'message 裸入完成通知队列(不要用自带去重门的老函数),idle 时喂模型;门与两条记号归库',
     },
     task_ledger_sync: {
         required: true,
-        // 🔴 **两个 source 都要接**(B6 核实:同一张任务卡实测出两条)——`tool_use` 是卡刚开时的
-        // 乐观建行(旧引擎只有它),`structured` 是引擎回来的权威全量态(带真实 id/状态)。
-        // 只接前者 ⇒ 引擎真实 id 永不回填;只接后者 ⇒ 面板要等工具跑完才出现。幂等键 = toolUseId。
         duty: '按 toolUseId 幂等落 TaskCreate/TaskUpdate —— source 的 tool_use(乐观建行)与 structured(权威全量态)两条都要接',
     },
     inline_task_stats: { required: true, duty: 'tick/settle/settle_all 转发给 engineInlineTaskStats' },
     prompt_suggestions: { required: false, duty: '推 composer 上方 chips(绝不回喂模型)' },
     last_turn_usage: { required: true, duty: '落最近一次 turn 真 usage(statusline 回落源)' },
-    // L-228(0.67.0):per-subagent 分表。`required:false` —— 不接 = 子代详情的用量面看不见
-    // (一个可选披露面),不属「已发生的行为丢失」那一档;但**不接就永远说不出**每只子代花了多少
-    // (core 终局只有合计,没有 per-task 分项)。
     subagent_turn_usage: {
         required: false,
         duty: '可选:按 `taskId`(= `sourceTaskId ?? parentToolCallId`,与终帧分表同键)落 per-subagent 的 turn 用量(子代详情面)。' +
@@ -47,8 +32,6 @@ const CHROME_ARM_TABLE = {
             '🔴 终帧的 `_sema_nested_usage_by_task` 是同一份账的**收口快照**,两者**不相加**(本臂是增量、那是合计)',
     },
     plan_review_park: { required: true, duty: '弹 plan 审批卡(fail-soft,不挡后续终态帧)' },
-    // D-3 / B-068:终局对账。`required:false` —— 不接不等于哑掉(终帧的两个超集键载着同一份事实),
-    // 但**不接就必须自己按那两个键对账**,否则 /cost 恒低报子代与压缩两笔账(B-068 原病)。
     run_cost_reconciled: {
         required: false,
         duty: '可选:终局成本对账(own / nested / compaction 三段 + reconciled = own + nested)。' +
@@ -58,10 +41,6 @@ const CHROME_ARM_TABLE = {
             '渲「≥」或「至少」,绝不渲成一笔已知的账;它与两个 costAbsent 位**正交**(定了价也可能数不全),三句分别说;' +
             '🔴 流中的 `last_turn_usage` 增量与本臂的终局总账**不相加**(子代花费只经本臂到账,相加 = 重复计账)',
     },
-    // FIX⑦:账本帧,**不带正文** ⇒ 义务是可选的(记进审计/时间线即可);🔴 硬约束是**不许**据此
-    // 铸转录行,渲署名时必须带上 `actor.hostAsserted` 的可信度标注。
-    // B-072 ④:定位账本帧,**不带正文** ⇒ 义务可选(落一张 entryId→已渲消息的映射表);
-    // 🔴 硬约束同 human_input:不许据此铸任何 transcript 行。
     message_committed: {
         required: false,
         duty: '可选:落一张 entryId → 已渲消息 的映射表(压缩分割线 `_sema_preserved_segment` 靠它解析;toolResult 按 toolCallId 绑、其余按流序绑)。绝不铸 transcript 行(本帧不带正文);只有 live 腿有本帧,replay/resume 上映射表为空时不画分割线而不是画在最后一条',
@@ -70,9 +49,6 @@ const CHROME_ARM_TABLE = {
         required: false,
         duty: '可选:记进会话审计/时间线(谁把什么喂进了这条 run)。绝不铸 transcript 行(本帧不带正文);渲署名必须跟渲 actor.hostAsserted 的可信度标注',
     },
-    // #318 件①:引擎结构化通告。`required:false` —— 不接 = 这类披露在该宿主上看不见(一个可选的
-    // 披露面),不属「已发生的行为丢失」那一档。🔴 但一旦接,四条硬约束(code+detail 渲 / 未知码
-    // 不许丢 / 重放幂等 / moved-escalated 禁相减)在臂注释里是**真源**,duty 这行只是索引。
     engine_notice: {
         required: false,
         duty: '可选:渲引擎通告(按 code+detail,message 仅 fallback;未知 code 也必须渲不许丢;durable 重放按 eventId 幂等;harvest 的 moved/escalated 并列呈现绝不相减)',
@@ -115,8 +91,6 @@ const CHROME_ARM_TABLE = {
             '子代工具的进度不在这条臂上(三键断闸),fleet 面板另有口。不接 = 看不见进度,不属行为丢失。',
     },
     thinking_segment_end: {
-        // CC-02(0.68.3):与 text_segment_end 同一类目的后果 —— server 7.77.0 起不接 = 未脱敏的推理字节留在
-        //    本地转录里(b2 形上那条明文思考行已经渲过 = 已发生的行为)⇒ `required: true`,理由同上臂。
         required: true,
         duty: '整段替换:①`diverged`(never false)在场 ⇒ 自己拼 thinking stream_delta 上屏的端按 content 重渲该块;' +
             '②`committedPrefixDiverged`(never false)在场 ⇒ 所有端把 `committedUuids` 首行就地换成 content,其余行**删除或清空其推理正文**(宿主按自身转录结构选:有父链/压缩段依赖的转录清空优于删,保行身份;安全目标 = 未脱敏字节零留盘;整段换不切片;`committedUuid` = 末条兼容位;`committedPrefixLen` = 全部行全文长度之和,单位 UTF-16 代码单元);' +
@@ -138,8 +112,6 @@ const CHROME_ARM_TABLE = {
             '但绝不许把它渲成「已完成」的正面确认;两个位是长度不是内容,别拿它们当正文来源',
     },
     approval_request: {
-        // 🔴 `required: true` —— 不接 = 这个宿主上**流内审批卡整面哑掉**(重连后 pending 卡恢复不了),
-        //    而卡是「用户不点就不往下走」的东西,属「已发生的行为丢失」那一档,不是可选披露面。
         required: true,
         duty: '用 sdk isApprovalRequestFrameV1 窄化 frame 才取 card/askId/窗三键;窄不下来 ⇒ 呈通用卡(安全元数据 + 人工 approve/deny),' +
             '🔴 永不 auto-deny;按 approvalId 与 legacy tool_approval 帧去重(同一只 ask 出两帧,优先渲本帧);' +
@@ -147,18 +119,12 @@ const CHROME_ARM_TABLE = {
             'card 的 message/args 是模型/工具产文,只渲染永不回喂模型',
     },
     approval_revoke: {
-        // 🔴 `required: true` —— 不接 = 撤销之后本地卡**不清**,用户对着一张已经决断不了的卡按 Yes。
         required: true,
         duty: '用 sdk isApprovalRevokeFrameV1 窄化 frame 取 batchId/askIds/taskId;窄不下来按通用撤卡处理(该批本地卡照清);' +
             '🔴 三纪律:①按 taskId 归属过滤(孤儿撤帧行非我即忽略)②账本重放的撤帧只用于时间线渲染,卡集基准恒为开流 preamble' +
             '(撤帧可能整帧丢失)③已 DECIDED 的兄弟不在 askIds 里;真撤到本地卡时给一行归因(reason 消毒后呈现),零命中不要多说那一行',
     },
     text_segment_end: {
-        // 🔴 0.68.1 / L-310:`false` → `true`。改的理由不是「这一面更重要了」,是**后果类目变了**:
-        //    本表的 `false` 语义逐字是「不接 = 这条披露看不见,不属『已发生的行为丢失』」,而 server
-        //    7.75.3 起不接的后果是**未脱敏字节留在本地转录里**(b2 那一形上,那条明文消息**已经渲过**
-        //    ⇒ 就是「已发生的行为」)。留 `false` = 把一条安全面义务标成可选,正是本仓点名要治的
-        //    「假 affordance / 悄悄的谎」。⚠️ 这一位翻面会让按本表自检覆盖率的端**当场显形**——那正是目的。
         required: true,
         duty: '🔴 引擎明报的 assistant 散文段边界 + **该段权威全文**(#323/core #447;server ≥7.75.3 起 content 经脱敏器、' +
             'text_delta 仍逐字 ⇒ 两者**可以不相等**)。①`diverged` 在场(never false)⇒ 你按增量拼出来的那一段是过期的,' +
@@ -172,25 +138,7 @@ const CHROME_ARM_TABLE = {
             '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = 前段定稿前缀 + content、其余行空;别整行换首行,提交行可能带上一段定稿),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位。',
     },
 };
-/**
- * chrome 臂**覆盖率断言出口**(§8-1 裁决的一半:client-core 定接口不定实现)。
- *
- * 用途:任何宿主(TUI / web / 桌面)在自检里遍历本表,对 `required:true` 的臂断言"我实现了消费口"。
- * 不实现 = 该 UI 面在那个宿主上是**哑的**(不是报错,是静默没有)—— 这正是多端最容易漏的一类,
- * 所以把义务做成**数据**而不是散落在注释里。
- *
- * `required` 判据:**不实现会让已发生的行为丢失**(转录/模型输入/hook/去重)⇒ true;
- * 只影响可选装饰(spinner 计量、活体预览、chips)⇒ false。
- * `duty` = 一句话义务(完整义务在上方每臂的注释里,那里是真源)。
- *
- * 数组形对外形状不变(消费方逐字沿用 `CHROME_ARMS.map/find/filter`)——真源是上面
- * {@link CHROME_ARM_TABLE},本表只是它的 `Object.entries` 派生投影。
- */
 export const CHROME_ARMS = Object.entries(CHROME_ARM_TABLE).map(([kind, d]) => ({ kind, required: d.required, duty: d.duty }));
-/**
- * transcript id 确定性派生([1653] 定案):稳定键优先序 = 帧 id > seq > toolCallId;
- * 全缺才用 ctx.uuid()。同流重放 ⇒ 同 id 序列(往返守卫钉此不变量)。
- */
 export function deriveTranscriptId(frame, ctx) {
     if (typeof frame.id === 'string' && frame.id.length > 0)
         return `wid_${frame.id}`;