@sema-agent/client-core 0.77.1 → 0.77.2

package/dist/imagesWireCaps.js

@@ -1,21 +1,3 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/imagesWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/imagesWireCaps.ts — PURE projection of a CC user message's IMAGE content blocks → engine ImageInput[]
- * (CC paste-image / drag-image parity). seamQuery imports it.
- *
- * The signature "壳渲染后端空" hole: REPL.tsx:3444 builds Anthropic image blocks
- *   { type:'image', source:{ type:'base64', media_type, data } }  (or { type:'url', url })
- * into the user message's `content` block array, but seamQuery.objectiveFromMessage kept ONLY `type==='text'`
- * blocks — so pasted images RENDERED but never reached the live engine. core/service already consume
- * `body.images` (main.ts:1296 → core `TaskSpec.images?: ImageInput[]`, types.ts:416 + brain toUserBlocks); this
- * is purely the missing shell-side projection. config-class (model-content the caller chose for their OWN turn).
- *
- * core ImageInput = `{ data: base64, mimeType } | { url }`. We map the Anthropic base64 source
- * (`source.media_type`/`source.data`) → `{ data, mimeType }`, and a url source → `{ url }`.
- */
-/** Map one Anthropic image block's `source` → ImageInput, or null if malformed/unsupported. */
 function sourceToImageInput(source) {
     if (typeof source !== 'object' || source === null)
         return null;
@@ -28,10 +10,6 @@ function sourceToImageInput(source) {
     }
     return null;
 }
-/**
- * Extract the IMAGE blocks of a CC user message → ImageInput[]. Reads `message.content` (string | block[]) the
- * same way objectiveFromMessage reads its text; a bare-string content has no images ⇒ []. Malformed blocks drop.
- */
 export function imagesFromMessage(msg) {
     const m = msg;
     const content = m?.message?.content ?? m?.content;

package/dist/index.d.ts

@@ -1,137 +1,3 @@
-/**
- * @sema-agent/client-core — 客户端会话运行时(sema wire → CC 会话词汇表 + 端无关会话逻辑)。
- * 定位公理:[1832](CC 皮肤形状全收本包、wire 保持中性;TUI/web/桌面共用同一个包)。
- * seam 设计对签:[1651]/[1652]/[1653];依赖方向:sdk(wire)+agent-types(词汇表)→ 本包,永不反向。
- * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
- * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
- * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
- * 0.10.0 = **B8 批**(搬迁总线**末批**,设计稿 §8-5「print lane 收编」):
- *   ① **请求拼装合一收官**:B4 建的 `buildTaskRequest(input, lane)` 从此是 print lane
- *      (`seamQueryEngine.ask`)的**唯一**构造口 —— 壳里那份「`-p` 自己另拼一份」的字面量废除;
- *      车道差异全在 `REQUEST_FIELD_MATRIX`(print 独有 finalVerification/limits/interactiveTools、
- *      TUI 独有 ultracode 等,逐条带理由与 `gap` 判断)。新增可执行判据 `unregisteredRequestKeys`
- *      —— **真上 wire 的那份**请求也要过表,再漏一个键就当场红(表以前只管得住构造器自己)。
- *   ② **`task_notification` 字段集合一**(`request/printNotification.ts`):print 出口帧与交互面
- *      共用 `normalizeTaskNotification` 这**一把闸**(空 task_id 丢帧 / summary 兜底 / status 回落),
- *      并补上**残局归因**(stoppedBy / resumable / partial / exitCode / diagnostics / result /
- *      lines / recentSteps / editedFiles / task_type / source / seq / injected)—— 修前这些位在
- *      `-p` 出口整段丢失,而 `-p` 恰恰是唯一没有人当场看着的车道。🔴 车道差异只剩 `status` 的
- *      killed⇒stopped 一条(CC 187 print 出口形,表里留注);去重键不出第二个名字,print 侧那份
- *      手写算法废除,直接用 `taskNotificationDedupKeyFromWire`。
- *   ③ **留壳**(§8-5 明写,本批一行没动):`PrintStreamProjector`(stream-json 帧序/SSE 重铸)与
- *      全部 stderr 分诊文案 —— 渲染面与人话面属端。
- * 0.9.0 = **B7 批**(设计稿 §3 B7「完成事件单一权威 + HITL」):
- *   ① **HITL 族四件**(新目录 `hitl/`):`hitlBridge`(整搬,🔴 **D-1 两元组 verbatim 回显**
- *      与「409 绝不自动重试」两段**逐字节**搬,pure 门 B7 段用冻结字面量 + 壳树双向对拍 +
- *      毒化行为口径三重钉)· `toolApprovalWire`(**拆**:判定/编排进包,三选卡本体经
- *      `ApprovalCardPort` 留端)· `askGateWire`(整搬;footer 通知与 Recent Denials 记账经
- *      `HitlHostSurface` 留端)· `planReviewWire`(整搬,**第七份 `wireConfig()` 收编闭合**)。
- *   ② **完成事件族 T2/T3**:`taskNotificationDedupKeyFromWire`(裸 wire 载荷键形)+
- *      `parseTranscriptNotificationSeeds` / `seedTaskNotificationDedupFromTranscript`
- *      (#63 resume 回植的 XML 反解)搬入 `notifications.ts`。**P1-3 未到货 ⇒ 只搬不删**,
- *      四道去重原样;退役条件登记进 `compensations.ts`(T1/T2/T3/T25/T53 五条)。
- *   ③ **`approvals.stream()` 换轮询**(census G20):`hitl/approvalsFeed.ts` —— SDK 原生推送优先、
- *      断流/无端点**回落轮询**的韧性臂保留;两条腿都收敛到「非 heartbeat 事件 ⇒ 重取权威
- *      `list()`」(SDK 自述 payload 是 FORWARD-DRAFT,绝不信未确认的 delta 形)。
- *   🆕 队列口新增**可选**动词 `enqueueMetaPrompt`(plan_review 结局回植;既有宿主不破)。
- * 0.8.0 = **B6 批**(设计稿 §3 B6,分两轮落):
- *   ——【前半,fleet/子代身份族】fleetClient 沿 §2.5 拆两半(帧体归库、连接归端):
- *   `fleet/fleetProjection` + `fleet/fleetLedger` · 子代 wire 族六件(`subagent/*`)·
- *   `engineSessionParam`(走新 `SessionPort`)· `engineWireTarget`(七份手抄 `wireConfig()` 收编
- *   前六份,第七份 `planReviewWire` 属 B7)· G13 taskStop 409 五形 typed · Path B 记号时序修。
- *   ——【后半,余项收官】① `detachWire` **拆**搬(判定 + cancel-arm 台账进包,信号路径的裸 fetch
- *   发射留宿主 —— 宪法例外 census C1-4;宿主取件口 `detachCancelArm()`)· `workflowClient` 整搬
- *   (投影器 + live 源)· `workflowMonitor` 契约(六个类型 + WPe,此前住在 TUI 渲染件里);
- *   ② **P4 残件三**:`hooksWireCaps`(SettingsPort 的第一个真消费者;port 缺席 = 整体 fail-closed)·
- *   `liveInitToolFace`(凭证换 §8-2 的 `resolveWireAuth`,三条动态 import 转静态)·
- *   **model 数据表**(`model/providerPresets.{ts,json}` + `modelFamilies.json` —— `modelBudgetRule`
- *   封顶① 的 `perModelCap` 的唯一来源;单一真源三锚见 model/providerPresets.ts 头注);
- *   ③ **P5**:T32/T34/T47/T48/T49(整条进包)与 T35/T36/T44(拆)逐条核实并配断言,新出
- *   `compensations.ts` 登记表(自检口 `compensationSplitViolations()` 恒应为空)+ **P1-2 归属回落
- *   定案**(FIFO 回落**不删** = tolerate-absent 保护臂;typed 双键在场恒赢已成对反钉;退役条件
- *   钉在达标线 ≥ server 1.290)。
- *   ⚠️ B6 落码事实更正:P5 那八条的**落码全在 B4**,B6 做的是核实 + 登记 + 定案,不是二次搬迁。
- * 0.7.0 = **B5 批**(设计稿 §3 B5):① **配对台账折回**([1857] —— 0.6.0 把 `notifiedRuns`/
- *   `cardEnqueuedRuns` 放适配器实例,与清账/记账的另一半不共享前提 = 双卡/UI 零显示/模型二收,
- *   本批整体折回 notifications.ts 的 module 台账);② **B/D/E 层搬入**(`toolResult.ts`:
- *   structuredToToolUseResult 14 case + wireOutputToBody 3 臂 + E 层 4 臂),`adapt()` 从此
- *   自己铸 `tool_result` 卡与两处开卡兜底;③ **structured 白名单吃现货**([1840]§一 30 项 ——
- *   在场则 T11/T14 正则退位、T24 的 B 层惰性退位,缺席保回落,退位由**调用计数器**钉死);
- *   ④ **T7 诚实缺席**(§8-4:不搬 mock 合成器,改 `_sema_degraded:'wire_carried_no_output'`)与
- *   **T20 diff hunks 进包**(`diff/patch.ts`,本包**第一个** runtime dep `diff`)。
- *   🆕 两个 chrome 臂:`bgshell_register`(#117a 判定在库、执行留宿主)· `task_ledger_sync{source:'structured'}`。
- * 0.6.0 = **B4 批**(设计稿 §3 B4):A 层帧分派**收官**(第 14 臂 `task_progress` + 行绑定/
- *   inline stats/alias/#6 常驻台账/SubagentStart/workflow lane 三级门 + `settlePanelTasks` 三处 sweep
- *   全接线)· P0-2 tool label 侧信道补漏(0.5.0 真缺口)· **请求面合一**(`request/taskRequest.ts`:
- *   三个构造器的字段集与合并语义收成一份,车道差异做成 `REQUEST_FIELD_MATRIX` 数据表)·
- *   §8-2 构造点收编(`resolveWireAuth`)· §8-1 verb 门面接口定型(`ClientSliceLike` + `CLIENT_VERBS`,
- *   **编译期**双向闭合门)· `CHROME_ARMS` 覆盖率出口 · 包级宿主装配 `installHost()`(settings/fs/
- *   queue/timers 四口 + `hostPortMisses()` 自检)· `scratchpadWireCaps` 搬入(FsPort 端到端证明)。
- * 0.5.0 = **B3 批**(设计稿 §3 B3):`AdapterContext` 扩容(log/probe/signal/setTimer/clearTimer/
- *   coalesceIntervalMs,**只加可选位 = minor 不 BREAKING**)· 适配内核搬入(`adapter/types` 运行时
- *   半场 + `adapter/downstream` 三件 + `adapter/runStream`)· runStream **两条外向边切除**
- *   (lastTurnUsageStore / planReviewWire ⇒ `last_turn_usage` / `plan_review_park` 两个 chrome 臂)·
- *   T38 三清第三清 + T40 IDLE-FLUSH + T57 第五处断闸 + T58 iterator cleanup + T59 abort + T60 收尾腿。
- *   🆕 第三道守卫 `scripts/run-client-core-portability-test.mjs`(内核闭包 1571 文件 → **6 文件**)。
- * 0.4.0 = **B2 批**(设计稿 §3 B2):通知族三文件合并进 notifications.ts(engineTaskNotification 全文 +
- *   taskNotificationErrorSupplement 全文 + hookNoticeStore 判定半场)· 17 个 `*WireCaps` + engineWireSdk +
- *   sseIdleTriage + classifierVerdictWire 判定半场 + controlRouter + 模型面纯逻辑 4 件 + 新写 hostEnv;
- *   宿主耦合的 6 件(hooksWireCaps/scratchpadWireCaps/liveInitToolFace/engineSessionParam/
- *   modelContextResolver/agentModelResolver)**本批不搬**,原因逐条见交接报告。
- * 0.3.0 = **B1 批**(多端改造设计稿 §3 批次表第二批):纯函数/台账 11 文件 + 1 纯类型文件搬入
- *   (壳侧 shim 替换随后批)。B1 只搬现行为、零收编、零行为改动;唯一的形状订正是 workflow.ts
- *   补齐 `agent_runs[].errorCode` 类型位(0.2.0 抄件漏项)。
- *
- * 🔴 **单实例纪律**(B1 起本包不再只有纯函数):下列模块持 module 级可变状态,写方与读方必须解析到
- * **同一个包实例** —— 壳侧本地旧副本与 npm 包同时进 bundle = 状态分裂(台账写进一份、读另一份,
- * 症状是「台账恒空」的静默失效,不报错)。清单见各文件头 🔴 段:
- *   workflow.ts(workflowAgentTaskIds)· subagentContentStore.ts · engineAgentPanelStore.ts ·
- *   fleetAgentPanelProjection.ts · liveQuestionStore.ts · engineInlineTaskStats.ts ·
- *   engineCapsCache.ts · engineToolLabelStore.ts
- *   —— B2 新增:notifications.ts(11 个通知台账 + 队列 port + 两个 probe 槽)·
- *   agentsWireCaps.ts(prepare 缓存/投影闭包/一次性告警集)· liveModelCatalog.ts(目录 + refresher)·
- *   sessionModelLatch.ts(三个 latch)· ultracodeWireCaps.ts(sticky preset)。
- *   —— B4 新增:scratchpadWireCaps.ts(`ensured` 建目录闩)· host.ts(宿主口装配 + miss 计数);
- *   适配器**实例级**(非 module 级)新增 `firedSubagentStartHookTaskIds`——cli 那份是 module 级,
- *   本包放实例级是**有意的**(多 session 宿主上 module 形会让两个会话互吞 SubagentStart,见 DIVERGENCE-6)。
- *   —— B3 新增:adapter/runStream.ts(`inFlightTurns` 计数,读口 `isRunStreamActive()`;
- *   两份实例 = 引擎滚动升级门恒读 false ⇒ **turn 中途热换引擎**,正是它当初要防的事)。
- *   —— B6 新增(前半):fleet/fleetLedger.ts(`liveBgViews`;两份 ⇒ 引擎温切门恒读空 ⇒ respawn
- *   静默杀掉在飞 bg 子代)· subagent/engineDelegatedPrompt.ts(`transcriptIdByTask`;两份 ⇒
- *   Prompt 段恒留白而两边代码看着都对)· engineWireTarget.ts(`installed`)。
- *   —— B6 新增(后半,按「两份实例会怎样」从重到轻排):
- *     · **hooksWireCaps.ts**(`wireSessionStopHookPrompt` + `wireSessionStopHookCcSemantics`)——
- *       写方 = `/goal` 命令层,读方 = 每 turn 的请求构造期 `hooksForWire()`。两份 ⇒ 目标设了、
- *       投不出去,**而两边代码看着都对**(与 fleetLedger 同一种静默失效)。
- *     · **detachWire.ts**(`cancelArm`)—— 写方 = `-p` 发头那一刻,读方三个:`isDetachArmed`
- *       (400 分诊的第一道门)、`detachedTaskId`(分诊文案)、`detachCancelArm`(**宿主发射腿的
- *       取件口**)。两份 ⇒ 头发了但 hint 判不出 + Ctrl+C 取消不掉,两个静默失效各一半。
- *     · liveInitToolFace.ts(`cached`)—— 两份只是多探一次 `/v1/capabilities/scenarios/:name`,
- *       **不是**静默失效;仍登记,免得下次读表的人以为它没状态。
- *     · model/providerPresets.ts(`presetIndexCache`)—— 由不可变 JSON 派生的纯 memo,两份只费内存。
- *   —— B7 新增(两条都是**装在一份、读另一份 = 面直接不工作**,比台账分裂更响):
- *     · **hitl/toolApprovalWire.ts**(`cardPort` + `cardPortMisses`)—— 写方 = 宿主启动装配
- *       `installApprovalCardPort()`,读方 = 两条决断腿。两份 ⇒ `hasApprovalCardPort()` 恒 false ⇒
- *       **每一张写权限 gate 都走 fail-closed deny(卡根本不弹)**,而宿主那边"我装了啊"。
- *     · **hitl/askGateWire.ts**(`hostSurface` + `hostSurfaceMisses`)—— 写方 = 宿主装配,
- *       读方 = cancel-deny warn 与分类器 deny 记账。两份 ⇒ 那一行 warn 与 Recent Denials 全丢。
- * 🔴 **宿主装配**——B4 起总入口是 `installHost({log,probe,queue,timers,settings,fs,session})`
- *   (`installNotificationQueuePort()` 仍是队列的真源出口,`installHost({queue})` 直通它,两者不分裂);
- *   自检口 `hostPortMisses()` 恒应为空对象,非空 = 有口漏装、对应的面已在静默失效。
- *   —— B2 起的既有说明:`installNotificationQueuePort()` ——
- *   不装 = task-notification 投递静默丢失(`notificationQueuePortMisses()` 恒应为 0)。
- *   —— B3 新增(可选口,缺席 = 对应 UI 面在该宿主上是哑的,不是报错):`ctx.emitChrome`
- *   (runStream 的两条切边:statusline 真 usage / plan-review 审批卡)· `ctx.setTimer`
- *   (T40 IDLE-FLUSH,不给 = 长工具参数生成期已生成内容仍押到下一帧才上屏)· `ctx.signal`
- *   (Esc 中断)· `ctx.log` / `ctx.probe`(诊断面)。
- *   —— B6 的两个**计 miss** 口(缺席不是「少个装饰」):`session`(缺 ⇒ durable 子代读面对
- *   session-bound run 一律 404 fail-closed)· `settings`(缺 ⇒ `hooksForWire()` 整体 fail-closed
- *   返回 undefined —— 信任门是**安全门**,库不会「读不到策略就照投」)。
- *
- * 🔴 **补偿层账本**(B6 引入):`MIGRATED_COMPENSATIONS` + `compensationSplitViolations()` ——
- *   哪条壳侧补偿拆成了「判定归库 / 执行留宿主」、对面挂在哪个 chrome 臂、上游到货后何时退休,
- *   全做成数据。它**不是** `ADAPTER_DIVERGENCES`(那张表说的是 adapt 与 cli 行为**不同**的地方)。
- */
 export * from './seam.js';
 export * from './workflow.js';
 export * from './notifications.js';