@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/workflow.d.ts

@@ -1,51 +1,11 @@
-/**
- * workflow 车道纯函数 + workflow-agent 台账。
- *
- * 沿革(B1 批,2026-07-27):0.2.0 时本文件是 cli `footerRowBelt.ts` / `workflowTaskOutputProjection.ts`
- * 的**双份抄件**;B1 批按设计稿 §2.4.1-A/B 裁决「以壳侧现文件为真身、包内不留两份实现」:
- *   · `parseWorkflowPollEnvelope` / `projectWorkflowTaskOutput` = cli `workflowTaskOutputProjection.ts`
- *     的逐字搬入(0.2.0 抄件漏了 `agent_runs[].errorCode` 类型位,已按真身补齐);
- *   · `rowIdTail` / `isWorkflowAgentTaskId` / `recordWorkflowAgentTaskId` / `isKnownWorkflowAgentTaskId`
- *     = cli `footerRowBelt.ts` 的**belt 半场**(判据①④),按设计稿 §2.4.1-B「拆」搬入。
- *     ⚠️ 留在 TUI 的是 `isFooterTaskRow` / `filterFooterTaskRows`(判据②③)—— 那两条含
- *     「丢弃所有无 parentId 顶层行」的**端专属决策**(主 run 头部行由壳侧 fleetClient 合成渲染,
- *     设计稿 §2.4.2-B),壳侧文件改成 import 本包的四个出口 + 自留那两个函数。
- *   🔴 台账(`workflowAgentTaskIds`)是 module 级单实例:壳侧 bridge 的 task_progress lane 门写、
- *     壳侧 belt 的 `isFooterTaskRow` 读 —— 两边都必须走**本包同一个模块实例**,否则台账写进一个
- *     副本、读另一个副本(判据④ 静默失效,幽灵行回归)。
- *
- * 围栏见 cli 仓 frameLaneGuards / taskOutputWorkflowEnvelope / footerRowBelt 套;
- * [1617] 幽灵行家族的判别资产。
- */
-/** 复合行键(`<runId> <taskId>`,fleet-bus fleetRunPublisher.childId)的尾段 = 引擎 taskId。
- *  导出给壳侧 belt 半场复用(判据②③ 的行 id 归一)。REF-CC-042(fleet2-04,P3 wave2):
- *  `fleetAgentPanelProjection.ts` 曾就地维护同语义私有副本(理由是「保持零依赖」,但该文件早已
- *  import 了 `engineAgentPanelStore.js`,前提本就不成立)——已改 import 本函数,单源。 */
 export declare function rowIdTail(id: string): string;
-/** core 1.356 BCE 合成 workflow-agent id 形:wa+16hex(判据①)。
- *  真实 fleet 子行 id 是 `${runId} ${engineTaskId}` 复合形——必须取空白分隔尾段再匹配
- *  (cli footerRowBelt 原版语义;对抗复审抓的等价性破坏,0.1.1 修)。
- *  upstreamBridge 的 task_progress 前台 lane 门在 wire 无 workflowRunId 时(server <a76bd77,
- *  [1619]:1.272.0 投影白名单仍剥该键)以此为次级判别——与 belt 双判据同模板。 */
 export declare function isWorkflowAgentTaskId(taskId: string): boolean;
 export declare function recordWorkflowAgentTaskId(taskId: string): void;
 export declare function isKnownWorkflowAgentTaskId(taskId: string): boolean;
-/** 测试钩:清台账(壳侧原版无此口——module 级 Set 在壳里靠进程边界隔离;包内多组断言同进程跑,
- *  必须能清,否则前一组的登记污染后一组)。 */
 export declare function __resetWorkflowAgentTaskIdsForTests(): void;
-/**
- * TaskOutput legacy 腿(tool_end 无 structured)的 workflow 信封识别(#49 C3)。
- * 判据=core task-registry formatWorkflowRun 真形:`{task_id, type:"workflow", status, name?, …}`
- * ——type 判别位 + task_id 字符串双门,非该形返回 null(绝不误吞 bash/agent 轮询)。
- */
 export declare function parseWorkflowPollEnvelope(body: string): {
     taskId: string;
     status: string;
     name?: string;
 } | null;
-/**
- * workflow 轮询 JSON → 人话多行投影(agents 汇总行 + per-agent ✓/✗ 明细 + note/error 尾透传);
- * 非 JSON 原样返回(fail-soft,`description [status]` 行仍在)。
- * 输入=引擎 formatWorkflowRun 的 JSON 原文(core 1.352 起带 agent_runs per-agent 明细 + 失败 note 指路)。
- */
 export declare function projectWorkflowTaskOutput(jsonSrc: string): string;

package/dist/workflow.js

@@ -1,41 +1,9 @@
-/**
- * workflow 车道纯函数 + workflow-agent 台账。
- *
- * 沿革(B1 批,2026-07-27):0.2.0 时本文件是 cli `footerRowBelt.ts` / `workflowTaskOutputProjection.ts`
- * 的**双份抄件**;B1 批按设计稿 §2.4.1-A/B 裁决「以壳侧现文件为真身、包内不留两份实现」:
- *   · `parseWorkflowPollEnvelope` / `projectWorkflowTaskOutput` = cli `workflowTaskOutputProjection.ts`
- *     的逐字搬入(0.2.0 抄件漏了 `agent_runs[].errorCode` 类型位,已按真身补齐);
- *   · `rowIdTail` / `isWorkflowAgentTaskId` / `recordWorkflowAgentTaskId` / `isKnownWorkflowAgentTaskId`
- *     = cli `footerRowBelt.ts` 的**belt 半场**(判据①④),按设计稿 §2.4.1-B「拆」搬入。
- *     ⚠️ 留在 TUI 的是 `isFooterTaskRow` / `filterFooterTaskRows`(判据②③)—— 那两条含
- *     「丢弃所有无 parentId 顶层行」的**端专属决策**(主 run 头部行由壳侧 fleetClient 合成渲染,
- *     设计稿 §2.4.2-B),壳侧文件改成 import 本包的四个出口 + 自留那两个函数。
- *   🔴 台账(`workflowAgentTaskIds`)是 module 级单实例:壳侧 bridge 的 task_progress lane 门写、
- *     壳侧 belt 的 `isFooterTaskRow` 读 —— 两边都必须走**本包同一个模块实例**,否则台账写进一个
- *     副本、读另一个副本(判据④ 静默失效,幽灵行回归)。
- *
- * 围栏见 cli 仓 frameLaneGuards / taskOutputWorkflowEnvelope / footerRowBelt 套;
- * [1617] 幽灵行家族的判别资产。
- */
-/** 复合行键(`<runId> <taskId>`,fleet-bus fleetRunPublisher.childId)的尾段 = 引擎 taskId。
- *  导出给壳侧 belt 半场复用(判据②③ 的行 id 归一)。REF-CC-042(fleet2-04,P3 wave2):
- *  `fleetAgentPanelProjection.ts` 曾就地维护同语义私有副本(理由是「保持零依赖」,但该文件早已
- *  import 了 `engineAgentPanelStore.js`,前提本就不成立)——已改 import 本函数,单源。 */
 export function rowIdTail(id) {
     return id.split(/\s+/).pop() ?? id;
 }
-/** core 1.356 BCE 合成 workflow-agent id 形:wa+16hex(判据①)。
- *  真实 fleet 子行 id 是 `${runId} ${engineTaskId}` 复合形——必须取空白分隔尾段再匹配
- *  (cli footerRowBelt 原版语义;对抗复审抓的等价性破坏,0.1.1 修)。
- *  upstreamBridge 的 task_progress 前台 lane 门在 wire 无 workflowRunId 时(server <a76bd77,
- *  [1619]:1.272.0 投影白名单仍剥该键)以此为次级判别——与 belt 双判据同模板。 */
 export function isWorkflowAgentTaskId(taskId) {
     return /^wa[0-9a-f]{16}$/.test(rowIdTail(taskId));
 }
-// ── 判据④:bridge task_progress lane 门台账([1641])────────────────────────────────────────────
-// bridge 的 workflow lane 门(帧带 workflowRunId 的权威判定)把子代 taskId 登记进来,行按尾段查。
-// ③④ 互为兜底:③(集合级双生识别,TUI 半场)不依赖时序但要求 wa 行在场;④ 不依赖 wa 行但要求
-// 本壳在读该 run 的会话流。
 const workflowAgentTaskIds = new Set();
 const MAX_WORKFLOW_TASK_IDS = 4096;
 export function recordWorkflowAgentTaskId(taskId) {
@@ -52,16 +20,9 @@ export function recordWorkflowAgentTaskId(taskId) {
 export function isKnownWorkflowAgentTaskId(taskId) {
     return workflowAgentTaskIds.has(taskId);
 }
-/** 测试钩:清台账(壳侧原版无此口——module 级 Set 在壳里靠进程边界隔离;包内多组断言同进程跑,
- *  必须能清,否则前一组的登记污染后一组)。 */
 export function __resetWorkflowAgentTaskIdsForTests() {
     workflowAgentTaskIds.clear();
 }
-/**
- * TaskOutput legacy 腿(tool_end 无 structured)的 workflow 信封识别(#49 C3)。
- * 判据=core task-registry formatWorkflowRun 真形:`{task_id, type:"workflow", status, name?, …}`
- * ——type 判别位 + task_id 字符串双门,非该形返回 null(绝不误吞 bash/agent 轮询)。
- */
 export function parseWorkflowPollEnvelope(body) {
     try {
         const j = JSON.parse(body);
@@ -69,8 +30,6 @@ export function parseWorkflowPollEnvelope(body) {
             return null;
         return {
             taskId: j.task_id,
-            // 0.72.12 CC-50(#59 A-07):缺 status ⇒ 'unknown'。此前折成 'completed',而 'completed' ∈ WF_TERMINAL ⇒
-            // 消费点顺手 markEngineWorkflowNotified,把真完成通知的补发通道一起缴械。缺席不是终局。
             status: typeof j.status === 'string' && j.status.length > 0 ? j.status : 'unknown',
             ...(typeof j.name === 'string' && j.name.length > 0 ? { name: j.name } : {}),
         };
@@ -79,11 +38,6 @@ export function parseWorkflowPollEnvelope(body) {
         return null;
     }
 }
-/**
- * workflow 轮询 JSON → 人话多行投影(agents 汇总行 + per-agent ✓/✗ 明细 + note/error 尾透传);
- * 非 JSON 原样返回(fail-soft,`description [status]` 行仍在)。
- * 输入=引擎 formatWorkflowRun 的 JSON 原文(core 1.352 起带 agent_runs per-agent 明细 + 失败 note 指路)。
- */
 export function projectWorkflowTaskOutput(jsonSrc) {
     try {
         const j = JSON.parse(jsonSrc);
@@ -91,16 +45,11 @@ export function projectWorkflowTaskOutput(jsonSrc) {
         if (j.agents && typeof j.agents.done === 'number' && typeof j.agents.total === 'number') {
             parts.push(`agents: ${j.agents.done}/${j.agents.total} done${typeof j.agents.failed === 'number' && j.agents.failed > 0 ? ` (${j.agents.failed} failed)` : ''}`);
         }
-        // per-agent 明细([1411]③/[1408] 围栏 M1):✓/✗ label [status] — error 首行/output 摘要。
-        // 缺席(老 core)零行=形状不变。
         if (Array.isArray(j.agent_runs)) {
             for (const r of j.agent_runs) {
                 if (!r || typeof r !== 'object')
                     continue;
                 const label = typeof r.label === 'string' && r.label.length > 0 ? r.label : '(agent)';
-                // 🔴 与 `parseWorkflowPollEnvelope` **同一判**(0.63.1,G-20 附带②):同一条 wire 上的
-                //    同一个字段,两条链路的「在场」判据必须同形。空串走 `typeof` 单门会被当成一个读数
-                //    渲成 `[]` —— 一对什么也没说的方括号,还长得像一个真答案。空串 = 缺席。
                 const st = typeof r.status === 'string' && r.status.length > 0 ? r.status : '?';
                 const errLine = typeof r.error === 'string' && r.error.length > 0
                     ? ` — ${r.error.split('\n')[0].slice(0, 120)}`
@@ -111,7 +60,6 @@ export function projectWorkflowTaskOutput(jsonSrc) {
                 parts.push(`  ${st === 'completed' ? '✓' : st === 'failed' ? '✗' : '·'} ${label} [${st}]${errLine}${outLine}`);
             }
         }
-        // note 尾透传(core 失败指路:TaskOutput+resumeFromRunId)——不留死胡同(围栏 M2)。
         if (typeof j.note === 'string' && j.note.length > 0)
             parts.push(j.note);
         if (typeof j.error === 'string' && j.error.length > 0)

package/dist/workflowClient.d.ts

@@ -1,56 +1,18 @@
 import type { WorkflowRun, WorkflowStreamEvent } from '@sema-agent/sdk';
 import type { WorkflowRunState, WorkflowToolCall } from './workflowMonitor.js';
-/** The live controller the host drives — a projected-snapshot reader + diagnostics + teardown. */
 export interface LiveWorkflowController {
-    /** the latest projected run state, or null (not yet resolved / degraded 501-404 / empty). */
     snapshot(): WorkflowRunState | null;
-    /** connection + degrade diagnostics for the empty/degraded render + verify cross-check. */
     status(): {
         connected: boolean;
-        /** true when the endpoint is unavailable (501 = S8 flag off) / the run is absent (404) / the list is empty. */
         degraded: boolean;
-        /** the HTTP status behind a degrade (501 / 404), else null. */
         code: number | null;
-        /** the resolved workflow run id (null until list()/config resolves one). */
         runId: string | null;
         lastError: string | null;
     };
-    /**
-     * Subscribe to "the projected snapshot changed" — fired on the FIRST successful `get()` and on every
-     * subsequent re-project. Returns an unsubscribe.
-     *
-     * WHY (clay 2026-07-30 症状②「入场蹲卡」): every host polls `snapshot()` on its own 1s interval, so a
-     * `get()` that answered in 50ms still took up to 1s to reach the screen — a purely self-inflicted delay,
-     * and during that window the panel renders its not-yet-resolved fill. The interval stays (it also drives
-     * the wall-clock cells: idle/duration/waiting), but the FIRST resolve no longer waits for a tick.
-     *
-     * 🔴 SUBSCRIBE-AND-RECONCILE: if a snapshot has ALREADY resolved by the time you subscribe, the callback fires
-     * ONCE synchronously from `subscribe` itself. Without this the notify arm and the subscribe arm do not share a
-     * premise — a host that renders (snapshot null) → subscribes in an effect loses the notify entirely whenever
-     * `get()` won that race, and falls back to waiting a full poll tick. That is exactly the residual outlier the
-     * entry-latency fence caught (2 of 3 runs ≈200-340ms, 1 run ≈1026ms = one whole tick).
-     *
-     * Contract: the callback runs INSIDE the source's own loop (or synchronously from `subscribe`) — hosts must only
-     * schedule a re-render from it, never re-enter the controller synchronously. A throwing callback is swallowed so
-     * one bad subscriber cannot kill the background consumer.
-     */
     subscribe(onChange: () => void): () => void;
-    /** abort the underlying SSE stream + stop the background loop (host unmount). */
     dispose(): void;
-    /**
-     * CC-38(0.72.2):把 `snapshot()` 的 `null` 三义**拆开**的读口 —— 宿主此前只能按「问了 N 秒还是 null」猜
-     * (cli 曾以 3 s 宽限窗权宜),现在按 `kind` 分派:
-     *   · `pending`:循环在跑、首发 `get()` 还没答上来(含纯连接错误退避中 —— `lastError` 带原因);**不是**引擎说不可用;
-     *   · `degraded`:引擎**明说** —— 501 端点不可用 / 404 run 不存在或非 owner;`code` 就是那个数字;
-     *   · `empty`:没配 `workflowId` 且 owner 名下零 run(list 空)—— 不是错误,下一轮会再问;
-     *   · `unavailable`:client 根本造不出来(baseUrl / 凭证非法)—— 永远不会答上来,别等;
-     *   · `live`:有快照,`state` 与 `snapshot()` 同一份;
-     *   · `stale`:曾经 live、之后引擎又说 501/404(run 被清)—— `state` 是最后一份快照,`code` 说明为什么不再新鲜。
-     * 纯读、不改内部状态;`snapshot()` 契约不变(live / stale 时非 null,其余 null)。
-     */
     resolution(): WorkflowResolution;
 }
-/** {@link LiveWorkflowController.resolution} 的六态。 */
 export type WorkflowResolution = {
     kind: 'pending';
     lastError: string | null;
@@ -74,104 +36,42 @@ export type WorkflowResolution = {
 };
 export interface LiveWorkflowConfig {
     baseUrl: string;
-    /** Bearer 串,或 `{ mode: 'same-origin-relay' }`([C175],0.29.0)—— 浏览器同源宿主形:凭证由
-     *  同源反代承载,`baseUrl` 该形下可为相对路径;直传 {@link makeEngineWireClient} 的同名放宽位
-     *  (唯一构造点纪律不破:relay 形也走那一个铸口)。串形语义与 0.28.x 字节不变。 */
     authToken: string | {
         mode: 'same-origin-relay';
     };
-    /** SDK Principal(workflows are owner-scoped by principal)。缺席=不发 x-agent-principal 头
-     *  (owner-null,F-011 停发;两侧同缺席仍对齐)。 */
     principal: string | undefined;
-    /** explicit workflow run id; when absent the source picks the first RUNNING run from list() (else the first). */
     workflowId?: string;
-    /**
-     * Test/host injection seam for the underlying HTTP transport (mirrors `EngineWireClientConfig.fetchImpl`
-     * on `makeEngineWireClient` — same purpose, forwarded verbatim). Absent ⇒ the SDK's real `fetch`. Lets a
-     * deterministic fake transport drive `noteDegrade`'s branches without a real socket (REF-CC-153 regression
-     * coverage).
-     */
     fetchImpl?: typeof fetch;
 }
-/** THE projector: SDK `WorkflowRun` (client.workflows.get) → the monitor's `WorkflowRunState`. Pure/total —
- *  tolerates absent/permissive fields and never throws (the graceful-degrade contract lives above, in the
- *  source loop; this just maps a well-formed run). Exported for the mock-parity unit cross-check. */
 export declare function projectWorkflowRun(run: WorkflowRun): WorkflowRunState;
-/** `parks[]` 的一行 —— **恰好三键**,凭据席位在本型上不存在(见上段 ①)。 */
 export interface WorkflowParkRowView {
-    /** 这只 park 属于哪一次调用(与 `agents[].callKey` join 得上)。 */
     callKey: string;
-    /** 停着的那只审批属于哪个会话(宿主按它路由)。 */
     sessionId: string;
-    /** 最初跑出这只 park 的那条 run。 */
     originRunId: string;
-    /**
-     * core 7.18.0 #755(0.68.3 CC-05):这一行**在记录上**,但还没有任何 journal 确认它属于谁 ——
-     * `originRunId` 此时说的是「材料**属于**哪条 run」,不是「在哪条 run 上见过」,消费端**禁**当已确认读。
-     * never-false:确认那一刻上游**删键**(绝不写 `false`)⇒ 缺席 = 已确认(与 7.18.0 之前写的行同读)。
-     * 本包逐字投影(core 顶注:same projection obligation as `parks` —— 丢了就把一条未确认行读成已确认)。
-     */
     originUnconfirmed?: true;
 }
-/**
- * `GET /v1/workflows/:id` 的 `parks[]` → 三键行;**整键缺席 ⇒ `undefined`**(与空数组逐字可分)。
- *
- * 🔴 **`undefined` 与 `[]` 不是一回事**,这是本读器最承重的一格:
- *    · `undefined` —— 这条记录上没有 `parks` 这一键(旧引擎写的)⇒ **证不出**有没有 park;
- *    · `[]`        —— 这条记录有这一键且是空的 ⇒ 一句正面事实:这条 run 上没有 park。
- * 🔴 **坏行只丢自己**(与本包 `wiring_manifest.mcp[]` 的处置同尺):三键缺一 / 非串 / 空串 的行
- *    整条丢弃,其余行保序留下;**非空输入而全部坏行 ⇒ 返回 `[]`**?—— **不**:那会把「读不出」
- *    伪装成「零 park」。全坏 ⇒ `undefined`(诚实缺席)。
- * 🔴 `parks` 不是数组(对象 / 串 / null)⇒ 当整键缺席(非投影口喂进来的形)。
- * 🔴 纯函数、零副作用、**绝不抛**。
- */
 export declare function readWorkflowParks(run: unknown): readonly WorkflowParkRowView[] | undefined;
-/**
- * `GET /v1/workflows/:id` 的 `resumeAdmissionIncomplete`(core 7.18.0 #755,0.68.3 CC-05)——
- * 「这条 resume run 的准入**没有完成**」:记录从创建起带 `true`,准入完成那一刻**删键**。
- *
- * 🔴 **在场 = 不是 resume 基**(引擎自己会拒 `workflow.park_truth_unreadable` / `admission_incomplete`,
- *    且不从它派生候选);缺席 = 每条非 resume run 与每次完成了的准入的常态。⇒ 读者只认在场,
- *    缺席不是断言。never-false:严格 `true` 才算在场,其余一律缺席。
- * 🔴 与 {@link readWorkflowParks} **同一条投影义务**(core 顶注逐字:dropping it turns a refused record
- *    back into an admissible one)—— 端渲 resume 候选 / 面板行时**必须**带上这一位;本包不把它折进
- *    `parks` 的缺席(那一形有自己的两义,见 `readWorkflowParks` 顶注)。
- * 🔴 纯函数、零副作用、绝不抛;坏载体 ⇒ `false`(不是「读不出」:这一位没有第三态)。
- */
 export declare function readWorkflowResumeAdmissionIncomplete(run: unknown): boolean;
-/** 台账里的一个 agent(读口产物,只读快照;缺席 = 不知道,绝不渲成 0/空)。 */
 export interface WorkflowActivityAgentView {
-    /** `ctx.agent` 调用的稳定身份(SSE 主键);老引擎/无 callKey 的帧上缺席。 */
     callKey?: string;
     label: string;
-    /** `agent_end.toolCalls` 权威;缺席时 = `agent_activity` 的 start 相位计数(**下界**)。 */
     toolCalls: number;
-    /** per-toolCallId 折好的 call 序(上限 {@link MAX_WORKFLOW_ACTIVITY_CALLS},超限丢最老)。 */
     activity: WorkflowToolCall[];
     lastToolName?: string;
     lastToolSummary?: string;
-    /** `agent_start.model` —— **请求词原样**(不是生效模型)。 */
     requestedModel?: string;
-    /** `agent_end.modelResolved` —— 实跑模型;core 的 workflow 记录从不折入它 ⇒ GET 结构上到不了。 */
     resolvedModel?: string;
-    /** 尾条 beat 的 ts。 */
     lastProgressAt?: number;
 }
-/** 台账读口产物。`byLabel` **已排除**归属不可判的 label —— 端侧零重名逻辑。 */
 export interface WorkflowActivityLedgerView {
     workflowId: string;
     byCallKey: ReadonlyMap<string, WorkflowActivityAgentView>;
     byLabel: ReadonlyMap<string, WorkflowActivityAgentView>;
-    /** 同 label 多个非 replay 的 agent_start ⇒ 归属不可判(诊断面;`byLabel` 已按它过滤)。 */
     ambiguousLabels: ReadonlySet<string>;
-    /** 流已收口(run 终态 / 显式 stop)——数据保留只读,不再消费。 */
     closed: boolean;
-    /** 已折入的帧数(反空转:0 = 这条台账一帧都没收到,「全都没有」不构成证据)。 */
     frames: number;
-    /** 最近一次 SSE 错误的人话;从没出过错 = null。**诊断面**,不参与归属判定。 */
     lastError: string | null;
 }
-/** 预热口/单流化源共用的连线配置(与 {@link LiveWorkflowConfig} 同域,workflowId 必填)。 */
 export interface WorkflowActivityLedgerConfig {
     baseUrl: string;
     authToken: string | {
@@ -181,31 +81,9 @@ export interface WorkflowActivityLedgerConfig {
     workflowId: string;
     fetchImpl?: typeof fetch;
 }
-/** 台账读口:没有该 id 的台账 ⇒ **null**(不是空视图 —— 「没开过账」与「开了账但一帧没收到」
- *  是两件事,端侧据此分辨)。产物只读,按 frames/closed 缓存。 */
 export declare function readWorkflowActivityLedger(workflowId: string): WorkflowActivityLedgerView | null;
-/**
- * **预热口**(幂等):fleet 流上见到 running workflow 行就调 —— 从 workflow 起跑积累工具事实,
- * monitor 无论何时打开都有自那时起的完整台账。已有台账(哪怕已收口)即早退,**绝不开第二条流**。
- */
 export declare function ensureWorkflowActivityLedger(cfg: WorkflowActivityLedgerConfig): void;
-/** fleet 行终态/remove 的收口口(空流收口是主径;这里防重连定时器竞态)。数据保留只读。 */
 export declare function stopWorkflowActivityLedger(workflowId: string): void;
-/** 测试钩:清空全部台账(abort 在飞流)。 */
 export declare function resetWorkflowActivityLedgers(): void;
-/**
- * 测试钩:**不起 SSE 流**,直接把一帧喂进(缺则新建)指定 run 的台账 —— 折叠规则走产品那一份
- * `foldWorkflowActivityFrame`,不是测试自己抄一份。建出来的台账是 closed 的,后续
- * `ensureWorkflowActivityLedger` 命中它即早退,离线单测因此永不触网。
- */
 export declare function __feedWorkflowActivityFrameForTests(workflowId: string, frame: WorkflowStreamEvent): void;
-/**
- * createLiveWorkflowSource({ baseUrl, authToken, principal, workflowId? }) — the LIVE workflow-monitor source.
- *
- * Constructs the AgentClient and kicks off a background loop that (1) resolves a run id (explicit config, else
- * the first running run from `list()`), (2) snapshots it via `get()` → project → store, and (3) follows
- * `stream()` as a change-ticker (re-`get()` throttled on each frame). Every step is degrade-safe: a 501 (S8
- * off) / 404 (non-owner/absent) / empty list / connection error is RECORDED (status().degraded/code) and
- * leaves `snapshot()` null so the host falls back to the mock/empty state — the source never throws into it.
- */
 export declare function createLiveWorkflowSource(config: LiveWorkflowConfig): LiveWorkflowController;