@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/adapter/types.d.ts

@@ -1,38 +1,3 @@
-/**
- * ⇄ B3 批搬迁(2026-07-27,多端改造设计稿 §3 B3 / §2.4.1-C):cli `src/seam/adapter/types.ts` 的
- * **运行时半场**搬入(`eventSeq` / `uuid` / `stamp` / `EmitContext`),外加 B3 的两个注入位。
- *
- * 🔴 **这个文件是「拆」不是「整搬」**,拆缝写明(设计稿 §2.5 同款口径):
- *   · 搬进来的 = 三个纯函数 + EmitContext(零依赖,浏览器可跑);
- *   · **留在壳里的 = 那 8 行 zod 推断型别名**(`z.infer<ReturnType<typeof SDKMessageSchema>>` …,
- *     真源 = 壳内 CC 自带的 `src/entrypoints/sdk/coreSchemas.ts`)。
- *   为什么不搬:① 搬它就得把 coreSchemas.ts(1,996 行 CC 自带 zod)一起 vendor 进本包并新增
- *   `zod` 运行时依赖 —— 本包至今 `dependencies: {}`;② 那是 CC 自带文件,本包是**公开 npm 包**;
- *   ③ 本仓既定词表来源是 `@sema-agent/agent-types`(全量镜像,非 curation)。
- *   ⇒ 壳侧 shim 里 `export type SDKMessage = z.infer<…>` 这几行**原样保留**,壳的消费面看到的
- *   仍然是 zod 推断真身,一个消费点都不换型。本包内部用 agent-types 的同名镜像。
- *
- * 🔴 **两个 `SDKMessage` 不是同一个 symbol**(B1 发现#4,printToolResultFrame.ts 同款记账):
- *   两者都镜像 CC 的同一个 union,但是两条独立的类型来源。本包搬入的三个文件里 `SDKMessage`
- *   **只当不透明返回型用**(每个构造点都走 `as unknown as SDKMessage`),所以这个选择在本包内
- *   零后果;真正的接触点在壳侧 shim 那一刻的 tsc —— 报错就是真信号,不许 any 压。
- *
- * ── 以下为原文件头(逐字保留)────────────────────────────────────────────────────────────────
- * Adapter-internal shared types + id-stamp / emit / uuid helpers (T21).
- *
- * The seam runs ONE direction here: downstream `@sema-ai/sdk` `AgentEvent`s
- * (events.ts:14-41) are projected into Claude Code `SDKMessage` arms
- * (coreSchemas.ts:1854 union) that the verbatim-copied REPL renders.
- *
- * Two laws this file pins (contract 02 §0-§1, 08 branding/altitude invariants):
- *  - contract-sovereign: the WIRE shape is `AgentEvent`; CC's `SDKMessage` is
- *    the *reference shape we reproduce* for the renderer. We DOWN-map (drop
- *    fields), never demand the SDK grow.
- *  - provider-agnostic: NO Anthropic symbol crosses this seam — no raw
- *    `APIAssistantMessage` block array, no `RawMessageStreamEvent` wire, no
- *    rate-limit window taxonomy, no `effort`/`fast_mode` vocabulary
- *    (events.ts:6-10; contract 02 §5). Those fields are simply never populated.
- */
 import type { AgentEvent } from '@sema-agent/sdk';
 import type { ModelUsage, SDKMessage } from '@sema-agent/agent-types';
 import type { ChromeEvent } from '../seam.js';
@@ -40,76 +5,20 @@ export type { ModelUsage, SDKMessage };
 export type StampedAgentEvent = AgentEvent & {
     id?: string;
 };
-/** Read the stamped durable seq off an AgentEvent, if present. */
 export declare function eventSeq(ev: AgentEvent): string | undefined;
 export declare function uuid(): string;
-/**
- * 一条被丢弃的引擎帧的**结构化留痕**([C77]①,`EmitContext.onDroppedFrame` 的载荷)。
- * 两个位都取自 `EventProjection` 的 `dropped` 臂原值,包侧不做任何加工:
- *   · `type` = 引擎那一帧的 `type`(未知臂/畸形帧的臂名);
- *   · `why`  = 投影器给的判词(今天是 `unknown_arm` / `malformed` / `turn_end_usage_absent`)。
- *     🔴 第三个词是 **0.68.0 新加**(core 7.17.0 #711 之后 `turn_end.usage` 恒在场 ⇒ 缺席是
- *     **契约违约**而不是一条合法形):它是本包第一处「不是渲不出来,而是上游违约」的判词,
- *     正因为 `why` 是开集,宿主不必改型就能收到它。
- * 🔴 **不是**开集枚举:`why` 故意留成 string —— 投影器长出新判词时宿主不该编译不过,
- * 它本来就是「说给人看的一句判词」,不是控制流上的判别位。
- */
 export interface DroppedFrameInfo {
     readonly type: string;
     readonly why: string;
-    /**
-     * CC-13(0.69.2,additive):与 `why` 配套的人读判词(= `droppedWhySentence(why)`;开集 why 落缺省句)。
-     * 本包铸的载荷恒带;宿主自构造的载荷可缺席 ⇒ 读方 `info.sentence ?? droppedWhySentence(info.why)`。
-     */
     readonly sentence?: string;
 }
-/**
- * Per-stream identity context. `session_id` threads every emitted arm; it is the
- * service-minted sessionId (TaskResult.sessionId / RunReceipt.sessionId) once
- * known, falling back to a locally-minted placeholder before the first reply.
- */
 export interface EmitContext {
     sessionId: string;
-    /** Wall-clock ms when the stream started draining (runStream stamps it once) — the terminal projector
-     *  derives the CC `duration_ms` from it (P1-5: the wire carries no duration; 0 was a fake constant). */
     startedAtMs?: number;
-    /**
-     * L-215③(0.65.0)—— **这条流跑在哪个模型上**,由**宿主开流时钉**(与 `sessionId` 同一类:
-     * 请求是宿主构造的,模型 id 是它自己写进 `TaskRequest` 的那一个;wire 的内容帧上没有这一格)。
-     *
-     * 用途:`assistant` 臂的 `message.model` —— CC 的 `SDKAssistantMessage.message` 上本来就有这一位,
-     * 而本包此前交给渲染端的是**裸** `{role, content}`,于是宿主十几处消费面只能各自猜。
-     * 🔴 **缺席 ⇒ 那一位不铸,绝不猜**:一个猜错的模型名比没有更坏(账单/能力面会拿它去查表)。
-     * ⚠️ **它是「这条流声明的模型」,不是「这一轮真正服务的模型」**:mid-run degrade / 网关重路由
-     * 不改写它(与 `TaskResult.model` 同一条纪律,core 的 `task_progress.model` 臂注逐字写过)。
-     * 要「真正服务的那一个」请读终帧的 `TaskResult.model` / `degraded`。
-     */
     model?: string;
-    /**
-     * B3 新增(设计稿 §5.2 两条外向边的落点)—— chrome 事件下泄口。runStream 里那两条
-     * `import('../../sema/…')` 动态边改走这里:宿主注入一个 sink,库侧只发事件。
-     * 缺席 = 该宿主不消费(**语义 = 那个 UI 面在这个宿主上是哑的**,不是报错)。
-     *
-     * 返回 `Promise` 时 runStream 只在 **cli 原本 await 的那一处** await(plan_review park),
-     * 其余点 fire-and-forget —— 与搬迁前的时序逐点对齐,别顺手改成全 await。
-     */
     emitChrome?(event: ChromeEvent): void | Promise<void>;
-    /**
-     * [C77]① 新增(协作板 web-client 请托)—— **丢帧留痕的宿主出口**。runStream 的 `dropped` 臂
-     * (引擎发了一帧、这个 build 渲不出来)此前只有包侧一行 `console.error`,宿主拿不到结构化的
-     * `{type, why}`:web 想把它并进自己的 frame-warnings 面只能去 scrape stderr,而 Ink 宿主
-     * 干脆把 console 吞了。形制与上面的 `emitChrome` 同款 —— **可选注入,缺席 = 该宿主不消费**
-     * (缺省行为一字不变:仍走那行 console.error)。
-     *
-     * 语义三条(实现在 `runStream.ts` 的 `reportDroppedFrame`):
-     *   · **每一条丢帧都发**,不去重 —— 去重是 console 那条腿为了不刷屏才有的;替宿主去重 =
-     *     替它撒谎(两条同型丢帧在它的告警面上会变成一条,计数就不是真的了);
-     *   · 装了 sink ⇒ console 那行**让位**(sink 是更强的通道,两条腿同时喊会打乱 TUI 渲染);
-     *   · sink 抛错**绝不影响流**,并且痕迹落回 console —— 让位的前提是它真接住了。
-     */
     onDroppedFrame?(info: DroppedFrameInfo): void;
 }
-/** Stamp `uuid` + `session_id` onto a freshly-built arm body. */
 export declare function stamp<T extends {
     uuid?: string | undefined;
     session_id?: string | undefined;
@@ -117,27 +26,7 @@ export declare function stamp<T extends {
     uuid: string;
     session_id: string;
 };
-/**
- * CC-13(0.69.2):段末帧(`text_end` / `reasoning_end`)的**子流身份三键**(sdk `EventIdentity`)。任一在场 =
- * 这条段边界不是 leader 的。此前只在 `adapt/arms.ts` 私有,自建管线的端(print 车道 / 座位层)只能逐字复刻一份;
- * §37y ② 的义务在包,判定也该在包 —— 端改调本判定,别再自铸。住在本文件 = 内核闭包既有文件(portability 棘轮零抬)。
- */
 export declare const SEGMENT_END_IDENTITY_KEYS: readonly ["parentToolCallId", "sourceTaskId", "bgAgentId"];
-/**
- * CC-13:段末帧是不是子流的(三键任一**在场**)。按「键在不在」判,不按「是不是串」判 —— 坏值已在投影口
- * fail-closed(malformed);这一道是给非投影口喂进来的帧(宿主自建管线 / 重放存量转录)用的。
- * 参数收任意对象(帧型不限;typeshape 纪律:边界层不让 `unknown` 出境)。
- */
 export declare function isSubFlowSegmentEnd(m: object): boolean;
-/**
- * 身份四键(`eventId` + 三只子流键)的**一次性快照**:每键恰读一次,读取抛错 ⇒ `null`(= 整帧不可信,调用方拒帧)。
- *
- * 🔴 投影口与 adapt 侧的**每一条**读身份的臂都必须走这一只(0.76.1;外部验收方对 0.76.0 的两条发现):
- *    0.76.0 只把投影口换成了一次性快照,adapt 侧的 compaction 臂仍先判子流再取 `parentToolCallId`(读两次),
- *    text_end / reasoning_end 的投影更是在同一个表达式里读两次 ⇒ 值随读变的帧让「投影口 → 内部臂」与
- *    「直喂 adapt()」两条路分叉 —— 正是一次性快照要消灭的那一形,却只修了一侧。
- *    读了两次的两个值不能相信任何一个;读一次的那一份,两条路都拿同一份。
- */
 export declare function snapshotSegmentIdentity(m: object): Record<string, unknown> | null;
-/** 与 {@link isSubFlowSegmentEnd} 同一条判据,但吃的是快照(不再回头读帧)。 */
 export declare function snapshotIsSubFlow(snap: Record<string, unknown>): boolean;

package/dist/adapter/types.js

@@ -1,13 +1,7 @@
-/** Read the stamped durable seq off an AgentEvent, if present. */
 export function eventSeq(ev) {
     return ev.id;
 }
-// ── identity mock-fill (contract 02 §4: AgentEvents are anonymous) ────────────
-// CC SDKMessage arms require `uuid` + `session_id`. The wire drops them, so the
-// adapter mints them client-side. A v4-shaped uuid is sufficient for the
-// renderer's keying; it is NEVER smuggled onto the wire.
 export function uuid() {
-    // RFC4122-v4 shape; crypto.randomUUID when available, else a deterministic-enough fallback.
     const g = typeof globalThis !== 'undefined' ? globalThis.crypto : undefined;
     if (g && typeof g.randomUUID === 'function')
         return g.randomUUID();
@@ -17,21 +11,10 @@ export function uuid() {
         return v.toString(16);
     });
 }
-/** Stamp `uuid` + `session_id` onto a freshly-built arm body. */
 export function stamp(ctx, body) {
     return { ...body, uuid: body.uuid ?? uuid(), session_id: ctx.sessionId };
 }
-/**
- * CC-13(0.69.2):段末帧(`text_end` / `reasoning_end`)的**子流身份三键**(sdk `EventIdentity`)。任一在场 =
- * 这条段边界不是 leader 的。此前只在 `adapt/arms.ts` 私有,自建管线的端(print 车道 / 座位层)只能逐字复刻一份;
- * §37y ② 的义务在包,判定也该在包 —— 端改调本判定,别再自铸。住在本文件 = 内核闭包既有文件(portability 棘轮零抬)。
- */
 export const SEGMENT_END_IDENTITY_KEYS = Object.freeze(['parentToolCallId', 'sourceTaskId', 'bgAgentId']);
-/**
- * CC-13:段末帧是不是子流的(三键任一**在场**)。按「键在不在」判,不按「是不是串」判 —— 坏值已在投影口
- * fail-closed(malformed);这一道是给非投影口喂进来的帧(宿主自建管线 / 重放存量转录)用的。
- * 参数收任意对象(帧型不限;typeshape 纪律:边界层不让 `unknown` 出境)。
- */
 export function isSubFlowSegmentEnd(m) {
     const rec = m;
     for (const k of SEGMENT_END_IDENTITY_KEYS)
@@ -39,15 +22,6 @@ export function isSubFlowSegmentEnd(m) {
             return true;
     return false;
 }
-/**
- * 身份四键(`eventId` + 三只子流键)的**一次性快照**:每键恰读一次,读取抛错 ⇒ `null`(= 整帧不可信,调用方拒帧)。
- *
- * 🔴 投影口与 adapt 侧的**每一条**读身份的臂都必须走这一只(0.76.1;外部验收方对 0.76.0 的两条发现):
- *    0.76.0 只把投影口换成了一次性快照,adapt 侧的 compaction 臂仍先判子流再取 `parentToolCallId`(读两次),
- *    text_end / reasoning_end 的投影更是在同一个表达式里读两次 ⇒ 值随读变的帧让「投影口 → 内部臂」与
- *    「直喂 adapt()」两条路分叉 —— 正是一次性快照要消灭的那一形,却只修了一侧。
- *    读了两次的两个值不能相信任何一个;读一次的那一份,两条路都拿同一份。
- */
 export function snapshotSegmentIdentity(m) {
     const rec = m;
     const snap = {};
@@ -56,13 +30,10 @@ export function snapshotSegmentIdentity(m) {
             snap[k] = rec[k];
     }
     catch {
-        // §C1 带理由的吞:读身份键本身抛 = 这一帧连自己是谁都说不出 ⇒ 整帧拒,由调用方决定「丢」的姿势
-        // (投影口判 malformed 留痕、adapt 侧零 chrome);再向上抛会从两个入口逸出、打断整条 adapt 流。
         return null;
     }
     return snap;
 }
-/** 与 {@link isSubFlowSegmentEnd} 同一条判据,但吃的是快照(不再回头读帧)。 */
 export function snapshotIsSubFlow(snap) {
     for (const k of SEGMENT_END_IDENTITY_KEYS)
         if (snap[k] !== undefined)

package/dist/agentSession/backgroundView.d.ts

@@ -1,105 +1,8 @@
-/**
- * backgroundView — design/161 平行入口 `createBackgroundView(client)` 的实现(实现批 A,2026-07-30)。
- *
- * 契约锚 = ./contract.ts(类型已冻结,clay 二裁/终裁):`assistant.tasks` 与 `fleet` 都是**会话外
- * 读面**(assistant 跨 session;fleet 是 idle 壳唯一保持订阅的常驻 SSE),生命周期不绑任何会话的
- * dispose(),所以归一投影在 createAgentSession 之外单开一门。
- *
- * ── 两源两张映射表(第三套中性 7 值词表,不用任一方词表)────────────────────────────────────
- *   · assistant(SDK types.d.ts AssistantTask.status,3 值闭集):活跃调度行词表 —— 无终态臂。
- *   · fleet(SDK resources/fleet.d.ts FleetTaskStatus,9 值 wire 闭集 / 读侧开)。
- *   两张表各自显式穷举 + `never` 卫兵:上游加词当天**编译红**,不静默落兜底;wire 真发了未知词
- *   (更新的 server × 旧 SDK)时走注释里的 open-set 回落 —— 与 workflowClient coerce 族同姿势。
- *
- * ── 拉取姿势(照 workflowClient 0.11.15 的订阅纪律)─────────────────────────────────────────
- *   · 轮询(可配 intervalMs 缺省 2000)+ **解析即通知**(首帧不等宿主 tick)+ **订阅即对账**
- *     (已解析后订阅同步补一发 —— 配对机制必须共享前提);订阅者抛异常吞;dispose abort 在飞
- *     请求(含 fleet.snapshot 的 SSE 短连)并停循环。
- *   · 两源**独立拉取独立降级**:一源挂另一源照常;本源绝不 throw 进宿主。
- *   · fleet 快照走 SDK `fleet.snapshot()`(G19 一次性快照 verb:开流取首 snapshot 帧即断 ——
- *     fleet 面无独立 REST 快照端点,这是契约形不是绕路)。
- *
- * ── 'not-configured' 判别(诚实缺席纪律)────────────────────────────────────────────────────
- *   · fleet:面 gated off 时路由在任何帧之前答 **501**(typed)—— 501 ⇒ 'not-configured',
- *     其它错 ⇒ 'unavailable'(拒绝形分档;错误判型走 controlRouter.errCodes 单源)。
- *   · assistant:无 run store 时 worker 回 `{tasks:[]}` **原样透传** —— wire 上与真空不可区分。
- *     能探则探:`GET /v1/capabilities` 的 **`approvals`** 位为 false ⇒ 'not-configured';
- *     caps 面自己不可达 ⇒ 判别缺席,**如实回 'ok'**(绝不编造判别)。
- *
- *     🔴 件 3 取证(读错键的定谳,协作板 [C33]③.3 → server [C34],server 3.13.0 已把辖域写进
- *     代码注与 ARCHITECTURE):本实现此前读 `scheduler`,那是**错的键**。
- *       · `/v1/assistant/*` 的挂载条件是 `checkpointStore`(server `routes/approvals-assistant.ts:67`
- *         的分支头:`if (deps.checkpointStore && (url.startsWith("/v1/approvals") ||
- *         url.startsWith("/v1/assistant")))`),而 caps 里**同一个谓词**的键是 `approvals`
- *         (`capabilities.ts:56` `approvals: Boolean(deps.checkpointStore)`)。键名窄(approvals)、
- *         辖域宽(整条 assistant 车道)——按名字猜会猜错,这是上游文档欠账不是消费端不小心。
- *       · `scheduler` 是**另一回事**:host 单用户腿的自唤醒 cron 工具(CronCreate/CronDelete/
- *         CronList),它对自己承诺的东西是诚实的,与「计划运行视图在不在」无关。
- *       · 实测后果(3.7.0 local 形,DB_BACKEND=local 无 DURABLE_APPROVAL):caps.scheduler=true 而
- *         `GET /v1/assistant/tasks`=404 ⇒ 面板**永久**渲「Scheduled runs can't be reached right now」。
- *       · 🔴 两个看似更省事的修法都**不采**(server [C34] 逐条否掉):(a) 把 404 并进
- *         not-configured —— 会吞掉「caps 说有路由却 404」这个真信号(真的漏注册/误删就再也看不见);
- *         (b) server 把 checkpointStore 与进 scheduler —— 会污染一个本来准确的键。
- *         **判别规则一个字没改,只改读哪个键。**
- *       · 🔴 换键**不**收口的残余缺口(照旧候引擎位,本实现不猜):`approvals:true`(checkpointStore
- *         在)而 run store 未配时,worker 仍回 `{tasks:[]}` —— 那份空列表与「真的没有任务」在
- *         wire 上依旧同形。要收口需要 wire 长出判别位(caps 或响应信封),不是客户端能推出来的。
- *
- * 字段纪律:缺席=键不在场(undefined),🔴 绝不 `?? 0` / `?? false` / `?? ''`;ISO→epoch ms 只在
- * assistant 行边界转一次(updatedAt/createdAt 同一个转换器,fleet 的 startedAt 本就是 epoch ms
- * 直出);fleet 复合 id("<runId> <taskId>")整串不拆;fleet 子行(parentId 在场)不进 rows
- * (子代不是用户的独立后台任务)。两源的时间锚是**两个不同的量**,各占各的契约位、互不顶替:
- * assistant 给 `createdAtMs`(创建时刻)、fleet 给 `startedAtMs`(launch 时刻)——见 contract.ts
- * 两处逐位说明。fleet 行的 `sessionId`/`scope` 被 server `stripT` 剥掉不上 wire,别在投影里等。
- *
- * ── 📋 下一批工单(件 4 调研,不在本批实现):BackgroundRow 的 canonical stop 能力判别 ────────
- * 起因(协作板 [C33]③.4):web 报「`runs.cancel` 的 id 空间是 taskId,而 fleet 顶层行 id 是 runId、
- * 子行是复合 id」⇒ 他们对 fleet 行**不渲 Stop**(没有已挣得的取消路径就不摆按钮 —— 这个处置本身
- * 是对的,server [C34] 也同意)。主会话裁定:**不是「fleet 行没有停止路径」,而是要按行类型分**。
- * 下一批要落的形状(本批只调研落档,不新建 API):
- *   ① **能力判别**应当是行上的一等位(建议 `stop?: { verb, target }` 或等价判别),由包算、端只读
- *      —— 端各自判 = 每端一份猜测,正是本批修的那类病。缺席即「本行不可停」,端据此**显隐** Stop。
- *   ② **verb × id 映射**(包内既有件,全部已核实):
- *      · agent 行(fleet 顶层/子行):`runs.taskStop(hostRunId, handle)`,包内封装 =
- *        `src/subagent/engineTaskHandleWire.ts`(`POST /v1/runs/:id/tasks/:handle/stop?session=`)。
- *        **handle 取法**:复合 id `"<runId> <taskId>"` 取尾段 = 引擎 taskId —— 包内已有同语义实现
- *        `rowIdTail()`(`src/workflow.ts:24`,导出;`src/fleetAgentPanelProjection.ts:94` 有零依赖叶
- *        的私有同款副本);宿主 run 解析走 `getBgParentRun(handle)`(#242 批 3 起台账缺席即诚实缺席,绝不回落活跃 run)。
- *        **能力门** = `capabilities.taskHandles`(`src/subagent/engineRowStopGate.ts`
- *        `engineTaskHandlesCapable()`),🔴 别 trial-by-404。
- *        **回执纪律**(同文件 `engineRowNeedsStopConfirm()`):只有 **200 算停了**;409
- *        `stop.not_landed` / `stop.not_local` 一律保持原状(引擎里可能还在跑),端绝不自己翻 killed。
- *      · 顶层 durable run 行:`runs.cancel(taskId)`(包内 `controlRouter.cancel`,202 ack)。
- *        🔴 但 **park 住的行不能走它**:suspended/needs_review 行要 cancel-by-DENY
- *        (`src/hitl/hitlBridge.ts:283` / `src/hitl/askGateWire.ts:417` 逐字纪律)——
- *        所以「行在等人」(status==='waiting-on-human')时 stop 判别必须映射到决断面而不是 cancel。
- *      · workflow 行:**今天包/SDK 面上没有 workflow 的停止 verb** —— 实装 SDK 2.0.0 的
- *        `WorkflowsResource` 只有 list/get/journal/stream/steerAgent(逐个核过);而 `runs.d.ts:224`
- *        写着「a workflow handle 404s — stop workflows via their cancel face」,那个 "cancel face"
- *        **不在 SDK 公面上**。⇒ 下一批第一步是找 server 把它钉出来(是 `runs.cancel(w* runId)`
- *        还是独立端点),🔴 在拿到 server 的确证之前不许猜、不许在端上摆 Stop。
- *   ③ **不可停时端凭什么显隐**:凭①的键缺席,而**不是**凭 status —— 例如 'stopping' 行是「已经在
- *      停」(不该再给 Stop),park 行是「要走决断面」,老引擎无 taskHandles 是「面不在」,三者语义
- *      不同但都落在「不给 Stop」上;把它们压进一个 status 判断会在下一次加词时静默错。
- */
 import type { AgentClient, AssistantTask, FleetTaskRow, FleetTaskStatus } from '@sema-agent/sdk';
 import type { BackgroundRow, BackgroundSourceHealth, BackgroundStatus, BackgroundView, CreateBackgroundView } from './contract.js';
-/** assistant 3 值 → 中性 7 值。suspended(durable HITL park)与 needs_review(plan_review/dry-run
- *  park)都是「引擎停着等人」⇒ 同落 'waiting-on-human'(区分度由行上 gate.kind 携带,不铸新词)。 */
 export declare function backgroundStatusFromAssistant(s: AssistantTask['status']): BackgroundStatus;
-/** fleet 9 值 → 中性 7 值。'waiting'(durable suspend)与 'awaiting approval'(needs-review /
- *  plan-approval park)都在等人;'idle' 是「活着但此刻没在推进」—— 中性词表无此臂,按活跃行渲
- *  'running'(诚实取舍:它既不 queued 也不终态,更不是在等人)。 */
 export declare function backgroundStatusFromFleet(s: FleetTaskStatus): BackgroundStatus;
-/** 一行 AssistantTask → BackgroundRow。gate 是 `AssistantGate | null`(wire 显式 null 形)——
- *  null 折成键缺席,非 null 原引用透传(契约位是 unknown,包不重构造)。
- *  🔴 [C33]③.1 三键(name / sessionId / createdAtMs)按 wire 在场性投影:缺席=键缺席,绝不
- *  `?? 0` / `?? ''` —— 端渲的是「不知道」,不是「0 秒前创建的无名任务」。 */
 export declare function assistantTaskToBackgroundRow(t: AssistantTask): BackgroundRow;
-/** 一行 FleetTaskRow → BackgroundRow;子行(parentId 在场)⇒ null(调用方剔除)。
- *  复合 id 不拆;`currentTool` 契约位是一行字符串 —— 优先 server 已 redact 的 `currentAction`
- *  原文,缺席时从结构化 `currentTool` 合成;`needsAttention` fleet wire 无显式位,从 park 态
- *  推导(awaiting approval / awaitingPlanApproval / waiting),非 park 行键缺席(缺席≠false)。 */
 export declare function fleetTaskToBackgroundRow(r: FleetTaskRow): BackgroundRow | null;
 export interface BackgroundViewInputs {
     readonly assistant: {
@@ -111,17 +14,8 @@ export interface BackgroundViewInputs {
         readonly tasks: readonly FleetTaskRow[];
     };
 }
-/** 纯组合:两源(各带三态健康位)→ BackgroundView。行序 = assistant 先(core 已按 triage 排,
- *  消费方不再排)、fleet 后(帧到达序);非 'ok' 源的行不出(那份列表不是证词);sources 三态
- *  恒在场 —— 源不可用/未配置与「空列表」是三件事,端必须渲它。 */
 export declare function projectBackgroundView(i: BackgroundViewInputs): BackgroundView;
 export interface BackgroundViewOptions {
-    /** 轮询间隔(缺省 2000ms)。 */
     readonly intervalMs?: number;
 }
-/**
- * createBackgroundView(client, opts?) — 后台任务归一视图(契约 `CreateBackgroundView`;第二参是
- * 实现旋钮,可选参不缩窄契约形)。生命周期:构造即起后台轮询;`snapshot()` 首解析前 null;
- * `subscribe` 解析即通知 + 订阅即对账;`dispose()` abort 在飞请求、停循环、清订阅。
- */
 export declare function createBackgroundView(client: AgentClient, opts?: BackgroundViewOptions): ReturnType<CreateBackgroundView>;

package/dist/agentSession/backgroundView.js

@@ -2,9 +2,6 @@ import { abortableSleep } from '../abortableSleep.js';
 import { errCodes } from '../controlRouter.js';
 import { engineWireDebugEnabled } from '../engineWireTarget.js';
 import { hostLog } from '../host.js';
-// ── status 映射表 ×2(显式穷举 + never 卫兵)──────────────────────────────────────────────────
-/** assistant 3 值 → 中性 7 值。suspended(durable HITL park)与 needs_review(plan_review/dry-run
- *  park)都是「引擎停着等人」⇒ 同落 'waiting-on-human'(区分度由行上 gate.kind 携带,不铸新词)。 */
 export function backgroundStatusFromAssistant(s) {
     switch (s) {
         case 'running':
@@ -14,17 +11,12 @@ export function backgroundStatusFromAssistant(s) {
         case 'needs_review':
             return 'waiting-on-human';
         default: {
-            const exhaustive = s; // 上游加词 ⇒ 这里编译红(闭集穷举卫兵)
+            const exhaustive = s;
             void exhaustive;
-            // A-004.10:wire 开集回落改诚实形——此前未知新词按「活着」渲 'running',上游若加的是
-            // 终态词就是幽灵活跃行(#182 同病)。'unknown' = 不编造任何一头。
             return 'unknown';
         }
     }
 }
-/** fleet 9 值 → 中性 7 值。'waiting'(durable suspend)与 'awaiting approval'(needs-review /
- *  plan-approval park)都在等人;'idle' 是「活着但此刻没在推进」—— 中性词表无此臂,按活跃行渲
- *  'running'(诚实取舍:它既不 queued 也不终态,更不是在等人)。 */
 export function backgroundStatusFromFleet(s) {
     switch (s) {
         case 'queued':
@@ -46,26 +38,19 @@ export function backgroundStatusFromFleet(s) {
         case 'killed':
             return 'stopped';
         default: {
-            const exhaustive = s; // 上游加词 ⇒ 编译红;wire 未知词(读侧开集)⇒ 'unknown' 诚实回落(A-004.10)
+            const exhaustive = s;
             void exhaustive;
             return 'unknown';
         }
     }
 }
-// ── 行投影 ×2 ────────────────────────────────────────────────────────────────────────────────
-/** ISO 串 → epoch ms,只在这一处转;烂串 ⇒ undefined(诚实缺席,绝不 NaN/0 外泄)。 */
 function isoToEpochMs(iso) {
     const ms = Date.parse(iso);
     return Number.isFinite(ms) ? ms : undefined;
 }
-/** 非空串才算「有值」:空串是「没有名字」,不是名字(占位归端)。 */
 function nonEmptyString(v) {
     return typeof v === 'string' && v !== '' ? v : undefined;
 }
-/** 一行 AssistantTask → BackgroundRow。gate 是 `AssistantGate | null`(wire 显式 null 形)——
- *  null 折成键缺席,非 null 原引用透传(契约位是 unknown,包不重构造)。
- *  🔴 [C33]③.1 三键(name / sessionId / createdAtMs)按 wire 在场性投影:缺席=键缺席,绝不
- *  `?? 0` / `?? ''` —— 端渲的是「不知道」,不是「0 秒前创建的无名任务」。 */
 export function assistantTaskToBackgroundRow(t) {
     const wire = t;
     const updatedAtMs = isoToEpochMs(t.updatedAt);
@@ -83,10 +68,6 @@ export function assistantTaskToBackgroundRow(t) {
         ...(t.gate !== null ? { gate: t.gate } : {}),
     };
 }
-/** 一行 FleetTaskRow → BackgroundRow;子行(parentId 在场)⇒ null(调用方剔除)。
- *  复合 id 不拆;`currentTool` 契约位是一行字符串 —— 优先 server 已 redact 的 `currentAction`
- *  原文,缺席时从结构化 `currentTool` 合成;`needsAttention` fleet wire 无显式位,从 park 态
- *  推导(awaiting approval / awaitingPlanApproval / waiting),非 park 行键缺席(缺席≠false)。 */
 export function fleetTaskToBackgroundRow(r) {
     if (typeof r.parentId === 'string' && r.parentId !== '')
         return null;
@@ -96,10 +77,6 @@ export function fleetTaskToBackgroundRow(r) {
             ? `${r.currentTool.toolName}${r.currentTool.target !== undefined ? ` ${r.currentTool.target}` : ''}`
             : undefined;
     const parked = r.status === 'awaiting approval' || r.status === 'waiting' || r.awaitingPlanApproval === true;
-    // [C33]③.2 / server [C36]:launch 时刻 epoch ms(revive 行=本 revive 周期 wake 时刻),
-    // ADDITIVE / tolerate-absent —— 排队中的行本就没有,缺席即键缺席(0 不是「1970 年启动」)。
-    // 两腿同一个 mapper:`snapshot` 首帧行与 `task` 增量帧行(POST-MERGE FULL row)都过这里。
-    // 与 fleet 投影同律:只有**有限正数**算 launch 锚(非有限值渲不出时长,只会变成 `null`)。
     const startedAtMs = typeof r.startedAt === 'number' && Number.isFinite(r.startedAt) && r.startedAt > 0 ? r.startedAt : undefined;
     return {
         key: { source: 'fleet', rowId: r.id },
@@ -113,9 +90,6 @@ export function fleetTaskToBackgroundRow(r) {
         ...(currentTool !== undefined ? { currentTool } : {}),
     };
 }
-/** 纯组合:两源(各带三态健康位)→ BackgroundView。行序 = assistant 先(core 已按 triage 排,
- *  消费方不再排)、fleet 后(帧到达序);非 'ok' 源的行不出(那份列表不是证词);sources 三态
- *  恒在场 —— 源不可用/未配置与「空列表」是三件事,端必须渲它。 */
 export function projectBackgroundView(i) {
     const rows = [];
     if (i.assistant.health === 'ok') {
@@ -134,7 +108,6 @@ export function projectBackgroundView(i) {
         rows,
     };
 }
-/** 501 判读走 errCodes 单源(SDK typed APIError 的 status;`statusCode` 变体同吃)。 */
 function isNotImplemented(err) {
     const { status } = errCodes(err);
     return status === 501;
@@ -143,17 +116,11 @@ function debugLog(msg) {
     if (engineWireDebugEnabled())
         hostLog('debug', `[client-core][backgroundView] ${msg}`);
 }
-/**
- * createBackgroundView(client, opts?) — 后台任务归一视图(契约 `CreateBackgroundView`;第二参是
- * 实现旋钮,可选参不缩窄契约形)。生命周期:构造即起后台轮询;`snapshot()` 首解析前 null;
- * `subscribe` 解析即通知 + 订阅即对账;`dispose()` abort 在飞请求、停循环、清订阅。
- */
 export function createBackgroundView(client, opts) {
     const intervalMs = opts?.intervalMs ?? 2000;
     let disposed = false;
     let current = null;
     let lastSerialized = null;
-    /** caps 探针结果:null = 还没探到/caps 面不可达(判别缺席);boolean = approvals 位(见头注件 3)。 */
     let capsApprovals = null;
     const listeners = new Set();
     const abort = new AbortController();
@@ -169,8 +136,6 @@ export function createBackgroundView(client, opts) {
             }
         }
     }
-    /** caps 只需探到一次;失败保持 null 下轮重试(caps 面挂 ≠ assistant 面挂,判别缺席不编造)。
-     *  🔴 读的是 `approvals` 不是 `scheduler` —— 取证见头注「'not-configured' 判别」节件 3。 */
     async function probeCaps() {
         if (capsApprovals !== null)
             return;
@@ -185,26 +150,21 @@ export function createBackgroundView(client, opts) {
     async function pullAssistant() {
         try {
             const { tasks } = await client.assistant.tasks({ signal: abort.signal });
-            // 0.72.12 CC-50(#59 A-17):200 回体缺 tasks 键 = 读不出,不是「零任务」⇒ unavailable(空表 + ok 是编的)。
             if (!Array.isArray(tasks))
                 return { health: 'unavailable', tasks: [] };
             return { health: capsApprovals === false ? 'not-configured' : 'ok', tasks };
         }
         catch (err) {
             debugLog(`assistant.tasks degrade: ${String(err)}`);
-            // 🔴 只有 approvals:false(面本就没挂)与 501(路由自报 gated off)算 not-configured。
-            // 「caps 说有(approvals:true)却 404」**留在 unavailable** —— 那是两个真源对不上的报警,
-            // 吞掉它以后真的漏注册/误删路由就再也看不见了(server [C34] 明确否掉的修法 (a))。
             const health = capsApprovals === false || isNotImplemented(err) ? 'not-configured' : 'unavailable';
             return { health, tasks: [] };
         }
     }
     async function pullFleet() {
         try {
-            // G19 一次性快照 verb:SDK 内部开 SSE 流取首 snapshot 帧即断;abort.signal 直通 ⇒ dispose 能掐在飞连接。
             const { tasks } = await client.fleet.snapshot({ signal: abort.signal });
             if (!Array.isArray(tasks))
-                return { health: 'unavailable', tasks: [] }; // CC-50:同 assistant 腿
+                return { health: 'unavailable', tasks: [] };
             return { health: 'ok', tasks };
         }
         catch (err) {
@@ -214,7 +174,6 @@ export function createBackgroundView(client, opts) {
     }
     async function pollOnce() {
         await probeCaps();
-        // 两源并行、各自 try/catch —— 独立拉取独立降级,一源挂另一源照常。
         const [assistant, fleet] = await Promise.all([pullAssistant(), pullFleet()]);
         if (disposed || abort.signal.aborted)
             return;
@@ -231,13 +190,10 @@ export function createBackgroundView(client, opts) {
                 await pollOnce();
             }
             catch (err) {
-                // pullAssistant/pullFleet 各自兜底,这里只剩投影/通知的意外 —— 记录不外抛(本源绝不 throw 进宿主)。
                 debugLog(`poll cycle error (kept alive): ${String(err)}`);
             }
             if (disposed || abort.signal.aborted)
                 return;
-            // REF-CC-147:abort 感知的 sleep(dispose 立即唤醒并清定时器,不留悬挂 timer 拖住宿主
-            // 进程)——本函数原实现已抽成共享叶 ../abortableSleep.js,workflowClient.ts 同款消费。
             await abortableSleep(intervalMs, abort.signal);
         }
     }
@@ -248,7 +204,6 @@ export function createBackgroundView(client, opts) {
         },
         subscribe(onChange) {
             listeners.add(onChange);
-            // 订阅即对账:订阅前已解析的话,notify 那一发已经打空 —— 同步补一发,宿主不用白等一个 tick。
             if (current !== null && !disposed) {
                 try {
                     onChange();
@@ -268,5 +223,4 @@ export function createBackgroundView(client, opts) {
         },
     };
 }
-// 契约锚(编译期钉):实现必须可赋给冻结契约形 —— 参数缩窄/返回面缺员在这里红,不等运行期。
 void createBackgroundView;