@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/effectiveFacts.d.ts

@@ -1,62 +1,22 @@
-/**
- * effectiveFacts.ts — 终局回执上两件「引擎生效面」事实的**窄读器**(CC-06 / B-081 包侧半场,0.71.3)。
- *
- * core `TaskResult.effectiveReasoning`(`brain/reasoning.d.ts` `ResolvedReasoning`)与
- * `TaskResult.effectiveMemoryScopes`(`core/task-result.d.ts` 四臂联合)由 server 终帧键集 **verbatim 转发**
- * (`trace/core-keyset-guard.ts` 终帧表 + `observability/run-terminal-log.ts` 两行 `"verbatim"`),但 sdk 的
- * `AgentEvent` d.ts **没建模**这两键 ⇒ 本包按 `_sema_` 超集键投到 CC 形 `result` 上(登记见 `docs/type-superset.json`),
- * 端渲「/effort 有效档」与「记忆面板 memoryless 面」时读它们,不必自己从裸终帧里挖。
- *
- * 🔴 读器纪律(与本包所有 wire 读器同律):坏形 ⇒ **整键不铸**(`undefined`),不折默认档、不折空表;
- *    多余成员不过境(新铸形);`dropped` 只认严格 `true`(core:「Present (true) only when …」never-false)。
- *    纯叶模块:零 import,零 Node 内建(内核闭包不涨)。
- */
-/** core `ResolvedReasoning` 的窄读视图:请求档 / 生效档 / 分级 / 夹取 / wire 形 / 端点 + 整只被丢的判别位。 */
 export interface EffectiveReasoningView {
-    /** 调用方要的档(core `ThinkingLevel`,开集串)。 */
     requested: string;
-    /** 映射到端点真实能力后**生效**的档;与 `requested` 不同即 `clamped`。 */
     effective: string;
-    /** 端点按分级(而非精确档)接受请求。 */
     graded: boolean;
-    /** `effective !== requested`(请求没被精确满足)。 */
     clamped: boolean;
-    /** 请求最终走的 wire 形(如 `anthropic-budget` / `openai-effort`)。 */
     format: string;
-    /** 端点粗标签(如 `anthropic-messages`)。 */
     endpoint: string;
-    /**
-     * 在场 = 请求**根本没带**推理参数(模型不声明推理能力 / 档不在契约里 / budget 路径 cap-wins 跳过)——
-     * 请求的档被**整只丢掉**,不是被夹取。缺席 = 带了(可能夹取)。
-     */
     dropped?: true;
 }
-/** core `EffectiveMemoryScopes` 四臂联合的窄读视图(端只按 `state` 分臂渲)。 */
 export interface EffectiveMemoryScopesView {
-    /** `mounted` = 记忆挂上了;`memoryless` = 该挂没挂上(看 `reason`);`none` = 本就不挂(`no-spec` / `disabled`)。 */
     state: 'mounted' | 'memoryless' | 'none';
-    /** `memoryless`:`mount-failed` / `no-backend`;`none`:`no-spec` / `disabled`;`mounted` 缺席。开集透传。 */
     reason?: string;
-    /** 记忆契约代际;`none` 臂缺席。 */
     contract?: 'v2' | 'legacy';
-    /** 生效的作用域(`mounted` 才非空);坏行逐条丢。 */
     scopes: readonly {
         scope: string;
         origin: 'deployment' | 'request';
     }[];
-    /** 写入作用域;`null` = 没有可写的。 */
     writeScope: string | null;
-    /** `memoryless` + `mount-failed` 时可能带:已物化的残留路径(非串滤)。 */
     materializedResidue?: readonly string[];
 }
-/** `TaskResult.effectiveReasoning` 的窄读:六键形对得上才铸;坏形 ⇒ `undefined`。 */
 export declare function readEffectiveReasoning(v: unknown): EffectiveReasoningView | undefined;
-/**
- * `TaskResult.effectiveMemoryScopes` 的窄读 —— **按臂**验必需成员、按臂构造允许成员(core `task-result.d.ts` 四臂):
- *  · `mounted`:`contract` 必在(v2 | legacy);`scopes` 数组(坏行逐条丢);`writeScope` 串或 null;不带 reason / residue;
- *  · `memoryless`:`reason` ∈ {mount-failed, no-backend} 必在;`scopes` 必为空数组;`writeScope` 必为 null;`contract` 可选;
- *    `materializedResidue` 只在 mount-failed 臂过境(非串滤);
- *  · `none`:`reason` ∈ {no-spec, disabled} 必在;`scopes` 空、`writeScope` null;不带 contract / residue。
- * 结构不成立 ⇒ `undefined`(整键不铸);臂外成员不过境。
- */
 export declare function readEffectiveMemoryScopes(v: unknown): EffectiveMemoryScopesView | undefined;

package/dist/effectiveFacts.js

@@ -1,18 +1,4 @@
-/**
- * effectiveFacts.ts — 终局回执上两件「引擎生效面」事实的**窄读器**(CC-06 / B-081 包侧半场,0.71.3)。
- *
- * core `TaskResult.effectiveReasoning`(`brain/reasoning.d.ts` `ResolvedReasoning`)与
- * `TaskResult.effectiveMemoryScopes`(`core/task-result.d.ts` 四臂联合)由 server 终帧键集 **verbatim 转发**
- * (`trace/core-keyset-guard.ts` 终帧表 + `observability/run-terminal-log.ts` 两行 `"verbatim"`),但 sdk 的
- * `AgentEvent` d.ts **没建模**这两键 ⇒ 本包按 `_sema_` 超集键投到 CC 形 `result` 上(登记见 `docs/type-superset.json`),
- * 端渲「/effort 有效档」与「记忆面板 memoryless 面」时读它们,不必自己从裸终帧里挖。
- *
- * 🔴 读器纪律(与本包所有 wire 读器同律):坏形 ⇒ **整键不铸**(`undefined`),不折默认档、不折空表;
- *    多余成员不过境(新铸形);`dropped` 只认严格 `true`(core:「Present (true) only when …」never-false)。
- *    纯叶模块:零 import,零 Node 内建(内核闭包不涨)。
- */
 const nonEmpty = (v) => typeof v === 'string' && v.length > 0;
-/** `TaskResult.effectiveReasoning` 的窄读:六键形对得上才铸;坏形 ⇒ `undefined`。 */
 export function readEffectiveReasoning(v) {
     if (typeof v !== 'object' || v === null)
         return undefined;
@@ -33,14 +19,6 @@ export function readEffectiveReasoning(v) {
 }
 const STATES = new Set(['mounted', 'memoryless', 'none']);
 const ORIGINS = new Set(['deployment', 'request']);
-/**
- * `TaskResult.effectiveMemoryScopes` 的窄读 —— **按臂**验必需成员、按臂构造允许成员(core `task-result.d.ts` 四臂):
- *  · `mounted`:`contract` 必在(v2 | legacy);`scopes` 数组(坏行逐条丢);`writeScope` 串或 null;不带 reason / residue;
- *  · `memoryless`:`reason` ∈ {mount-failed, no-backend} 必在;`scopes` 必为空数组;`writeScope` 必为 null;`contract` 可选;
- *    `materializedResidue` 只在 mount-failed 臂过境(非串滤);
- *  · `none`:`reason` ∈ {no-spec, disabled} 必在;`scopes` 空、`writeScope` null;不带 contract / residue。
- * 结构不成立 ⇒ `undefined`(整键不铸);臂外成员不过境。
- */
 export function readEffectiveMemoryScopes(v) {
     if (typeof v !== 'object' || v === null)
         return undefined;

package/dist/effortWire.d.ts

@@ -1,13 +1,2 @@
-/**
- * The core ThinkingLevel = the service `reasoningEffort` accept-set (`server.ts:3576`) = the SDK
- * `TaskRequest.reasoningEffort` union. Declared as a literal union (not bare `string`) so the projection's
- * result narrows to exactly what `TaskRequest.reasoningEffort` accepts — a bare `string` would not be
- * assignable to that enum (the false-green tsc hid this; see memory shell-tsc-check-broken-false-green).
- */
 export type ReasoningEffort = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
-/**
- * Project a picked `EffortValue` (string level | number | undefined) → the wire `reasoningEffort`, or
- * undefined to OMIT. Returns the value verbatim iff it is a core ThinkingLevel; everything else (auto,
- * ultracode, numeric efforts, undefined) → undefined so the engine applies its own default.
- */
 export declare function effortToReasoningEffort(effort: unknown): ReasoningEffort | undefined;

package/dist/effortWire.js

@@ -1,19 +1,7 @@
 const REASONING_EFFORT_TUPLE = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
-/**
- * 🔴 [2006] B-CC-2(2026-07-29):`new Set<ReasoningEffort>([…])` 只保证「元素合法」,**从不保证
- * 穷举** —— 往 `ReasoningEffort` 加第八档而这里不跟,编译期一声不吭,运行期那一档被
- * `effortToReasoningEffort` 当成非法值 OMIT 掉 ⇒ 用户拨到的档位静默到不了引擎。补的就是
- * 「类型 → 常量」那半边:两个方向的 `Exclude` 都必须塌成 `never`。
- * `Covers`(REF-CC-145/dup-12,P3 wave1 卡C-argv)改吃共用叶 typePins.ts——四份逐字重复钉之一。
- */
 const _effortPins = [true, true];
 void _effortPins;
 const REASONING_EFFORTS = new Set(REASONING_EFFORT_TUPLE);
-/**
- * Project a picked `EffortValue` (string level | number | undefined) → the wire `reasoningEffort`, or
- * undefined to OMIT. Returns the value verbatim iff it is a core ThinkingLevel; everything else (auto,
- * ultracode, numeric efforts, undefined) → undefined so the engine applies its own default.
- */
 export function effortToReasoningEffort(effort) {
     return typeof effort === 'string' && REASONING_EFFORTS.has(effort) ? effort : undefined;
 }

package/dist/engineAgentPanelStore.d.ts

@@ -1,246 +1,77 @@
-/**
- * ⇄ B1 批搬迁(2026-07-27,多端改造设计稿 §2.4.1-B):cli src/sema/engineAgentPanelStore.ts 逐字搬入(零 import;壳侧改 re-export)。
- * 🔴 同 subagentContentStore:buffer/listener/residentTaskIds 是单实例语义,发布侧(bridge/fleet
- * 投影)与订阅侧(chrome-agentprogress 的面板 hook)必须同实例,否则事件发进一个副本、面板订另一个。
- */
-/**
- * engineAgentPanelStore — dep-free side-channel store bridging ENGINE-side subagent progress
- * (`task_progress` ticks, design/99 MF-10) to CC's CoordinatorTaskPanel (the footer live-agent panel).
- *
- * WHY A STORE (the retryStatusStore / liveQuestionStore pattern): the upstream bridge is a plain
- * generator with no React/AppState access, while the panel reads `AppState.tasks` — so the bridge
- * PUBLISHES neutral events here and a sema-owned hook inside chrome-agentprogress.tsx (already mounted
- * under the footer) SUBSCRIBES and applies them to AppState via registerTask/updateTaskState. CC files
- * stay verbatim; the AppState write side lives in the sema override that owns the panel.
- *
- * WHY THE PANEL (CC-187 parity): a local sync AgentTool renders an inline progress TRAIL from the
- * subagent's real messages. An engine tick carries ONLY rollup numbers ({toolUses, totalTokens}) — the
- * exact shape of CC's `AgentProgress` — and CC's own precedent for out-of-process agents (remote agent
- * tasks) is the TASK PANEL + task-notification, not a synthetic inline trail. Faithful mapping, no
- * fabricated subagent messages.
- *
- * Buffering: ticks published before the panel mounts are buffered (bounded) and replayed to the first
- * subscriber, so early frames in a fast turn aren't lost to mount timing.
- */
 export type EngineAgentPanelEvent = {
     kind: 'tick';
     taskId: string;
-    /** Subagent display name off the wire tick (redacted upstream); absent ⇒ keep taskId. */
     name?: string;
-    /** The delegating Task tool_use's `description` (the card title), when the bridge could bind one. */
     description?: string;
-    /** The delegated prompt off the bound tool_use input, when present. */
     prompt?: string;
-    /** core 1.262.0 [558]B (service 1.154.0 wire) — the child's most recent tool intent as ONE
-     *  human line ("Bash npm test"), service-redacted. The panel consumer maps it onto the row's
-     *  `progress.summary` (CC's own live-activity display slot); absent ⇒ slot untouched. */
     currentAction?: string;
     toolUses: number;
     totalTokens: number;
-    /**
-     * 0.75.1 —— 派生这只子代时**被调用方声明的名字**(wire `task_progress.spawnName`,engine 侧新位)。
-     * 🔴 与 `name` 是两位,别合流:`name` 是**展示名**(上游由委派卡的 description 派生),本位是 spawn 时的名字。
-     * 🔴 缺席 = **旧形**(产生者还没有这一位)⇒ 键不落,绝不拿展示名冒充。
-     */
     spawnName?: string;
-    /**
-     * 0.74.3 CC-70:tick 上带的委派卡 id(wire `task_progress.parentToolCallId`,在场才带)—— 身份归一的**退路键**
-     * (`transcriptId` 查不到时按它反查 fleet 尾段)。
-     */
     parentToolCallId?: string;
-    /**
-     * 0.74.3 CC-70(**发布方提示键**,消费端忽略):`true` = 这条 tick 绑在本 turn 一张仍开着的委派卡上(同步委派形)。
-     * 身份归一的漏斗据此决定「查不到 fleet 尾段时直发还是缓一拍」:绑卡的子代不会有 fleet 行要等。
-     */
     cardBound?: true;
-    /**
-     * 0.74.3 CC-70:**归一后**才有 —— 这条事件在 wire 上原来的 `taskId`(引擎 UUIDv7 = transcriptId);
-     * `taskId` 已改写成 fleet 行 id 尾段。在场 = 改写过;缺席 = 原样。
-     */
     wireTaskId?: string;
-    /**
-     * 0.74.3 CC-70:这条 tick 的 `taskId` 是哪一把身份 —— `'fleet-row'` = 已归一到 fleet 尾段(与 fleet-row / 通知 end /
-     * 壳本地 agentId 同键);`'wire'` = 反查不到,原样发(同步委派子代 / 老 server 行帧无 transcriptId / fleet 行还没到)。
-     * tick 恒带(它只有一个铸点 = task_progress);`end` 只在归一时带。
-     */
     taskIdOrigin?: 'fleet-row' | 'wire';
 } | {
-    /**
-     * 行帧 lane 投影(2026-07-26 「后台 Agent 子代不进 Background 面板」案)。
-     *
-     * 一手取证(verify/_bgagent-panel-lane-live-pty.mjs 首跑,engine 1.277.4 真机):两个
-     * `run_in_background:true` 的 fork 子代**活跃干活整跑**,`task_progress` tick 探针 **0 条**、
-     * fleet 行帧探针 **24 条** —— 父 turn 秒收口即关 SSE,子代的 tick 根本没有通道到壳;行帧
-     * lane(常开 fleet stream)才是后台子代唯一在场的 lane。面板的 local_agent 行此前**只**由
-     * tick 注册 ⇒ 产品自印的「N background agents launched (↓ to manage)」指向一个看不到它们的
-     * 面板(还顺带让 `ctrl+x ctrl+k … stop all agents` 的渲染门在真产品里永不成立)。
-     *
-     * 为什么是独立事件形而不是复用 'tick':两条 lane 的**可选性**不同 —— tick 的 `toolUses` 是
-     * 必填数,行帧的是**可选**位(server 1.278.0 才有,老引擎没有)。复用 tick 会强迫本 lane 在
-     * 缺席时编一个 0,把前台子代由真 tick 写进去的进度数字每秒清一次。消费端对本事件的规矩:
-     * 只建/只喂**本 lane 亲手建的行**,tick 一到就永久让位(fleetOwnedRowIds 摘除)。
-     */
     kind: 'fleet-row';
     taskId: string;
-    /** 行帧 agentType(fleet 行 label 列,如 'fork')→ 行的 agentType。 */
     name?: string;
-    /** 行帧投影出的任务描述(如 'alpha-probe')→ 行的 description(面板行 label)。 */
     description?: string;
-    /** core 1.429 → server 1.288([1831]②):子代当前工具的结构化形。`toolName` verbatim
-     *  (查壳工具注册表),`target` 已上游 redact + 300 bound。缺席=旧端或子代从未跑过工具。 */
     currentTool?: {
         toolName: string;
         target?: string;
     };
-    /** 行帧累计 token。 */
     totalTokens?: number;
-    /**
-     * server 1.278.0 起行帧也带的**累计**工具调用数(修「后台子代详情页 tool 计数恒 0」)。
-     *
-     * 🔴 三态,别写 `?? 0`:
-     *   · 键在 ⇒ 真值(含真 0 = 引擎说「一个工具都没跑」);
-     *   · 键不在 ⇒ 老引擎没这个位 = **不知道**,消费端如实留空/保留行上已有值,绝不写 0。
-     * 🔴 **累计不是增量**:bg sink 的 usage 是累计口径(与 `turn_end` 的每轮增量相反,后者在
-     *    upstreamBridge 里要累加)——消费端直接赋值,绝不 `+=`。
-     *
-     * ⚠️ 时序差(server 主动提醒,不是接错):1.278.0 只在 **bg lane** 上线;workflow/subagent
-     * 子代走的 `task_progress`(tick lane)的 `usage.toolUses` 在 core 类型里本来就必填、数据一直
-     * 在,只是那条 lane 也没发 —— 已补齐但搭 1.278.0 之后的下一车。所以短期内「有的行有、有的
-     * 行没有」是**预期形**,两条 lane 的接线口径已按同一套三态写好。
-     */
     toolUses?: number;
-    /**
-     * server 1.278.0 `transcriptId`(= core 铸的子代 childSessionId)—— 转录锚,**不是** prompt。
-     * 委派 prompt 走它:壳侧凭这个 id 去转录读面取首条 user 消息(engineDelegatedPrompt.ts),
-     * 修「详情页 Prompt 段恒空」。缺席 ⇒ 维持现状(诚实留白)。
-     */
     transcriptId?: string;
-    /**
-     * server 1.250 起行帧带的 launch 真锚(epoch ms)。R4(clay 五报 07-31):此前投影层丢弃它,
-     * 详情页 elapsed 只能锚「壳建行时刻」(createTaskStateBase 的 Date.now())——遗留/重挂行上
-     * 渲出 1h+ 假时长。消费端拿到即覆盖行的 startTime;缺席 ⇒ 老引擎,维持现状。
-     */
     startedAt?: number;
-    /**
-     * 0.74.0 —— 这一行的**代际号**(引擎的 stop-cycle 计数;fleet 行帧 `cycleSeq` 与后台通知 `seq` 同域同轴:
-     * 首次派发 = 1,每次复活 +1)。消费端把它记在行上,用 {@link isStaleEngineAgentPanelEnd} 判 `end` 是不是上一周期迟到的。
-     * 🔴 缺席 = 这一行**没有代际概念**(同步委派子代 / workflow agent / 顶层 run / 老引擎),**不是第一代**。
-     */
     cycleSeq?: number;
-    /**
-     * 0.74.3 CC-70:行帧上的委派卡 id(sdk `FleetTaskRow.parentToolCallId`,在场才带)—— 与 tick 的同名键是同一把钥匙,
-     * 身份归一的退路(`transcriptId` 缺席时凭它把 task_progress 的 UUID 反查到本行)。
-     */
     parentToolCallId?: string;
-    /** 0.74.4 CC-83:先发布的键为准 —— 这个子代已按 UUID 上屏时,行帧的 `taskId` 改写成那把 UUID,原尾段进这里;缺席 = 未改写。 */
     wireTaskId?: string;
     taskIdOrigin?: 'wire';
 } | {
     kind: 'end';
     taskId: string;
     isError: boolean;
-    /**
-     * 0.74.0 —— 这条终态属于**哪一个周期**。同一个 taskId 可以复活;没有周期身份时,上一周期迟到的 `end` 会把
-     * 复活后的新一轮结掉。fleet 行车道与通知车道在 wire 给了的时候带;**流内 close 臂没有这个概念,恒缺席**。
-     * 读法单源:{@link isStaleEngineAgentPanelEnd}。缺席 ⇒ 判不出 ⇒ 按现行为 settle(不因缺席丢一条真终态)。
-     */
     cycleSeq?: number;
-    /** 0.74.0 —— 同上,launch 锚(epoch ms);只有 fleet 行车道带得出。 */
     startedAt?: number;
-    /** The subagent's FINAL REPORT — the delegating Task/Agent card's `tool_end.output` text (only the
-     *  explicit close arm carries it; the defensive sweeps settle without one). The consumer persists it
-     *  on the row (task.result) + appends it to a live-viewed transcript (拍1 查看态 seed). */
     report?: string;
-    /** 0.74.3 CC-70:同 tick 臂 —— 归一后才有(流内 close 臂 / 终态 tick 的 `end` 带的是 UUID,改写成 fleet 尾段时记原词)。 */
     wireTaskId?: string;
-    /** 0.74.3 CC-70:归一时带 `'fleet-row'`;0.74.4 CC-83:尾段被改写成先发布的 UUID 时带 `'wire'`(原尾段进 `wireTaskId`);其余不带。 */
     taskIdOrigin?: 'fleet-row' | 'wire';
 } | {
-    /** Exception-path safety net (published by seamQuery after every turn, throw or return):
-     *  the consumer settles ALL rows it owns that are still running. Idempotent. */
     kind: 'sweep';
 };
-/**
- * 两条 lane 对 `toolUses` 的口径(运行期读面,给门用;上面的编译钉保证它没在撒谎)。
- * `required-engine-always-emits` = 缺席不可达 ⇒ 兜底值合法;
- * `optional-tolerate-absent`     = 缺席即「不知道」⇒ 必须传播缺席(键不落)。
- */
 export declare const PANEL_TOOLUSES_LANE_POLICY: Readonly<Record<'tick' | 'fleet-row', string>>;
 export declare function markEnginePanelTaskResident(taskId: string): void;
 export declare function clearEnginePanelTaskResident(taskId: string): void;
 export declare function isEnginePanelTaskResident(taskId: string): boolean;
 type Listener = (ev: EngineAgentPanelEvent) => void;
-/**
- * 0.74.5 CC-87 —— 「这一帧是不是**新周期**」的单源判据(`isStaleEngineAgentPanelEnd` 的对偶,壳侧此前各拼一份):
- *   · 两边都带 `cycleSeq` ⇒ **只**比它:不等 ⇒ 新周期;
- *   · 否则两边都带 `startedAt` ⇒ 不等 ⇒ 新周期;
- *   · 任一边判不出 ⇒ **不是**新周期(这一帧没说,不算变化 —— 方向与陈旧判据相同:缺席不制造周期)。
- * 与缓冲合并屏障(`launchAnchorChanged`)同一条规则;消费端在 `fleet-row` 到时拿行上记的身份与帧上的身份调它。
- */
 export declare function isNewEngineAgentPanelCycle(prev: EngineAgentPanelCycleIdentity | null | undefined, next: EngineAgentPanelCycleIdentity | null | undefined): boolean;
-/** 周期身份的一格(`end` 事件上的,或消费端记在行上的当前周期)。 */
 export interface EngineAgentPanelCycleIdentity {
     readonly cycleSeq?: number;
     readonly startedAt?: number;
 }
-/**
- * 0.74.0 —— 这条 `end` 是不是**上一周期迟到的**(单源判据,三端共用)。`current` = 消费端记在行上的当前周期
- * (取自最近一条 `fleet-row` 的 `cycleSeq` / `startedAt`)。
- *   · 两边都有 `cycleSeq` ⇒ **只**比它:`end` 更小 ⇒ 陈旧;
- *   · 否则两边都有 `startedAt` ⇒ `end` 更早 ⇒ 陈旧;
- *   · 任一边判不出(流内 close 臂的 `end` / 没有代际概念的行 / 老引擎 / 坏形)⇒ **不陈旧** —— 按现行为 settle。
- *     方向是宁可照旧也不因为缺席丢掉一条真终态。
- * 陈旧的 `end`:忽略(不 settle、不写 report、不摘所有权)。
- */
 export declare function isStaleEngineAgentPanelEnd(end: EngineAgentPanelCycleIdentity | null | undefined, current: EngineAgentPanelCycleIdentity | null | undefined): boolean;
-/** 缓一拍的节拍上限:别的 fleet-row / end / sweep 每过一条算一拍(别的 tick 不算)。 */
 export declare const MAX_HELD_WIRE_TICK_BEATS = 16;
-/** 身份归一的读数:`taskId` = 该用的键;`origin` = 它是哪一把。 */
 export interface EnginePanelTaskIdentity {
     readonly taskId: string;
     readonly origin: 'fleet-row' | 'wire';
-    /** 钥匙上记的周期身份(登记它的那条 fleet-row 带的);`origin:'wire'` 时恒缺席。 */
     readonly cycleSeq?: number;
     readonly startedAt?: number;
 }
-/**
- * 0.74.3 CC-70:把 wire 上的子代 id(task_progress 的 UUID)反查成 fleet 行 id 尾段;`transcriptId` 表优先,退 `parentToolCallId` 表;
- * 都查不到 ⇒ 原样(`origin:'wire'`)。fleet 尾段本身传进来也原样(它就是目标键)。
- */
 export declare function resolveEnginePanelTaskId(wireTaskId: string, parentToolCallId?: string): EnginePanelTaskIdentity;
-/**
- * 0.74.3 CC-70(异源复审 R3 [high]):按 wire 上的子代 id 清常驻标 —— 原键照清;归一到 fleet 尾段的那把键**只在这条终态属当代时**才清:
- * 复活后迟到的前代终态(旧 UUID 的流内 close / 终态 tick)归一后带旧代际,清了尾段键 = 撤掉复活行的 sweep 保护 ⇒ 下一次 sweep 假结它。
- * 判据与 `end` 的陈旧判据同一只(`isStaleEngineAgentPanelEnd`,拿钥匙上的周期对最近一条行帧的周期);判不出 ⇒ 照清(不因缺席留下永久常驻)。
- * `cycle`(0.74.4):调用方(通知车道)带得出这条终态的周期时传进来 —— 尾段归某把 UUID 所有而通知比所有权旧 ⇒ 不清那把 UUID 的常驻标。
- */
 export declare function clearEnginePanelTaskResidentByWire(wireTaskId: string, cycle?: EngineAgentPanelCycleIdentity): void;
-/**
- * 测试钩。逐表清单(每加一张表同批更新这里):① 转录钥匙表(UUID → 行尾段)② 父调用钥匙表(parentToolCallId → 行尾段)
- * ③ 缓着的未绑卡 tick ④ 每行最近一次行帧的周期水位 ⑤ 「先发布的键」集合(UUID)⑥ 同上按父调用记的那一份 ⑦ 反向所有权表(行尾段 → UUID)。
- * 🔴 不清:订阅者 / 回放缓冲、常驻标、running 历史(那一本由 `__resetPanelRunningHistoryForTests` 清)。
- * 🔴 连续场景(同一只子代跨多步的用例)**中途别调**:清掉 ④–⑦ 之后,陈旧判据与「先发布的键为准」都会从零开始,前后两半不再是同一段历史。
- */
 export declare function __resetEngineAgentPanelIdentityForTests(): void;
-/** 宿主的唯一发布口(三条 lane 都经这里):先归一身份,再进主通道(订阅者 / 缓冲)。 */
 export declare function publishEngineAgentPanelEvent(ev: EngineAgentPanelEvent): void;
-/** Single consumer (the panel hook). Replays any buffered events, returns an unsubscribe. */
 export declare function subscribeEngineAgentPanel(fn: Listener): () => void;
-/** 缺席上报的载荷(独立订阅口;**没有** `kind` 位 —— 它不属于主通道联合)。 */
 export interface EngineAgentPanelAbsence {
     taskId: string;
-    /** 最后一次在投影里见到这一行的钟(epoch ms)。 */
     lastSeenAtMs: number;
-    /** 发出这条上报时已缺席多久(ms;> `ABSENT_SETTLE_MS`)。 */
     absentForMs: number;
-    /** 0.74.4 CC-83:`taskId` 被改写成先发布的 UUID 时,原尾段在这里;缺席 = 按尾段发。 */
     wireTaskId?: string;
 }
 type AbsenceListener = (ev: EngineAgentPanelAbsence) => void;
-/** 发布一条缺席上报(由 `projectFleetAgentRows` 的缺席路径调;消费者抛错不反噬投影)。 */
 export declare function publishEngineAgentPanelAbsence(ev: EngineAgentPanelAbsence): void;
-/** 单消费者(面板 hook)。订阅即回放缓冲,返回取消订阅。不订阅 = 行为与 0.72.11 的壳完全相同(行停在最后已知态)。 */
 export declare function subscribeEngineAgentPanelAbsence(fn: AbsenceListener): () => void;
-/** 测试钩:清缺席口的订阅与缓冲。 */
 export declare function __resetEngineAgentPanelAbsenceForTests(): void;
 export {};