@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/oneShotWireCaps.d.ts

@@ -1,36 +1,2 @@
-/**
- * src/oneShotWireCaps.ts — PURE projection: the headless `-p` submission's one-shot declaration →
- * the TOP-LEVEL `TaskRequest.oneShot` boolean the SERVICE consumes(server ≥7.12.0 wire-types:
- * boolean 才投影进 TaskSpec、缺席不写键、非 boolean 400)。Mirrors retainBackgroundWireCaps
- * (the verified top-of-body wire pattern)。
- *
- * 语义(SDK `TaskRequest.oneShot` 契约,core ≥5.23.0 `TaskSpec.oneShot`):
- * `true` = 本次提交是一次性的 —— 不存在一个后续回合能接住异步的后台通知(原型就是 headless
- * `sema -p`:回合一结束进程就退了)。core 只把它当**给模型的指引**用:`RunWorkflow`/委派回执里
- * 那句「结束回合等通知」改成「用 `TaskOutput({block:true})` 主动阻塞等」。不发,headless 调用方
- * 会丢后台结果;发了也只是尽力而为,不是完成契约。
- *
- * 提交体是**开集**:还没接这个键的老 worker 收下 `oneShot: true`、回 200、键被静默忽略(=现状
- * 行为,零回归)——所以本键与姊妹键 `interactiveTools`/`retainBackgroundProcesses` 同款,发送侧
- * 不做能力位前置门(`capabilities.oneShot` 是「键被消费」的观测位,同步 caps 缓存在 `-p` 单回合
- * 车道上探测大概率未回,前置门会把键变死键)。
- *
- * 三问(宪法 NO-SHIP 检查):
- *   谁需要:headless `-p` 用户 —— 模型在 `-p` 里收到「结束回合等通知」的指引会白等(没有下一
- *           回合),后台委派/workflow 的结果就丢了;stamp 后 core 换发 block-wait 指引。
- *   谁受害:无 —— 键只改模型指引文案,不授予权限、不改门;交互车道不 stamp(有后续回合,
- *           指引「等通知」本来就对)。
- *   补偿机制:`SEMA_HEADLESS_ONE_SHOT=0|false|no|off` 逃生口 ⇒ 不 stamp ⇒ 引擎缺省(交互态
- *           指引)生效;老引擎静默忽略本键。
- *
- * 语义:缺省 ON —— unset / 未识别值 ⇒ `true`(stamp);显式 truthy(1/true/yes/on)⇒ `true`;
- * 只有显式 falsy(0/false/no/off)⇒ `undefined`(不 stamp)。返回型刻意是 `true | undefined`
- * —— opt-out 一律表达为**不 stamp**,绝不发 `false`(形状诚实,与缺席在 wire 上同义,发小的
- * 那个)。PURE — callers pass `env`;caller gates to LIVE mode(mock request shape 不变)。
- */
 import { type EnvLike } from './hostEnv.js';
-/**
- * ENV source → `true`(缺省 ON = `-p` 提交的一次性本性),只有显式 falsy 逃生口
- * ({@link envFlagOff} 拼写集)⇒ `undefined`(不 stamp ⇒ 引擎缺省交互态指引)。
- */
 export declare function oneShotFromEnv(env?: EnvLike): true | undefined;

package/dist/oneShotWireCaps.js

@@ -1,41 +1,6 @@
-/**
- * src/oneShotWireCaps.ts — PURE projection: the headless `-p` submission's one-shot declaration →
- * the TOP-LEVEL `TaskRequest.oneShot` boolean the SERVICE consumes(server ≥7.12.0 wire-types:
- * boolean 才投影进 TaskSpec、缺席不写键、非 boolean 400)。Mirrors retainBackgroundWireCaps
- * (the verified top-of-body wire pattern)。
- *
- * 语义(SDK `TaskRequest.oneShot` 契约,core ≥5.23.0 `TaskSpec.oneShot`):
- * `true` = 本次提交是一次性的 —— 不存在一个后续回合能接住异步的后台通知(原型就是 headless
- * `sema -p`:回合一结束进程就退了)。core 只把它当**给模型的指引**用:`RunWorkflow`/委派回执里
- * 那句「结束回合等通知」改成「用 `TaskOutput({block:true})` 主动阻塞等」。不发,headless 调用方
- * 会丢后台结果;发了也只是尽力而为,不是完成契约。
- *
- * 提交体是**开集**:还没接这个键的老 worker 收下 `oneShot: true`、回 200、键被静默忽略(=现状
- * 行为,零回归)——所以本键与姊妹键 `interactiveTools`/`retainBackgroundProcesses` 同款,发送侧
- * 不做能力位前置门(`capabilities.oneShot` 是「键被消费」的观测位,同步 caps 缓存在 `-p` 单回合
- * 车道上探测大概率未回,前置门会把键变死键)。
- *
- * 三问(宪法 NO-SHIP 检查):
- *   谁需要:headless `-p` 用户 —— 模型在 `-p` 里收到「结束回合等通知」的指引会白等(没有下一
- *           回合),后台委派/workflow 的结果就丢了;stamp 后 core 换发 block-wait 指引。
- *   谁受害:无 —— 键只改模型指引文案,不授予权限、不改门;交互车道不 stamp(有后续回合,
- *           指引「等通知」本来就对)。
- *   补偿机制:`SEMA_HEADLESS_ONE_SHOT=0|false|no|off` 逃生口 ⇒ 不 stamp ⇒ 引擎缺省(交互态
- *           指引)生效;老引擎静默忽略本键。
- *
- * 语义:缺省 ON —— unset / 未识别值 ⇒ `true`(stamp);显式 truthy(1/true/yes/on)⇒ `true`;
- * 只有显式 falsy(0/false/no/off)⇒ `undefined`(不 stamp)。返回型刻意是 `true | undefined`
- * —— opt-out 一律表达为**不 stamp**,绝不发 `false`(形状诚实,与缺席在 wire 上同义,发小的
- * 那个)。PURE — callers pass `env`;caller gates to LIVE mode(mock request shape 不变)。
- */
 import { hostEnv } from './hostEnv.js';
 import { envFlagOff } from './envFlag.js';
-/** The env key the shell reads(SEMA_ 命名空间;`-p` 车道 per-request 意图面,非引擎部署面)。 */
 const ONE_SHOT_ENV = 'SEMA_HEADLESS_ONE_SHOT';
-/**
- * ENV source → `true`(缺省 ON = `-p` 提交的一次性本性),只有显式 falsy 逃生口
- * ({@link envFlagOff} 拼写集)⇒ `undefined`(不 stamp ⇒ 引擎缺省交互态指引)。
- */
 export function oneShotFromEnv(env = hostEnv()) {
     return envFlagOff(env[ONE_SHOT_ENV]) ? undefined : true;
 }

package/dist/ownKey.d.ts

@@ -1,34 +1 @@
-/**
- * src/ownKey.ts — 「拿 **wire 给的串**当对象键」时的**唯一落键姿势**(0.68.0 / L-246 B2 单源化)。
- *
- * ── 病形(0.67.1 在 `terminalToSdkResult.ts` 上定谳,同批在 `hitl/parkResolver.ts` 上又长了一份)──
- * `Object.prototype.__proto__` 是一个 **accessor**:在一只普通对象上写 `o["__proto__"] = v` 走的是
- * 那只 setter ——
- *   · **不产生自有属性** ⇒ 那一行在 `Object.keys` / `JSON.stringify` 里**整条消失**,连行数都少一;
- *   · `v` 是对象时还**顺手改了 `o` 的原型**。
- * 而这几张表的键全都来自 wire(taskId / modelId / core 开集的 costBreakdown 键名 / 一条问题正文),
- * 没有任何一条保证它们不等于这个字面。⇒ 落键一律走 `defineProperty`。
- *
- * ── 为什么要单源(本文件存在的理由)────────────────────────────────────────────────────────
- * 修前同一条处置有**两份实现**(`terminalToSdkResult.ts` 的 `putOwn` 与 `parkResolver.ts` 里那只
- * 内联 `put`),而且两份都带着各自的一段说明。两份同形实现的代价不是重复几行,是**下一次只修一处**:
- * 这条落键姿势将来若要再收紧(例如连 `constructor` 一类也要拦),漏掉的那一份会静默地把老病留住。
- * 本仓「同形存量」纪律的直接落点。
- *
- * 🔴 **不改成 null 原型对象交付**:端拿到的仍是一只正常对象(`hasOwnProperty` / `toString` 都在),
- *    本模块只管「落键」这一步,不改交付形 —— 换原型会在宿主侧造出一类新的 `TypeError`。
- *    描述符与普通赋值**逐位相同**(`writable` / `enumerable` / `configurable` 三真),所以除了
- *    `__proto__` 这一个字面,其余每一个键的行为一个字节都没变。
- *
- * 🔴 **零 import**(纯叶):它进 runStream 内核闭包与 index 闭包两条传递闭包,自己一条 import 都没有
- *    ⇒ 不可能把任何东西拖进去(portability 门真正守的三件 —— 零 Node 内建 / 零 react·ink /
- *    外部包等值集 —— 一件都不动)。
- */
-/**
- * 把 `value` 落在 `table[key]` 上,**保证产生一个自有属性**(`key` 可以是任何 wire 串,含 `__proto__`)。
- *
- * @param table 目标表(交付形不变:仍是一只普通对象)
- * @param key   来自 wire 的键串
- * @param value 要落的值
- */
 export declare function putOwnKey<T>(table: Record<string, T>, key: string, value: T): void;

package/dist/ownKey.js

@@ -1,36 +1,3 @@
-/**
- * src/ownKey.ts — 「拿 **wire 给的串**当对象键」时的**唯一落键姿势**(0.68.0 / L-246 B2 单源化)。
- *
- * ── 病形(0.67.1 在 `terminalToSdkResult.ts` 上定谳,同批在 `hitl/parkResolver.ts` 上又长了一份)──
- * `Object.prototype.__proto__` 是一个 **accessor**:在一只普通对象上写 `o["__proto__"] = v` 走的是
- * 那只 setter ——
- *   · **不产生自有属性** ⇒ 那一行在 `Object.keys` / `JSON.stringify` 里**整条消失**,连行数都少一;
- *   · `v` 是对象时还**顺手改了 `o` 的原型**。
- * 而这几张表的键全都来自 wire(taskId / modelId / core 开集的 costBreakdown 键名 / 一条问题正文),
- * 没有任何一条保证它们不等于这个字面。⇒ 落键一律走 `defineProperty`。
- *
- * ── 为什么要单源(本文件存在的理由)────────────────────────────────────────────────────────
- * 修前同一条处置有**两份实现**(`terminalToSdkResult.ts` 的 `putOwn` 与 `parkResolver.ts` 里那只
- * 内联 `put`),而且两份都带着各自的一段说明。两份同形实现的代价不是重复几行,是**下一次只修一处**:
- * 这条落键姿势将来若要再收紧(例如连 `constructor` 一类也要拦),漏掉的那一份会静默地把老病留住。
- * 本仓「同形存量」纪律的直接落点。
- *
- * 🔴 **不改成 null 原型对象交付**:端拿到的仍是一只正常对象(`hasOwnProperty` / `toString` 都在),
- *    本模块只管「落键」这一步,不改交付形 —— 换原型会在宿主侧造出一类新的 `TypeError`。
- *    描述符与普通赋值**逐位相同**(`writable` / `enumerable` / `configurable` 三真),所以除了
- *    `__proto__` 这一个字面,其余每一个键的行为一个字节都没变。
- *
- * 🔴 **零 import**(纯叶):它进 runStream 内核闭包与 index 闭包两条传递闭包,自己一条 import 都没有
- *    ⇒ 不可能把任何东西拖进去(portability 门真正守的三件 —— 零 Node 内建 / 零 react·ink /
- *    外部包等值集 —— 一件都不动)。
- */
-/**
- * 把 `value` 落在 `table[key]` 上,**保证产生一个自有属性**(`key` 可以是任何 wire 串,含 `__proto__`)。
- *
- * @param table 目标表(交付形不变:仍是一只普通对象)
- * @param key   来自 wire 的键串
- * @param value 要落的值
- */
 export function putOwnKey(table, key, value) {
     Object.defineProperty(table, key, { value, enumerable: true, writable: true, configurable: true });
 }

package/dist/panelRunningHistory.d.ts

@@ -1,49 +1,21 @@
 export declare function notePanelRowRunning(taskId: string): void;
-/** 结掉了(任何 lane 的 end 递达):历史不再需要。 */
 export declare function retirePanelRowRunning(taskId: string): void;
-/** 结过的行 → 那条 end 的周期身份(两键都可缺席 = 判不出代际);投影据此分「同代的最终用量到了」与「结过之后复活的新一代」。 */
 export interface PanelRowEndedIdentity {
     cycleSeq?: number;
     startedAt?: number;
 }
-/**
- * 单调写(异源复审 R3 [high]:旧 end 后到不许把已结周期倒写回前代):`older(cycle, existing)` 由调用方(漏斗)用陈旧判据算 ——
- * 可证更旧 ⇒ 不写;同代 / 判不出 ⇒ 与已有记录合并(保留已知的另一半身份);可证更新 ⇒ 调用方传 older=false,本函数整只替换已知键。
- */
 export declare function notePanelRowEnded(taskId: string, cycle: PanelRowEndedIdentity, older: boolean): void;
-/** 本进程递达过这一行的 end ⇒ 那条 end 的周期身份;没有 ⇒ undefined。 */
 export declare function panelRowEndedIdentity(taskId: string): PanelRowEndedIdentity | undefined;
-/** 首见即终态且**确知**消费端没有这一行(running 表没溢出、不在 running 表、也没递达过 end)⇒ 历史行。 */
 export declare function panelRowUnknownToConsumer(taskId: string): boolean;
 export declare function holdNewbornTerminalRow(taskId: string, ev: object): void;
 export declare function peekHeldNewbornTerminalRow<T extends object>(taskId: string): T | undefined;
 export declare function takeHeldNewbornTerminalRow<T extends object>(taskId: string): T | undefined;
 export declare function dropHeldNewbornTerminalRow(taskId: string): void;
-/** 一条缓行**自带**的 wire 侧身份键(它是一条 fleet 行帧,两把键都可缺席)。 */
 export interface HeldNewbornTerminalRef {
-    /** 缓行在本表里的键 = fleet 行 id 尾段。 */
     readonly taskId: string;
     readonly transcriptId?: string;
     readonly parentToolCallId?: string;
 }
-/**
- * 0.75.1(实测反例):`end` 归一的三把可能的键里,**后两把只在行帧真发布过时才登记**
- * (`transcriptId → 尾段` 钥匙表与 `尾段 → UUID` 反向所有权都由 `publishEngineAgentPanelEvent`
- * 的 fleet-row 臂写),而缓行的定义就是「还没发布」⇒ `tick{UUID}` 先上屏、终态行 `{尾段,
- * transcriptId: UUID}` 被缓住、`end{UUID}` 到达时三把键全查不到,缓行永远放不出、短命子代的
- * 最终用量丢。所以漏斗还需要第四条腿:按缓行**自己带着的** wire 侧键反查。
- *
- * 🔴 **为什么是遍历、不是第六本索引**:面板这一族已经有五本账(running 历史 / ended 账 / 缓行 /
- * 所有权 / 周期水位),再加一张 `transcriptId → 缓行键` 的索引就要在 hold / take / drop / 容量淘汰
- * 四个写口上各维护一次同步 —— 那是本族出过真回归的形(一本账写了另一本没写 ⇒ 缓行放两次或永不放)。
- * 缓行表有界 4096 且只在 **`end` 递达**时被扫(不是每拍;一条子代一生至多几次),所以遍历的成本
- * 上限是一条 end 读 4096 个小对象,换来的是「缓行表自己就是唯一真源」。
- */
 export declare function heldNewbornTerminalRefs(): HeldNewbornTerminalRef[];
-/**
- * 测试钩。清四样:① 「发布过 running 且还没结」的行 id 集合 ② 溢出标(溢出后读口一律答保守)③ 「递达过 end」的行 id 集合 ④ 缓着的首见终态行。
- * 🔴 连续场景中途别调:清掉之后,「首见即终态」的判定会把此前见过 running / 结过的行当成从没见过。
- */
 export declare function __resetPanelRunningHistoryForTests(): void;
-/** 测试 / 诊断读面。 */
 export declare function __panelRunningHistorySize(): number;

package/dist/panelRunningHistory.js

@@ -1,11 +1,3 @@
-/**
- * panelRunningHistory — 「本进程**发布过 running 而尚未结掉**的面板行 id」(0.74.5 CC-86;包内共享叶,不出公面)。
- *
- * 写方 = fleet 投影(非终态帧);读方 = fleet 投影的终态分支(首见即终态 ∧ 从没发布过 running ⇒ 历史行,零事件);
- * **结掉的写方 = 面板漏斗的 `end` 递达**(异源复审 0.74.5 R2 [medium]:通知车道的 end 不经投影,只在投影里删会让完成过的 id 永远留在表里、
- * 最终溢出把压制永久关掉)—— 任何 lane 的 end 到漏斗都在这里销账,且**只销当代**(前代迟到的 end 不擦新一代的 running 历史)。
- * 作用域 = 面板订阅作用域(进程级,不按 sessionKey 分桶);有界 4096,溢出后转保守(不再压制)直到整表重置。
- */
 const MAX_IDS = 4096;
 const ids = new Set();
 let overflowed = false;
@@ -20,22 +12,11 @@ export function notePanelRowRunning(taskId) {
             ids.delete(oldest);
     }
 }
-/** 结掉了(任何 lane 的 end 递达):历史不再需要。 */
 export function retirePanelRowRunning(taskId) {
     ids.delete(taskId);
 }
-/**
- * 0.75.0 W2(test 0.74.5 复验读数):「没发布过 running」不等于「消费端没有这一行」—— 短命子代在两拍之间起步并结束时,通知车道的 end
- * 已经递达(消费端建了行、状态 ended),终态 fleet-row 再被零事件吞掉 = 那一行的最终用量丢了(它是唯一带全 usage 的一帧)。
- * ⇒ 第二本账:本进程**递达过 end** 的行 id(任何 lane;只记当代 —— 与销 running 历史同一个陈旧判据)。有界 FIFO 4096;被挤掉的 id 之后
- *    若再来终态行会被当历史行(用量丢),这是有界的代价,不是压制永久关掉。
- */
 const MAX_ENDED = 4096;
 const endedIds = new Map();
-/**
- * 单调写(异源复审 R3 [high]:旧 end 后到不许把已结周期倒写回前代):`older(cycle, existing)` 由调用方(漏斗)用陈旧判据算 ——
- * 可证更旧 ⇒ 不写;同代 / 判不出 ⇒ 与已有记录合并(保留已知的另一半身份);可证更新 ⇒ 调用方传 older=false,本函数整只替换已知键。
- */
 export function notePanelRowEnded(taskId, cycle, older) {
     const existing = endedIds.get(taskId);
     if (existing !== undefined && older)
@@ -48,18 +29,12 @@ export function notePanelRowEnded(taskId, cycle, older) {
             endedIds.delete(oldest);
     }
 }
-/** 本进程递达过这一行的 end ⇒ 那条 end 的周期身份;没有 ⇒ undefined。 */
 export function panelRowEndedIdentity(taskId) {
     return endedIds.get(taskId);
 }
-/** 首见即终态且**确知**消费端没有这一行(running 表没溢出、不在 running 表、也没递达过 end)⇒ 历史行。 */
 export function panelRowUnknownToConsumer(taskId) {
     return !overflowed && !ids.has(taskId) && !endedIds.has(taskId);
 }
-/**
- * 反序(终态 fleet-row 先到、通知 end 后到):终态行先缓住(投影把它当历史行零事件),end 到漏斗时先放行再放 end —— 用量不丢、也不为真历史行建行。
- * 有界 FIFO 4096(与两本 id 账同量级;挤掉 = 那一行的用量丢,触发条件 = 同一进程里 4096 条首见终态行都还没等到 end);任何后到的行帧把缓着的作废。
- */
 const MAX_HELD = 4096;
 const heldNewborn = new Map();
 export function holdNewbornTerminalRow(taskId, ev) {
@@ -84,19 +59,6 @@ export function takeHeldNewbornTerminalRow(taskId) {
 export function dropHeldNewbornTerminalRow(taskId) {
     heldNewborn.delete(taskId);
 }
-/**
- * 0.75.1(实测反例):`end` 归一的三把可能的键里,**后两把只在行帧真发布过时才登记**
- * (`transcriptId → 尾段` 钥匙表与 `尾段 → UUID` 反向所有权都由 `publishEngineAgentPanelEvent`
- * 的 fleet-row 臂写),而缓行的定义就是「还没发布」⇒ `tick{UUID}` 先上屏、终态行 `{尾段,
- * transcriptId: UUID}` 被缓住、`end{UUID}` 到达时三把键全查不到,缓行永远放不出、短命子代的
- * 最终用量丢。所以漏斗还需要第四条腿:按缓行**自己带着的** wire 侧键反查。
- *
- * 🔴 **为什么是遍历、不是第六本索引**:面板这一族已经有五本账(running 历史 / ended 账 / 缓行 /
- * 所有权 / 周期水位),再加一张 `transcriptId → 缓行键` 的索引就要在 hold / take / drop / 容量淘汰
- * 四个写口上各维护一次同步 —— 那是本族出过真回归的形(一本账写了另一本没写 ⇒ 缓行放两次或永不放)。
- * 缓行表有界 4096 且只在 **`end` 递达**时被扫(不是每拍;一条子代一生至多几次),所以遍历的成本
- * 上限是一条 end 读 4096 个小对象,换来的是「缓行表自己就是唯一真源」。
- */
 export function heldNewbornTerminalRefs() {
     const out = [];
     for (const [taskId, ev] of heldNewborn) {
@@ -109,17 +71,12 @@ export function heldNewbornTerminalRefs() {
     }
     return out;
 }
-/**
- * 测试钩。清四样:① 「发布过 running 且还没结」的行 id 集合 ② 溢出标(溢出后读口一律答保守)③ 「递达过 end」的行 id 集合 ④ 缓着的首见终态行。
- * 🔴 连续场景中途别调:清掉之后,「首见即终态」的判定会把此前见过 running / 结过的行当成从没见过。
- */
 export function __resetPanelRunningHistoryForTests() {
     ids.clear();
     overflowed = false;
     endedIds.clear();
     heldNewborn.clear();
 }
-/** 测试 / 诊断读面。 */
 export function __panelRunningHistorySize() {
     return ids.size;
 }

package/dist/peerFrames.d.ts

@@ -1,70 +1,20 @@
-/**
- * peerFrames.ts — design/385 的三条**引擎注入帧**在客户端的类型化投影(判定单源在包,端只装配)。
- *
- * ── 这一件守的是什么 ────────────────────────────────────────────────────────────────
- * 引擎把三类东西塞进 **同一条** `task_notification` 车道,而它们在模型面根本不是同一种东西
- * (core `renderTaskNotificationXml` 对这三类**不套** `<task-notification>` 壳):
- *   · `agentMessage`         同进程子代 → 父会话的 uplink(`SendMessage("main")`,§1.4 d1);
- *   · `crossSessionMessage`  另一个会话的消息,从本会话自己的信箱里 drain 出来(§4.1);
- *   · `crossSessionNotice`   关于**本会话自己发出去的**那条消息的回执 / idle 通知(§4.4 / §5.2)。
- * 端如果照 `task_notification` 泛化卡去渲,用户看到的是一张「后台任务完成」卡,而模型读到的是
- * 一条同事发来的话 —— 两个面说的不是同一件事。
- *
- * 🔴 **判别位是类型化载体的在场,永远不是 `summary` 文本**。这三条载体只有引擎的注入腿铸得出
- *    (`ExternalNotificationInput` 是 `TaskNotificationPayload` 的**真子集**,外部 `notify()` 一个
- *    都穿不上);而 `summary`/`result` 是任何一条通知都填的字段,拿它做判据 = 任何一个后台任务
- *    只要把 `<agent-message from="…">` 写进 summary 就能冒充一条同事消息。
- *
- * 🔴 **身份三条等式**:`_sema_provenance` 必须在场、`kind` 与车道相符,且 `from`/`taskId`/`seq`
- *    与载体和载荷逐一相等(三条都由 core 铸点直证,见 `provenanceAgrees`)。只核 `kind` 拦得住
- *    半截载荷,拦不住**同 kind 的伪造**——载体署一个可信名字、provenance 三位全不对,屏上照样
- *    出现一条署着那个名字的消息。
- *
- * 🔴 **fail-closed**:载体在场但形不合(`from` 空、`body` 非串、notice 的 `kind` 不在闭集里)⇒
- *    返回 `null` = 退回泛化卡。退回泛化卡是**诚实降级**(用户仍看得见这条通知,只是没有专用形);
- *    而放一个半截形出去,端就会拿 `undefined` 去渲一张署名为空的「来自 @undefined 的消息」卡。
- *
- * 🔴 **优先序照抄 core 的渲染腿**(`agentMessage` → `crossSessionMessage` → `crossSessionNotice`)。
- *    多载体同时在场是矛盾载荷,但**模型那一面已经按 core 的顺序读过了** —— 端按同一个顺序判,
- *    两个面才说同一件事;这里另立一套「矛盾就退泛化」会让屏上那张卡与模型读到的帧对不上。
- *
- * ── 为什么渲染/解析两半都在包里 ─────────────────────────────────────────────────────
- * 端的消息面(CC 血统:`UserTextMessage` 按标签分派)拿到的只有**文本**,没有帧。所以包必须同时
- * 给出「帧 → 文本」与「文本 → 帧」两半,且**同源**(同一组标签常量、同一套属性序),端才可能
- * 做到零字符串判定。两半的往返在常驻门里逐形对拍。
- *
- * ── 与上游的锚 ──────────────────────────────────────────────────────────────────────
- * 两个标签字面量是 core 的铸点镜像(`core/task-notification.js::AGENT_MESSAGE_TAG` /
- * `agents/cross-session-envelope.js::CROSS_SESSION_MESSAGE_TAG`),登记在壳的 wire 锚契约表里
- * (cli `scripts/wire-anchor-registry.mjs`)—— core 改词当天那道门就红,而不是等到用户发现
- * 「同事消息又变回一张后台任务卡了」。
- */
-/** core `core/task-notification.ts::AGENT_MESSAGE_TAG` 的镜像(同进程 uplink 的模型面标签)。 */
 export declare const AGENT_MESSAGE_TAG = "agent-message";
-/** core `agents/cross-session-envelope.ts::CROSS_SESSION_MESSAGE_TAG` 的镜像(跨会话信封标签)。 */
 export declare const CROSS_SESSION_MESSAGE_TAG = "cross-session-message";
-/** core `_sema_provenance.kind` 的闭集(7.4.0 三员;7.2.0 只有第一员 —— 缺员按「上游还没发」处理,
- *  不是「上游改词」:本模块从不要求 provenance 在场,只要求**在场时不自相矛盾**)。 */
 export declare const PEER_FRAME_LANES: readonly ["agent_message", "cross_session_message", "cross_session_notice"];
 export type PeerFrameLane = (typeof PEER_FRAME_LANES)[number];
-/** core `crossSessionNotice.kind` 的闭集(§4.4:投递回执 / idle 回执两形)。 */
 export declare const CROSS_SESSION_NOTICE_KINDS: readonly ["delivery_notice", "idle_notice"];
 export type CrossSessionNoticeKind = (typeof CROSS_SESSION_NOTICE_KINDS)[number];
-/** core `PermissionModeClass`(发送方**自述**的权限模式类,不是被证实的事实)。 */
 export declare const PEER_MODE_CLASSES: readonly ["bypass", "prompting"];
 export type PeerModeClass = (typeof PEER_MODE_CLASSES)[number];
 export type AgentMessageFrame = {
     lane: 'agent_message';
-    /** 帧的 `from="…"` 属性所拼的那个署名(子代的名字 / 标签)。 */
     from: string;
     body: string;
     agentType?: string;
-    /** 生产者的 per-frame 计数器(= 本 payload 的 `seq`);缺席不补 0。 */
     seq?: number;
 };
 export type CrossSessionMessageFrame = {
     lane: 'cross_session_message';
-    /** 发送方的**地址**(可回信的那一个;§4.1 provenance 的 `from` 同值)。 */
     from: string;
     body: string;
     fromSession?: string;
@@ -76,31 +26,10 @@ export type CrossSessionMessageFrame = {
 export type CrossSessionNoticeFrame = {
     lane: 'cross_session_notice';
     kind: CrossSessionNoticeKind;
-    /** 引擎自铸的整行文本(`[Cross-session delivery notice] …` / `[Cross-session idle notice] …`)。
-     *  🔴 端**原样渲一行**:这行是引擎按类型化 `peerMeta.notice` 铸的,端再解析一遍就是拿散文当数据。 */
     text: string;
 };
 export type PeerFrameProjection = AgentMessageFrame | CrossSessionMessageFrame | CrossSessionNoticeFrame;
-/**
- * `task_notification` 原始 wire 载荷 → 三条引擎注入车道之一;认不出 ⇒ `null`(= 泛化通知,
- * 调用方照旧走 `normalizeTaskNotification` / `renderTaskNotificationXml`)。
- *
- * 入参是**原始**载荷(snake_case `task_id` 那一份),不是 `normalizeTaskNotification` 的产物 ——
- * 后者是一张 15 键白名单,这三条载体一个都不在里面。
- */
 export declare function classifyPeerNotification(n: Record<string, unknown>): PeerFrameProjection | null;
-/**
- * 投影 → 转录行文本(端的消息面按标签分派的那一份)。
- *
- * 🔴 这**不是** core 模型面信封的逐字副本,也不该是:core 那一份是给**模型**读的(带纪律块、
- *    带 CC 逐字属性语法、带 round-trip 拒收);这一份是**端的转录回显**,只需要与本模块的解析腿
- *    往返一致。刻意不复刻 core 的语法契约 —— 复刻一份对不上的副本比不复刻更坏
- *    (它会让人以为端这一行是模型读到的那一行)。属性序仍照 core 的规范序排,便于人肉比对。
- */
 export declare function renderPeerFrameTranscriptText(p: PeerFrameProjection): string;
 export declare function parsePeerFrameText(text: string): AgentMessageFrame | CrossSessionMessageFrame | null;
-/**
- * 端渲「@谁」时该用的那个名字 —— 判定在包,端不许自己排优先序。
- * 跨会话:`fromName`(人取的名)优先于 `from`(地址);同进程:只有 `from`。
- */
 export declare function peerFrameDisplayName(p: AgentMessageFrame | CrossSessionMessageFrame): string;