@sema-agent/client-core 0.8.1 → 0.10.0

package/dist/index.js

@@ -5,6 +5,35 @@
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
  * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.10.0 = **B8 批**(搬迁总线**末批**,设计稿 §8-5「print lane 收编」):
+ *   ① **请求拼装合一收官**:B4 建的 `buildTaskRequest(input, lane)` 从此是 print lane
+ *      (`seamQueryEngine.ask`)的**唯一**构造口 —— 壳里那份「`-p` 自己另拼一份」的字面量废除;
+ *      车道差异全在 `REQUEST_FIELD_MATRIX`(print 独有 finalVerification/limits/interactiveTools、
+ *      TUI 独有 ultracode 等,逐条带理由与 `gap` 判断)。新增可执行判据 `unregisteredRequestKeys`
+ *      —— **真上 wire 的那份**请求也要过表,再漏一个键就当场红(表以前只管得住构造器自己)。
+ *   ② **`task_notification` 字段集合一**(`request/printNotification.ts`):print 出口帧与交互面
+ *      共用 `normalizeTaskNotification` 这**一把闸**(空 task_id 丢帧 / summary 兜底 / status 回落),
+ *      并补上**残局归因**(stoppedBy / resumable / partial / exitCode / diagnostics / result /
+ *      lines / recentSteps / editedFiles / task_type / source / seq / injected)—— 修前这些位在
+ *      `-p` 出口整段丢失,而 `-p` 恰恰是唯一没有人当场看着的车道。🔴 车道差异只剩 `status` 的
+ *      killed⇒stopped 一条(CC 187 print 出口形,表里留注);去重键不出第二个名字,print 侧那份
+ *      手写算法废除,直接用 `taskNotificationDedupKeyFromWire`。
+ *   ③ **留壳**(§8-5 明写,本批一行没动):`PrintStreamProjector`(stream-json 帧序/SSE 重铸)与
+ *      全部 stderr 分诊文案 —— 渲染面与人话面属端。
+ * 0.9.0 = **B7 批**(设计稿 §3 B7「完成事件单一权威 + HITL」):
+ *   ① **HITL 族四件**(新目录 `hitl/`):`hitlBridge`(整搬,🔴 **D-1 两元组 verbatim 回显**
+ *      与「409 绝不自动重试」两段**逐字节**搬,pure 门 B7 段用冻结字面量 + 壳树双向对拍 +
+ *      毒化行为口径三重钉)· `toolApprovalWire`(**拆**:判定/编排进包,三选卡本体经
+ *      `ApprovalCardPort` 留端)· `askGateWire`(整搬;footer 通知与 Recent Denials 记账经
+ *      `HitlHostSurface` 留端)· `planReviewWire`(整搬,**第七份 `wireConfig()` 收编闭合**)。
+ *   ② **完成事件族 T2/T3**:`taskNotificationDedupKeyFromWire`(裸 wire 载荷键形)+
+ *      `parseTranscriptNotificationSeeds` / `seedTaskNotificationDedupFromTranscript`
+ *      (#63 resume 回植的 XML 反解)搬入 `notifications.ts`。**P1-3 未到货 ⇒ 只搬不删**,
+ *      四道去重原样;退役条件登记进 `compensations.ts`(T1/T2/T3/T25/T53 五条)。
+ *   ③ **`approvals.stream()` 换轮询**(census G20):`hitl/approvalsFeed.ts` —— SDK 原生推送优先、
+ *      断流/无端点**回落轮询**的韧性臂保留;两条腿都收敛到「非 heartbeat 事件 ⇒ 重取权威
+ *      `list()`」(SDK 自述 payload 是 FORWARD-DRAFT,绝不信未确认的 delta 形)。
+ *   🆕 队列口新增**可选**动词 `enqueueMetaPrompt`(plan_review 结局回植;既有宿主不破)。
  * 0.8.0 = **B6 批**(设计稿 §3 B6,分两轮落):
  *   ——【前半,fleet/子代身份族】fleetClient 沿 §2.5 拆两半(帧体归库、连接归端):
  *   `fleet/fleetProjection` + `fleet/fleetLedger` · 子代 wire 族六件(`subagent/*`)·
@@ -80,6 +109,12 @@
  *     · liveInitToolFace.ts(`cached`)—— 两份只是多探一次 `/v1/capabilities/scenarios/:name`,
  *       **不是**静默失效;仍登记,免得下次读表的人以为它没状态。
  *     · model/providerPresets.ts(`presetIndexCache`)—— 由不可变 JSON 派生的纯 memo,两份只费内存。
+ *   —— B7 新增(两条都是**装在一份、读另一份 = 面直接不工作**,比台账分裂更响):
+ *     · **hitl/toolApprovalWire.ts**(`cardPort` + `cardPortMisses`)—— 写方 = 宿主启动装配
+ *       `installApprovalCardPort()`,读方 = 两条决断腿。两份 ⇒ `hasApprovalCardPort()` 恒 false ⇒
+ *       **每一张写权限 gate 都走 fail-closed deny(卡根本不弹)**,而宿主那边"我装了啊"。
+ *     · **hitl/askGateWire.ts**(`hostSurface` + `hostSurfaceMisses`)—— 写方 = 宿主装配,
+ *       读方 = cancel-deny warn 与分类器 deny 记账。两份 ⇒ 那一行 warn 与 Recent Denials 全丢。
  * 🔴 **宿主装配**——B4 起总入口是 `installHost({log,probe,queue,timers,settings,fs,session})`
  *   (`installNotificationQueuePort()` 仍是队列的真源出口,`installHost({queue})` 直通它,两者不分裂);
  *   自检口 `hostPortMisses()` 恒应为空对象,非空 = 有口漏装、对应的面已在静默失效。
@@ -217,7 +252,30 @@ export * from './liveInitToolFace.js';
 //    来源。表不在包里,那条中央规则在 web/桌面上恒拿不到 cap ⇒ 对 deepseek-chat(8192)这类模型
 //    超发 ⇒ 网关 400。搬迁期与壳树两份 JSON 由 pure 门的 byte-identity 断言锁住。
 export * from './model/providerPresets.js';
+// ── B7 批:HITL 族(2026-07-27,设计稿 §3 B7)────────────────────────────────────────────────
+// 🔴 `hitl/hitlBridge.ts` 里的 **D-1 两元组 verbatim 回显**是安全不变量(`bindingOf` 绝不重算
+//    hash;409 ⇒ `HitlSafetyError('binding_mismatch')` 绝不自动重试)—— pure 门 B7 段做**字节级**
+//    断言,改一个字符就红。
+// 🔴 两个新拆缝口(缺席都计 miss,宿主自检恒应为 0):
+//    · `installApprovalCardPort` —— 三选卡本体(vendored CC `PermissionRequest` / 桌面模态);
+//    · `installHitlHostSurface` —— footer 通知与 /permissions Recent Denials 记账(端状态形状)。
+// 🔴 单实例:`toolApprovalWire` 的卡口槽 + `askGateWire` 的宿主面槽是 module 级变量;两份实例 ⇒
+//    装在一份、读另一份 = 每张 gate 都走 fail-closed deny(卡根本不弹)。
+export * from './hitl/hitlBridge.js';
+export * from './hitl/toolApprovalWire.js';
+export * from './hitl/askGateWire.js';
+export * from './hitl/planReviewWire.js';
+// B7 ③(census G20,**行为改动**不是搬迁):pending-approvals 推送 feed(stream 优先 / 断流回落
+// 轮询 / 定期再试)。🔴 它**不替换** D-1 的取件 —— 那三处必须继续走权威 `list()`(见文件头)。
+export * from './hitl/approvalsFeed.js';
 // ── B6 余项③(P5):补偿层登记表 —— 把「哪条补偿拆了、拆缝对面是谁、什么时候能退休」做成数据。
 // 🔴 它**不是** `ADAPTER_DIVERGENCES`(那张表说的是 adapt 与 cli 行为不同的地方;本表里的东西
 //    两侧行为相同)。自检口 `compensationSplitViolations()` 恒应为空。
 export * from './compensations.js';
+// ── B8 批:print lane 收编(2026-07-27,设计稿 §8-5 裁决 —— 总线末批)──────────────────────────
+// `task_notification` 字段集合一:`-p` 的 SDK 出口帧从 6 位手写字面量换成与交互面**同一把闸**
+// (normalizeTaskNotification)+ 一张逐字段对照表;残局归因(stoppedBy/resumable/partial/
+// exitCode/…)从此不在 print 出口丢失。🔴 车道差异只剩 `status` 的 killed⇒stopped 一条(表里留注)。
+// 去重键**不出第二个名字**:print 侧那份手写算法废除,直接用 `taskNotificationDedupKeyFromWire`。
+// 请求面同批补上可执行判据 `unregisteredRequestKeys`(见 request/taskRequest.ts 文件末)。
+export * from './request/printNotification.js';

package/dist/notifications.d.ts

@@ -49,6 +49,46 @@ export declare function taskNotificationDedupKey(n: {
     seq?: number | string;
     taskType?: string;
 }): string;
+/**
+ * ⇄ B7(T2):同一把键的 **裸 wire 载荷** 入口 —— cli `upstreamBridge.engineTaskNotificationDedupKey`
+ * 的等价物(入参是引擎 `task_notification` 帧的原始 payload:snake_case `task_id` / `task_type`)。
+ *
+ * 🔴 **不是第二份算法**:字段归一之后直接委托给上面那一个 `taskNotificationDedupKey`。
+ * 两份手写算法正是这条键在 0.1.1 被 codex 对抗复审抓到过的形(无 seq 追不追段的差异会让
+ * 「重放去重」整条失效而两边代码看着都对);pure 门 B7 段对两个入口做**同键对拍**。
+ *
+ * 键形:`[external:]taskId:status[:seq]`。缺 `task_id` ⇒ 空 taskId 段(与 cli 逐字一致 ——
+ * 空 id 的通知本就在 `normalizeTaskNotification` 那一层被丢弃,这里不额外加语义)。
+ *
+ * ⚠️ **P1-3(完成事件单一权威)未到货 ⇒ 只搬不删**:引擎给出 `completionId` 之后,这把
+ * 「客户端按 taskId:status[:seq] 自己重算」的键才能换成「读引擎发的 id」。退役条件见
+ * `compensations.ts` 的 T2 行。
+ */
+export declare function taskNotificationDedupKeyFromWire(n: Record<string, unknown>): string;
+/**
+ * ⇄ B7(T3):从**落盘转录**里的 `<task-notification>` 块反解去重键 —— #63 resume 回植的
+ * **纯解析半场**(适配器实例的 `importLedgerFromTranscript` 与宿主的 resume 装载腿共用这一份)。
+ *
+ * 为什么要单独导出:cli 里这段解析有**两份**(`upstreamBridge.seedEngineTaskNotificationDedupFromTranscript`
+ * 与包内 `WireToCcAdapterImpl.importLedgerFromTranscript`),两份的差异会让 resume 回植在某一侧
+ * 静默失效。B7 把解析收成一份纯函数,两个消费口都调它;壳侧那份 shim 化后直接调
+ * `bridgeAdapter().importLedgerFromTranscript(...)`。
+ *
+ * 🔴 键形必须是**无 seq** 的:落盘 XML 不带 seq,Monitor 的 `:seq` 批键形与之不同 —— 这正是
+ * 「绝不误伤 Monitor 多批流」的判据(cli `taskNotificationResumeSeed` 单测双向钉的就是它)。
+ *
+ * ⚠️ **P1-3 到货后**:仍需回植(crash 窗口是客观存在的),但不必再解 XML —— 转录里会直接带
+ * `completionId`。退役条件见 `compensations.ts` 的 T3 行。
+ */
+export interface TranscriptNotificationSeeds {
+    /** 渲染去重键(`[external:]taskId:status`,**无 seq 段**)。 */
+    renderedKeys: string[];
+    /** 跨通道记账键(裸 taskId;仅**非 external** 的终态 completed/failed/killed)。 */
+    notifiedKeys: string[];
+    /** 解出的块数(= cli `seeded` 返回值)。 */
+    seeded: number;
+}
+export declare function parseTranscriptNotificationSeeds(messages: ReadonlyArray<unknown>): TranscriptNotificationSeeds;
 /** 宿主队列条目的最小结构形(壳 QueuedCommand 的子集;本包只读这三个键)。 */
 export interface QueuedCommandLike {
     mode?: unknown;
@@ -63,6 +103,23 @@ export interface NotificationQueuePort {
     }): void;
     /** 壳 = messageQueueManager.removeByFilter;返回被摘掉的条目(数量是判据)。 */
     removeByFilter(predicate: (cmd: QueuedCommandLike) => boolean): QueuedCommandLike[];
+    /**
+     * B7:`mode:'prompt'` 的 **isMeta** 回植(今天唯一的消费者 = plan_review 结局,
+     * `hitl/planReviewWire.ts`)。与上面那条是**不同的队列语义**(task-notification 走
+     * `<task-notification>` 通道;这条是一个 isMeta 的 prompt turn),所以是第二个动词而不是
+     * 给第一个加参数。
+     *
+     * 🔴 **可选**(`?`):既有宿主(壳 B2 起装的那份)不实现它照样满足接口 —— 加必填方法会让所有
+     * 已装配的宿主在类型层一起红,而这条动词只有一个消费者。缺席 ⇒ 计 miss + 该结局不回植
+     * (模型在 approve 之后原地不动),**不是**静默可接受的面,所以计 miss 而不是静默。
+     */
+    enqueueMetaPrompt?(command: {
+        value: string;
+        mode: 'prompt';
+        priority: 'later';
+        isMeta: true;
+        workload: string;
+    }): void;
 }
 /** 宿主装配:壳侧 shim / web 宿主在**模块加载期**装(装之前的调用会计入 miss)。 */
 export declare function installNotificationQueuePort(port: NotificationQueuePort | null): void;
@@ -81,6 +138,16 @@ export declare function _resetNotificationQueuePortForTest(): void;
  * (enqueue 两族与 bridge 渲染同用 escapeXml,键形字节对齐)。仅主线程 task-notification
  * 条目(agentId undefined);用户输入/其他模式绝不触碰。
  */
+/**
+ * B7:plan_review 结局回植(`hitl/planReviewWire.ts` 的唯一调用点)。走队列口的
+ * `enqueueMetaPrompt` 可选动词 —— 口或动词缺席 ⇒ 计 miss(与 `port()` 同一个计数器,宿主
+ * 只看 `hostPortMisses()` 一个数)并**返回 false**,调用方 fail-soft。
+ *
+ * 🔴 为什么不复用 `enqueuePendingNotification`:那条走的是 `<task-notification>` 通道(队列
+ * 的 `task-notification` 模式,drain 时按通知语义处理);plan_review 结局是一个 **isMeta 的
+ * prompt turn**。混用 = 结局被当成后台任务完成通知渲染,是「看起来送到了」的假绑定。
+ */
+export declare function enqueuePlanReviewOutcome(value: string): boolean;
 export declare function dropQueuedNotificationsForRun(taskId: string): number;
 /**
  * Pre-seed the runId dedup WITHOUT enqueueing — the completion already reached the model in-band

package/dist/notifications.js

@@ -99,6 +99,80 @@ export function taskNotificationDedupKey(n) {
     const lane = n.taskType === 'external' ? 'external:' : '';
     return `${lane}${n.taskId}:${n.status}${seq ? `:${seq}` : ''}`;
 }
+/**
+ * ⇄ B7(T2):同一把键的 **裸 wire 载荷** 入口 —— cli `upstreamBridge.engineTaskNotificationDedupKey`
+ * 的等价物(入参是引擎 `task_notification` 帧的原始 payload:snake_case `task_id` / `task_type`)。
+ *
+ * 🔴 **不是第二份算法**:字段归一之后直接委托给上面那一个 `taskNotificationDedupKey`。
+ * 两份手写算法正是这条键在 0.1.1 被 codex 对抗复审抓到过的形(无 seq 追不追段的差异会让
+ * 「重放去重」整条失效而两边代码看着都对);pure 门 B7 段对两个入口做**同键对拍**。
+ *
+ * 键形:`[external:]taskId:status[:seq]`。缺 `task_id` ⇒ 空 taskId 段(与 cli 逐字一致 ——
+ * 空 id 的通知本就在 `normalizeTaskNotification` 那一层被丢弃,这里不额外加语义)。
+ *
+ * ⚠️ **P1-3(完成事件单一权威)未到货 ⇒ 只搬不删**:引擎给出 `completionId` 之后,这把
+ * 「客户端按 taskId:status[:seq] 自己重算」的键才能换成「读引擎发的 id」。退役条件见
+ * `compensations.ts` 的 T2 行。
+ */
+export function taskNotificationDedupKeyFromWire(n) {
+    return taskNotificationDedupKey({
+        taskId: typeof n.task_id === 'string' ? n.task_id : '',
+        status: typeof n.status === 'string' ? n.status : 'completed',
+        ...(typeof n.seq === 'number' || typeof n.seq === 'string' ? { seq: n.seq } : {}),
+        ...(typeof n.task_type === 'string' ? { taskType: n.task_type } : {}),
+    });
+}
+export function parseTranscriptNotificationSeeds(messages) {
+    const unescape = (s) => s
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&amp;/g, '&');
+    const renderedKeys = [];
+    const notifiedKeys = [];
+    let seeded = 0;
+    for (const m of messages) {
+        const rec = m;
+        if (rec?.type !== 'user')
+            continue;
+        const content = rec.message?.content;
+        const texts = [];
+        if (typeof content === 'string')
+            texts.push(content);
+        else if (Array.isArray(content)) {
+            for (const b of content) {
+                const bb = b;
+                if (bb?.type === 'text' && typeof bb.text === 'string')
+                    texts.push(bb.text);
+            }
+        }
+        for (const text of texts) {
+            if (!text.includes(`<${TASK_NOTIFICATION_TAG}`))
+                continue;
+            const blockRe = new RegExp(`<${TASK_NOTIFICATION_TAG}(\\s[^>]*)?>([\\s\\S]*?)</${TASK_NOTIFICATION_TAG}>`, 'g');
+            for (const bm of text.matchAll(blockRe)) {
+                const attrs = bm[1] ?? '';
+                const body = bm[2] ?? '';
+                const idM = body.match(new RegExp(`<${TASK_ID_TAG}>([\\s\\S]*?)</${TASK_ID_TAG}>`));
+                const stM = body.match(new RegExp(`<${STATUS_TAG}>([\\s\\S]*?)</${STATUS_TAG}>`));
+                if (!idM || !stM)
+                    continue;
+                const taskId = unescape(idM[1] ?? '');
+                const status = unescape(stM[1] ?? '');
+                if (taskId.length === 0 || status.length === 0)
+                    continue;
+                const external = /\btype="external"/.test(attrs);
+                renderedKeys.push(`${external ? 'external:' : ''}${taskId}:${status}`);
+                if (!external && (status === 'completed' || status === 'failed' || status === 'killed')) {
+                    notifiedKeys.push(taskId);
+                }
+                seeded++;
+            }
+        }
+    }
+    return { renderedKeys, notifiedKeys, seeded };
+}
 // ══════════════════════════════════════════════════════════════════════════════════════════════
 // ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2「通知族合并」):cli 三个文件并入本模块
 //   ① src/sema/engineTaskNotification.ts(347 行,台账 + watcher + 入队合成)
@@ -180,6 +254,26 @@ const notifiedRunIds = new Set();
  * (enqueue 两族与 bridge 渲染同用 escapeXml,键形字节对齐)。仅主线程 task-notification
  * 条目(agentId undefined);用户输入/其他模式绝不触碰。
  */
+/**
+ * B7:plan_review 结局回植(`hitl/planReviewWire.ts` 的唯一调用点)。走队列口的
+ * `enqueueMetaPrompt` 可选动词 —— 口或动词缺席 ⇒ 计 miss(与 `port()` 同一个计数器,宿主
+ * 只看 `hostPortMisses()` 一个数)并**返回 false**,调用方 fail-soft。
+ *
+ * 🔴 为什么不复用 `enqueuePendingNotification`:那条走的是 `<task-notification>` 通道(队列
+ * 的 `task-notification` 模式,drain 时按通知语义处理);plan_review 结局是一个 **isMeta 的
+ * prompt turn**。混用 = 结局被当成后台任务完成通知渲染,是「看起来送到了」的假绑定。
+ */
+export function enqueuePlanReviewOutcome(value) {
+    const p = port();
+    if (!p)
+        return false;
+    if (typeof p.enqueueMetaPrompt !== 'function') {
+        queuePortMisses++;
+        return false;
+    }
+    p.enqueueMetaPrompt({ value, mode: 'prompt', priority: 'later', isMeta: true, workload: 'plan-review' });
+    return true;
+}
 export function dropQueuedNotificationsForRun(taskId) {
     const needle = `<${TASK_ID_TAG}>${escapeXml(taskId)}</${TASK_ID_TAG}>`;
     const p = port();

package/dist/request/printNotification.d.ts

@@ -0,0 +1,33 @@
+/** 帧身份位(壳侧从被投影的那条 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

@@ -0,0 +1,116 @@
+/**
+ * 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:被终止子代的残果(消费方须渲成不完整,不得当完整结果)' },
+    { field: 'exitCode', from: 'exitCode', cc: false, why: '后台 bash 退出码(137=OOM 这类归因只在这一位上)' },
+    { field: 'diagnostics', from: 'diagnostics', cc: false, why: '引擎侧诊断串(UNTRUSTED,service 已 redact)' },
+    { field: 'result', from: 'result', cc: false, why: '完成结果正文(#49 C1:帧带 result 必入 XML,print 出口同理不得独漏)' },
+    { field: 'lines', from: 'lines', cc: false, why: '尾部输出行(UNTRUSTED);交互面折进 <output-lines>' },
+    { field: 'recentSteps', from: 'recentSteps', cc: false, why: '结构化残局步骤 {tool,target,outcome}[] —— **原样透传**,不降级成交互面那份显示串(SDK 消费方要结构)' },
+    { field: 'editedFiles', from: 'editedFiles', cc: false, why: '结构化改档清单 {path,edits}[];同上原样透传' },
+    { field: 'task_type', from: 'task_type', cc: false, why: 'lane 位(external/background_agent/…)—— 去重键的分域依据,消费方要能自己算同一把键' },
+    { field: 'source', from: 'source', cc: false, why: 'external lane 的来源标识(交互面渲成开标签 from= 属性)' },
+    { field: 'seq', from: 'seq', cc: false, why: '停机周期/批次计数([508]②)—— 与 task_id+status 一起构成去重键' },
+    { 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)
+        return null;
+    const structured = (key) => Array.isArray(n[key]) && n[key].length > 0 ? { [key]: n[key] } : {};
+    return {
+        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 } : {}),
+        ...(f.exitCode !== undefined ? { exitCode: f.exitCode } : {}),
+        ...(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 } : {}),
+        ...(f.externalSource !== undefined ? { source: f.externalSource } : {}),
+        ...(typeof n.seq === 'number' || typeof n.seq === 'string' ? { seq: n.seq } : {}),
+        ...(typeof n.injected === 'boolean' ? { injected: n.injected } : {}),
+        ...(identity.uuid !== undefined ? { uuid: identity.uuid } : {}),
+        ...(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));
+}

package/dist/request/taskRequest.d.ts

@@ -133,3 +133,20 @@ export interface LiveDefaultsInput {
 export declare function applyLiveRequestDefaults(req: TaskRequestLike, host: LiveDefaultsInput): TaskRequestLike;
 /** 出口约束:构造结果确实是一个 `TaskRequest`(型只在这里碰 SDK,运行时零依赖)。 */
 export type BuiltTaskRequest = TaskRequest;
+/**
+ * ⇄ B8(§8-5 请求拼装合一的**可执行判据**)—— 一份请求体里出现了**没进车道表**的键就点名它。
+ *
+ * 为什么要有:B4 把字段集做成了 `REQUEST_FIELD_MATRIX` 这张表,但表当时只管住了
+ * `buildTaskRequest` 自己;端上真正上 wire 的那份请求仍可以在构造器之外多塞一个键(print lane
+ * 修前正是「自己另拼一份」),于是「表说了算」就退化成一句注释。本函数让**真上 wire 的那份**
+ * 也过一遍表:print lane 收编之后,`-p` 的请求体逐键都能报出登记出处,再漏就当场红。
+ *
+ * 判据口径(三类不点名):
+ *   ① 车道表里的字段(`lanes` 含本车道);② `LIVE_DEFAULT_FIELDS` —— live 兜底层追加、两条车道
+ *   都经过,故本就不进车道表;③ `settings` 的子键按表认(`settings.<sub>`),但**交互车道**的
+ *   `settings.<resolved>` 是 resolver 的 effective 快照 = **开放集**,子键不可枚举 ⇒ 整体放行。
+ *
+ * 🔴 它**不判**「该不该有」——只判「有没有登记」。补齐一条真实差异要改表(带理由),
+ * 而不是绕过本函数:改表这个动作本身就会在 diff 里显形,这正是本判据存在的意义。
+ */
+export declare function unregisteredRequestKeys(req: TaskRequestLike, lane: RequestLane): string[];

package/dist/request/taskRequest.js

@@ -17,7 +17,10 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'promptProfile', lanes: ['interactive', 'print'], live: true, why: 'core 1.328 呈现轴 A/B 口,缺省不 stamp = 引擎缺省 simple' },
     { field: 'enableFork', lanes: ['interactive', 'print'], live: true, why: '显式布尔才 stamp([503]② fail-OPEN 教训:off 必须显式)' },
     { field: 'attachments', lanes: ['interactive', 'print'], live: true, why: 'design/133 + G1 缺省开的 turn 边界 attachment' },
-    { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地 .claude/skills 投影;两条车道都由 launchRepl 载入面注入' },
+    // ⚠️ 这条 why 原文写的是本地技能目录的**字面路径**,B8 把本模块拉进壳的生产闭包之后,那串
+    //    字面量随 bundle 进了 `dist/sema.js` 并被壳的品牌门当场逮住(壳的 R11 codemod 只走自己
+    //    的 src,走不到 node_modules ⇒ 包里的 CC 路径字面 = 品牌面泄漏)。见本文件末的包内纪律。
+    { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地技能目录投影(布局取 CC 同款);两条车道都由 launchRepl 载入面注入' },
     { field: 'mcpServers', lanes: ['interactive', 'print'], live: true, why: '本地 .mcp.json 投影;service 单用户门决定是否兑现' },
     { field: 'settings.webSearch', lanes: ['interactive', 'print'], live: true, why: 'SEMA_WEBSEARCH_* / settings.json;per-request 配置赢过部署 env' },
     { field: 'settings.hooks', lanes: ['interactive', 'print'], live: true, why: '[495]① 用户 settings 文件 hooks 逐字上 wire' },
@@ -174,3 +177,56 @@ export function applyLiveRequestDefaults(req, host) {
     }
     return out;
 }
+/**
+ * ⇄ B8(§8-5 请求拼装合一的**可执行判据**)—— 一份请求体里出现了**没进车道表**的键就点名它。
+ *
+ * 为什么要有:B4 把字段集做成了 `REQUEST_FIELD_MATRIX` 这张表,但表当时只管住了
+ * `buildTaskRequest` 自己;端上真正上 wire 的那份请求仍可以在构造器之外多塞一个键(print lane
+ * 修前正是「自己另拼一份」),于是「表说了算」就退化成一句注释。本函数让**真上 wire 的那份**
+ * 也过一遍表:print lane 收编之后,`-p` 的请求体逐键都能报出登记出处,再漏就当场红。
+ *
+ * 判据口径(三类不点名):
+ *   ① 车道表里的字段(`lanes` 含本车道);② `LIVE_DEFAULT_FIELDS` —— live 兜底层追加、两条车道
+ *   都经过,故本就不进车道表;③ `settings` 的子键按表认(`settings.<sub>`),但**交互车道**的
+ *   `settings.<resolved>` 是 resolver 的 effective 快照 = **开放集**,子键不可枚举 ⇒ 整体放行。
+ *
+ * 🔴 它**不判**「该不该有」——只判「有没有登记」。补齐一条真实差异要改表(带理由),
+ * 而不是绕过本函数:改表这个动作本身就会在 diff 里显形,这正是本判据存在的意义。
+ */
+export function unregisteredRequestKeys(req, lane) {
+    /** live 兜底层的键名(表项写法含 `|` 备选位与括号说明,取裸键名)。 */
+    const liveDefaults = new Set(LIVE_DEFAULT_FIELDS.flatMap(row => row.split('|')).map(name => name.replace(/\(.*\)$/, '').trim()));
+    const laneRows = REQUEST_FIELD_MATRIX.filter(f => f.lanes.includes(lane));
+    /** 顶层键 → 表项(`resumeAt/rewindFiles/rewindFilesTo` 这类斜杠合写项逐键展开)。 */
+    const laneTopKeys = new Set();
+    for (const row of laneRows) {
+        if (row.field.startsWith('settings.'))
+            continue;
+        for (const key of row.field.split('/'))
+            laneTopKeys.add(key);
+    }
+    const laneSettingsKeys = new Set(laneRows
+        .filter(f => f.field.startsWith('settings.') && f.field !== 'settings.<resolved>')
+        .map(f => f.field.slice('settings.'.length)));
+    const settingsIsOpenSet = laneRows.some(f => f.field === 'settings.<resolved>');
+    const out = [];
+    for (const key of Object.keys(req)) {
+        if (key === 'settings') {
+            if (settingsIsOpenSet)
+                continue;
+            const settings = req.settings;
+            if (settings === null || typeof settings !== 'object')
+                continue;
+            for (const sub of Object.keys(settings)) {
+                if (laneSettingsKeys.has(sub) || liveDefaults.has(`settings.${sub}`))
+                    continue;
+                out.push(`settings.${sub}`);
+            }
+            continue;
+        }
+        if (laneTopKeys.has(key) || liveDefaults.has(key))
+            continue;
+        out.push(key);
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
   },
   "devDependencies": {
     "@sema-agent/agent-types": "^0.2.0",
-    "@sema-agent/sdk": "^0.0.118",
+    "@sema-agent/sdk": "^0.0.125",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"
   }