@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/printToolResultFrame.d.ts

@@ -1,119 +1,19 @@
-/**
- * ⇄ B1 批搬迁(2026-07-27,多端改造设计稿 §2.4.1-B):cli src/sema/printToolResultFrame.ts 逐字搬入,
- * 唯一改动 = `SDKMessage` 的 type-only import 从壳内 `../seam/adapter/index.js` 改指
- * `@sema-agent/agent-types`(type-only,零运行时边)。
- *
- * 🔴 **这两个 SDKMessage 不是同一个 symbol**(实测,别沿用「re-export」的想当然):壳侧
- * `src/seam/adapter/types.ts:35` 是 `z.infer<ReturnType<typeof SDKMessageSchema>>` —— CC 自己
- * `src/entrypoints/sdk/coreSchemas.ts` 里 zod schema 的推断型;本包用的是 agent-types 手写 `.d.ts`
- * 的同名镜像联合。两者都镜像 CC 的同一个 union,但**是两条独立的类型来源**。
- * 本函数返回值本来就走 `as unknown as SDKMessage`(见文件末),所以搬迁没有改变任何运行时字节;
- * ⚠️ 但**壳侧 shim 时要过一道 tsc**:`seamQueryEngine.ask` 那个消费点期望的是 zod 推断型,
- * 换成 agent-types 型后若不结构兼容,tsc 会在 shim 那一刻报——那是真信号,不要用 any 压掉。
- *
- * ⚠️ 设计稿 §8-5 把 print lane 的归属列为未决裁量点 —— 本文件是纯投影(tool_end arm → CC user 帧),
- * 任何端的「工具失败」判据都要它,故按 B1 清单搬入;`-p` 车道的**消费方**仍在壳侧。
- */
-/**
- * src/sema/printToolResultFrame.ts — headless `-p` 车道的 CC `user`/tool_result 帧合成
- * ([909]B1「工具错误置 is_error」半句勘察定案,2026-07-16)。
- *
- * 勘察结论(真行为实证,dist 自 spawn 引擎 + 失败 Bash 调用):`-p --output-format stream-json
- * --verbose` 的 stdout 里【零】tool_result 帧——既不是壳写死 is_error:false,也不是引擎帧失真:
- * 引擎 tool_end.isError 一路如实到壳(eventToSdkMessage.ts tool_end 臂 → 内部 tool_end_result arm),
- * 但 seamQueryEngine.ask 的消费循环把该 arm 整帧吞掉(此前 :506 `continue`,swallow 注释自证)。
- * TB「~4000 个 Bash 调用 is_error:true 零次」= 语料里只有 assistant/tool_use 帧,工具结果面整体缺席。
- *
- * CC 2.1.207 对表:`-p --verbose` 的 stream-json 在每个工具收尾后发
- *   {type:'user', message:{role:'user', content:[{type:'tool_result', tool_use_id, content,
- *    is_error}]}, parent_tool_use_id, uuid, session_id}
- * (SDKUserMessage 信封;交互 REPL 侧 upstreamBridge.ts:1323-1343 已按同款形状合成给渲染面)。
- * 本模块把内部 arm 投影成该形状,`-p` 集成面从此能从流里辨认工具失败(is_error 如实透传)。
- *
- * 车道纪律:只被 seamQueryEngine.ask(headless `-p`)消费;交互 REPL 走 upstreamBridge 的
- * deferred-close 管线,一根毛不动。
- */
 import type { SDKMessage } from '@sema-agent/agent-types';
-/**
- * Flatten the §E1 wire `output`(NON-UNIFORM: `string` | `(TextContent|ImageContent)[]`)into one
- * plain-text blob。🔴 UNTRUSTED / OBSERVABILITY-ONLY:只呈现,绝不回喂模型。
- *
- * ⇄ REF-CC-008 / dup-05 兑现(ADAPT-F1,2026-08-02):此处曾是 `flattenWireOutput` 的**逐字节副本**,
- * 豁免理由写着「避免把重量级 REPL 桥拖进 `-p` 车道的 import 图」。A 族拆分把该函数从 1607 行的
- * `adapt.ts` 搬进了 `adapt/wireShapes.ts`,而那个文件**唯一的 import 是 `import type {Frame}`**
- * (type-only,编译后整段消失)—— 正是台账要的那片「零 import 叶」,拆分创造了退役条件。
- * 副本随之删除,`flattenToolOutput` 收成对唯一实现的**具名再导出**(公面名不动:它在
- * public-export-baseline 里,改名会当场红)。
- */
 export { flattenWireOutput as flattenToolOutput } from './adapt/wireShapes.js';
-/** 内部 tool_end_result arm(`eventToSdkMessage.ts` 的 `case 'tool_end'` 臂铸造)的防御性读形。
- *  ⚠️ ADAPTER-F8 注纠(2026-08-02):原文锚的是裸行号 `213-231`,A 族拆分后那段是 `case 'text'` /
- *  `case 'reasoning'`,真正的 tool_end 臂已挪位。锚换成符号名(REF-CC-063 同款,腐烂不了)。 */
 export interface ToolEndResultArmLike {
     type?: unknown;
     toolCallId?: unknown;
     toolName?: unknown;
     isError?: unknown;
     output?: unknown;
-    /** 引擎 CC-shaped details(core 1.199+ AgentToolResult.details;Bash 时带 exitCode)。 */
     structured?: unknown;
     truncated?: unknown;
-    /**
-     * 这次调用失败的**机器码**(开集;`eventToSdkMessage` 的 `case 'tool_end'` 臂原样上臂,宿主从
-     * 臂上直读 —— 与 {@link gate}/{@link delivered} 同款「臂带、卡不带」姿势)。已知族:中断
-     * 合成收口两码(`interrupted_never_started` / `interrupted_outcome_unknown`,core 5.10.0)、
-     * 委派席位到限两码(`delegation.*`)与 `mcp.server_revoked`(两族 core ≥5.50.0 孪生拼法起才
-     * 真到达 —— 更旧引擎恒缺席,缺席≠没拒过)。词表与判定单源 `engineErrorCodes.ts`
-     * (`delegationCapDispositionOf` 等);宿主只渲已知码的指路文案,未知码原样报码**不编因**。
-     */
     errorCode?: unknown;
-    /**
-     * 这次调用**整条门记录**(0.60.0 / engine ≥7.64.0 / sdk 8.4.0)—— `eventToSdkMessage` 的
-     * `case 'tool_end'` 臂经包内单源窄读器 `gateOutcomeOf` 铸出后原样上臂,宿主据此把处置/结算归属
-     * 渲到工具卡与审计面。
-     *
-     * 它取代了退役的四个正交词 `settledBy` / `resolution` / `autoDenied` / `approver`
-     * (**四键全删,无 alias**);那四个词的配对规则只活在注释里,消费端要靠**缺席**推语义。现在是
-     * 一条记录:`disposition`(放行 / 被哪一**层**拒)+ `settlement?`(这次消费掉的等待怎么结束的)
-     * + `origin?`(谁问的),后两位**同在同缺**。
-     *
-     * 🔴 **判定归包,别在宿主自拼**:「这次是不是审批窗自己走完的拒绝」「是不是引擎的限额回落窗
-     *    自动拒的」两问各有一个包面谓词(`isApprovalWindowExpiredGate` / `isDenialLimitAutoDeniedGate`)
-     *    —— 旧形上这个判定是端各自拼的两键合取,而拼错的方式有好几种且错法静默。
-     * 🔴 **缺席不带语义,不许反推**:上游逐字列了四种在 wire 上不可分辨的成因(门没看见这次调用 /
-     *    延后重发 / reconcile 捡回的孤儿 / 记录过不了引擎的筛而 server 整条不投)⇒ 一律退回
-     *    `isError` + 文案。
-     *    ⚠️ **第五种成因有可读标记**(engine 7.64.0 真机黑盒 + server 认定为契约设计):审批窗走完
-     *    未决而走 **park** 路径时,本臂上没有 `gate`、只有 {@link errorCode} `"gate.parked"`。宿主判
-     *    「这次调用没在这里结算」必须**两形合读**(`isApprovalWindowExpiredGate` ∪
-     *    `isGateParkedToolEnd`);两形语义不同 —— 前者「窗走完拒了」,后者「park 了还没人决」。
-     * 🔴 **UNTRUSTED-for-display**:`settlement.who.approver`(通道自报的身份串)与 `settlement.note`
-     *    (拒批人自写)只渲染,绝不回喂模型/工具入参,更不许当鉴权判据 —— 转录不是认证。
-     * 🔴 本形是**防御性读形**(`unknown`):词表属主是引擎,消费方分支已知值 + 永远带 `default`。
-     */
     gate?: unknown;
-    /**
-     * 这次 **MCP** 失败**到没到那台服务器**(core ≥7.6.0 S6-B;`yes` / `no` / `unknown` + 开集读)。
-     *
-     * 🔴 与 {@link errorCode} **合读**才有意义:同一个 `connection_closed`,`no` 可以直接重试
-     *    (什么都没发出去)、`unknown` 必须先去查(请求**可能**已经执行了)——带写副作用的工具在
-     *    `unknown` 上必须先核实再重试。
-     * 🔴 **缺席不带语义**:每一次执行成功的调用、每一次非 MCP 失败都不带它。
-     * ⚠️ `no` 说的是**调用方的工具调用**没发出去,**不**保证「那台服务器一个字节都没收到」。
-     */
     delivered?: unknown;
-    /**
-     * 耐久 park 正扣着**哪一个** tool call 的 id(core ≥5.55.0 #333)。引擎从已提交 checkpoint 的
-     * pendingAction 直读(**禁由工具自报**)。tool-less park(resource_limit / plan_review / task_done)
-     * 上**整键缺席**,契约逐字 "ABSENT, never guessed" —— 缺席不铸键、也不猜。
-     */
     gatedCallId?: unknown;
     parentToolCallId?: unknown;
     uuid?: unknown;
     session_id?: unknown;
 }
-/**
- * tool_end_result arm → CC `user`/tool_result SDK 帧。toolCallId 缺失(防御:未来 wire 变形)
- * 返回 null,调用方维持原 swallow 行为(绝不发无法对账的孤儿 tool_result)。
- */
 export declare function toolEndResultToUserFrame(arm: ToolEndResultArmLike): SDKMessage | null;

package/dist/printToolResultFrame.js

@@ -1,35 +1,9 @@
-/**
- * Flatten the §E1 wire `output`(NON-UNIFORM: `string` | `(TextContent|ImageContent)[]`)into one
- * plain-text blob。🔴 UNTRUSTED / OBSERVABILITY-ONLY:只呈现,绝不回喂模型。
- *
- * ⇄ REF-CC-008 / dup-05 兑现(ADAPT-F1,2026-08-02):此处曾是 `flattenWireOutput` 的**逐字节副本**,
- * 豁免理由写着「避免把重量级 REPL 桥拖进 `-p` 车道的 import 图」。A 族拆分把该函数从 1607 行的
- * `adapt.ts` 搬进了 `adapt/wireShapes.ts`,而那个文件**唯一的 import 是 `import type {Frame}`**
- * (type-only,编译后整段消失)—— 正是台账要的那片「零 import 叶」,拆分创造了退役条件。
- * 副本随之删除,`flattenToolOutput` 收成对唯一实现的**具名再导出**(公面名不动:它在
- * public-export-baseline 里,改名会当场红)。
- */
 export { flattenWireOutput as flattenToolOutput } from './adapt/wireShapes.js';
 import { flattenWireOutput } from './adapt/wireShapes.js';
-/**
- * Bash 臂的 is_error 派生(真行为实证,2026-07-16):引擎 tool_end.isError 语义 = 「工具本身
- * 是否执行失败」——命令非零退出时工具照常返回模型面框架文本(core runShell `exit code: N\n---
- * stdout ---…`)且 isError:false。CC 2.1.207 的 Bash tool_result 对非零退出置 is_error:true;
- * 交互 REPL 桥按同款派生。
- *
- * 🔴 语序与 toolResult.ts T11 逐字同款([1948] E4 / core RB-257,2026-07-29):
- * **structured.exitCode 在场 ⇒ 权威直读;缺席 ⇒ 正则反解兜底**。此前只有正则——输出超
- * 30000 字符溢写成 persisted-output 引用后,前缀把 `exit code: N` 挤出行首,锚失配 ⇒
- * 非零退出照样 is_error:false(test AI 生产轨迹 2/2 命中);而 structured 字段在溢写时
- * **完好保留**,正是为这种形准备的。兜底失锚时如实 false,绝不按内容嗅探瞎猜
- * (与 core [1951] 同判断:拿前缀猜 isError = 用一个谎换另一个谎)。
- */
 function bashExitCodeFailed(toolName, text, structured) {
     if (typeof toolName !== 'string' || toolName.toLowerCase() !== 'bash')
         return false;
     const st = structured;
-    // 良性非零退出注记在场(grep/rg 无命中族)⇒ 非错——CC 同款:interpretation 形走 data
-    // 路径非 error 路径(pretty223:394251);与 toolResult.ts T11 同判别量(2026-08-27)。
     if (typeof st?.returnCodeInterpretation === 'string' && st.returnCodeInterpretation.length > 0)
         return false;
     const ec = st?.exitCode;
@@ -38,10 +12,6 @@ function bashExitCodeFailed(toolName, text, structured) {
     const m = /^exit code: (\d+)\b/.exec(text);
     return m !== null && m[1] !== '0';
 }
-/**
- * tool_end_result arm → CC `user`/tool_result SDK 帧。toolCallId 缺失(防御:未来 wire 变形)
- * 返回 null,调用方维持原 swallow 行为(绝不发无法对账的孤儿 tool_result)。
- */
 export function toolEndResultToUserFrame(arm) {
     if (typeof arm.toolCallId !== 'string' || arm.toolCallId.length === 0)
         return null;
@@ -54,15 +24,12 @@ export function toolEndResultToUserFrame(arm) {
                 {
                     type: 'tool_result',
                     tool_use_id: arm.toolCallId,
-                    // truncated 输出如实标注(观察面注记;截断体绝不回喂模型——upstreamBridge 同款)。
                     content: arm.truncated === true ? `${text}\n…(truncated)` : text,
                     is_error: arm.isError === true || bashExitCodeFailed(arm.toolName, text, arm.structured),
                 },
             ],
         },
         parent_tool_use_id: typeof arm.parentToolCallId === 'string' ? arm.parentToolCallId : null,
-        // eventToSdkMessage 已 stamp 的 uuid/session_id 原样骑帧(uuid = core-minted eventId 优先级
-        // 在 stamp 里已定);缺失时留 undefined,print 面容忍(CC 消费者按可选读)。
         uuid: arm.uuid,
         session_id: arm.session_id,
     };

package/dist/promptProfileWireCaps.d.ts

@@ -1,16 +1,3 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/promptProfileWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/promptProfileWireCaps.ts — PURE projection: the shell's prompt-profile pick → the
- * `TaskRequest.promptProfile` axis (core 1.328 [1144]: CC LT(model_id)-同构的呈现轴,
- * "simple"=CC 对 BYOM id 发的短形面(引擎缺省)/"classic"=长形面,按任务/模型可切)。
- *
- * Config source: env `SEMA_PROMPT_PROFILE`(A/B 与手选口;center 下发面走引擎侧 TaskSpec 直通,
- * 不经此位)。STRICT allowlist:仅 "simple"/"classic"(大小写不敏感,trim)stamp;其它/缺省 ⇒
- * `undefined`(不 stamp=引擎缺省 simple,请求形状不变——additive 纪律与 retainBackgroundWireCaps
- * 同款)。CALLER 前置 live 门(mock 形不变)。
- */
 import { type EnvLike } from './hostEnv.js';
 export type PromptProfile = 'simple' | 'classic';
 export declare function promptProfileFromEnv(env?: EnvLike): PromptProfile | undefined;

package/dist/promptProfileWireCaps.js

@@ -1,16 +1,3 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/promptProfileWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/promptProfileWireCaps.ts — PURE projection: the shell's prompt-profile pick → the
- * `TaskRequest.promptProfile` axis (core 1.328 [1144]: CC LT(model_id)-同构的呈现轴,
- * "simple"=CC 对 BYOM id 发的短形面(引擎缺省)/"classic"=长形面,按任务/模型可切)。
- *
- * Config source: env `SEMA_PROMPT_PROFILE`(A/B 与手选口;center 下发面走引擎侧 TaskSpec 直通,
- * 不经此位)。STRICT allowlist:仅 "simple"/"classic"(大小写不敏感,trim)stamp;其它/缺省 ⇒
- * `undefined`(不 stamp=引擎缺省 simple,请求形状不变——additive 纪律与 retainBackgroundWireCaps
- * 同款)。CALLER 前置 live 门(mock 形不变)。
- */
 import { hostEnv } from './hostEnv.js';
 const PROMPT_PROFILE_ENV = 'SEMA_PROMPT_PROFILE';
 export function promptProfileFromEnv(env = hostEnv()) {

package/dist/readFacePosture.d.ts

@@ -1,53 +1,10 @@
-/**
- * operator 面读数(sdk `ReadFacePosture` 的防御读视图;结构逐字同源,见文件尾编译期对账钉)。
- */
 export interface ReadFacePostureView {
-    /** 这台部署此刻的生效档。`null` = 没钉,引擎默认接管——与租户面同一份产物、同一句「没钉」。 */
     face: 'open' | 'roots' | null;
-    /** 这一档是谁定的。server 闭四词(`env` / `center` / `posture` / `engine-default`),**按开集读**
-     *  ——server 闭集之外的值原样透传,不窄读成枚举(那会在 server 加词当天把一个合法读数判没)。 */
     source: string;
-    /** 给运维的指路句。UNTRUSTED-for-display:呈前消毒 + 封长,见 {@link readFacePostureDetail}。 */
     note: string;
 }
-/**
- * `wiring.readFace` → 读数;**畸形一律 `undefined`**,绝不抛出。
- *
- * 🔴 整键缺席(老 worker,server <7.65.0)与在场但形坏,消费端拿到的都是同一个 `undefined` ——
- *    两者对端说的是同一句话(「这一面这一次答不出来」)。「为什么答不出来」不是这一位该回答的,
- *    是调用方自己知道的事(它有没有拿到 operator 响应;见 {@link readFacePostureDetail} 的
- *    `opts.reachable` 参数,那条信息只能由调用方——不是本读器——提供)。
- * ⚠️ `face` 只认三态字面量(闭集,坏词一律判畸形);`source` 非空串即收(开集,理由见上);`note`
- *    允许空串(它是自由文本,空文本本身也是一句读数,不是「读不出」)。
- */
 export declare function projectReadFacePosture(wiring: unknown): ReadFacePostureView | undefined;
-/**
- * 三态措辞的**唯一铸点**(三端共用一句话;别在各端的行装配里另写一遍——与
- * `writeProtectionDoctorDetail` / `sqlEngineDoctorDetail` 同一条纪律)。
- *
- * 🔴 三句刻意逐字互异(黑盒锚):
- *   ① `view` 在场 —— `read face <open|roots|not pinned> (source: <source> — <note>)`;
- *   ② `opts.reachable === false` —— 「未观测」:这次进程没读到 operator 响应,与「这台部署没有
- *      READ 档」是两件事,消费端不许把它读成后者;
- *   ③ `reachable:true` 但 `view` 仍缺席 —— 「不报」:响应读到了,只是这一位读不出来。
- *      🔴 **不武断咎为版本**:`projectReadFacePosture` 把「整键缺席(老引擎,<7.65.0)」与
- *      「在场但形坏(≥7.65.0 的引擎送出一个本读器解不出来的响应)」折成同一个 `undefined`
- *      (见该函数顶注),句子因此**不能**替其中一种情形撒谎——「需要更新引擎」对第二种情形是一句
- *      误导故障排查的假话。措辞同时点出两种成因,不擅自替调用方选一种。
- */
 export declare function readFacePostureDetail(view: ReadFacePostureView | undefined, opts: {
     reachable: boolean;
 }): string;
-/**
- * 租户面 `capabilities.readFace` 与本面 `posture.face` 分歧时的一句话;**只答分歧,不答一致**
- * ——一致不是新闻(两位的在场时点天然不同源,「相符」证不了什么也不该被渲成保证),本函数只在
- * 两者**确实不同**时才开口。
- *
- * 🔴 两个入参**任一**答不出来 ⇒ `undefined`(诚实缺席,不是「没有分歧」——见不到两位就判不了):
- *    `posture === undefined`(operator 面这一次读不到,见 {@link projectReadFacePosture})或
- *    `capFace` 既不是三态字面量也不是任意字符串(租户面那一位整键缺席时调用方会传 `undefined`,
- *    这里按同一条闸处理,不单独分支)。
- * 🔴 `capFace` 按**开集**读,与租户面型面同宽:除 `open`/`roots`/`null` 外的任意字符串仍当一个
- *    **能判别的词**收(不是「读不懂」),因为 sdk 的租户面型面本就留了同一个 `(string & {})` 逃生口。
- */
 export declare function readFaceDisagreement(capFace: unknown, posture: ReadFacePostureView | undefined): string | undefined;

package/dist/readFacePosture.js

@@ -1,19 +1,6 @@
 import { capForDisplay } from './fleetTaskDesc.js';
-/** `note` 上屏前的封长(UTF-16 单元,按**转义后**的字节数算——见 {@link capForDisplay})。它是
- *  一句人话不是一个词,给得比 source/face 宽。 */
 const READ_FACE_NOTE_MAX = 256;
-/** `source` / 分歧句里词形的封长(与本包其余 detail 铸点同值同理由;同样按转义后字节数算)。 */
 const READ_FACE_WORD_MAX = 40;
-/**
- * `wiring.readFace` → 读数;**畸形一律 `undefined`**,绝不抛出。
- *
- * 🔴 整键缺席(老 worker,server <7.65.0)与在场但形坏,消费端拿到的都是同一个 `undefined` ——
- *    两者对端说的是同一句话(「这一面这一次答不出来」)。「为什么答不出来」不是这一位该回答的,
- *    是调用方自己知道的事(它有没有拿到 operator 响应;见 {@link readFacePostureDetail} 的
- *    `opts.reachable` 参数,那条信息只能由调用方——不是本读器——提供)。
- * ⚠️ `face` 只认三态字面量(闭集,坏词一律判畸形);`source` 非空串即收(开集,理由见上);`note`
- *    允许空串(它是自由文本,空文本本身也是一句读数,不是「读不出」)。
- */
 export function projectReadFacePosture(wiring) {
     if (typeof wiring !== 'object' || wiring === null || Array.isArray(wiring))
         return undefined;
@@ -31,20 +18,6 @@ export function projectReadFacePosture(wiring) {
         return undefined;
     return { face: r.face, source: r.source, note: r.note };
 }
-/**
- * 三态措辞的**唯一铸点**(三端共用一句话;别在各端的行装配里另写一遍——与
- * `writeProtectionDoctorDetail` / `sqlEngineDoctorDetail` 同一条纪律)。
- *
- * 🔴 三句刻意逐字互异(黑盒锚):
- *   ① `view` 在场 —— `read face <open|roots|not pinned> (source: <source> — <note>)`;
- *   ② `opts.reachable === false` —— 「未观测」:这次进程没读到 operator 响应,与「这台部署没有
- *      READ 档」是两件事,消费端不许把它读成后者;
- *   ③ `reachable:true` 但 `view` 仍缺席 —— 「不报」:响应读到了,只是这一位读不出来。
- *      🔴 **不武断咎为版本**:`projectReadFacePosture` 把「整键缺席(老引擎,<7.65.0)」与
- *      「在场但形坏(≥7.65.0 的引擎送出一个本读器解不出来的响应)」折成同一个 `undefined`
- *      (见该函数顶注),句子因此**不能**替其中一种情形撒谎——「需要更新引擎」对第二种情形是一句
- *      误导故障排查的假话。措辞同时点出两种成因,不擅自替调用方选一种。
- */
 export function readFacePostureDetail(view, opts) {
     if (view !== undefined) {
         const faceWord = view.face === null ? 'not pinned' : view.face;
@@ -59,18 +32,6 @@ export function readFacePostureDetail(view, opts) {
     }
     return 'read face not reported by this engine (an engine below 7.65.0, or a response this end could not parse)';
 }
-/**
- * 租户面 `capabilities.readFace` 与本面 `posture.face` 分歧时的一句话;**只答分歧,不答一致**
- * ——一致不是新闻(两位的在场时点天然不同源,「相符」证不了什么也不该被渲成保证),本函数只在
- * 两者**确实不同**时才开口。
- *
- * 🔴 两个入参**任一**答不出来 ⇒ `undefined`(诚实缺席,不是「没有分歧」——见不到两位就判不了):
- *    `posture === undefined`(operator 面这一次读不到,见 {@link projectReadFacePosture})或
- *    `capFace` 既不是三态字面量也不是任意字符串(租户面那一位整键缺席时调用方会传 `undefined`,
- *    这里按同一条闸处理,不单独分支)。
- * 🔴 `capFace` 按**开集**读,与租户面型面同宽:除 `open`/`roots`/`null` 外的任意字符串仍当一个
- *    **能判别的词**收(不是「读不懂」),因为 sdk 的租户面型面本就留了同一个 `(string & {})` 逃生口。
- */
 export function readFaceDisagreement(capFace, posture) {
     if (posture === undefined)
         return undefined;
@@ -82,12 +43,5 @@ export function readFaceDisagreement(capFace, posture) {
     const wireWord = posture.face === null ? 'not pinned' : posture.face;
     return `capabilities says ${capWord}, wiring says ${wireWord}`;
 }
-/**
- * **编译期对账钉**(不出公面):sdk 的 `ReadFacePosture` 必须能赋给本视图 —— 这是本包 sdk 地板抬到
- * 8.5.0 的直接理由:<8.5.0 上这个名字根本不存在,`tsc` 报「没有导出成员」。
- *
- * 🔴 反向**刻意不钉**(本视图不必能赋给 sdk 形):`source` 在本视图上放宽成任意 `string`(开集读,
- * 见字段注),那是**故意比铸点宽**——窄读域只许等于或宽于铸点域,钉反向会把这条纪律反过来判成错。
- */
 const _readFacePostureShapePin = (w) => w;
 void _readFacePostureShapePin;

package/dist/request/printNotification.d.ts

@@ -1,33 +1,13 @@
-/** 帧身份位(壳侧从被投影的那条 SDK 消息上取,包内不铸号)。 */
 export interface PrintFrameIdentity {
     uuid?: unknown;
     session_id?: unknown;
 }
-/**
- * print 出口帧的**逐字段对照表** —— 与 `REQUEST_FIELD_MATRIX` 同一纪律:
- * `cc:true` = CC 自己命名过的位,**改名即偏离 parity**;`cc:false` = 本次收编补上的归因位
- * (wire 原名 = SDK `AgentEvent.task_notification` 词汇)。`from` 写明它从 wire 的哪一位来。
- */
 export interface PrintNotificationFieldSpec {
-    /** print 出口帧上的键名。 */
     field: string;
-    /** wire 侧来源键(`—` = 信封位/由归一层派生)。 */
     from: string;
-    /** CC 逐字位(改名即偏离 parity)。 */
     cc: boolean;
     why: string;
 }
 export declare const PRINT_NOTIFICATION_FIELD_MATRIX: readonly PrintNotificationFieldSpec[];
-/**
- * 引擎 `task_notification` 帧载荷 → CC `system/task_notification` 出口帧(print lane 唯一构造口)。
- *
- * 判定全部委托 `normalizeTaskNotification`(交互面同一把闸);缺席位一律**不铸空键**
- * (tolerate-absent —— 老引擎不发的字段不该在出口变成 `undefined` 值键)。
- * 返回 `null` = 该帧不该出口(task_id 空/缺)。
- */
 export declare function taskNotificationToPrintFrame(n: Record<string, unknown>, identity?: PrintFrameIdentity): Record<string, unknown> | null;
-/**
- * 出口帧里出现了**没进上表**的键就点名它(与 `unregisteredRequestKeys` 同纪律):
- * 顺手加一位很容易,加了之后「字段集合一」就又退化成一句注释 —— 加位必须先改表(带理由)。
- */
 export declare function unregisteredPrintNotificationKeys(frame: Record<string, unknown>): string[];

package/dist/request/printNotification.js

@@ -1,56 +1,15 @@
-/**
- * request/printNotification.ts — **`task_notification` 字段集合一**(B8,多端改造设计稿 §8-5 裁决
- * 第二件;§2.5 拆缝表 `seamQueryEngine.ts:690-708` 那一格)。
- *
- * ## 它解决的是什么
- *
- * 同一条引擎 `task_notification` 帧,壳里有**两个**消费者,各自决定「哪些字段算数」:
- *   · 交互 lane:`notifications.normalizeTaskNotification` → `renderTaskNotificationXml`
- *     (模型面 XML + 转录面),字段集 = `TaskNotificationFields` 15 位;
- *   · print lane(`-p` 的 SDK 出口):`seamQueryEngine.ask` 里**手写的一段对象字面量**,
- *     只挑了 6 位(task_id / tool_use_id / status / output_file / summary / usage)。
- *
- * 后果是**残局归因在 `-p` 出口整段丢失**:引擎明明发了 `stoppedBy`(谁停的)/`resumable`
- * (还能不能续)/`partial`(残果)/`exitCode` / `diagnostics` / `result` / `lines` /
- * `recentSteps` / `editedFiles`,交互面 XML 里逐条都在,而**唯一没有人类当场看着的那条车道**
- * ——集成/自动化用的 `-p --output-format stream-json`——拿不到任何归因位。
- * (设计稿 §7.3(b) 记的是 fleet `bg_notification` lane 的同款不对称;print 出口这一处是
- * B8 落码时逐行核出来的第二处,同族。)
- *
- * ## 合一的口径(逐字段留注 = `PRINT_NOTIFICATION_FIELD_MATRIX`)
- *
- * 🔴 **判据同源**:本模块**不重新判**任何一位 —— 先过交互面那把闸
- * `normalizeTaskNotification`(空 task_id 丢帧 = RB-75 同族;summary 缺省兜底句;status 非串
- * 回落 `completed`),再把归一结果映到 CC 的 print 帧信封上。两面从此只有**一份**判据。
- *
- * 🔴 **车道差异只剩一条**:`status` 的 `killed ⇒ stopped` 归一 —— 那是 CC 自己 print/SDK 出口的
- * 形(FULL-SOURCE-187 line ~32320),XML 面按引擎原词渲染。这一条差异是**有理由的**,写在表里。
- *
- * **命名口径**:CC 已经命名过的 6 位保持 CC 逐字(`task_id` / `tool_use_id` / `output_file` /
- * `status` / `summary` / `usage`);新增的归因位用 **wire 原名**(`stoppedBy` / `resumable` / …)
- * —— 也就是 SDK `AgentEvent.task_notification` 的词汇表,`-p` 的 SDK 消费方与直连 SDK 的消费方
- * 因此看到同一套键名,不必再学第三套。additive:老消费方按 key 取值,多出来的键不碍事。
- *
- * ## 留壳的部分(§8-5 明写)
- *
- * `PrintStreamProjector`(stream-json 帧序/SSE 重铸)与全部 stderr 分诊文案**留壳**:那是
- * 渲染面与人话面,不是数据面。本模块只做「wire 帧 → CC 帧」这一跳。
- */
 import { normalizeTaskNotification } from '../notifications.js';
 export const PRINT_NOTIFICATION_FIELD_MATRIX = [
-    // ── 信封(CC system 帧形)────────────────────────────────────────────────────────────────────
     { field: 'type', from: '—', cc: true, why: "CC system 帧信封:{type:'system'}" },
     { field: 'subtype', from: '—', cc: true, why: "CC 完成通知的 subtype:'task_notification'(187 print/SDK 出口形)" },
     { field: 'uuid', from: '—', cc: true, why: '帧身份:壳侧从被投影的 SDK 消息取(包内不铸号)' },
     { field: 'session_id', from: '—', cc: true, why: 'CC 每帧带会话 id;壳侧透传' },
-    // ── CC 已命名的 6 位(逐字,改名即偏离 parity)──────────────────────────────────────────────
     { field: 'task_id', from: 'task_id', cc: true, why: 'CC 逐字 snake 名;空/缺 ⇒ 整帧丢弃(RB-75:空 id 会塌成共享桶互吞)' },
     { field: 'status', from: 'status', cc: true, why: "CC 逐字;**唯一车道差异** killed ⇒ stopped(187 print 出口形;XML 面按引擎原词渲染)" },
     { field: 'summary', from: 'summary', cc: true, why: '缺省走交互面同一句兜底(`Background task "<id>" <status>`)—— 修前 print 出口发空串' },
     { field: 'tool_use_id', from: 'toolUseId', cc: true, why: 'CC 逐字 snake 名(wire 是 camel);把通知钉回发起它的那次工具调用' },
     { field: 'output_file', from: 'output_file', cc: true, why: 'CC 逐字;后台输出落盘路径' },
     { field: 'usage', from: 'usage', cc: true, why: 'CC 逐字 optional;计量面(交互面 XML 反而不读它 —— 那是渲染面口径)' },
-    // ── B8 补上的残局归因位(wire 原名 = SDK task_notification 词汇)────────────────────────────
     { field: 'stoppedBy', from: 'stoppedBy', cc: false, why: '🔴 残局归因核心位:谁停的(用户/上限/引擎)。修前 `-p` 出口零携带' },
     { field: 'resumable', from: 'resumable', cc: false, why: '🔴 残局归因:还能不能 resume —— 自动化要靠它决定重试还是放弃' },
     { field: 'partial', from: 'partial', cc: false, why: 'server 1.258:被终止子代的残果(消费方须渲成不完整,不得当完整结果)' },
@@ -66,13 +25,6 @@ export const PRINT_NOTIFICATION_FIELD_MATRIX = [
     { field: 'injected', from: 'injected', cc: false, why: '[1818]§四:本帧**不**证明 XML 已进模型上下文;消费方须按此位判,不得按帧到达判' },
 ];
 const PRINT_FRAME_KEYS = new Set(PRINT_NOTIFICATION_FIELD_MATRIX.map(r => r.field));
-/**
- * 引擎 `task_notification` 帧载荷 → CC `system/task_notification` 出口帧(print lane 唯一构造口)。
- *
- * 判定全部委托 `normalizeTaskNotification`(交互面同一把闸);缺席位一律**不铸空键**
- * (tolerate-absent —— 老引擎不发的字段不该在出口变成 `undefined` 值键)。
- * 返回 `null` = 该帧不该出口(task_id 空/缺)。
- */
 export function taskNotificationToPrintFrame(n, identity = {}) {
     const f = normalizeTaskNotification(n);
     if (f === null)
@@ -82,13 +34,11 @@ export function taskNotificationToPrintFrame(n, identity = {}) {
         type: 'system',
         subtype: 'task_notification',
         task_id: f.taskId,
-        // CC 逐字:killed ⇒ stopped(唯一车道差异,表里有理由)。
         status: f.status === 'killed' ? 'stopped' : f.status,
         summary: f.summary,
         ...(f.toolUseId !== undefined ? { tool_use_id: f.toolUseId } : {}),
         ...(f.outputFile !== undefined ? { output_file: f.outputFile } : {}),
         ...(n.usage !== undefined ? { usage: n.usage } : {}),
-        // ── 残局归因(B8 补;归一层已做过类型与空值判定)──────────────────────────────────────
         ...(f.stoppedBy !== undefined ? { stoppedBy: f.stoppedBy } : {}),
         ...(f.resumable !== undefined ? { resumable: f.resumable } : {}),
         ...(f.partial !== undefined ? { partial: f.partial } : {}),
@@ -96,7 +46,6 @@ export function taskNotificationToPrintFrame(n, identity = {}) {
         ...(f.diagnostics !== undefined ? { diagnostics: f.diagnostics } : {}),
         ...(f.result !== undefined ? { result: f.result } : {}),
         ...(f.lines !== undefined ? { lines: f.lines } : {}),
-        // 结构化两位取**裸 wire**(归一层把 recentSteps 折成了交互面的显示串,那是渲染口径)。
         ...structured('recentSteps'),
         ...structured('editedFiles'),
         ...(f.taskType !== undefined ? { task_type: f.taskType } : {}),
@@ -107,10 +56,6 @@ export function taskNotificationToPrintFrame(n, identity = {}) {
         ...(identity.session_id !== undefined ? { session_id: identity.session_id } : {}),
     };
 }
-/**
- * 出口帧里出现了**没进上表**的键就点名它(与 `unregisteredRequestKeys` 同纪律):
- * 顺手加一位很容易,加了之后「字段集合一」就又退化成一句注释 —— 加位必须先改表(带理由)。
- */
 export function unregisteredPrintNotificationKeys(frame) {
     return Object.keys(frame).filter(k => !PRINT_FRAME_KEYS.has(k));
 }