@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/subagentContentStore.d.ts

@@ -1,41 +1,3 @@
-/**
- * ⇄ B1 批搬迁(2026-07-27,多端改造设计稿 §2.4.1-B):cli src/sema/subagentContentStore.ts 逐字搬入(零依赖;壳侧改 re-export)。
- * 🔴 module 级台账(tasks/parentToTask/ownEngineRuns/bgFacts)= 单实例语义:写方(seam adapter
- * runStream 的子代内容分流 + liveClient 的 run_started own 台账)与读方(查看态/帧级 own 判别)
- * 必须走**同一个模块实例**,否则 own 判别恒 false(帧级校验静默失效)。
- */
-/**
- * subagentContentStore — dep-free side-channel store for ENGINE subagent CONTENT events (C1 consumption,
- * service 1.89 `forwardSubagentEvents` + core 1.219; blackboard [381]⑤/[383]③).
- *
- * WIRE FACTS: with `forwardSubagentEvents: true` on the task request, the live stream carries the
- * subagent's text_delta / reasoning_delta / tool_start / tool_end stamped with EventIdentity
- * —— 🔴 **durable 腿(重放)送的是同一段的聚合形** `text` / `reasoning`(整段全文,同样带
- * EventIdentity)。两类都要收:只收增量的话,续听重放尾的宿主整条子代转录都是空的
- * (0.62.0 补;两类的处置**不同**,见 {@link publishSubagentContentEvent} 的吸收规则)
- * 🔴 **重放的幂等闸覆盖四个臂**(`text` / `reasoning` / `tool_start` / `tool_end`):重连 = 新的一条
- * 流,缝前那道事件序号去重只在同一条流内有效,所以「整轮重放」拦得住的只能是这本账。判据形相同
- * (先问身份、再问账本),身份与账本各按臂取:散文两臂 = 聚合帧 `eventId` + 已上屏的整段正文;
- * 工具两臂 = `toolCallId` + `items` 上那张卡,收口另带一本**自己额度**的收口身份账(同一次调用
- * 会有**第二发**真收口 —— 门 park 之后恢复执行,见 {@link publishSubagentContentEvent})。
- * (§E1 redact upstream; §E2 identity). 🔴 EventIdentity 的键是 `eventId` / `parentToolCallId`
- * (+ LIVE 白名单四臂上的 `sourceTaskId` / `bgAgentId`)—— **没有 `taskId`**(sdk `events.d.ts` 的
- * `interface EventIdentity` 直证;`taskId` 只长在 `meta` 首帧上)。所以内容帧到不了「自带引擎
- * taskId」那一步,归账键靠 `parentToTask`,见 `canonicalKey`。The seam adapter (runStream.ts)
- * DIVERTS those events here — they must never reach the main-transcript pipeline (a subagent's tokens
- * rendering as the leader's text is the pollution failure mode).
- *
- * WHAT IT KEEPS (bounded, per task):
- *   - a NEUTRAL item log: {kind:'text'|'thinking',text} | {kind:'tool',name,input,output,isError,id}
- *     (ring-capped) — the 查看态 transcript backlog, so entering a running agent mid-flight still shows
- *     history. Message SHAPES are built by the consumers (engineAgentView/chrome-agentprogress own the
- *     CC message creators; this store stays dep-free like engineAgentPanelStore).
- *   - live accumulation buffers (streaming text/thinking not yet segment-closed).
- *   - taskId → parentToolCallId (the C2 steer target — service routes subagent steer by parentToolCallId).
- *
- * NOTIFY: coalesced (~250ms) per-task notify so a per-token delta storm never turns into per-token
- * AppState writes; consumers pull a snapshot on notify.
- */
 export type SubagentContentItem = {
     kind: 'text';
     text: string;
@@ -49,59 +11,20 @@ export type SubagentContentItem = {
     input: unknown;
     output?: string;
     isError?: boolean;
-}
-/** local user echo (查看态 composer 插话) — rides in the item log so a full rebuild keeps it in order */
- | {
+} | {
     kind: 'echo';
     text: string;
-}
-/**
- * **截尾留痕**(0.62.0):字节预算把这条子代早先的内容丢掉了多少。恒**排在 items 最前**、
- * 每条子代**至多一条**(丢一次加一条会把账本自己撑爆),随后续丢弃**原地更新**。
- *
- * 🔴 它存在的唯一理由是「不许无声消失」:没有它,用户读到的转录比真实发生的少一截而毫无提示,
- *    而那正是本包在别处反复记账的那类静默失败。渲染端该把它渲成一行可见的省略说明。
- * 🔴 本记录**自身不计入预算**(它是关于预算的元信息,不是内容)。
- */
- | {
+} | {
     kind: 'truncated';
     droppedBytes: number;
     keptFrom: number;
 };
-/**
- * 🔴 [2393] sweep-F15(2026-08-03 全窗复审)**记一笔口径分叉**(裁定:留 `| undefined`,写明为什么):
- * 下面五个可选位在 eopt 收官批被写成 `?: T | undefined`(= 允许显式赋 `undefined` 落键),而同窗
- * 另两处的口径是相反的(`fleetAgentPanelProjection` 的「🔴 缺席即不落键(消费端据键在不在判三态)」、
- * `toolResult` 的「公面键恒在形不许被 eopt 批翻成条件展开」)。两种口径都出自同一批,当时没有一处记账。
- * 为什么这里走另一条:**本类型的消费端一处都不用「键在不在」判三态** —— 本文件 `apply()` 全部用
- * `typeof ev.delta === 'string'` / `ev.output ?? ''` / `ev.isError === true` 这类**值级**判据
- * (逐行核过,见下方 switch),所以 `{delta: undefined}` 与「不落键」在本模块里可观测等价;而生产者
- * 是宿主的帧适配腿,`{ delta: maybe }` 这种直写形在 eopt 下会编译红,逼它们改写成条件展开只是把
- * 噪音推给三端,换不来任何判别力。
- * ⚠️ 反过来的约束:**谁想给这个类型加一个用「键在不在」判三态的位,就必须同批把这里改成条件展开**
- * (那时两种口径就不能再共存了)。
- */
 export interface SubagentContentEvent {
-    /**
-     * 🔴 六臂,两类语义(0.62.0 加 `text` / `reasoning` 两个**聚合**臂):
-     *   · `*_delta` = **增量**,语义是「往缓冲里追加」;
-     *   · `text` / `reasoning` = 一段的**权威全文**(durable 重放腿送的就是这一形),语义是
-     *     「这一段最终是这样」—— 处置**不是追加**,见 {@link publishSubagentContentEvent} 的吸收规则。
-     * 两类必须分得开:把聚合帧折成一发 `*_delta` 会让「活体流过 + 重放聚合」变成**双份**。
-     */
     type: 'text_delta' | 'reasoning_delta' | 'text' | 'reasoning' | 'tool_start' | 'tool_end';
     taskId: string;
     parentToolCallId: string;
     delta?: string | undefined;
-    /** 聚合两臂(`text` / `reasoning`)的**整段全文**。刻意不复用 `delta` 位:同名不同义会让
-     *  「这一位是增量还是全文」变成读者要靠 `type` 去反推的事,而反推错的代价是内容重复上屏。 */
     text?: string | undefined;
-    /** wire 上那一帧的**事件身份**(聚合两臂的幂等键;缺席 ⇒ 退回内容判据,见 publish 的两道闸)。
-     *  🔴 工具两臂**不拿它当身份**:那次调用的身份是 `toolCallId`,账本是 `items` 上那张卡。
-     *  ⚠️ 但两臂**确实读它**(0.62.2 起):它是那张卡逐半的**阶段水位**({@link CardPhase} 的
-     *     `start` / `end`),回答「这一发比卡上现在承载的那一阶段新还是旧」。缺席是一个值 ——
-     *     身份缺席而内容真的变了 ⇒ 那一半的水位被清掉(判不出新旧就诚实地说判不出)。
-     *     旧注写的「工具两臂不读这一位」自 0.62.2 起不成立。 */
     eventId?: string | undefined;
     toolCallId?: string | undefined;
     toolName?: string | undefined;
@@ -109,110 +32,25 @@ export interface SubagentContentEvent {
     output?: string | undefined;
     isError?: boolean | undefined;
 }
-/**
- * `tool_end.output` → 本 store 的 `output` 位(**唯一**字符串化口)。
- *
- * 为什么住在这里(#158 移交① / [3674](d) 姊妹病,2026-08-12 搬入):这个函数原本长在
- * `subagent/engineSubagentTail.ts`(tail 腿)里。而喂本 store 的是**两条**腿 —— tail 腿与
- * seam 适配器的 C1 分流臂(`adapter/runStream.ts`)—— C1 那条当时自己写了
- * `typeof sub.output === 'string' ? sub.output : undefined`,于是同一个 wire 形经不同腿进同一个
- * 账本得到两种结果(块数组走 C1 恒空)。字符串化口跟着**它服务的那个位**走,两条腿一律 import
- * 这一份:第二份实现在类型面就没有立足点了。
- * 🔴 住这里的另一个硬理由:tail 腿的传递闭包里有 SDK/host(engineWireSdk 等),而 C1 所在的
- *    `runStream.ts` 有一道**可移植性闭包门**(零 Node 内建 / 零 react / 文件数棘轮 ≤7)——
- *    从 tail 腿 import 会当场把整条 wire 依赖拖进内核。本 store 已在那 7 件之内且零 import,
- *    所以搬到这里的代价是 0 个新闭包文件。
- *
- * 语义:`undefined`/`null` ⇒ `undefined`(诚实缺席,不铸空串);`string` ⇒ 原样直通;
- * **§E1 的 `(TextContent|ImageContent)[]` 块数组 ⇒ 规范展平**(text 块贡献 `.text`、image 块贡献
- * 中性占位 `[image]`);其余(server `redactDeep` 之后原型不保的对象形等)⇒ `JSON.stringify`,
- * 序列化失败退 `String(v)`。
- *
- * 🔴 块数组这一支为什么不是 `JSON.stringify`(0.30.0 发包扫描修,2026-08-14):`output` 是**展示位**
- * (投进 {@link planSubagentViewSlots} 的结果栏),而同一个 wire 形在主 lane 走的是
- * `adapt/wireShapes.ts` 的 `flattenWireOutput`(工具卡体 / print 帧 / 面板 settle 三处)。修前这里
- * 出的是 `[{"type":"text","text":"…"}]` 这种机器形 —— 同一份素材主 lane 渲人话、子代查看态渲转义
- * JSON;带 image 块时整段 base64(events.d.ts 的 `totalChars` 注释逐字:image/document = base64 真实
- * 体量)会被原样灌进内容账本并上屏(item 数有 200 上限、**单 item 体量无上限**)。
- * 🔴 为什么这里还有第二份展平实现、而不是 import 那一份:本 store 是 `runStream.ts` 内核可移植闭包
- * (`run-client-core-portability-test.mjs` 的 `MAX_CLOSURE_FILES`,只许降)里的一件,且本文件头注
- * 三处以「dep-free / 零 import」为立身之本;从 `adapt/wireShapes.ts` 拉一条边会同时破这两条。
- * ⇒ 两份实现由 **pure 门 ⑨b 段的等值断言**逐形对拍钉住(字符串 / 纯 text 块 / 含 image 块 / 混合 /
- *   空数组 / 未知块形六形,`coerceOutput(x) === flattenWireOutput(x)` + 逐字面值),任一侧改语义当场红。
- *   动本函数的块数组分支 ⇒ 同批看那条断言。
- */
 export declare function coerceOutput(v: unknown): string | undefined;
-/**
- * 本账本的**字节预算**。此前只有条数帽(每条子代 ≤ 200 条 item、≤ 32 条子代),而条数帽对
- * 「一条工具结果里的一整个 base64 附件」「一段几 MB 的模型输出」**零判别力** —— 200 条的上限在
- * **单条无上限**的前提下根本不是一个预算,实测面上一个子代槽位吃到十几 MB 常驻是可复现的。
- *
- * 🔴 单位是 **UTF-8 字节**(不是 JS 串长度):账本里装的是引擎送来的文本,而「多少内存 / 多少屏」
- *    这两件事都跟编码后的体量走;按串长度算会让一段 CJK 的真实占用是名义值的三倍。
- * 🔴 缺省值的来历(如实):对标产品的语料里**没有**对应的「子代转录字节预算」可对齐(查过),
- *    所以这两个数不假称是 parity —— 它们来自 web 端探针实测的「单槽十几 MB」这一观测:总帽取
- *    16 MiB(把整本账本按住在那个量级),每子代帽取总帽的 1/8 = 2 MiB(一条子代吃满也留得下
- *    另外七条的位置)。端可以按自己的宿主改配,这两个数只是「不配时不至于无界」。
- */
 export interface SubagentContentStoreConfig {
-    /** 单条子代**保留**的内容字节上限。超出 ⇒ 从最早的内容开始丢,并留一条 `truncated` 记录。 */
     maxBytesPerTask: number;
-    /** 整本账本保留的内容字节上限。超出 ⇒ 整条**最久未用**的子代账本被清掉(不是无差别清空)。 */
     maxBytesTotal: number;
 }
-/** 不配时生效的两位(理由见 {@link SubagentContentStoreConfig} 顶注)。 */
 export declare const SUBAGENT_CONTENT_STORE_DEFAULTS: Readonly<SubagentContentStoreConfig>;
-/**
- * 配字节预算(宿主启动时调一次;两位可分开配,只给一位时另一位保持现值)。
- *
- * 🔴 **fail-loud**:0 / 负数 / 非有限数 / 非整数一律 `throw` —— 一个被**静默忽略**的预算配置正是
- *    这本账本要消灭的那类失败(宿主以为配上了,而账本还在按缺省无声地丢或不丢)。
- * 🔴 拒绝是**原子**的:任何一位不合法就整只拒,既有配置一个字节不动(半套配置比不配更坏)。
- */
 export declare function configureSubagentContentStore(next: Partial<SubagentContentStoreConfig>): void;
-/** 当前生效的两位(**快照**:改返回值不影响账本)。 */
 export declare function subagentContentStoreConfig(): SubagentContentStoreConfig;
-/** 测试钩:把预算复位到缺省。 */
 export declare function __resetSubagentContentStoreConfigForTests(): void;
-/**
- * **内容归账那一半**(`parentToolCallId → taskId`,多对一):把停在 parent 键下的内容迁到 canonical
- * task 键,并让后续内容帧的 `canonicalKey` 解析到 task。**不写** `taskToParent`。
- *
- * 为什么要与 {@link registerSubagentAlias} 分开(#158② 复审收货,2026-08-12):这张表其实承载
- * **两件不同的事**,方向与基数都不同 ——
- *   · `parentToTask`:内容归账,**多对一**(同一个子代可能被多次调用宣告:SendMessage 复活会为
- *     同一 taskId 再发一条 `async_launched` 回执,骑的是复活那次调用的 toolCallId);旧键不删,
- *     所以两次宣告的内容都归到同一个 taskId,加一条只会更全。
- *   · `taskToParent`:**单值**,而它的读口 {@link parentToolCallIdOf} 是**对外**的 C2 steer 投递
- *     目标(service 按「委派工具调用的 id」路由子代 steer)。这一位的**权威来源是 wire 的内容帧**
- *     (`publishSubagentContentEvent` 记在内容态上的 `parentToolCallId`,读口对它做兜底),
- *     一条启动回执**不足以**改写它:复活回执带的是复活调用,拿它盖掉真正的委派调用 = 用户插话
- *     投到错的目标,而「复活后该按哪个 target 投」要 server 语义作证,本包无从判定。
- * ⇒ 回执类喂点只用本函数(只加内容归账,零 steer 面影响);`task_progress` tick 那条喂点两键都带、
- *   且是引擎对「这条 tick 属谁」的当期陈述,继续用 {@link registerSubagentAlias}。
- */
 export declare function registerSubagentContentAlias(parentToolCallId: string, taskId: string): void;
-/** Register the parentToolCallId ↔ engine-taskId pair (from task_progress, which carries both).
- *  Content parked under the parent key migrates to the canonical task key.
- *  ⚠️ 这一口**同时**写单值的 `taskToParent`(= 对外 C2 steer 目标,见
- *  {@link registerSubagentContentAlias} 头注的两件事分家说明)。只想补内容归账的喂点用那一口。 */
 export declare function registerSubagentAlias(parentToolCallId: string, taskId: string): void;
 export declare function publishSubagentContentEvent(ev: SubagentContentEvent): void;
-/** 查看态 composer echo (C2 steer optimistic display) — segment-closes the buffers first so the echo
- *  lands AFTER the text streamed before it. taskId may be unseen (row entered before any content):
- *  parentToolCallId may then be unknown — pass '' and the steer path resolves the target separately. */
 export declare function pushSubagentLocalEcho(taskId: string, text: string): void;
 export interface SubagentContentSnapshot {
     items: SubagentContentItem[];
-    /** streaming tails not yet segment-closed (render as the live trailing message) */
     textBuf: string;
     thinkBuf: string;
 }
 export declare function getSubagentContentSnapshot(taskId: string): SubagentContentSnapshot | null;
-/**
- * 一个查看态转录槽位。`slot` = 稳定 key(消费端拿去当 message uuid —— 250ms 一次的重组不换 key);
- * `live: true` = 尚未段闭合的流式尾巴(下一次段闭合后由同内容的真 item 接位)。
- */
 export type SubagentViewSlot = {
     kind: 'text';
     slot: string;
@@ -227,9 +65,7 @@ export type SubagentViewSlot = {
     kind: 'echo';
     slot: string;
     text: string;
-}
-/** 截尾留痕(0.62.0):渲染端渲一行「更早的 N 字节输出已被预算丢弃」类说明。 */
- | {
+} | {
     kind: 'truncated';
     slot: string;
     droppedBytes: number;
@@ -240,27 +76,15 @@ export type SubagentViewSlot = {
     id: string;
     name: string;
     input: unknown;
-    /** undefined = tool_start 已到、tool_end 未到(在飞工具:卡先上屏,结果就地补) */
     output?: string;
     isError?: boolean;
 };
-/**
- * 把一个子代的内容账本投影成查看态渲染计划。
- *
- * [1568] 之前的形(壳侧 engineAgentView 里)有两处「等段闭合」:①遇到第一个未闭合工具就 break;
- * ②textBuf/thinkBuf 完全不投影。实测(engine 1.275.0 真跑):数据面 ~23 帧/s 的 delta 连续到壳,
- * 查看态却只在 tool 边界更新(进查看态后 6.0s 全空,之后每 5–15s 才动一次)。现形:在飞工具照投,
- * 流式尾巴作为 live 槽投 —— 屏面粒度 = wire 粒度(store notify 已按 250ms 合并)。
- */
 export declare function planSubagentViewSlots(taskId: string): SubagentViewSlot[];
-/** C2 steer target: the service routes subagent steer by the delegating tool call's id. */
 export declare function parentToolCallIdOf(taskId: string): string | undefined;
-/** Settle a task's streaming buffers (turn ended / run settled) so the snapshot is complete. */
 export declare function settleSubagentContent(taskId: string): void;
 export declare function clearSubagentContent(taskId: string): void;
 export interface BgTerminalFacts {
     status: string;
-    /** 0.74.0 —— 这份终局属于哪个周期(通知带 `seq` 时记;缺席 = 通知没报)。洗绿保护只在同周期内生效。 */
     cycleSeq?: number;
     summary?: string;
     recentSteps?: Array<{
@@ -270,116 +94,35 @@ export interface BgTerminalFacts {
     }>;
 }
 export declare function recordBgTerminalFacts(taskId: string, facts: BgTerminalFacts): void;
-/** 复活清账(#242 批 3 / 0.31.0 扫码 P2):非终态行帧/snapshot 复活 = 新周期开启,旧周期的
- * 终态事实作废 —— 不清账时 factsAccepted 的方向核会拿上周期的 killed/failed 当先例,把
- * 第二周期的合法 completed 整条拒收(status 与 summary 都不入账)。只删本 taskId 键;
- * taskToParent 映射不动(寻址面与事实面分离)。 */
 export declare function clearBgTerminalFacts(taskId: string): void;
 export declare function getBgTerminalFacts(taskId: string): BgTerminalFacts | undefined;
-/** 一行子代的宿主记录。`sessionId` = 登记时刻那条流的会话(per-id 读面要拼 `?session=`)。 */
 export interface SubagentOwnerRecord {
-    /** 宿主引擎 run id(resume / subagentOutput / tail 三条读面寻址的第一段)。 */
     runId: string;
-    /** 登记时的会话 id;缺席即不带 `?session=`(空串按「带了且不匹配」处理 = 404,恒不铸空串)。 */
     sessionId?: string;
-    /**
-     * 🔴 design/285 批 2(D7a):登记时那条流所属的**会话槽键**(`installHostFor(key, …)` 的 key)。
-     *
-     * 为什么记它而不是只记 `sessionId`:读侧要的不只是 `?session=`,还有**打哪台服务器、用谁的
-     * token 与 principal** —— 那三件在 `engineWireTargetFor(sessionKey)` 上,按槽装配。只记会话
-     * 而 wire target 仍走默认槽 = 「会话对了、凭证是别人的」(D7b),per-key 会话锚只做完一半。
-     *
-     * 缺席 ⇒ 读侧回落 `DEFAULT_SESSION_KEY`,与 0.44.0 逐字同(见 `resolveOwnerContext`)。
-     * 🔴 缺席的**唯一**合法来源是「这一写没有通道证据」:兼容入口 `ledger.applyFrame` 每帧现读槽
-     * 会话、库里不留锚,它写进来的行归属不可知,所以两个新位一律不写(与 0.44.0 逐字同)。
-     */
     sessionKey?: string;
 }
-/**
- * 🔴 R6(design/285 §7):同一个 `runId` 上先后被喂进**两个不同**会话时的留痕。
- *
- * 为什么要有:合表后 tick 腿(壳 liveClient 开流时捕获)与 fleet 两腿(ingress 捕获)会写同一条
- * 记录。口径仍是「带值的写照常赢」(last-write-wins),但那不能是**静默**的 —— 两条腿对同一个宿主
- * run 给出不同会话,要么是宿主把两条流的帧喂进了同一本账,要么是某一腿的捕获点写错了,两种都是
- * 承重缺陷。**判据是计数而不是日志**:本 store 是零 import 的内核闭包(见文件头注),而且
- * 「只落日志的告警在测试里等于不存在」(本仓既有裁定,见 `auditRetainWithoutWake` 头注)。
- */
 export interface SubagentOwnerSessionConflict {
     taskId: string;
     runId: string;
-    /** 冲突前记录上的**出身对**(整对记,不是只记会话 —— 换槽键与换会话同样是换出身)。 */
     prior: {
         sessionId?: string;
         sessionKey?: string;
     };
-    /** 这一写带来的出身对(它整对赢)。 */
     next: {
         sessionId?: string;
         sessionKey?: string;
     };
 }
-/** R6 读口:`count` = 累计冲突次数(恒应为 0);`last` = 最后一次的四元组(诚实缺席用 undefined)。 */
 export declare function subagentOwnerSessionConflicts(): {
     count: number;
     last?: SubagentOwnerSessionConflict;
 };
-/**
- * fleet 行帧 / bg 通知腿的登记口(既有两写点)。
- * `sessionId` 是 #242 批 2 additive 补位:缺席则不落键(读面据此判「不带 `?session=`」)。
- * `sessionKey` 是 design/285 批 2 additive 补位,同款「缺席则不落键」。
- *
- * 🔴 **两个新位的值必须来自 ingress 的不可变捕获**(`ledger.issueStream()` 那一刻解析一次),
- *    **不是**每帧现读某个可变槽 —— 逐帧现读会让重连后旧流的迟到帧被登记成 `{旧 runId, 新会话}`,
- *    正是本文件 `recordSubagentOwnerFromProgress` 头注明令禁止的错组合。ingress 的 epoch 闸让旧代际
- *    的帧根本进不来,这才是「原子」的落点。
- */
 export declare function recordBgParentRun(taskId: string, runId: string, sessionId?: string, sessionKey?: string): void;
-/**
- * 「这一行子代的宿主 run」统一登记口(**显式传值**,零推断,见本段头注)。
- * `runId` 缺席/空串 ⇒ 什么都不记(宁可「不知道」也不记一个错的宿主);`taskId === runId`
- * 的退化自指映射同样拒收(顶层 run 行不是任何人的子代)。
- *
- * 🔴 **`sessionId` 的缺席不覆盖在场**(合表的承重口径,#242 批 2 自查抓出):喂本表的三条腿里
- *    **只有 tick 腿带 session**(它在开流时一次性捕获),fleet 行帧腿与 bg 通知腿都不带。合表前
- *    两表各记各的,合表后若让「后到的无 session 写」直接盖掉整条记录,tick 捕获的会话就会被抹掉,
- *    resume 退回「此刻的会话」—— 那正是对抗复审轮5 M1 要防的错组合(旧 runId + 新 sessionId ⇒
- *    session-bound run 上 fail-closed 404)。
- *    口径:**同一 `runId` 上缺席不覆盖在场**(带值的写照常赢);`runId` 真变了 ⇒ 旧 session 必须丢
- *    (那是另一条宿主 run 的会话,留着就是错组合)。
- *
- * 🔴 **`sessionId` 与 `sessionKey` 是一个「出身对」,整对进出**(design/285 批 2,异源对抗复审
- *    [high] 收紧):**这一写带了任一位就整对赢**;**两位都缺席**才走上面那条「缺席不覆盖在场」。
- *    分开 merge(各留各的)会合成一条从来没被同一次捕获产生过的元组 —— 而读侧正是拿这一对去挑
- *    服务器 / 凭证 / 会话,详见函数体里那段头注的两条可达路径。`runId` 变了 ⇒ 整对丢。
- * 🔴 **同 runId 上换出身不静默**(R6):出身对(会话**或**槽键)变了就计 `ownerSessionConflictCount`
- *    并留下两对(读口 {@link subagentOwnerSessionConflicts})。值仍按「带出身的写赢」,变的是它不再无声。
- */
 export declare function recordSubagentOwner(taskId: string, runId?: string, sessionId?: string, sessionKey?: string): void;
-/**
- * `task_progress` 腿的登记口(#242 批 2 ①:收编前本表**零 task_progress 腿**,已直证)。
- *
- * 一条帧进,认得就记,认不得就什么都不做(**绝不改帧**)。只认 `task_progress` —— 引擎侧子代的
- * 累计 tick,带子代自己的 `taskId`。
- *
- * 🔴 **`ownerRunId` / `ownerSessionId` 必须由调用方显式喂**,本函数**不许**从
- *    `activeEngineRunId()` 推断(壳 `subagentOwnerLedger.ts:20-22` 对抗复审轮3 H2 实撞的教训:
- *    进程级值被并发 main/fork 流互相覆写 + 每个 query 的 finally 清空 ⇒ run A 的 tick 可能被
- *    登记到 run B 名下,而错值比缺席更坏)。登记点必须在**持有 stream-local run id 的那个闭包**
- *    里(壳 = `liveClient.ts` 的 `stampSubagentOwners`),把不可变的值传进来。
- * 🔴 `ownerSessionId` 同理**开流时一次性捕获**,不逐帧现读:逐帧现读会让 `/clear`、resume、
- *    会话切换之后晚到的旧流 tick 被登记成 `{旧 runId, 新 sessionId}`,这对组合去 resume 会带着
- *    错 session 打旧 run,fail-closed 404。
- */
 export declare function recordSubagentOwnerFromProgress(ev: unknown, ownerRunId?: string, ownerSessionId?: string, ownerSessionKey?: string): void;
 export declare function getBgParentRun(taskId: string): string | undefined;
-/**
- * 整条宿主记录(runId + 登记时会话)。undefined = **诚实不知道**,调用方渲 no-run 出路 /
- * 不渲入口 —— 绝不在这里回落成「此刻在飞的那条 run」([anchor-on-the-deciding-quantity])。
- */
 export declare function getBgParentRunOwner(taskId: string | undefined): SubagentOwnerRecord | undefined;
-/** 测试钩:清宿主台账(module 级单例,同进程多组断言必须能清)。R6 冲突台账一并清。 */
 export declare function __resetSubagentOwnerLedgerForTests(): void;
 export declare function recordOwnEngineRun(runId: string): void;
 export declare function isOwnEngineRun(runId: string): boolean;
-/** Single consumer (the panel hook). Returns an unsubscribe. */
 export declare function subscribeSubagentContent(fn: (taskId: string) => void): () => void;