@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/fleet/fleetProjection.js

@@ -1,49 +1,10 @@
 import { collapseLabel, escapeDisplayControlChars, taskDescFromName } from '../fleetTaskDesc.js';
 import { rowIdTail } from '../workflow.js';
-/**
- * SDK `FleetTaskStatus` 的终态词汇 —— 非终态即在飞(未知未来值按在飞算,保守)。
- * cli 侧 `engineBgGate.TERMINAL_STATUSES` 是**刻意的第二份**(零模块图污染),drift 由壳的
- * `terminalStatuses.test.ts` 锁定 —— 本批不动那份。
- */
 export const TERMINAL_FLEET_TASK_STATUSES = new Set([
     'completed',
     'failed',
     'killed',
 ]);
-/**
- * 未来/未知 wire 状态 → 渲染词汇(闭集但读侧开集)。
- *
- * ⚠️ **B6 未删 `parked`,与任务书的 G11 指令相反 —— 理由与直证写在这里**:
- *  · 直证(server 1.291.0 dist,`fleet/fleet-bus.d.ts` + `fleet-bus.js` 12 处 publishTask):
- *    `FleetTaskStatus` 闭集**不含** `parked`,且每处 publishTask 的 status 都出自
- *    `completed|failed|killed|running` 四值三元链 ⇒ 今天 `'parked'` 在 fleet 行 wire 上**不可达**,
- *    这一支确实是死分支。
- *  · 但**后果方向不对称**([anchor-on-the-deciding-quantity]「先定这个量门控动作的正负号」):
- *    本支是**保护型**映射(把非活非终态的 parked 映到 'awaiting approval');删掉之后
- *    它落 `default`(⚠️ [2393] notif-F5 纠:`default` 已由 REF-CC-043 改渲 `'idle'`,下面那段
- *    是权威;本行原写「渲成 `running` = 谎报活跃」是**退役后没跟的旧行为描述**)。core 1.382 已有该状态([1561],
- *    design/153 §7.1),server 只是尚未投影 ⇒ 这不是「猜测层」,是**预挂**。
- *    删的收益 = 一行;删的代价 = server 补上透传那天静默说谎。
- *  ⇒ 保留 + 把「候 server 预挂」的注释换成上面这条可复核的直证。定谳权交回 PM。
- *
- * 🔴 REF-CC-043(fleet2-05,P2 裁 GO,宪法三问已过):`default` 分支此前渲 `'running'` ——
- *  未知未来状态被谎报成「活跃」,后果方向是**伤害型**(用户会以为一个已经僵住/退场的子代还在跑)。
- *  改渲 `'idle'`(闭集里本就存在的「非活跃」词,187 用它表示「非活跃、非终态、非阻塞」)—— 门
- *  `ALWAYS_EMITTED_TASK_VIEW_KEYS` 不受影响,只是同一个已知渲染词的语义更诚实。
- *  🔴 [2393] notif-F5(2026-08-03 全窗复审)**补记宿主后果**(上一版裁决注只写到「同一个已知
- *  渲染词」,而下游语义比这句话大 —— 宪法三问的「谁受害」那一栏漏了这两处,补在这里以免下一棒
- *  照着「只是换个词」去判断):
- *    · 壳 `overrides/fleet-tree.tsx`:`idle` 分支**短路 elapsed 与 token 两列**(返回
- *      `elapsed:'idle'`、`tokenText:''`),`running` 则渲真 elapsed/tokens;
- *    · 壳 `overrides/fleet-view-screen.tsx`:`deriveBands` 把 `idle` 计进 **awaiting**(「等你处理」)
- *      档,`running` 计进 **working** 档。
- *  ⇒ status 缺席/脏的行现在会:丢掉 elapsed/tokens + 在表头被数成「awaiting」。方向仍然对
- *  (谎报活跃 = 伤害型,谎报不活跃 = 保护型),但它是一次**跨仓渲染语义**改动;三端提货单已点名
- *  (`docs/refactor/README.md`「提货单 / 破坏性变更清单」B 组),宿主侧另有一条陈述漂移待改
- *  (同表「宿主侧待办」:壳 engineBgShellPanelStore 的兜底方向陈述已成假话)。
- *  `s` 的参数类型同批收窄:`| undefined` 半支从未被真实调用点使用过(唯一生产调用点
- *  `projectTasks` 传的是 SDK 必填闭集 `FleetTaskRow['status']`),继续留着是死分支。
- */
 export function coerceTaskStatus(s) {
     switch (s) {
         case 'queued':
@@ -59,34 +20,9 @@ export function coerceTaskStatus(s) {
         case 'parked':
             return 'awaiting approval';
         default:
-            // 未知未来状态 → 渲成非活跃中性词(开集回落;绝不谎报活跃,REF-CC-043)。
             return 'idle';
     }
 }
-/**
- * 中性 workflow 状态(run 席 `running|completed|failed`;item 席多一个 `parked`)→ 渲染词汇。
- *
- * 🔴 **0.65.0 加 `parked`(L-215① / B-079②)**:sdk 9.0.0 把 item 席具名成 `WorkflowItemStatus`
- * 并加了 `parked`(「这一序数停在耐久审批门上等一次决定」),core 7.10.0 #642 是它的出处。
- * 修前这里**没有这个 case**,于是它落进 `default` 被折成 `running` —— fleet 车道上一条**停着等人**
- * 的工作流被渲成「在跑」,而那正是「等你」与「不需要你动」的分界。折成 `running` 之后用户没有任何
- * 线索去按 ctrl+t 找那张卡,run 就一直停在那里。
- * ⇒ 与 {@link coerceTaskStatus} 的 `parked` 臂**同一个落点** `awaiting approval`:同一件事在两条
- *   车道上必须渲同一个词(两处各渲各的正是同名不同义的来源)。
- *
- * 🔴 **为什么直接加词、而不是铸一个 `_sema_parked: true` 超集键**(任务书要求写明选形理由):
- * 判据是 sdk 那一位**在型面上开不开**,不是「它今天有几个已知值」——
- * `FleetWorkflowRow.status` 在 sdk 8.8.0 与 9.0.0 上都声明成裸 `string`(`dist/resources/fleet.d.ts`
- * 的 `status: string`,头注逐字「the NEUTRAL workflow run status (`running`|`completed`|`failed`),
- * **open on read**」)。**它不是闭集** ⇒ 一个新词在 wire 上、在型面上都合法,消费端要做的就是
- * 认它;此时再加一个 `_sema_` 前缀的孪生布尔,等于替一件上游已经能说清楚的事**另铸第二个真源**,
- * 而两个真源迟早分叉(本包一贯要根治的形)。超集键留给「上游那一位真是闭集、加词会让严格消费端
- * 判违约」的那一类,这里不是。
- *
- * ⚠️ **本函数仍收 run 席与 item 席两处**(调用点见 `projectWorkflows`):core 的两张词表里
- * `parked` 只在 item 席,所以 run 席读到它属于上游异常 —— 但**渲染面的处置相同**(都是「等人」),
- * 在这里为「哪一席」分叉只会长出一条没有用户面差别的分支。
- */
 export function coerceWorkflowStatus(s) {
     switch (s) {
         case 'completed':
@@ -102,20 +38,9 @@ export function coerceWorkflowStatus(s) {
         case 'running':
             return 'running';
         default:
-            // 0.72.12 CC-51(#64 同形):认不出的词不再谎报活跃 —— 与同文件 `coerceTaskStatus`(REF-CC-043)同律落
-            // 非活跃中性词 `idle`(FleetTaskStatus 是 wire 闭集,无 unknown 位;idle = 「活着但此刻没在推进」,
-            // 是闭集里唯一不断言方向的词)。
             return 'idle';
     }
 }
-/**
- * 187 给 fleet 行命名用的是 agent 的**身份**,从不是它的 objective:
- * `tjl(e) = e.type==="in_process_teammate" ? e.identity.agentName : e.agentType`
- * (ui-modules/0616_053_uiux_ejl.js:20-21)。SDK `FleetTaskRow` 带 `agentType`/`agentName`
- * (§K-7),所以这里**重建** tjl:`agentName`(in-process teammate 实例名)优先,否则 `agentType`
- * (subagent_type/teammate 类型名)。只有引擎还没发身份时才退到 objective 派生的 `name` ——
- * 折成单行、绝不整段多行 prompt、绝不空(187 的显示名恒是非空短身份)。全空 → 短 id 尾。
- */
 function deriveAgentLabel(agentType, agentName, name, id) {
     const identity = collapseLabel(agentName ?? '') || collapseLabel(agentType ?? '');
     if (identity)
@@ -126,23 +51,6 @@ function deriveAgentLabel(agentType, agentName, name, id) {
     const tail = rowIdTail(id).slice(-8);
     return tail ? `agent ${tail}` : 'agent';
 }
-/**
- * 引擎把 fleet 行的 `description` 设成 agent 的**最后一个工具名**(service fleet-bus
- * `description = ev.toolName`)。187 的行正文是进度摘要、从不是工具动词,所以控制面/合成动词
- * 泄漏进行(clay 见过的 `report_blocked`)是纯分歧。这里压掉**已知**的控制面动词(保守集合),
- * 真实工作工具(Read/Bash/Edit…)原样放行。
- *
- * 集合 = core `RESERVED_AGENT_NAMES`(subagent.ts)的 CC-parity PascalCase 形 + goal 模式的
- * `DeclareDone`。引擎 ≥ core 1.176 经 `canonicalToolName` 发 PascalCase。
- *
- * 🔴 [2006] A-CC-4(2026-07-29):此表此前**零门看守**,而 core 早已把子代委派工具改名成
- *    `Agent`(`DEFAULT_SUBAGENT_TOOL_NAME`;`Task`/`Fork` 退成 `OLD_TO_NEW` 旧名,`Fork` 还进了
- *    `TOMBSTONED_TOOLS`)。表里缺 `Agent` ⇒ 今天绝大多数 fleet 行的 description(引擎发的正是
- *    canonical 形 `Agent`)**压制不掉**,控制面动词照样泄漏进行正文 —— 正是本函数存在的理由被
- *    静默架空。看守从此是 engine-vocab 门对**实装 core** `RESERVED_AGENT_NAMES` 的等值门;
- *    `Fork` 作为**登记旧名**保留(老引擎仍可能发;压制集多一个只多压制、不误伤真工具),
- *    而"登记"本身要过门 —— 登记项必须是 core 认过的改名/墓碑词。
- */
 export const CONTROL_TOOL_VERBS = new Set([
     'Agent',
     'Task',
@@ -153,37 +61,20 @@ export const CONTROL_TOOL_VERBS = new Set([
     'ToolSearch',
     'DeclareDone',
 ]);
-/**
- * 行的活动正文:控制面动词 ⇒ 空(187 从不显示它),否则按单行呈现载体规整后放行。
- *
- * #307:本函数是描述列的**主臂**(`projectDescription(...) || taskDescFromName(...)`),
- * 修前它把 wire 原串原样返回 —— 描述列的规整只落在 fallback 臂的 `collapseLabel` 上,
- * 主臂给值时那道规整根本不经过([assert-absence-check-fallback-layers] 同族形)。
- * 🔴 压制判定仍按**原值** trim(判据集是 ASCII 动词名,规整不参与放行判定);规整只加在
- *    返回的呈现串上。空/非空面不变:可见转义不产生空白,`|| fallback` 的真假面照旧。
- */
 export function projectDescription(description) {
     const d = description ?? '';
     if (CONTROL_TOOL_VERBS.has(d.trim()))
         return '';
     return escapeDisplayControlChars(d);
 }
-// ── wire 值域过滤器(B6:类型面已到货,这里只剩「脏值不当真」)──────────────────────────────────
-/**
- * `toolUses` —— 子代**累计**工具调用数。语义两条(接错会显示一个「看起来很合理」的错数字):
- *  ① **累计不是增量** —— bg 子代 sink 的 usage 是累计口径,与 `turn_end` 的每轮增量相反。直取,绝不累加。
- *  ② **缺席 ≠ 0** —— 老 server 不发这个键。有键 ⇒ 真值(含真 0);无键 ⇒ undefined(不知道)。
- */
 function wireToolUses(r) {
     const v = r.toolUses;
     return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : undefined;
 }
-/** `transcriptId` —— 子代转录锚(core 铸的 childSessionId);委派 prompt 凭它去转录读面自取。 */
 function wireTranscriptId(r) {
     const v = r.transcriptId;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
-/** `currentTool: {toolName, target?}` —— `currentAction` 的结构化同源体(core 1.429 → server 1.288)。 */
 function wireCurrentTool(r) {
     const v = r.currentTool;
     if (typeof v !== 'object' || v === null)
@@ -197,27 +88,18 @@ function wireCurrentTool(r) {
         ...(typeof target === 'string' && target.length > 0 ? { target } : {}),
     };
 }
-/** `startedCount` —— 「已起过的 agent 数」。🔴 缺席 ≠ 0(见 FleetWorkflowView 键注)。 */
 function wireStartedCount(r) {
     const v = r.startedCount;
     return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : undefined;
 }
-/** `parentToolCallId`(P1-2)—— 归属直读键。空串按缺席处理(引擎不该发,发了也别当真)。 */
 function wireParentToolCallId(r) {
     const v = r.parentToolCallId;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
-/**
- * `parentId` —— 悬空父的存在性判定唯一铸点(REF-CC-049,fleet2-11)。B10 禁真值判定当存在性判定:
- * 空串是脏值形(SDK 只承诺「悬空不发」,那是 server 当下行为不是类型保证),按缺席处理。
- * `fleetLedger.ts` 与本文件的 `projectTasks` 都调它 —— 一个谓词一个铸点,防止 `!== undefined`
- * 与真值判定两种写法在同一字段上判读相反(悬空父脏值 `""` 时曾经真的翻过面)。
- */
 export function wireParentId(r) {
     const v = r.parentId;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
-/** 终态四键之 `usage`(数值 verbatim,只挑数字位;全脏 ⇒ 整键缺席,不造空对象)。 */
 export function wireRowUsage(r) {
     const u = r.usage;
     if (typeof u !== 'object' || u === null)
@@ -230,7 +112,6 @@ export function wireRowUsage(r) {
     }
     return Object.keys(out).length > 0 ? out : undefined;
 }
-/** 终态四键之 `editedFiles`(bg 子代专属;脏项逐条丢,不整键丢)。 */
 function wireEditedFiles(r) {
     const v = r.editedFiles;
     if (!Array.isArray(v))
@@ -245,47 +126,21 @@ function wireEditedFiles(r) {
         .map(f => ({ path: f.path, edits: f.edits }));
     return out.length > 0 ? out : undefined;
 }
-/** 终态四键之 `stoppedBy`(开放枚举 verbatim:"user"/"parent"/"system"/…)。 */
 function wireStoppedBy(r) {
     const v = r.stoppedBy;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
-/**
- * #261 §2① `cycleSeq`(server ≥7.25.0 / core 5.36.0 #258;SDK **7.2.0** 才把它声明进
- * `FleetTaskRow` ⇒ 本包 0.38.0 提货补投)—— 这一行的**代际号**,与 `FleetBgNotification.seq` /
- * `task_progress.seq` **同域同轴**(fresh spawn 就是 cycle 1,每次 SendMessage 复活翻 +1)。
- *
- * 🔴 **缺席 = 「无此概念」,不是「第一代」**(SDK 头注逐字):没有 `a*` registry 行的 run ——
- * 同步委派子代 / workflow `wa*` agent / **顶层 run 行** —— 根本没有代际。把缺席读成 1 的消费端
- * 会把「首帧迟到」误判成「复活」。所以这里对**非正整数**一律整键缺席(0 / 负数 / 非有限数 /
- * 非整数都不是合法代际号),绝不 `?? 0`、绝不 `?? 1`。
- */
 export function wireCycleSeq(r) {
     const v = r.cycleSeq;
     return typeof v === 'number' && Number.isInteger(v) && v > 0 ? v : undefined;
 }
-/**
- * #261 §2② `retiredBy`(server ≥7.25.0;SDK 7.2.0 声明)—— 这一帧的终态**不是发布方亲报**,
- * 而是对账腿从 durable run 行**投影**出来的(发布方死了,行本会永久僵在活跃集里当幽灵)。
- *
- * 🔴 **发布方亲报的终态帧恒不带此键** ⇒ 两种终态在 wire 上可判:要区分「引擎说它完了」与
- * 「我们从库里读出来它完了」时,这是**唯一**的判据([ghost-rows-need-upstream-liveness] 的
- * wire 侧对位物 —— 此前本层把这一位整个丢掉,两种终态在视图上同形)。
- * service 侧今天是单词闭集(`"reconcile"`),**读侧开集**:未知词原样透传(将来的第二个投影者
- * 会是一个新词而不是改义),消费端 branch 已知值 + 通渲兜底,**绝不**按成员判死。
- */
 function wireRetiredBy(r) {
     const v = r.retiredBy;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
-/** 终态四键之 `resumable`(仅 bg 子代有源;非 boolean ⇒ 缺席,**不当 false**)。 */
 export function wireResumable(r) {
     return typeof r.resumable === 'boolean' ? r.resumable : undefined;
 }
-/**
- * wire task 行(Map values)→ 渲染行。树 depth/parentId 来自 wire:无 parentId = 顶层(depth 0),
- * 子行挂在父下面,depth 沿 parent 链算(自引用/环由 `seen` 断)。
- */
 export function projectTasks(allRows, opts) {
     const rows = opts.rowFilter(allRows);
     const viewingTaskId = opts.viewingTaskId;
@@ -301,7 +156,6 @@ export function projectTasks(allRows, opts) {
         }
         return d;
     };
-    // descendantCount:有多少行认这一行当爹(行尾的 " (+N)")。
     const childCount = new Map();
     for (const r of rows) {
         if (r.parentId)
@@ -322,26 +176,19 @@ export function projectTasks(allRows, opts) {
         const task = {
             id: r.id,
             name: deriveAgentLabel(r.agentType, r.agentName, r.name, r.id),
-            // 子行帧无 description → 从 name 复原任务描述(CC 锚:行正文恒显 description,不留空列)。
             description: projectDescription(r.description) || taskDescFromName(r.name, r.agentType, r.agentName),
             depth: depthOf(r),
             ...(parentId !== undefined ? { parentId } : {}),
             status: coerceTaskStatus(r.status),
             ...wireNumberKey('elapsedMs', wireDuration(r.elapsedMs)),
             ...wireNumberKey('tokens', wireCount(r.tokens)),
-            // 🔴 wire 从无 tokenDir(#50 门禁盘出的真类型错:读点恒 undefined 曾靠 ?? 掩住)——恒壳侧缺省。
             tokenDir: 'down',
             ...wireNumberKey('queuedCount', wireCount(r.queuedCount)),
             awaitingPlanApproval: r.awaitingPlanApproval ?? false,
             descendantCount: childCount.get(r.id) ?? 0,
-            // 198 isViewed:这一行就是被查看的那个 agent(行 id 尾段 = 引擎 taskId)。
             viewed: viewingTaskId !== undefined && rowIdTail(r.id) === viewingTaskId,
-            // 🔴 「键缺席」与「值为 0/''」是两件事 —— 只有真给了才落键(下游据「键在不在」判三态)。
             ...(toolUses !== undefined ? { toolUses } : {}),
             ...(transcriptId !== undefined ? { transcriptId } : {}),
-            // launch 真锚原值透传(> 0 才算有值)。ledger 拿它算 elapsedMs 是**另一件事** —— 下游要的是
-            // 时刻本身(自己的钟去减),elapsedMs 是发帧那一刻的快照,客户端存着会漂([C36] server 判据)。
-            // launch 锚只认**有限正数**;非有限值按缺席(它序列化成 `null` 发出去 = 一个不存在的 launch 时刻)。
             ...(typeof r.startedAt === 'number' && Number.isFinite(r.startedAt) && r.startedAt > 0 ? { startedAt: r.startedAt } : {}),
             ...(currentTool !== undefined ? { currentTool } : {}),
             ...(parentToolCallId !== undefined ? { parentToolCallId } : {}),
@@ -349,35 +196,27 @@ export function projectTasks(allRows, opts) {
             ...(usage !== undefined ? { usage } : {}),
             ...(resumable !== undefined ? { resumable } : {}),
             ...(editedFiles !== undefined ? { editedFiles } : {}),
-            // #261 §2 两位:代际号与「非亲报终态」判别位。两者都是**在场才落键** —— cycleSeq 缺席是
-            // 「这条行没有代际概念」、retiredBy 缺席是「发布方亲报」,任何一个补默认值都会把一个诚实
-            // 缺席翻译成一句假话。
             ...(cycleSeq !== undefined ? { cycleSeq } : {}),
             ...(retiredBy !== undefined ? { retiredBy } : {}),
         };
         return task;
     });
 }
-/** 计数位的窄读:非负**整数**才算数(0 是真 0);其余(缺席 / 负数 / 小数 / NaN / Infinity / 非数)⇒ `undefined`。 */
 function wireCount(v) {
     return typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;
 }
-/** 时长位的窄读:非负有限数才算数;其余 ⇒ `undefined`。 */
 function wireDuration(v) {
     return typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : undefined;
 }
-/** 有值才落键(缺席 ⇒ 空对象 ⇒ 视图上键缺席,不铸 0)。 */
 function wireNumberKey(key, v) {
     return (v !== undefined ? { [key]: v } : {});
 }
-/** wire workflow 行 → 渲染行。 */
 export function projectWorkflows(rows) {
     return rows.map(r => {
         const startedCount = wireStartedCount(r);
         const errorCode = wireErrorCode(r);
         return {
             id: r.id,
-            // 187 workflow label = `e.summary ?? e.description`(短 label);折成单行,空 → 187 占位符。
             name: collapseLabel(r.name ?? '') || 'Dynamic workflow',
             description: projectDescription(r.description),
             status: coerceWorkflowStatus(r.status),
@@ -391,20 +230,10 @@ export function projectWorkflows(rows) {
         };
     });
 }
-/** CC-72:sdk 未声明的 run 级码,按结构读 —— 非空串才算在场;空串 / 非串 / null 一律缺席(不折串)。 */
 function wireErrorCode(r) {
     const v = r.errorCode;
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
-// ── 键集契约(`run-fleet-view-keys-test.mjs` 的运行期锚)─────────────────────────────────────
-//
-// 两跳链条,一跳都断不了(形与 `seatContract.ts` 的座位门同款):
-//   interface ──类型钉(本文件末 `_fleetViewKeyPins`,编译期,**两个方向**)──> 键名元组
-//             ──双向键集门(运行期,对最大行/最小行的真产出逐元素相等)──> 实装投影
-//
-// 为什么钉在**内部 const 元组**而不是导出的 `readonly string[]`:后者的 `[number]` 塌回 `string`,
-// `Covers` 恒真 = 零判别力(seatContract `:838-843` 同一个坑的记录)。公开面给 `readonly string[]`,
-// 消费者的 `includes(someString)` 不受影响。
 const FLEET_TASK_VIEW_KEY_TUPLE = [
     'id',
     'name',
@@ -431,7 +260,6 @@ const FLEET_TASK_VIEW_KEY_TUPLE = [
     'cycleSeq',
     'retiredBy',
 ];
-/** `FleetTaskView` 的键名清单(运行期物;编译期与 `keyof FleetTaskView` 双向等值)。 */
 export const FLEET_TASK_VIEW_KEYS = FLEET_TASK_VIEW_KEY_TUPLE;
 const FLEET_WORKFLOW_VIEW_KEY_TUPLE = [
     'id',
@@ -446,7 +274,6 @@ const FLEET_WORKFLOW_VIEW_KEY_TUPLE = [
     'startedCount',
     'errorCode',
 ];
-/** `FleetWorkflowView` 的键名清单(同上)。 */
 export const FLEET_WORKFLOW_VIEW_KEYS = FLEET_WORKFLOW_VIEW_KEY_TUPLE;
 const FLEET_TASK_ROW_WIRE_KEY_TUPLE = [
     'id',
@@ -472,12 +299,9 @@ const FLEET_TASK_ROW_WIRE_KEY_TUPLE = [
     'usage',
     'resumable',
     'editedFiles',
-    // SDK 7.2.0 新声明的两位(#261 §2,server ≥7.25.0 早已在 wire 上 —— 这是**类型跟车**不是新能力)。
     'cycleSeq',
     'retiredBy',
 ];
-/** SDK `FleetTaskRow` 的**入口**键名清单(编译期与 `keyof FleetTaskRow` 双向等值 ⇒ SDK 加一个
- *  wire 键,本元组不跟就编译红;跟了之后覆盖账那条腿再逼你表态「投不投」)。 */
 export const FLEET_TASK_ROW_WIRE_KEYS = FLEET_TASK_ROW_WIRE_KEY_TUPLE;
 const FLEET_WORKFLOW_ROW_WIRE_KEY_TUPLE = [
     'id',
@@ -491,16 +315,7 @@ const FLEET_WORKFLOW_ROW_WIRE_KEY_TUPLE = [
     'elapsedMs',
     'tokens',
 ];
-/** SDK `FleetWorkflowRow` 的入口键名清单(同上)。 */
 export const FLEET_WORKFLOW_ROW_WIRE_KEYS = FLEET_WORKFLOW_ROW_WIRE_KEY_TUPLE;
-/**
- * **不投影登记表**:wire 上有、`FleetTaskView` 上**故意没有**的键,每条必须写清理由。
- *
- * 🔴 这张表是 `startedAt` 那类事故的正面看守:那次不是「谁反对投影它」,是**没有人被逼着表态**——
- * wire 有、ledger 读到了、另外两个投影面都补过,唯独这一层静默丢弃,编译期一声不吭。有了本表,
- * 每个 wire 键只有两条出路:**要么投影出去,要么在这里写下不投的理由**;新 wire 键在覆盖账那条
- * 腿上当场红,不给「悄悄没人管」留位置。
- */
 export const FLEET_TASK_ROW_KEYS_NOT_PROJECTED = {
     sourceLane: {
         kind: 'by-design',
@@ -535,10 +350,6 @@ export const FLEET_TASK_ROW_KEYS_NOT_PROJECTED = {
         reason: '结构化同源体 `currentTool` 已投影(SDK 注:currentAction 是它的**文本回落**)。🔴 诚实记账:旧端(server <1.288)只发 currentAction ⇒ 那一档上本视图今天确实拿不到活动文本,这是**已知缺口**不是设计取舍;补它 = 加 `currentAction?: string` 进本视图 + 端侧回落渲染。',
     },
 };
-/** workflow 行:wire 十键与视图十键一一同名同义 ⇒ 本表**空**(空不是「忘了填」,是覆盖账那条腿
- *  每跑一次都在证明它该空:少投一个键就红)。 */
 export const FLEET_WORKFLOW_ROW_KEYS_NOT_PROJECTED = {};
-// `Covers`(REF-CC-145/dup-12,P3 wave1 卡C-argv)改吃共用叶 ../typePins.js——四份逐字重复钉之一
-// (`Exclude<A,B> extends never` = 「A 的每个成员都在 B 里」;不成立时类型是 `never`,赋 `true` 即编译红)。
 const _fleetViewKeyPins = [true, true, true, true, true, true, true, true, true, true];
 void _fleetViewKeyPins;

package/dist/fleet/fleetRowAgentType.d.ts

@@ -1,9 +1,3 @@
-/**
- * 记一条 fleet 行的 agentType(幂等;行帧不带这一位 / 坏形 ⇒ 整条不动,不擦掉已知值 ——
- * 同一行的后续帧缺席这一位是「这帧没说」,不是「类型没了」)。
- */
 export declare function recordFleetRowAgentType(taskIdTail: string, agentType: string | undefined): void;
-/** 读口:这一行的子代类型;`undefined` = **诚实不知道**(调用方让键缺席,不许回落到展示名)。 */
 export declare function fleetRowAgentType(taskIdTail: string | undefined): string | undefined;
-/** 测试钩:清台账(module 级单例,同进程多组断言必须能清)。 */
 export declare function __resetFleetRowAgentTypeForTests(): void;

package/dist/fleet/fleetRowAgentType.js

@@ -1,37 +1,8 @@
-/**
- * fleetRowAgentType — 「这一条 fleet 行的子代是什么**类型**」的台账(0.75.1 CC-95(b);包内叶,不出公面)。
- *
- * ── 为什么要有它 ──────────────────────────────────────────────────────────────────────────────
- * `subagent_lifecycle` 的 `agentType`(CC `SubagentStart.agent_type` 那一位)此前取的是 tick 的**展示名**
- * `task_progress.name` —— 那一位是上游由委派卡的 `description` 派生的**显示串**,不是类型。于是宿主的
- * SubagentStart hook 收到的是任务描述:一个看起来合理的错答案。
- *
- * 诚实来源亲核(sdk 9.8.1 实装字节):
- *   · `task_progress` 臂(`dist/events.d.ts`)上**没有** `agentType`、也没有 `spawnAgentType` —— tick 这条
- *     lane 今天根本不报类型,所以本层**不读**无出处的键(读了就是替上游发明一个字段)。🔴 **措辞更正(外部验收方 [7764])**:因此 tick 这一档**不是一条「今天恒不命中的路径」,它根本没有代码** —— 本文件里 `agentType` 的三处出现全在注释,唯一的代码走的是 fleet 行帧那一档。相应地,「上游铸位当天零改生效」这句**不成立**:上游若铸出 `spawnAgentType`,本包**没有读口**,仍需改码补一档;
- *   · `FleetTaskRow.agentType`(`dist/resources/fleet.d.ts`,§K-7 的短类型 label,如 `Explore` /
- *     `general-purpose`)**有出处** —— 但 `fleet/fleetProjection.ts` 把它**折进** `FleetTaskView.name`
- *     (`deriveAgentLabel` = `agentName ?? agentType`,登记在
- *     `FLEET_TASK_ROW_KEYS_NOT_PROJECTED` 里),折完之后它与显示名再也分不开。
- * ⇒ 所以类型这一位要在**折之前**留一份:行帧消费臂按行 id 尾段记,tick 臂按归一后的尾段读。
- *
- * ── 纪律 ────────────────────────────────────────────────────────────────────────────────────
- * 🔴 **只记 wire 真给了的**:空串 / 非串一律不入账(空串既不是类型也不是「不知道」);账上没有 ⇒ 读口
- *    答 `undefined` = **诚实缺席**,调用方让键缺席,绝不回落到展示名或编一个 `subagent`。
- * 🔴 作用域 = 进程级(与本包转录锚台账逐字同族:写方 = 行帧消费臂,读方 = tick 臂;两份模块实例 ⇒ 读口恒空、
- *    `agentType` 恒缺席,而两边代码看着都对)。
- * 有界 LRU(命中即续命):上限是内存约束不是语义,被挤掉只退化成「这一行的类型不知道」。
- */
 const MAX_ROWS = 2048;
 const agentTypeByTail = new Map();
-/**
- * 记一条 fleet 行的 agentType(幂等;行帧不带这一位 / 坏形 ⇒ 整条不动,不擦掉已知值 ——
- * 同一行的后续帧缺席这一位是「这帧没说」,不是「类型没了」)。
- */
 export function recordFleetRowAgentType(taskIdTail, agentType) {
     if (typeof taskIdTail !== 'string' || taskIdTail.length === 0)
         return;
-    // 形核仍在本层做(wire 值不可信,型面说是 string 不等于到货一定是 string;空串既不是类型也不是「不知道」)。
     if (typeof agentType !== 'string' || agentType.length === 0)
         return;
     agentTypeByTail.delete(taskIdTail);
@@ -42,18 +13,16 @@ export function recordFleetRowAgentType(taskIdTail, agentType) {
             agentTypeByTail.delete(oldest);
     }
 }
-/** 读口:这一行的子代类型;`undefined` = **诚实不知道**(调用方让键缺席,不许回落到展示名)。 */
 export function fleetRowAgentType(taskIdTail) {
     if (typeof taskIdTail !== 'string' || taskIdTail.length === 0)
         return undefined;
     const v = agentTypeByTail.get(taskIdTail);
     if (v === undefined)
         return undefined;
-    agentTypeByTail.delete(taskIdTail); // LRU 续命:还在飞的子代不被一阵新登记挤掉
+    agentTypeByTail.delete(taskIdTail);
     agentTypeByTail.set(taskIdTail, v);
     return v;
 }
-/** 测试钩:清台账(module 级单例,同进程多组断言必须能清)。 */
 export function __resetFleetRowAgentTypeForTests() {
     agentTypeByTail.clear();
 }

package/dist/fleet/workflowSizeWarning.d.ts

@@ -1,59 +1,22 @@
-/**
- * src/fleet/workflowSizeWarning.ts —— workflow **规模告警**的判定(0.73.5)。
- *
- * 三端 footer / 面板都要回答同一个问题:「这条 workflow 是不是大到该提醒用户了」。判定与 CC 同形
- * (三个缺省帽、每 agent 用量估算、guideline 表、两个 env 覆盖、三档文案与宽度阶梯),属于客户端公共逻辑,
- * 由本包单源;端只负责读环境、读设置、量宽度与渲染。
- *
- * 🔴 **入参按 fleet 视图的三态键读**(`FleetWorkflowView`:`totalCount` / `startedCount` / `doneCount` /
- *    `failedCount` / `tokens` 全是可选位,缺席 = wire 没报 = 不知道)。出参三态:
- *      · `warn`    —— 有**正向证据**证明至少一条轴超帽(别的键缺席不挡它;下界分母算出的上界**不算**证据);
- *      · `ok`      —— 两条轴都判得出,且都在帽内(或 ultracode 压掉了整条告警);
- *      · `unknown` —— 没有超帽的正向证据,且至少一条轴判不出。**未知的规模不能被当作规模正常**:
- *                     `unknown` 绝不折成 `ok`,`missing` 点名缺了哪几键。
- *
- * 🔴 **分母口径**(每 agent 用量 `u = tokens / started`):
- *      · `startedCount` 在场且不小于 `doneCount + failedCount` ⇒ 用引擎真值(含真 0:「一个都还没起」是一条真信息
- *        ⇒ 用先验);比已完成数还小(帧间竞态)⇒ 这份读数是陈旧的,按下面的下界处置;
- *      · 缺席 ⇒ 只有 `doneCount` / `failedCount` **两键都在场**才回退成下界,结果标 `startedIsLowerBound`。
- *        下界偏小 ⇒ `u` 偏大 ⇒ 算出来的是投影的**上界**(`projectedTokensUpperBound`,不是 `projectedTokens`):
- *        上界在帽内 ⇒ 真的在帽内 ⇒ 可以判 `ok`;上界超帽**不是**超帽的证据(同一份读数补上真 `startedCount`
- *        可能远在帽内)⇒ 投影轴判不出,`unknown`。想保守一点的端可以自己拿上界去提示,判词不替它撒谎;
- *      · 下界为 0 ⇒ 每 agent 用量判不出:「0 个完成」不是「一个没起」的证据,先验只在引擎**亲口**报
- *        `startedCount = 0` 时可用;
- *      · 只有一键在场 ⇒ 不回退(缺席的那键不读作 0)。
- */
-/** 缺省 agent 数帽。 */
 export declare const WORKFLOW_SIZE_WARNING_AGENT_CAP = 25;
-/** 缺省 token 帽(已花 ∨ 投影)。 */
 export declare const WORKFLOW_SIZE_WARNING_TOKEN_CAP = 1500000;
-/** 还没有任何 agent 起跑时的每 agent 用量先验。 */
 export declare const WORKFLOW_SIZE_WARNING_TOKENS_PER_AGENT = 70000;
-/** 显式 `workflowSizeGuideline` → agent 数帽。`unrestricted` 与缺省(未配置)**不贡献帽**,故不在表里。 */
 export declare const WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS: Readonly<Record<'small' | 'medium' | 'large', number>>;
-/** 两个 env 覆盖各自的名字,按读取优先级排(品牌名在前,兼容名在后)。本包不读 `process.env`,名字单源在这里。 */
 export declare const WORKFLOW_SIZE_WARNING_ENV_NAMES: Readonly<{
     agents: readonly [string, string];
     tokens: readonly [string, string];
 }>;
-/** 三档文案(宽 → 窄)。 */
 export declare const WORKFLOW_SIZE_WARNING_TEXT_LONG = "\u26A0 Large workflow \u00B7 /workflows to stop";
 export declare const WORKFLOW_SIZE_WARNING_TEXT_SHORT = "\u26A0 Large workflow";
 export declare const WORKFLOW_SIZE_WARNING_TEXT_MIN = "\u26A0";
 export interface WorkflowSizeInput {
-    /** workflow 的 agent 总数(`FleetWorkflowView.totalCount`)。缺席 = 不知道。 */
     readonly totalCount?: number;
-    /** 已起跑的 agent 数(引擎真值)。缺席 ⇒ 见头注的下界回退。 */
     readonly startedCount?: number;
     readonly doneCount?: number;
     readonly failedCount?: number;
-    /** 已花 token(`FleetWorkflowView.tokens`)。缺席 = 不知道,**不是 0**。 */
     readonly tokens?: number;
-    /** ultracode 档压掉整条告警。 */
     readonly ultracodeActive?: boolean;
-    /** 设置里**显式配置**的 `workflowSizeGuideline`;未配置就别传(缺省档不贡献帽)。 */
     readonly guidelineSize?: string;
-    /** env 覆盖(最高优先级);正有限数才生效。 */
     readonly envAgentCap?: number;
     readonly envTokenCap?: number;
 }
@@ -63,11 +26,8 @@ interface WorkflowSizeFacts {
     readonly tokenCap: number;
     readonly scheduledAgents?: number;
     readonly totalTokens?: number;
-    /** 投影(已花 ∨ 每 agent 用量 × 总数);只在分母是引擎真值时在场。 */
     readonly projectedTokens?: number;
-    /** 投影的**上界**;只在分母用了 `doneCount + failedCount` 下界(且下界 > 0)时在场,与 `projectedTokens` 互斥。 */
     readonly projectedTokensUpperBound?: number;
-    /** 只在分母用了下界时在场。 */
     readonly startedIsLowerBound?: true;
 }
 export type WorkflowSizeVerdict = (WorkflowSizeFacts & {
@@ -80,17 +40,10 @@ export type WorkflowSizeVerdict = (WorkflowSizeFacts & {
     readonly kind: 'unknown';
     readonly missing: readonly WorkflowSizeMissingKey[];
 });
-/** 规模判定。纯函数:每个环境量都由调用方注入。 */
 export declare function evaluateWorkflowSize(input: WorkflowSizeInput): WorkflowSizeVerdict;
-/**
- * 两个 env 覆盖的读口。`env` 由调用方交(本包不碰 `process.env`)。每组按 {@link WORKFLOW_SIZE_WARNING_ENV_NAMES}
- * 的顺序取**第一个在场的名字**;那个名字的值不是正有限数 ⇒ 该键不在场,**不回落**到第二个名字
- * (显式写错不该被悄悄换源)。
- */
 export declare function readWorkflowSizeWarningEnvCaps(env: Readonly<Record<string, string | undefined>> | undefined): {
     envAgentCap?: number;
     envTokenCap?: number;
 };
-/** 宽度阶梯:挑放得下的最长一档;连字形都放不下 ⇒ `undefined`(整段不渲)。`width` 由调用方注入(与渲染器同一把尺)。 */
 export declare function workflowSizeWarningTextForWidth(available: number, width: (s: string) => number): string | undefined;
 export {};