@sema-agent/server 7.43.0 → 7.44.0

package/dist/trace/project.js

@@ -1,48 +1,24 @@
-// 值导入(非 `import type`):`settledBy`/`resolution` 的闭集判据必须**复用 core 的谓词**——本仓抄
-// 一份词表就是值拷贝漂移源(上游加员时两处静默不同步)。settledBy=core 5.18.1 #187;
-// resolution 三席=core 5.52.0 根导出([4819] 应诺兑现,[4820] 预挂的闭集换装即此)。
 import { isApprovalSettledBy, isAskDenyResolution } from "@sema-agent/core";
 import { redactSecrets, redactDeep } from "./redact.js";
-/** E8 (shell-host): drain the per-task model-usage accumulator into an append-only `model_usage` DELTA event.
- *  Shared by BOTH durable-write legs (runInBackground + the resume leg) so the persisted shape never drifts; the
- *  append-only deltas make a suspended/resumed run's total resume-safe (each leg appends its own, the echo sums).
- *
- *  core 3.0.0([2296] 装车单 S10,§DESIGN-V2 V2-⑤): every drained row is tagged with `usageBasis:
- *  "uncached-components-v1"` — the write point for this label (the tracker itself, {@link ModelUsageTracker},
- *  never sets it; it stays a pure token/cost accumulator). This is what lets {@link aggregateModelUsage} tell
- *  apart rows written under the current component semantics from older rows (pre-dating this label) when it
- *  sums across a run's whole event log. */
 export async function appendModelUsageDelta(append, modelUsage, taskId) {
     const delta = modelUsage?.drain(taskId);
     if (delta) {
         const tagged = {};
-        // [2373]A-4 记账(2026-08-02):usageBasis(与 TraceTurn.tokens.uncachedIn 同族)五端+黑盒仓零运行时读者——
-        // 3.0.0 cache 语义翻转的诚实位,契约正确但暂无消费;web/desktop 接账单面时它是现成的。
         for (const [model, d] of Object.entries(delta))
             tagged[model] = { ...d, usageBasis: "uncached-components-v1" };
         await append("model_usage", { usage: tagged });
     }
 }
-/** [998]② drain the pending prompt-manifest records (whitelisted at RECORD time, budget.ts — ids/digests/
- *  counts only, no prompt bodies by core's manifest contract) into durable `prompt_assembled` events, one per
- *  prepare IN EMISSION ORDER (a cascade/verify leg re-prepares under one taskId — every rung's manifest
- *  persists; release-review finding). Shared by both durable-write legs; a no-op when nothing is pending
- *  (one Map.get), so callers fire it liberally. */
 export async function appendPromptManifest(append, tracker, taskId) {
     const records = tracker?.drain(taskId);
     if (records)
         for (const m of records)
             await append("prompt_assembled", m);
-    // [1301]③:config.assembled 同拍同门落 durable(config_assembled 事件)——与 prompt_assembled 完全同
-    // 生命周期(register 门/lease clear/所有 drain 落点自动覆盖:bg 首跑、resume 两径、verify 径);
-    // 逐条保序(codex F2:cascade 每 rung 的生效配置各自成帧,与其 prompt manifest 可配对)。
     const cfgs = tracker?.drainConfig?.(taskId);
     if (cfgs)
         for (const cfg of cfgs)
             await append("config_assembled", cfg);
 }
-/** E8: at a TERMINAL done — flush the final delta, then SUM all `model_usage` events (every process leg) into the
- *  result's `stats.modelUsage` echo. Returns the result unchanged when no usage was tracked (shell soft-degrades). */
 export async function attachModelUsage(result, ctx) {
     if (!ctx.modelUsage)
         return result;
@@ -52,35 +28,10 @@ export async function attachModelUsage(result, ctx) {
         return result;
     return { ...result, stats: { ...result.stats, modelUsage: usage } };
 }
-/** E8 (shell-host contract): SUM the per-turn `model_usage` delta events in a run's durable event log into the
- *  cumulative per-model total for `TaskStats.modelUsage`. The tracer drains deltas at each turn boundary
- *  (append-only) → this is resume-safe: it sums across ALL process legs of a suspended/resumed run. Returns
- *  undefined when the run logged no model usage (→ the shell soft-degrades to aggregate cost only).
- *
- *  #59([2052]①):事件体是 **DB 里的 JSON**(旧版本 / 别的 producer 都可能写),此前的 `?? 0` 只接住
- *  null/undefined——NaN 与字符串会原样进 `+`,一个坏键就把该模型的整 run 总量变成 NaN 或字符串拼接,
- *  再顺着 `TaskStats.modelUsage` 回声流进 usage-analytics 的整窗聚合。守卫改「非有限数 = 缺席、按 0 计」,
- *  与 usage-analytics 读侧同口径。
- *
- *  🔴 RB-368(core 2.3.0,[2083] 提货单①)——**缺席必须活着走完整条链**。此前本折叠对「costMicroUsd
- *  缺席」与「=0」输出相同(都是 0),那时无所谓:core 恒发数字,缺席没有 producer。现在 unpriced 部署
- *  下 core 行级缺席、budget.ts 如实透传落库,若在这里折 0,诚实就只活到落库为止——回声上又变回
- *  「花了 0」,行级消歧白做。故改**未知传染**:该模型任一贡献行缺 costMicroUsd 键 ⇒ 总量的该键**整个不在**
- *  (和里含一个不知道的项,这个和就不知道)。传染按**模型隔离**,不毒别的模型,更不毒整窗。
- *
- *  判别轴(两种"没数"不同罪):
- *   · **键缺席** = 契约允许的「未知」(SDK ModelUsageDelta 五键全可选)⇒ 传染,输出也缺席。
- *   · **键在场但值坏**(NaN / 字符串 / null)= 数据损坏,写了键的 producer 是在声称自己知道 ⇒ 维持既有
- *     折叠(按 0 计,不传染,已知量不受损),否则一条陈年坏行就能把整个模型的成本抹成"未知"。
- *  下游补偿件早已就位:usage-analytics 的 numOf + `estimated` 标记(缺数值键 ⇒ 总量偏低并诚实标注)。 */
 export function aggregateModelUsage(events) {
     const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : 0);
     const total = {};
-    const costUnknown = new Set(); // RB-368:该模型至少有一行没带 costMicroUsd 键 ⇒ 总量不可知
-    // S10([2296] 装车单,§DESIGN-V2 V2-⑤):usageBasis 只在**这个模型贡献的每一行**都带同一个值时才透传到
-    // 回声行——混窗(升级前落盘的旧行 / 坏行 / 未来换了别的 basis 字符串)一律诚实省略,不猜、不传染出一个
-    // 假的一致标记。Map 记「目前为止这个模型见过的一致值」:第一行定值;之后任何一行不同(含缺席,记作
-    // undefined)⇒ 永久锁定为 undefined(一旦分歧就回不去)。
+    const costUnknown = new Set();
     const basisSeen = new Map();
     let any = false;
     for (const ev of events) {
@@ -91,11 +42,9 @@ export function aggregateModelUsage(events) {
             continue;
         for (const [model, d] of Object.entries(usage)) {
             any = true;
-            // F3(2026-07-30 复审):null/非对象行的守卫必须在任何取值**之前**——原来它排在 `d.inputTokens`
-            // 之后,对唯一能判别的形(null)先抛,守卫不可达;坏行按整行 0 折(#59 同口径),cost 记未知。
             if (d === null || typeof d !== "object") {
                 costUnknown.add(model);
-                basisSeen.set(model, undefined); // 坏行 = 不可知,视同分歧,不透传 basis
+                basisSeen.set(model, undefined);
                 continue;
             }
             const cur = total[model] ?? { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, costMicroUsd: 0 };
@@ -103,8 +52,6 @@ export function aggregateModelUsage(events) {
             cur.outputTokens += num(d.outputTokens);
             cur.cacheReadTokens += num(d.cacheReadTokens);
             cur.cacheWriteTokens += num(d.cacheWriteTokens);
-            // `d` 是 DB 里的 JSON:用 hasOwn 判「键在不在」(值为 undefined 的显式键与缺键同罪——落库后
-            // 两者本就无法区分,JSON.stringify 会把显式 undefined 抹掉)。
             if (d !== null && typeof d === "object" && Object.hasOwn(d, "costMicroUsd") && d.costMicroUsd !== undefined)
                 cur.costMicroUsd = num(cur.costMicroUsd) + num(d.costMicroUsd);
             else
@@ -124,31 +71,15 @@ export function aggregateModelUsage(events) {
             total[model].usageBasis = basis;
     return any ? total : undefined;
 }
-/** Identity fields core stamps on each content event (1.121.0 `TaskEventIdentity`, shell-host contract E2):
- *  `eventId` (core-mint uuidv7, the stable handle for dedup / the E18 resume-at anchor) + `parentToolCallId`
- *  (present only when the run is a sub-agent task spawned under a parent tool call). Both additive / tolerate-absent. */
 function identityFields(src) {
     return {
         ...(src.eventId ? { eventId: String(src.eventId) } : {}),
         ...(src.parentToolCallId ? { parentToolCallId: String(src.parentToolCallId) } : {}),
     };
 }
-/** The durable `tool_start` event payload, shared by BOTH append sites (runInBackground + the resume leg) so the
- *  persisted shape never drifts: redacted args (UNTRUSTED) + E2 identity. `label`([1543]§三族B:durable 腿
- *  此前剥掉——同一 run live 观看有展示名、replay/resume 退化成 wire 名):core 展示名 verbatim(tail 面
- *  1.251 复审同裁,两腿同处理)。 */
 export function toolStartEventData(ev) {
     return { toolCallId: ev.toolCallId, toolName: ev.toolName, ...(ev.label !== undefined ? { label: ev.label } : {}), args: redactDeep(ev.args), ...identityFields(ev) };
 }
-/** The durable `tool_end` payload (shared by both append sites). E1: the model-facing `output` is UNTRUSTED RAW
- *  from core (file/shell/API bodies) — core only SIZE-bounds it (`truncated`), REDACTION is ours (same contract as
- *  `tool_start.args`); never re-fed to a model. E2: identity. Absent `output` ⇒ the tool produced no content body.
- *  core 1.203: `structured` = the tool's CC-shaped `details` card (edit/create/bash/… — core
- *  allowlists the card `type` and size-caps the whole card, omit-whole on overflow, so a subagent's child-TaskResult
- *  can never appear here) — SAME UNTRUSTED RAW contract as `output` (a card carries `originalFile`/stdout bodies),
- *  so it gets the same deep redaction before it is persisted or echoed. `label`(core 展示名,同 tool_start 的
- *  label 待遇 verbatim)白名单排查(2026-07-24)补齐进函数本体——此前外包给调用点各自手动拼接,7 处只有
- *  3 处记得拼,resume leg + ledger-sink 落盘两处漏了,持久化记录本身缺 label 一写盘就永久追不回来。 */
 export function toolEndEventData(ev) {
     return {
         toolCallId: ev.toolCallId,
@@ -157,151 +88,50 @@ export function toolEndEventData(ev) {
         isError: ev.isError,
         ...(ev.output !== undefined ? { output: redactDeep(ev.output) } : {}),
         ...(ev.truncated ? { truncated: true } : {}),
-        // core 1.442([1898] RB-210):截断诚实体量(各 block 真实大小之和,不含 JSON 包装开销)。
         ...(Number.isFinite(ev.totalChars) ? { totalChars: ev.totalChars } : {}),
         ...(ev.structured !== undefined ? { structured: redactDeep(ev.structured) } : {}),
-        // core 5.9.0 W3([2535];2026-08-04 复审纠偏):errorCode = core 在 isError 时对**任意工具 ToolResult
-        // 的 `details.code`** 的透传 —— 开集,无引擎白名单(runtask 直读 result.details.code,structuredFrom
-        // 的 CC_DETAIL_TYPES 白名单只管 structured 键)。引擎码 `gate.parked`/`tool.not_found` 只是两例,
-        // 工具层现役即有 `path_not_in_root`/`readonly_out_of_root` 等,自注册工具可加新码 —— 消费端必须
-        // 带 default 臂,禁按两值穷举。verbatim 依据:码是机器短串标识符、非用户内容(不脱敏),边界靠
-        // 显式上限而非词表 —— >128 字符=非法形,整键丢弃(不截断:截断会铸出 core 从未发过的码)。
         ...(typeof ev.errorCode === "string" && ev.errorCode.length <= 128 ? { errorCode: ev.errorCode } : {}),
-        // core 5.18.1 #187([3110] 提货批):`settledBy` = 这一次调用的**结算来源**("human"/"timeout"/
-        // "aborted"),只挂在经审批结算的那个 tool_end 上。与上面的 errorCode **不同族**,两条差别都承重:
-        //  ① 它是**闭集**,判据走 core 导出的 `isApprovalSettledBy`(单一属主)—— 不在本仓抄词表,也不拿
-        //     长度上限当边界(那是开集的兜底姿势,对闭集等于没门:出格词照样上 wire,下游按闭集写的
-        //     switch 会撞 default 或更坏地把它当成一次真结算)。上游加员时判据自动跟随。
-        //  ② **缺席不是语义**:core 契约逐字写「Absence = an older caller — consumers must not infer
-        //     semantics from a missing key」;姿态臂(headless auto-deny / 整体放行)本就不填。所以缺席
-        //     一律不铸键 —— 既不折 "human" 也不折 null,把「不知道」如实表达成「没有这个键」。
-        // 值是引擎铸的枚举短串、非用户内容 ⇒ 不脱敏。
         ...(isApprovalSettledBy(ev.settledBy) ? { settledBy: ev.settledBy } : {}),
-        // core 5.51.0 #127([4816] 提货单件①):`resolution` = ask 解析席**拒绝臂**的分类(九码闭集
-        // `AskDenyResolution`)——比 settledBy 更细(那个只说结算是什么种类,这个说拒绝走了哪条臂),
-        // 铸点在 resolveAsk 的组臂处、经引擎结算 sideband 逐字携带,**不可由 tool/policy 自declare**——
-        // core 契约逐字:「an out-of-vocabulary or self-declared word is dropped at the screens」,即
-        // **筛点单点在 core**。判据=闭集谓词 `isAskDenyResolution`(core 5.52.0 三席根导出到货,
-        // [4819]/[4820] 过渡形〔string 非空+≤64〕退役,单一属主纪律不抄词表)。
-        // 缺席不是语义(执行了的调用/policy 直拒/durable 腿都不带)。
         ...(isAskDenyResolution(ev.resolution) ? { resolution: ev.resolution } : {}),
-        // core 5.35.0 design/252 G-7(#263 提货批,[4022] G3):`approver` = 这次结算**是谁的**——审批通道
-        // 自报的结算方标识串,core `screenApproverAttribution` 筛形后逐字转录在 `settledBy` 旁,两键**合读**
-        // (`settledBy:"timeout"` + approver = 超时的那条队列名,不是拒绝的人)。与 settledBy 同族三条纪律:
-        //  ① 只挂在经审批结算的 tool_end 上;缺席 = 通道没报名字,**永不**意味「没人批」或「有人批」;
-        //  ② core 只筛形不鉴别(转录不是认证)—— server 同姿势,不折不铸,typeof 判形即过境;
-        //  ③ 值是**宿主派生的身份串**(login/email/账号 id),照 humanInputEventData 的 issuer/actor.id
-        //     先例过 redactSecrets(对正常标识恒等,对密钥形打码;core 已拒控制符/超长,无需重复筛)。
         ...(typeof ev.approver === "string" && ev.approver !== "" ? { approver: redactSecrets(ev.approver) } : {}),
-        // core 5.55.0 #333/[4918](#337 提货):`gatedCallId` = durable park 正扣着**哪个** tool call 的 id——
-        // core runtask 铸点从 committed checkpoint 的 pendingAction 直读(**禁由工具自报**:core 契约原话,
-        // 能自报的 id 是对「另一个 call」的断言,工具能写它就能把审批 UI 指向一个没人等的 call),只挂在
-        // park 污染帧上。id 串非用户内容不脱敏;缺席=park 不扣 call(resource_limit/plan_review 形挂的
-        // pendingAction 没有 tool call),core 契约「ABSENT, never guessed」——缺席不铸键。
         ...(typeof ev.gatedCallId === "string" && ev.gatedCallId !== "" ? { gatedCallId: ev.gatedCallId } : {}),
         ...identityFields(ev),
     };
 }
-/** The `task_progress` payload (a subagent's live progress tick) — EXPLICIT WHITELIST shared by all
- *  three legs (bg runs.ts + resume append + the sync live SSE frame): taskId/parent linkage/token rollup verbatim,
- *  `name` UNTRUSTED (core sanitizes for rendering, does NOT secret-redact — a taskName can be secret-shaped) →
- *  `redactSecrets`. Never the delegated objective/args. E2 identity rides (eventId/
- *  parentToolCallId are core-mint uuidv7 identifiers, not content — consumers bind concurrent subagent ticks
- *  exactly by them; the 1.72 whitelist dropped them, leaving a FIFO heuristic). */
 export function taskProgressEventData(ev) {
     return {
         taskId: ev.taskId,
-        // core 5.36.0(#258,[4066] 提货①):这一拍所报的 registry 行**代际号**(fresh spawn = 1,每次
-        // 复活翻转 +1)—— 与 `TaskNotificationPayload.seq` / `BackgroundChildEvent.seq` **同一条轴**,
-        // core 原话「不是第三种拼法」。它回答的是消费端在帧迟到时otherwise判不了的那一个问题:
-        // 「这是我已知那一代的迟到首帧(同值),还是一次我还没折叠的复活(更大)?」
-        // 🔴 **缺席是事实不是缺口**:没有 `a*` registry 行的 run(同步委派子代 / workflow `wa*` / 顶层 run)
-        // 根本没有代际概念,缺席**禁**读作 cycle 1。core-mint 数值,无用户内容 ⇒ verbatim,缺席不铸键。
         ...(typeof ev.seq === "number" ? { seq: ev.seq } : {}),
-        // core 5.14.0([2854] 六车批②):委派种类判别键(core `DelegationTaskType` =
-        // "background_agent" | "workflow")—— 消费端据此路由一条 progress 帧,不必再从 id 形状猜。
-        // 形参取 `string` 而非闭枚举:该类型**没有**从 core 包根导出(亲验 index.d.ts 零命中,与发车帖
-        // 「新导出」的说法不符),抄一份闭集就是值拷贝漂移源;`stoppedBy` 先例同款——core 的开集串
-        // verbatim,消费端按契约容忍未知值。缺席=同步子代(无 fleet 行),缺席即不铸键。
         ...(typeof ev.taskType === "string" && ev.taskType.length > 0 ? { taskType: ev.taskType } : {}),
         ...(ev.parentTaskId ? { parentTaskId: ev.parentTaskId } : {}),
         ...(ev.name ? { name: redactSecrets(ev.name) } : {}),
-        // core [1414]#3 settle 终态 tick("completed"/"failed"——[1543]§三族B:此前被剥,消费方只见最后
-        // 一拍 running 后行消失,恰是该 tick 要修的体验)。core enum verbatim。
         ...(ev.status !== undefined ? { status: ev.status } : {}),
         ...(ev.usage ? { usage: ev.usage } : {}),
-        // core 1.262.0: the child's most recent tool intent as one human line ("Bash npm
-        // test") — derived from the child's tool_start (tool name + argument head), so the ARGUMENT part is
-        // UNTRUSTED free text (a command line can be secret-shaped) → `redactSecrets`, same boundary as `name`.
         ...(ev.currentAction ? { currentAction: redactSecrets(ev.currentAction) } : {}),
-        // core 1.401.0([1611]→[1616]/[1617] 方案 B):后台 workflow 子代的 tick additive 带这两个字段,
-        // 让下游(cli)能把这条前台裸 uuid 行识别为"fleet 那边已有一份"从而跳过重复渲染。workflowRunId 是
-        // core-mint 的不透明 run id(不含用户内容)→ 同 identityFields 待遇直传;workflowAgentLabel 是脚本
-        // 作者可控的展示字符串(UNTRUSTED,同 name 的信任边界)→ redactSecrets。
         ...(ev.workflowRunId ? { workflowRunId: ev.workflowRunId } : {}),
         ...(ev.workflowAgentLabel ? { workflowAgentLabel: redactSecrets(ev.workflowAgentLabel) } : {}),
         ...identityFields(ev),
     };
 }
-/** The `task_notification` payload (core 1.202 design/115 P2: a background task finished — this event is the
- *  LEDGER/display projection of the OBSERVED terminal state, emitted the moment core observes it. It does NOT
- *  attest that the `<task-notification>` XML has entered the model context: core's steer targets the NEXT TURN
- *  BOUNDARY (design/116 §7 — turn 在飞时不注入), so the frame can precede actual injection by minutes ([1818]
- *  clay live: 3m54s; the previous wording here — "core already injected in-process" — was the same wrong
- *  assumption that broke the shell's dedup). `injected: false` says exactly that on the wire: a consumer must
- *  NOT treat this frame as an echo of model-context injection. EXPLICIT WHITELIST (never `{...ev}` — the 1.72 task_progress lesson: a
- *  future core field must not ride raw): ids/status/usage verbatim; `summary`/`result`/`output_file` are UNTRUSTED
- *  free text (core bounds+sanitizes for XML, does NOT secret-redact) → `redactSecrets` at OUR wire boundary. Shared
- *  by all three legs (bg runs.ts + resume append + the sync live SSE frame) so the shape never drifts. Takes the
- *  EVENT (not just the payload) so the E2 identity fields core stamps on it (eventId/parentToolCallId) ride the
- *  frame like every other content event (review round 2: the payload-only version silently dropped them). */
 export function taskNotificationEventData(ev) {
     const n = ev.notification;
     return {
-        // [1818]§四 (b)案:显式判别位 —— 本帧=台账观测,不证已入模型上下文(见 docstring)。恒 false 是
-        // 如实声明:server 观测不到 core 的 turn 边界注入时刻;若未来 core 给出注入回声 seam,echo 帧以
-        // injected:true 骑同帧族。
         injected: false,
         task_id: n.task_id,
         task_type: n.task_type,
-        // core 1.238: the child's sessionId — the stable a*↔uuid cross-system anchor (the killed
-        // receipt renders off summary+sessionId). Optional (bash lane has none).
         ...(n.sessionId !== undefined ? { sessionId: n.sessionId } : {}),
         ...(n.toolUseId !== undefined ? { toolUseId: n.toolUseId } : {}),
         status: n.status,
-        // The design/135 Monitor + design/134 stoppedBy fields were MISSING
-        // from this whitelist — the shell had no dedup discriminator (`seq` is what keeps successive Monitor event
-        // batches from collapsing into one, per core's taskNotificationDedupKey) and no batched line text / stop
-        // attribution. `seq` is a core counter (verbatim); `lines` is watched-process stdout = UNTRUSTED free text
-        // (redact each line, same boundary as result); `stoppedBy` is core's OPEN enum (verbatim string — consumers
-        // tolerate unknown values by contract).
         ...(n.seq !== undefined ? { seq: n.seq } : {}),
         ...(n.lines !== undefined ? { lines: n.lines.map((l) => redactSecrets(l)) } : {}),
         ...(n.stoppedBy !== undefined ? { stoppedBy: n.stoppedBy } : {}),
-        // P1-3(core 1.452):完成幂等锚 verbatim(消费端跨通路去重;[1925] 一轮批)。
         ...(n.completionId !== undefined ? { completionId: n.completionId } : {}),
-        // RB-386(core 2.4.0 wire note,2.5.0 提货收编):bg agent 失败面归因两键——error 是引擎侧
-        // 失败说明(可能含网络地址等)→ redactSecrets;errorCode 是机器码 verbatim。缺席=非失败帧。
         ...(n.error !== undefined ? { error: redactSecrets(n.error) } : {}),
         ...(n.errorCode !== undefined ? { errorCode: n.errorCode } : {}),
-        // [1543]§二 server①:白名单滞后 core payload 四键补齐——
-        //   source:external 通知来源标(caller 供 = UNTRUSTED)→ redactSecrets;
-        //   exitCode:数值 verbatim(bash 腿);
-        //   partial:boolean verbatim——**killed 残果诚实标**(缺它 cli 把残果渲染得像完整结果,core
-        //   特意打的标到不了用户面,本键是四键里的主案);
-        //   diagnostics:[1409] 教学文本 = UNTRUSTED 自由文本 → redactSecrets。
         ...(n.source !== undefined ? { source: redactSecrets(n.source) } : {}),
         ...(n.exitCode !== undefined ? { exitCode: n.exitCode } : {}),
         ...(n.partial !== undefined ? { partial: n.partial } : {}),
         ...(n.diagnostics !== undefined ? { diagnostics: redactSecrets(n.diagnostics) } : {}),
-        // core 1.262.0 五个补面——additive passthrough, same posture as
-        // lines/stoppedBy above. Fields PICKED (never spread — a future core field must not ride raw):
-        //   recentSteps: `tool` = core tool name (verbatim); `target` (file path / command / pattern) and
-        //   `outcome` (tool result first line) are UNTRUSTED free text (a command or output line can be
-        //   secret-shaped) → `redactSecrets`, same boundary as `result`/`lines`. Bounded upstream (≤10).
-        //   editedFiles: `path` is engine working-file derived but still crosses our wire → `redactSecrets`
-        //   (the compacted attachedFiles posture); `edits` numeric verbatim.
-        //   resumable: core boolean verbatim (E — parent decides continue-vs-restart without trial-and-error).
         ...(n.recentSteps !== undefined
             ? { recentSteps: n.recentSteps.map((s) => ({ tool: s.tool, target: redactSecrets(s.target), outcome: redactSecrets(s.outcome) })) }
             : {}),
@@ -314,18 +144,6 @@ export function taskNotificationEventData(ev) {
         ...identityFields(ev),
     };
 }
-/** The `compacted` payload — EXPLICIT WHITELIST shared by all three legs (bg runs.ts + resume append + the sync
- *  live SSE frame; the 1.72 task_progress lesson: never `{...ev}`). trigger/tokensBefore (MF-18) verbatim;
- *  `preserved_segment.firstKeptEntryId` verbatim (a core-mint entryId, the shell's compaction-divider anchor);
- *  core 1.219 `attachedFiles` (attachWorkingFiles default-ON — the shell renders CC's post-compact `Read {path}`
- *  cards from it): `path` is the engine's own working-file path (env-derived, not free text) but still crosses our
- *  wire → `redactSecrets` (a project path can embed a secret-shaped dir name); chars/truncated are numeric/bool
- *  verbatim. Absent fields stay absent (feature off / nothing attached / no kept-tail floor). */
-/** The `diagnostics` payload (core 1.220 design/121 — NEW LSP diagnostics drained at a turn boundary; the model
- *  already got the `<new-diagnostics>` context message in-process, this frame is the shell's render source).
- *  EXPLICIT WHITELIST shared by all three legs. UNTRUSTED RAW (§E1: language-server output over workspace files —
- *  a diagnostic message can quote file content, a secret-shaped uri/source is possible) → `redactSecrets` on the
- *  string fields; severity/range/code numbers verbatim. E2 identity rides. */
 export function diagnosticsEventData(ev) {
     return {
         files: (Array.isArray(ev.files) ? ev.files : []).map((f) => ({
@@ -342,11 +160,6 @@ export function diagnosticsEventData(ev) {
         ...identityFields(ev),
     };
 }
-/** The `steering_injected` payload([1550]/[1552] 裁定透传;core `TaskEvent` 联合臂 `type: "steering_injected"`,
- *  shell 渲染源 = CC 的系统提醒条:core 在 turn 之间给模型注入一条系统提示[todo 提醒/文件变化/日期跨天/
- *  技能列表变化…]时随手抛的展示投影,一附件一帧)。EXPLICIT WHITELIST(source=封闭枚举 verbatim;
- *  preview=注入文本的展示摘录,UNTRUSTED[core 未做秘密脱敏]→ `redactSecrets`)。共享三腿(sync 实时 SSE +
- *  bg/resume 落账,ledger-sink 同门)。 */
 export function steeringInjectedEventData(ev) {
     return {
         source: String(ev.source),
@@ -354,14 +167,7 @@ export function steeringInjectedEventData(ev) {
         ...identityFields(ev),
     };
 }
-/** `compaction_outcome`(core 2.5.0 [2105]②:压缩非 compacted 结局——manual /compact 的 mooted/failed
- *  两条真路)。[2373]A-2/C-2:此前它是**唯一**不走共享 builder、只在 live 腿 res.write 内联挑键的
- *  内容帧 ⇒ 两条 durable 腿零 case、回放即消失、三方普查各自失明。收进共享白名单 builder,三腿同源。
- *  outcome/trigger=闭枚举 verbatim;reason=引擎说明文本(可能引用配置值)→ redactSecrets;identity 同款。 */
 export function compactionOutcomeEventData(ev) {
-    // 形参照 contextUsageEventData 先例:全可选 unknown + 内部窄化,call site 免宽铸型(棘轮零新增)。
-    // 🔴 缺键守卫(同款「不合形即缺席」):无条件 String() 会把缺席/非串的键铸成字面 "undefined"/"null"
-    // 落进 durable 行——回放端读到的是一个看起来合法的枚举值,比缺席更难发现。
     const s = (v) => (typeof v === "string" ? v : undefined);
     return {
         ...(s(ev.outcome) !== undefined ? { outcome: s(ev.outcome) } : {}),
@@ -370,78 +176,16 @@ export function compactionOutcomeEventData(ev) {
         ...identityFields(ev),
     };
 }
-/** The `workspace_changed` payload([1559]二 core 裁定:design/99 §E13 旧臂,L1 门本车首次撞见——非新增,
- *  是本门扩 TaskEvent 臂集时第一次显式处置。语义 = bash `cd`/EnterWorktree 移动任务逻辑 cwd 后,在移动
- *  它的工具结算后发一帧,给 shell/宿主 UI 一个路径提示行。cwd 与已展示的工具 args 同信任级[UNTRUSTED,
- *  RAW 逻辑路径,symlink 不解析]→ `redactSecrets` + 长度 bound[300,与 brainStatusEventData.detail 同
- *  惯例]。core 只在真变化时才发(不播初始 cwd);渲染面（cli）不得当持久态——跨 suspend/resume 重置为
- *  根，这是消费端纪律，服务端只如实转发单帧不做状态缓存。 */
 export function workspaceChangedEventData(ev) {
     return {
         cwd: redactSecrets(String(ev.cwd)).slice(0, 300),
         ...identityFields(ev),
     };
 }
-/**
- * `wiring_manifest`(core 5.14.0 design/173 新 `TaskEvent` 臂)—— 每条腿(root/child/resume)在 prepare
- * 时自证「我到底接了什么线」的清单帧。
- *
- * 🔴 **本构造器存在的唯一理由是剥掉 `governance` 段**。core 给该段盖了 `audience: "operator"` 并成文
- * 了服务层义务:*a serving layer forwarding this event to a multi-tenant stream MUST project the governance
- * section for operators only; **no projection ⇒ do not disclose***。我方的三条腿(sync SSE / durable 账本 /
- * resume 账本)都是租户可读面,而 operator 投影是 #154 的独立大件——按 core 写死的失败方向,**没有投影
- * 就不得披露**,所以本批先把整段剥掉止泄(此前 sync 腿的裸 catch-all 会把它连同 `lockedConfig` /
- * `compliance` / `memoryAdmission` / `retention` 四个治理面在场位原样透传给任意订阅者)。
- * operator 投影是**另一个**构造器({@link wiringManifestOperatorEventData},live 腿按调用方身份挑),
- * 不是往这里加键 —— 两条 durable 腿没有调用方身份可挑,所以它们恒用本构造器。
- * ⚠️ 剥段还必须连**对该段取的哈希**一起剥:`configFingerprint` 同样不投影,理由见下方它那一行的旁注
- * (无盐哈希 + 4 布尔 = 16 组合的谕示器,把「结构上藏起来」的段原样还原出来)。
- *
- * 其余段逐键挑(禁 `{...manifest}`:1.72 task_progress 教训——未来 core 加段必须由人显式处置,而不是
- * 顺着 spread 裸上线,尤其当新段可能又是一个 audience 受限面时)。所有值都是引擎派生的闭枚举/布尔/
- * 有限数/不透明摘要串,**非用户内容 ⇒ 不脱敏**;畸形值一律按缺席处理(不铸假值,与 compacted 同规)。
- *
- * 🔴 **未标签面的准入裁定逐面记录在此,缺省不是「放行」**(#154 裁定 C)。core 只给 `governance` 标了
- * audience,其余段没有标签 —— 没标签**不等于**可以默认投给租户,每一段都要有一次人的裁定,写在这里:
- *  · `interaction.posture`(三值:interactive / headless / absent)—— **裁:租户可见**。它是部署形的
- *    自述(这条腿有没有人能答问题),消费端据此决定渲不渲交互面;不是治理秘密,也不构成任何治理位的
- *    侧信道(它不参与 governance 那 4 个布尔的还原)。
- *  · `permissionRules.storeWired`(布尔;core 5.18.0 design/179 新段)—— **裁:租户可见**。同族判据:
- *    它与 `parkLane.capable` / `elicit.seamWired` / `fleet.backgroundAgentStore` 是同一类「这条腿接没接
- *    某个可选设施」的部署形自述,而那三个早已租户可见。消费端的真需求也在租户侧:审批卡要不要渲染
- *    「不再询问」这一格,取决于这台 worker 有没有规则店 —— 剥掉它,客户端只能靠试(提交后被拒)才知道。
- *    它**不在** `governance` 段里(core 自己把它放在段外),也不构成那 4 个治理布尔的侧信道。
- *    ⚠️ 恒在段(core 侧 `permissionRules` 无 `?`):两个真值都可能出现,**别把 false 读成缺席**。
- *    本仓自 #154 车二 / design/203 起真接了规则店(`main.ts` 在 `PERMISSION_RULES_ENABLED` 为真 ∧
- *    backend 在场时把 `permissionRuleStore` 装进 `RunnerDeps`,SQL 与 File 两形)⇒ 那样的部署报
- *    `storeWired: true`;旋钮关掉或后端缺席的部署仍报 `false`。消费端读到 false 就是「这台 worker
- *    今天没有这条车道」,不许当成「这版引擎还没这个概念」。
- *  · `permissionRules.syncWired` / `permissionRules.orgGoverned`(布尔两位;core 5.23.0 design/182 §9/§7
- *    给**同一段**加的员,[3372] 提货批 codex 复审 high 抓获——首版把它们静默剥了,正是本仓建这份台账要防
- *    的「投影白名单剥键」病)—— **裁:租户可见,与同段的 `storeWired` 同待遇**。判据三条:
- *    ① **同段同类**:core 把它们放进 `permissionRules` 而不是 `governance`(唯一带 audience 标签的段),
- *       且形状与 `storeWired` 逐字同构(恒在的布尔,present-and-false 表示「有这个概念,这里没开」);
- *    ② **消费端真需求在租户侧**:这两位说的是「按下『不再询问』之后,这条同意到底落到多大的信任域里」——
- *       `syncWired` = 这台 worker 会把规则并进跨设备/传输/服务端的**同一个同意信任域**;`orgGoverned` =
- *       组织治理层武装着(且它的 fail-closed 契约意味着读不到 org 快照时**每一次**放行都会被抬成真人审批)。
- *       同一张审批卡上的同一个动作,后果因这两位而不同,剥掉它们等于让客户端渲一格语义不明的开关;
- *    ③ **不是治理侧信道**:两位都不参与 `governance` 那 4 个布尔的还原(它们描述规则店这条车道自身的
- *       形状,与 lockedConfig/compliance/memoryAdmission/retention 无函数关系)。
- *    ⚠️ 与 `storeWired` **不同**:本仓这两条至今未接(`RunnerDeps.permissionRuleSyncWired` /
- *    `permissionRuleOrg` 全树零声明点,2026-08-10 #204 复扫亲验)⇒ 今天恒 `false`,这是**真值**不是
- *    缺席。哪天接上其中任一条,连本句一起改 —— 这一行是它的登记处。
- * 未来 core 加一段而它没有 audience 标签时,**先在这里补一条裁定再决定挑不挑键** —— 段级完备性钉
- * (test/wiring-manifest-projection.test.ts)会在那一刻先把人拦下来。
- */
 export function wiringManifestEventData(ev) {
-    // 形参照 `compactionOutcomeEventData` / `contextUsageEventData` 先例:全可选 `unknown` + 内部逐层窄化。
-    // 两个理由,不是风格:①三条腿里有两条(ledger-sink.onEvent / resume switch)手里只有 `{type:string}`,
-    // 窄形参会逼出 `as unknown as` 双铸型(类型卫生棘轮门当场红);②窄化在这里做,账本回放/第三方 producer
-    // 送来的畸形段也走同一道门,而不是只保护 live 腿。
     const str = (v) => (typeof v === "string" && v.length > 0 ? v : undefined);
     const bool = (v) => (typeof v === "boolean" ? v : undefined);
     const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : undefined);
-    /** 段读:非对象即缺席(不铸空段)。 */
     const sec = (v) => (typeof v === "object" && v !== null && !Array.isArray(v) ? { ...v } : undefined);
     const nonEmpty = (o) => (Object.keys(o).length > 0 ? o : undefined);
     const m = sec(ev.manifest) ?? {};
@@ -462,7 +206,6 @@ export function wiringManifestEventData(ev) {
     const question = nonEmpty({
         ...(str(questionIn.wired) !== undefined ? { wired: questionIn.wired } : {}),
         ...(str(questionIn.provenance) !== undefined ? { provenance: questionIn.provenance } : {}),
-        // 组装谎言标(交互工具在场却没有投递面)——只在 core 真铸时带,缺席不折 false。
         ...(questionIn.interactiveToolsWithoutDeliveryFace === true ? { interactiveToolsWithoutDeliveryFace: true } : {}),
     });
     const elicit = nonEmpty({
@@ -471,8 +214,6 @@ export function wiringManifestEventData(ev) {
     });
     const parkLane = nonEmpty({
         ...(bool(parkIn.capable) !== undefined ? { capable: parkIn.capable } : {}),
-        // `effective` 是三态(true / false / "unresolved")——布尔与字符串两支都得过。折成布尔会把
-        // 「还没定」谎报成「不能 park」,而那正是这个字段被造出来要区分的那一格。
         ...(bool(parkIn.effective) !== undefined || str(parkIn.effective) !== undefined ? { effective: parkIn.effective } : {}),
         ...(Array.isArray(parkIn.reasons) ? { reasons: parkIn.reasons.filter((r) => typeof r === "string") } : {}),
         ...(str(parkIn.checkpointDurability) !== undefined ? { checkpointDurability: parkIn.checkpointDurability } : {}),
@@ -481,9 +222,6 @@ export function wiringManifestEventData(ev) {
         ...(bool(fleetIn.backgroundAgentStore) !== undefined ? { backgroundAgentStore: fleetIn.backgroundAgentStore } : {}),
         ...(bool(fleetIn.hostChildEventSink) !== undefined ? { hostChildEventSink: fleetIn.hostChildEventSink } : {}),
     });
-    // core 5.18.0 design/179 段 + 5.23.0 design/182 §9/§7 两位加员(裁定见头注:三位同判租户可见)。
-    // 逐键挑,与其余段同规:非布尔按缺席处理(不铸假值——一个编出来的 `false` 会被读成「确实没接/没开」,
-    // 而真相是这段读不出来)。
     const permissionRules = nonEmpty({
         ...(bool(rulesIn.storeWired) !== undefined ? { storeWired: rulesIn.storeWired } : {}),
         ...(bool(rulesIn.syncWired) !== undefined ? { syncWired: rulesIn.syncWired } : {}),
@@ -500,46 +238,11 @@ export function wiringManifestEventData(ev) {
         ...(str(sessionIn.store) !== undefined ? { session: { store: sessionIn.store } } : {}),
         ...(fleet !== undefined ? { fleet } : {}),
         ...(permissionRules !== undefined ? { permissionRules } : {}),
-        // governance —— **刻意不在此**(见头注:受众标 operator,无投影不披露)。
-        // configFingerprint —— **也刻意不在此**(codex 复审 2026-08-06 F1,验真后采纳)。剥掉一个段却把
-        // **对它取的哈希**发出去,等于没剥:core 的算法是
-        // `sha256(canonicalize(manifest 去掉 leg 与两个 provenance))` 取前 16 hex —— 无盐、输入里含整个
-        // governance 段,而 governance 只有 4 个布尔(audience 是常量)⇒ **16 种组合**。租户手里已经有其余
-        // 全部哈希输入(它们正是我们投影出去的那些段),把 16 种组合逐个拼进去重算一遍即可比中,
-        // lockedConfig / compliance / memoryAdmission / retention 四位当场还原。
-        // 「结构上藏起来、经哈希谕示器泄出去」仍然是泄出去,core 写死的失败方向(no projection ⇒ do not
-        // disclose)对侧信道一样适用。它的广告用途(判两条腿是不是同一套装配)在本仓与 SDK **今天零消费端**,
-        // 所以直接不发,而不是另铸一个「只对已投影字段取哈希」的服务端自造值(那是新 wire 语义,要跨仓对表)。
-        // 带 core 真 fingerprint 的是 {@link wiringManifestOperatorEventData}(explicitOperatorOk 为真的 live
-        // 连接才走那条),对那个受众而言四布尔本就在同一份产物里,哈希不再是侧信道。
         ...identityFields(ev),
     };
 }
-/**
- * `wiring_manifest` 的 **operator 投影**(#154 件一)—— {@link wiringManifestEventData} 的租户形加上
- * `governance` 段与 core 的真 `configFingerprint`。
- *
- * 🔴 分叉发生在**读口**,不在账本:两条 durable 腿(ledger-sink / resume)恒存剥后形,因为账本写的那一刻
- * 不知道未来的读者是谁(`GET /v1/runs/:id/events` 任何 run owner 都读得到),往账本存全量 = 把 operator-only
- * 面写进租户可读介质;存两份则是双写漂移源。所以只有 live 腿在**知道调用方身份**的那一刻挑构造器。
- * 代价是 operator 看不到历史腿的 governance 段 —— 治理四布尔是部署形事实(不随 leg 漂),静态自检面
- * (`GET /v1/diagnostics/wiring`)随时给出当前真值。
- *
- * 准入判据是 `explicitOperatorOk`(**不是** `isOperator`):空 `OPERATOR_PRINCIPALS` 必须是「没有人是
- * operator」,不能是「所有人都是」—— 后者会让一个没配 operator 名单的部署把治理面发给每一个订阅者。
- *
- * `configFingerprint` 只在本构造器里透传:它是 `sha256(canonicalize(manifest 去 leg/去两个 provenance))`
- * 前 16 hex,**无盐**且输入含整个 governance 段,而 governance 只有 4 个布尔 ⇒ 16 种组合。租户手里已有其余
- * 全部哈希输入,发给租户等于把剥掉的四位原样还原(谕示器);发给 operator 无损 —— 同一份产物里四布尔本就
- * 在场。
- *
- * governance **逐键挑**(禁 `{...governance}`):core 往这个段里加第五键时必须由人显式处置,而不是顺着
- * spread 裸上线 —— 这个段的每一键都是部署治理面,新键的默认待遇必须是「不发」。
- */
 export function wiringManifestOperatorEventData(ev) {
-    // 租户形整体复用(不是复制一份键表):operator 面 ⊇ 租户面 是结构性的,两个构造器不可能在共有段上漂。
     const tenant = wiringManifestEventData(ev);
-    // 窄读器与租户构造器内的孪生同形而独立 —— 那只构造器被 16 组合谕示器钉钉着,本件不改它一个字节。
     const str = (v) => (typeof v === "string" && v.length > 0 ? v : undefined);
     const bool = (v) => (typeof v === "boolean" ? v : undefined);
     const sec = (v) => (typeof v === "object" && v !== null && !Array.isArray(v) ? { ...v } : undefined);
@@ -558,24 +261,6 @@ export function wiringManifestOperatorEventData(ev) {
         ...(str(m.configFingerprint) !== undefined ? { configFingerprint: m.configFingerprint } : {}),
     };
 }
-/**
- * `human_input`(core 5.14.0 design/171 新 `TaskEvent` 臂)—— 「谁把什么喂进了这条 run」的生命周期账本
- * 帧(objective / 实时 steer / nextTurn / parked-steer 续跑 / wake 五个载体共用一个投影点)。
- *
- * 信任划线(与 tool_approval 帧同族):
- *  · `inputId` / `sessionSeq` / `carrier` / `source` / `delivery` / `entryId` —— 引擎铸的标识与枚举值,
- *    **非用户内容** ⇒ verbatim。注意本帧**不带正文**(core 的臂里就没有 text 字段),所以没有内容脱敏面。
- *  · `issuer` 与 `actor.id` / `actor.issuer` —— 宿主从入口凭据派生的**身份串**,自由文本形(`slack:U123`
- *    这类命名空间串里可以嵌任何东西)⇒ 过 `redactSecrets`,与 `sourceAgentName` 同待遇。
- *  · `actor.hostAsserted` —— 布尔,verbatim。**它是消费端唯一能判「这个署名可信吗」的位**(core 的
- *    `[from …]` 渲染就是靠它决定加不加 `(unverified)`),剥掉它比剥掉 id 更坏:剩下一个看不出真假的名字。
- *  · `principal` —— **刻意不投影**(与 ToolApprovalFrame 的 `principal` 同裁):帧本就经 owner-scoped 流
- *    投递,租户身份不必再由帧自述。要它请先提消费需求,别顺手加。
- *
- * `actor` 逐键挑(禁 spread):core 已声明 `ActorAssertion` 是冻结三键形,但白名单的意义正是「core 加第
- * 四键时由人处置」——身份对象上多出来的键裸上线是本文件反复登记的病族。
- * 形参全可选 `unknown` 的理由同 {@link wiringManifestEventData}(两条 durable 腿手里只有 `{type:string}`)。
- */
 export function humanInputEventData(ev) {
     const str = (v) => (typeof v === "string" && v.length > 0 ? v : undefined);
     const a = typeof ev.actor === "object" && ev.actor !== null && !Array.isArray(ev.actor) ? { ...ev.actor } : {};
@@ -585,8 +270,6 @@ export function humanInputEventData(ev) {
         ...(str(a.issuer) !== undefined ? { issuer: redactSecrets(String(a.issuer)) } : {}),
     };
     return {
-        // 缺键守卫同 compactionOutcomeEventData:无条件 String() 会把缺席铸成字面 "undefined" 落进 durable 行,
-        // 回放端读到一个看起来合法的 id/枚举值,比缺席更难发现。
         ...(str(ev.inputId) !== undefined ? { inputId: ev.inputId } : {}),
         ...(typeof ev.sessionSeq === "number" && Number.isFinite(ev.sessionSeq) ? { sessionSeq: ev.sessionSeq } : {}),
         ...(str(ev.carrier) !== undefined ? { carrier: ev.carrier } : {}),
@@ -598,10 +281,6 @@ export function humanInputEventData(ev) {
         ...identityFields(ev),
     };
 }
-/** S4 (SILENT-FALLBACK P0-a): the durable `brain_status` observation row, shared by the bg + resume append
- *  sites. core marks the live `status` frame EPHEMERAL (never replayed by core on resume) — this row is the
- *  SERVICE's own observation record (why a turn stalled: rate_limited/retrying/reconnecting/circuit_open),
- *  not a core event replay. Whitelist: the closed phase union + neutral bounded detail (redacted) + retryInSec. */
 export function brainStatusEventData(ev) {
     const num = (v) => typeof v === "number" && Number.isFinite(v);
     return {
@@ -616,12 +295,7 @@ export function brainStatusEventData(ev) {
     };
 }
 export function compactedEventData(ev) {
-    // Bounded-numeric guard for the 1.289 additive scalars: finite numbers verbatim, anything else absent
-    // (whitelist discipline — a malformed field must not ride the wire, same class as the 1.72 lesson).
     const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : undefined);
-    // core 1.289 `phaseDurations` (CompactionPhaseDurations: prepareMs/summaryMs?/persistMs/ptlRetries) — a
-    // CLOSED numeric struct rebuilt field-by-field (never `{...ev.phaseDurations}`: an unexpected extra key must
-    // not leak onto the wire); non-numeric members are dropped, an all-empty struct stays absent.
     const phaseDurations = (() => {
         const p = ev.phaseDurations;
         if (!p || typeof p !== "object")
@@ -637,14 +311,6 @@ export function compactedEventData(ev) {
     return {
         ...(ev.eventId !== undefined ? { eventId: ev.eventId } : {}),
         ...(ev.parentToolCallId !== undefined ? { parentToolCallId: ev.parentToolCallId } : {}),
-        // 🔴 2026-07-25:这三处此前**违反本函数注释自己写的那条不变量**(「畸形字段不得上线,与 1.72 同类」)——
-        //   ① `trigger`/`tokensBefore` 是**裸赋值**:`tokensBefore` 为 `NaN` 时 `JSON.stringify` 把它变成 **`null`**,
-        //      于是压缩面板渲染成「压缩前 0 tokens」而不是「未知」;裸赋值还会留下 present-with-undefined 的键
-        //      (JSON 会丢,但非 JSON 后端的进程内读者看得到)⇒ 统一走 `num()`/类型判据 + 条件 spread。
-        //   ② `attachedFiles` 的元素**逐字段照抄**:一个畸形元素(如 `{}`)会被**造成**
-        //      `{path:"undefined", chars:undefined, truncated:undefined}` —— 那是**编造值**,比丢弃更坏
-        //      (下游看到一个叫 "undefined" 的文件路径)。改成**逐元素校验后丢弃畸形项**,全丢光则整键省略
-        //      (与既有的 `length > 0` 同口径)。
         ...(typeof ev.trigger === "string" ? { trigger: ev.trigger } : {}),
         ...(num(ev.tokensBefore) !== undefined ? { tokensBefore: num(ev.tokensBefore) } : {}),
         ...(ev.preserved_segment?.firstKeptEntryId ? { preserved_segment: { firstKeptEntryId: ev.preserved_segment.firstKeptEntryId } } : {}),
@@ -657,75 +323,33 @@ export function compactedEventData(ev) {
                 .map((f) => ({ path: redactSecrets(f.path), chars: f.chars, truncated: f.truncated }));
             return files.length > 0 ? { attachedFiles: files } : {};
         })(),
-        // core 1.286 additive fields ([792]②b, design/145 compression batch): modelFallback/fallbackReason = the
-        // compaction summarizer fell back to a larger-window model; clampedRatio/clampReason = the keep ratio was
-        // clamped and why. Closed literal bool/enum/number — verbatim; absent stays absent.
         ...(ev.modelFallback === true ? { modelFallback: true } : {}),
         ...(ev.fallbackReason !== undefined ? { fallbackReason: ev.fallbackReason } : {}),
-        ...(num(ev.clampedRatio) !== undefined ? { clampedRatio: num(ev.clampedRatio) } : {}), // 同上:NaN 不得以 null 上线
+        ...(num(ev.clampedRatio) !== undefined ? { clampedRatio: num(ev.clampedRatio) } : {}),
         ...(ev.clampReason !== undefined ? { clampReason: ev.clampReason } : {}),
-        // core 1.289 additive fields (codex F7 — parity batch, same posture as [792]②b above): tokensAfter/
-        // triggerTokensBefore/durationMs are engine-derived scalars, verbatim when finite numbers; phaseDurations
-        // is the closed bounded struct built above. Absent stays absent on all three wire legs (bg runs.ts append,
-        // the resume append, and the sync live SSE frame — all funnel through THIS builder).
         ...(num(ev.tokensAfter) !== undefined ? { tokensAfter: num(ev.tokensAfter) } : {}),
         ...(num(ev.triggerTokensBefore) !== undefined ? { triggerTokensBefore: num(ev.triggerTokensBefore) } : {}),
         ...(num(ev.durationMs) !== undefined ? { durationMs: num(ev.durationMs) } : {}),
         ...(phaseDurations !== undefined ? { phaseDurations } : {}),
     };
 }
-/**
- * `context_usage` 的白名单投影(core 1.414 新增一等 `TaskEvent` 分支;server [1669]⑥ 点名要的上下文用量面)。
- *
- * 🔴 两条 core 明确交代的口径,必须原样传下去、不要在服务端"聪明地"重算:
- *  · `usedTokens > compactAtTokens` **就是引擎自己喂 `shouldCompact` 的谓词** —— 消费方直接用,别重新推导阈值。
- *  · `windowTokens` 是 **autocompact 窗**,**不是**「模型上下文大小」(模型声明 `autoCompactTokens` 时物理请求
- *    窗更大)。渲染成"模型上下文"会给用户一个错的分母。
- * ⚠️ 它在**每个压缩边界**上报(不只压缩真发生时),所以一次任务里会有多条 —— 消费方按最后一条取当前值。
- * ⚠️ 它**没有**挂在 `turn_end.usage` 上(core 解释:边界检查跑在 turn_end 之后、对 flush 后的消息集,
- *    挂那儿会是"另一次更早的测量顶着同一个名字")。去 turn_end 找是找不到的。
- * 三个字段都是引擎派生的有限数标量 ⇒ 走 finite 门(与 compacted 的 1.289 标量同姿势),非有限即缺席。
- */
-// [2373]A-3 记账(2026-08-02):SDK 有臂、五端零读点(webC Composer 读的是本端自己的 state.context,
-// 非 wire 三键)——半死:契约面已就位、消费端一个都没接。头注下方的三条口径纪律警告的消费者还不存在;
-// 谁要做压缩面板,这是真正需要的量,先上黑板认领。
 export function contextUsageEventData(ev) {
     const n = (v) => (typeof v === "number" && Number.isFinite(v) ? v : undefined);
     return {
         ...(n(ev.usedTokens) !== undefined ? { usedTokens: n(ev.usedTokens) } : {}),
         ...(n(ev.windowTokens) !== undefined ? { windowTokens: n(ev.windowTokens) } : {}),
         ...(n(ev.compactAtTokens) !== undefined ? { compactAtTokens: n(ev.compactAtTokens) } : {}),
-        // [2557] 2.4:本分支带 TaskEventIdentity 而 builder 曾剥——差集门补进三构造器当场红出(compacted 同病先例)。
         ...identityFields(ev),
     };
 }
-/**
- * `turn_end` 的白名单投影 —— 🔴 2026-07-25 补:`turn_end` 此前是**唯一没有 builder 的内容臂**,两条持久化点
- * (ledger-sink 与 resume 腿)各自手写 `{ usage }`,于是 core 的另两个字段被静默剥掉:
- *   · `stopReason` —— **这一轮为什么停**(max_tokens / stop_sequence / …);
- *   · `usageMissing: true` —— **用量不可信**的诚实标记。缺了它,"没有 usage"会被读成"用量是 0",
- *     而不是"未知";这正是那种"回放后看起来一切正常"的丢失。
- * 两者**在 live 腿看得见、durable 腿回放后永久消失** —— 与 [1622] 的 `label`、[1611] 的 workflowRunId 同一族
- * (白名单没跟上 core 新增字段)。补 builder 的同时也就把它纳入了 `wire-whitelist-exhaustiveness` 的编译期差集门。
- */
 export function turnEndEventData(ev) {
     return {
         ...(ev.usage ? { usage: ev.usage } : {}),
         ...(ev.usageMissing === true ? { usageMissing: true } : {}),
         ...(typeof ev.stopReason === "string" ? { stopReason: ev.stopReason } : {}),
-        // [2557] 2.4:同 contextUsage——identity 键(eventId/parentToolCallId)曾被剥,差集门红出补齐。
         ...identityFields(ev),
     };
 }
-/** Map core's `turn_end.usage` (1.76 / core [R59]: inputTokens/outputTokens/cacheReadTokens/cacheWriteTokens/
- *  costMicroUsd; core 3.0.0 adds required `totalInputTokens`) → the contract's `TraceTurn.tokens`.
- *  Absent/empty → undefined.
- *
- *  core 3.0.0([2296] 装车单 S3,§DESIGN-V2 V2-②,codex 复审「异议」采纳):`TraceTurn.tokens` 是本服务自有
- *  的投影契约,不是 wire verbatim——`in` 保持它一直以来的**总量**语义,3.0.0 起改取 `totalInputTokens`
- *  (归一化总输入含 cache)优先,`inputTokens` 回落(旧帧/尚未升级的 core 下 `totalInputTokens` 缺席时,
- *  `in` 落回旧值,读端零伤)。`uncachedIn` 只在**能确认自己踩在新契约帧上**(`totalInputTokens` 在场)时
- *  才发——旧帧的 `inputTokens` 是族依赖的旧语义,标成「uncachedIn(cache-MISS)」会是谎言。 */
 export function toContractTokens(usage) {
     if (!usage || typeof usage !== "object")
         return undefined;
@@ -740,10 +364,6 @@ export function toContractTokens(usage) {
         ...(u.cacheWriteTokens != null ? { cacheWrite: u.cacheWriteTokens } : {}),
     };
 }
-/** [2373]C-13:tool_start/tool_end 的**共享挑键**——`projectEvents`(turns 面)与 `mapTraceEvent`
- *  (trace SSE 面)对同一账本行的字段选择逐字同构,此前两处独立手写,structured/totalChars/label
- *  三次扩字段各改两遍(见两处对偶注)。收一份:两面各自包装键名皮(id/name/input vs 同名),
- *  字段集合从此单点演进。 */
 export function toolCallFieldsOf(d) {
     return {
         id: String(d.toolCallId ?? ""),
@@ -760,26 +380,14 @@ export function toolResultFieldsOf(d) {
         ...(d.truncated ? { truncated: true } : {}),
         ...(Number.isFinite(d.totalChars) ? { totalChars: d.totalChars } : {}),
         ...(d.structured !== undefined ? { structured: d.structured } : {}),
-        // core 5.9.0 W3([2535]):机器可判别的 park/死投影码(`gate.parked`/`tool.not_found`)——写侧
-        // toolEndEventData 已带,读腿必须同键 verbatim(absent⇒absent),否则冷回放退回锚 abort 文案字面。
         ...(typeof d.errorCode === "string" ? { errorCode: d.errorCode } : {}),
-        // core 5.18.1 #187:结算来源(闭集)——写侧 toolEndEventData 已带,读腿同键 verbatim(absent⇒absent)。
-        // 🔴 读腿的闭集门是**独立的一道**,不是写侧那道的复述:账本行可以来自任何引擎世代、任何第三方
-        // producer,写侧的门管不到它们;这里放行 = 把一个 core 从未发过的词直接送上 wire。
         ...(isApprovalSettledBy(d.settledBy) ? { settledBy: d.settledBy } : {}),
-        // core 5.35.0 G-7(#263):结算归属(settledBy 旁的 WHOSE)——写侧已 redactSecrets 后落账,读腿
-        // 同键过境;判形独立一道(同上款理由),开集身份串故只判 string 非空,不设词表。
         ...(typeof d.approver === "string" && d.approver !== "" ? { approver: d.approver } : {}),
-        // 🔴 #337 红先补(A-067 F1a 现行案):`resolution` #326 提货时写侧落账、TraceBlock 留了槽位,本
-        // 共享挑键漏挑 ⇒ live 有、turns/trace 冷回放丢——[1622]/label 剥键族在「单点挑键」建立之后的复发。
-        // 读腿闭集门独立一道(账本行可来自任何世代/第三方 producer),判据同 core 谓词。
         ...(isAskDenyResolution(d.resolution) ? { resolution: d.resolution } : {}),
-        // core 5.55.0 #333(#337 提货):park 扣着的 call id——写侧已判形落账,读腿独立同判(string 非空)。
         ...(typeof d.gatedCallId === "string" && d.gatedCallId !== "" ? { gatedCallId: d.gatedCallId } : {}),
         ...identityFields(d),
     };
 }
-/** Project a per-task event slice (seq-ascending) into ordered `TraceTurn[]`. Pure + total (never throws). */
 export function projectEvents(events, opts = {}) {
     const turns = [];
     if (opts.objective) {
@@ -810,16 +418,10 @@ export function projectEvents(events, opts = {}) {
                 blocks.push({ type: "tool-call", ...toolCallFieldsOf(d) });
                 break;
             case "tool_end": {
-                // E1: output is read straight off the (already-redacted-at-append) event — no session join. Absent ⇒ undefined.
-                // `structured` (core 1.203 CC card) was redacted at APPEND (toolEndEventData) — passthrough on the read
-                // path so a cold-replay/turns consumer renders the same rich card the live wire carried (additive field).
                 blocks.push({ type: "tool-result", ...toolResultFieldsOf(d), output: d.output, ...(d.isError ? { isError: true } : {}) });
                 break;
             }
             case "prompt_assembled":
-                // [998]②: whitelisted at APPEND (budget.ts promptManifestRecordOf — ids/digests/counts only);
-                // passthrough on the read path (the `structured` posture). Lands ahead of the turn's first content
-                // block, so the "Prompt 组成" card renders at the top of the turn it prepared.
                 firstTs ??= ev.ts;
                 blocks.push({
                     type: "prompt-assembled",
@@ -833,17 +435,14 @@ export function projectEvents(events, opts = {}) {
             case "turn_end":
                 flushTurn(ev.seq, ev.ts, toContractTokens(d.usage));
                 break;
-            // compacted / done / suspended / failed are lifecycle, not turn output — status comes from the run record.
         }
     }
-    // A trailing in-progress turn (events after the last turn_end — e.g. a live task mid-turn).
     if (blocks.length > 0) {
         const last = events[events.length - 1];
         flushTurn(last.seq, last.ts);
     }
     return turns;
 }
-/** Structured `lastStep` (contract 2.1) from the latest event — UI maps an icon, never free text. */
 export function lastStep(latestEventType, status) {
     if (status !== "running")
         return { type: "idle" };
@@ -858,11 +457,7 @@ export function lastStep(latestEventType, status) {
             return { type: "responding" };
     }
 }
-/** A run record → the cheap list summary (contract 2.1). Token/cost/turns come from the terminal result.stats;
- *  scenario isn't denormalized on the run row (omitted — a later push-index/column refinement). */
 export function taskSummary(run, latestEventType) {
-    // [2373]D-1(活 bug 修):core 2.0.0 起浮点 costUsd 族整删,stats 只有整数 costMicroUsd —— 旧读点
-    // (costUsd × 1e6)对现役 core 恒缺席,verbatim 透传才是唯一正确形。
     const stats = (run.result?.stats ?? {});
     const terminal = run.status !== "running";
     return {
@@ -880,28 +475,13 @@ export function taskSummary(run, latestEventType) {
         lastStep: lastStep(latestEventType, run.status),
     };
 }
-/** design/158 B2(lens4 N8)—— 重放边界的**读旧**归一:把历史账本里的 `brain_status` 行改叫 `status`。
- *
- *  同一条「大脑存活性」观测曾在两条腿上叫两个名字:live 腿(`POST /v1/tasks/stream`)发 `type:"status"`,
- *  durable 腿的账本行落 `brain_status`,而 SDK 的公开 `AgentEvent` 联合**只有** `status` —— 于是走
- *  `GET /v1/runs/:id/events` 的消费端会收到一个公开联合之外的帧(穷举式 closed-oneOf 消费者当场抛)。
- *
- *  写入侧已经改叫 `status`(ledger-sink.ts 与 resume 腿的 append 两处),但**存量行救不了**:任何
- *  <1.317 的部署账本里都躺着 `brain_status` 行,重放它们仍会漏出旧名。所以「写新」必须配一个「读旧」——
- *  这个函数就是那个读边界,唯一调用点是 task_run SSE 的 `formatEvent`(routes/runs.ts)。
- *
- *  🔴 刻意**只**认这一个键,不做成映射表:帧名归一是历史包袱的一次性偿还,不是一条可以长胖的兼容层。
- *  再有第二个名字对不齐,应当在源头修,而不是往这里加一行。 */
 export function normalizeRunEventType(type) {
     return type === "brain_status" ? "status" : type;
 }
-/** Map one durable event → a sema-registry SSE trace event (contract 2.3). null = not a client event. The
- *  durable log is block-grained, so each block ships as one "delta" the client appends (stream mode = "delta"). */
 export function mapTraceEvent(type, seq, data) {
     const mapped = mapTraceEventInner(type, seq, data);
     if (mapped === null)
         return null;
-    // [2373]C-12:data 里补 `type`(=event 名)双发(fleet 流同批;error 帧 arm 自带 type 保持原值)。
     return { event: mapped.event, data: { type: mapped.event, ...mapped.data } };
 }
 function mapTraceEventInner(type, seq, data) {
@@ -913,51 +493,27 @@ function mapTraceEventInner(type, seq, data) {
         case "tool_start":
             return { event: "tool-call", data: { seq, ...toolCallFieldsOf(data) } };
         case "tool_end":
-            // E1: output/truncated are already redacted+bounded at append; pass through. E2: identity additive.
             return { event: "tool-result", data: { seq, ...toolResultFieldsOf(data), isError: Boolean(data.isError), ...(data.output !== undefined ? { output: data.output } : {}) } };
         case "turn_end": {
             const tokens = toContractTokens(data.usage);
             return { event: "turn", data: { seq, ...(tokens ? { tokens } : {}) } };
         }
         case "prompt_assembled":
-            // [998]②: whitelisted at append (ids/digests/counts, no prompt bodies) — passthrough, own event name.
             return { event: "prompt-assembled", data: { seq, ...data } };
         case "done":
             return { event: "done", data: { seq } };
-        // 🔴 park 的账本事件名有**两个**(扫描P2,status/kind 同名词混淆病族):`suspended` 与
-        // `needs_review` —— 写点是 `trace/ledger-sink.ts` 的 `appendParked(kind)`(kind 逐字取自
-        // `result.status`)、`runs.ts` 的 bg 腿、`http/server.ts` 的两条 resume 腿;`needs_review` 就是
-        // plan_review / dry_run 两种 gate 的 park 落名。只映射前者 ⇒ 一条 plan_review park 在 trace 流上
-        // 落进 `default → null`,**一帧都不发**,消费端只看到流无声中止(既不是 done 也不是 error)。
-        // 契约 2.3 的 park 标记只有 `suspended: true` 这一个位 ⇒ 两个词共用同一张帧(gate 细分在
-        // `GET /v1/runs/:id`,不在这条流上)。
         case "suspended":
         case "needs_review":
             return { event: "done", data: { seq, suspended: true } };
         case "failed":
-            // BL-13: redact at the read boundary too (defense-in-depth) — covers any errorMessage that reached the
-            // log un-redacted via another write path; idempotent on the BL-12-redacted catch-path message.
-            // A1/A6/B(复审 2026-07-29):error 帧统一为 `{ type:"error", errorCode, message }` —— 与 sse-log /
-            // approvals 的帧同形。这一处是 3.0.0 摘 legacy `code` 键时的漏网:帧在 src/trace/ 铸,而当时的门只扫
-            // src/http/,于是"SSE error 帧机器键统一为 errorCode"的公开声明与 wire 上跑的东西不一致(门是绿的)。
             return { event: "error", data: { type: "error", errorCode: "WORKER_DOWN", message: redactSecrets(String(data.errorMessage ?? "run failed")) } };
-        // 🔴 **显式不投影**(A-032 P1-③ 裁定,2026-08-14)。这四型是账本写口(`trace/ledger-sink.ts` 与
-        // resume 腿都 append 它们)却从来不在任何 case 臂上,于是走的是下面那个 `default` —— 而「刻意不发帧」
-        // 与「忘了接线」在码面上**同形**,两者的下一步动作却相反(前者什么都不做,后者是缺陷)。写成显式臂
-        // 就是把裁定钉在源码上。裁的是「不投影」,理由不是懒:契约 2.3 的帧集是**闭集**(thinking/content/
-        // tool/turn/prompt/done/error 七类),给它加一个新帧名会让穷举式 closed-oneOf 消费端收到公开联合之外
-        // 的帧 —— design/158 B2 那次(durable 腿发 `brain_status`、公开联合只有 `status`)真咬过的同形。
-        // 这四型的消费面是 `GET /v1/runs/:id/events` 裸回放,不是这条流。特别地 `human_input` **不能**折成
-        // content/thinking:它是「谁经哪条载体喂了这条 run」的归属事实,映射成 agent 内容就是编造。
-        // 要改成投影 ⇒ 那是一次 wire 帧集扩张(能力发布件,须点名消费方表态),不是顺手加一行。
-        // 闭合门:test/probe-wire-1.test.ts「A-032 P1-③ 账本写口 ↔ mapTraceEvent 投影的三方闭合门」。
         case "context_usage":
         case "compaction_outcome":
         case "wiring_manifest":
         case "human_input":
             return null;
         default:
-            return null; // compacted etc. — not a client trace event
+            return null;
     }
 }
 //# sourceMappingURL=project.js.map