langchain_agentx_stream_ui 0.2.7 → 0.3.2

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, PointerEventHandler } from 'react';
-import { q as Source, L as LangchainAgentEvent, N as NodeRegistry, v as TierOverrides, I as InteractionBus, M as MarkdownRenderer, p as SessionTree, l as SessionStatus, R as ReducerError, r as SourceEventContext, T as Task, t as TaskPhase, E as EventTier } from './multi-session-xvSZstSN.js';
-export { C as CommonFields, D as DEFAULT_EVENT_TIERS, a as EventType, b as InteractionBusHandlers, c as MarkdownRendererProps, d as MultiAgentSession, e as MultiAgentSessionProps, f as MultiSessionSourceConfig, g as MultiSessionStore, h as MultiSessionStoreOptions, i as MultiSessionStoreState, j as NodeWidget, k as NodeWidgetProps, P as PermissionResolvePayload, S as SessionSlice, m as SessionStore, n as SessionStoreOptions, o as SessionStoreState, s as SourceHandler, u as TaskStatus, w as createActiveSessionBridge, x as createEmptyTree, y as createInteractionBus, z as createMultiSessionStore, A as createSessionStore, B as getNoopInteractionBus, F as useActiveSession, G as useSessionIds } from './multi-session-xvSZstSN.js';
-import { T as ToolDisplayRegistry, P as PermissionUiMode, b as DisplayMode, c as ProjectionContext, R as RenderableEntry, C as CanonicalNodeRef } from './sessionViewOptions-WM00Fpcn.js';
-export { a as CollapsedExplorePayload, D as DEFAULT_SESSION_VIEW_OPTIONS, S as SessionViewOptions, d as ToolUseSnapshot, e as buildProjectionContext, f as buildProjectionViewContext, g as createDefaultToolRegistry, h as createProjectionContext, r as resolveEffectiveToolBodyMode, s as shouldApplyGrouping, i as shouldShowExploreDetail } from './sessionViewOptions-WM00Fpcn.js';
+import { q as Source, L as LangchainAgentEvent, N as NodeRegistry, v as TierOverrides, I as InteractionBus, M as MarkdownRenderer, p as SessionTree, R as ReducerError, r as SourceEventContext, T as Task, t as TaskPhase, l as SessionStatus, E as EventTier } from './multi-session-CerO558Y.js';
+export { C as CommonFields, D as DEFAULT_EVENT_TIERS, a as EventType, b as InteractionBusHandlers, c as MarkdownRendererProps, d as MultiAgentSession, e as MultiAgentSessionProps, f as MultiSessionSourceConfig, g as MultiSessionStore, h as MultiSessionStoreOptions, i as MultiSessionStoreState, j as NodeWidget, k as NodeWidgetProps, P as PermissionResolvePayload, S as SessionSlice, m as SessionStore, n as SessionStoreOptions, o as SessionStoreState, s as SourceHandler, u as TaskStatus, w as createActiveSessionBridge, x as createEmptyTree, y as createInteractionBus, z as createMultiSessionStore, A as createSessionStore, B as getNoopInteractionBus, F as useActiveSession, G as useSessionIds } from './multi-session-CerO558Y.js';
+import { T as ToolDisplayRegistry, P as PermissionUiMode, b as DisplayMode, c as ProjectionContext, R as RenderableEntry, C as CanonicalNodeRef } from './sessionViewOptions-DQRzPuN_.js';
+export { a as CollapsedExplorePayload, D as DEFAULT_SESSION_VIEW_OPTIONS, S as SessionViewOptions, d as ToolUseSnapshot, e as buildProjectionContext, f as buildProjectionViewContext, g as createDefaultToolRegistry, h as createProjectionContext, r as resolveEffectiveToolBodyMode, s as shouldApplyGrouping, i as shouldShowExploreDetail } from './sessionViewOptions-DQRzPuN_.js';
 import { a as ToolBodyMode } from './types-BEXSHQG7.js';
 export { T as ToolBodyComponent, b as ToolDisplayProps } from './types-BEXSHQG7.js';
 import { StoreApi } from 'zustand/vanilla';
 export { DEFAULT_ESTIMATE_SIZE, DEFAULT_VIRTUALIZE_THRESHOLD, SessionTimeline, SessionTimelineProps, VirtualTimeline, VirtualTimelineProps } from './virtual.js';
-export { A as AgentToolBody, a as AskUserQuestionToolBody, B as BashToolBody, D as DefaultToolBody, E as EditToolBody, G as GlobToolBody, b as GrepToolBody, R as ReadToolBody, S as SkillToolBody, W as WebFetchToolBody, c as WebSearchToolBody, d as WriteToolBody, f as formatToolTitle, r as resolveToolBody } from './AskUserQuestionToolBody-BG1StdvE.js';
+export { A as AgentToolBody, a as AskUserQuestionToolBody, B as BashToolBody, D as DefaultToolBody, E as EditToolBody, G as GlobToolBody, b as GrepToolBody, R as ReadToolBody, S as SkillToolBody, W as WebFetchToolBody, c as WebSearchToolBody, d as WriteToolBody, f as formatToolTitle, r as resolveToolBody } from './AskUserQuestionToolBody-CUXqUkar.js';
 import { S as SessionNode, a as SessionNodeKind } from './nodes-BcyPw6Fr.js';
 export { E as ErrorNode, N as NodeDetail, P as PermissionNode, R as ReasoningNode, b as StepDetail, c as StepNode, d as SubAgentNode, T as TextNode, h as ToolCallNode, U as UnknownNode } from './nodes-BcyPw6Fr.js';
 export { B as BodyBlock, a as BodyBlockList, D as DiffView, M as MAX_PREVIEW_LINES, b as MarkdownBlock, T as TruncatedContent, c as buildBashBodyBlocks, d as displayPath, f as formatDiffFromStrings, e as formatPatternTitle, g as formatSearchResultBody, h as formatTimeoutFooter, p as parseDiffText, t as truncateCommand } from './MarkdownBlock-CcXZ5nTm.js';
@@ -48,9 +48,11 @@ interface AgentSessionProps {
     exploreFullscreenBash?: boolean;
     memoryDir?: string | null;
     workspaceRoot?: string | null;
+    /** D34 P2 LeakGate synthesize；默认 false */
+    subagentLeakGate?: boolean;
     children?: ReactNode;
 }
-declare function AgentSession({ source, initialEvents, registry, tierOverrides: _tierOverrides, onError, autoReconnect: _autoReconnect, debug, virtualized, virtualizeThreshold, interactionBus, toolDisplayRegistry, defaultBodyMode, groupParallelTools, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, children, }: AgentSessionProps): react_jsx_runtime.JSX.Element;
+declare function AgentSession({ source, initialEvents, registry, tierOverrides: _tierOverrides, onError, autoReconnect: _autoReconnect, debug, virtualized, virtualizeThreshold, interactionBus, toolDisplayRegistry, defaultBodyMode, groupParallelTools, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, subagentLeakGate, children, }: AgentSessionProps): react_jsx_runtime.JSX.Element;
 
 interface AgentLoopViewProps {
     /** 传入时使用隔离 store（workflow scoped）；省略则使用上层 SessionStoreContext */
@@ -94,37 +96,6 @@ interface WorkflowScaleOptions {
 }
 declare const DEFAULT_WORKFLOW_SCALE_OPTIONS: WorkflowScaleOptions;
 
-interface WorkflowSessionProps {
-    source: Source;
-    initialEvents?: LangchainAgentEvent[];
-    registry?: NodeRegistry;
-    tierOverrides?: TierOverrides;
-    onError?: (error: Error) => void;
-    interactionBus?: InteractionBus;
-    toolDisplayRegistry?: ToolDisplayRegistry;
-    defaultBodyMode?: ToolBodyMode;
-    permissionUiMode?: PermissionUiMode;
-    markdownRenderer?: MarkdownRenderer;
-    displayMode?: DisplayMode;
-    verbose?: boolean;
-    exploreFullscreenBash?: boolean;
-    memoryDir?: string | null;
-    workspaceRoot?: string | null;
-    virtualized?: boolean;
-    virtualizeThreshold?: number;
-    groupParallelTools?: boolean;
-    /** P1–P4：大规模 workflow 缩放选项 */
-    workflowScale?: Partial<WorkflowScaleOptions>;
-    /** P2：展开已淘汰 loop 时由宿主 replay 事件 */
-    onRequestLoopReplay?: WorkflowLoopReplayHandler;
-    /** SSE 流正常结束（传输 resolve）；与 status=done 互补，供宿主解锁 loading */
-    onStreamComplete?: () => void;
-    children?: ReactNode;
-}
-declare function WorkflowSession({ source, initialEvents, registry, tierOverrides, onError, interactionBus, toolDisplayRegistry, defaultBodyMode, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, virtualized, virtualizeThreshold, groupParallelTools, workflowScale, onRequestLoopReplay, onStreamComplete, children, }: WorkflowSessionProps): react_jsx_runtime.JSX.Element;
-
-declare const WorkflowScaleContext: react.Context<WorkflowScaleOptions>;
-
 /**
  * workflowDisplay.ts — SDK WorkflowDisplayPayload 契约（TS）
  *
@@ -214,22 +185,6 @@ interface WorkflowContainerTreeState {
     containersById: Record<string, WorkflowContainerRuntimeNode>;
 }
 
-interface WorkflowStageListPartition {
-    visible: WorkflowContainerRuntimeNode[];
-    hiddenCount: number;
-    total: number;
-    /** 当前已展示的 done stage 数量 */
-    visibleDoneCount: number;
-    /** done stage 总数 */
-    totalDoneCount: number;
-}
-/**
- * P3：running / failed / pending / blocked 全显；
- * done 按 maxVisibleDoneCount 分页展示（默认最近 completedStagePageSize 条）。
- * maxVisibleDoneCount 由 WorkflowStageListPanel 的 "Show N more" 逐页递增。
- */
-declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[], maxVisibleDoneCount: number, containersById?: Record<string, WorkflowContainerRuntimeNode>): WorkflowStageListPartition;
-
 /**
  * workflowSession.ts — Workflow 会话顶层状态
  *
@@ -245,6 +200,41 @@ declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[],
 
 /** SDK v1.9.0 根 workflow 终态语义 SSOT */
 type WorkflowTerminalKind = 'healthy' | 'forced_closeout' | 'failed';
+/** 宿主业务权威快照 — 唯一控制面输入（D33） */
+type WorkflowAuthorityStatus = 'pending' | 'running' | 'done' | 'error' | 'canceled' | 'partial_success';
+interface WorkflowAuthoritySnapshot {
+    taskId: string;
+    status: WorkflowAuthorityStatus;
+    updatedAt: number;
+    metadata?: {
+        failed_items?: string[];
+        cleanup_failures?: Array<{
+            action: string;
+            error: string;
+        }>;
+        execution_authority?: true;
+        orphan_items_reaped?: number;
+        partial_success_kind?: string;
+        projection_status?: 'complete' | 'degraded' | 'running';
+        projection_dropped_count?: number;
+    };
+}
+/** 纯投影 / 传输展示态 — 不可驱动宿主 phase（D33） */
+type WorkflowDisplayProjectionStatus = 'connecting' | 'running' | 'done' | 'error' | 'done_with_warning';
+interface WorkflowDisplayProjection {
+    /** SSE 字节流是否已结束（transport） */
+    streamEnded: boolean;
+    /** 投影推断的编排展示态（workflow-end / 容器树；缺帧时不 infer done） */
+    projectionStatus: WorkflowDisplayProjectionStatus;
+    terminalKind: WorkflowTerminalKind | null;
+    openChildIdentities: string[];
+    /** streamEnded 且 authority 仍 running 超过阈值时的展示降级 */
+    awaitingAuthority?: boolean;
+    /** streamEnded + running 超过 120s 仍无 authority terminal */
+    authoritySyncFailed?: boolean;
+    /** authoritySource.subscribe 抛错时的展示降级 */
+    authoritySubscribeFailed?: boolean;
+}
 /** P2：stage 完成摘要缓存（loop 树淘汰后仍显示 teaser） */
 interface CachedStageDoneSummary {
     label: string;
@@ -281,11 +271,10 @@ interface WorkflowScopeFrame {
     loopSessionId: string | null;
 }
 interface WorkflowSessionState {
-    status: SessionStatus;
-    /** SDK v1.9.0 根终态语义；stream 推断 done 时为 null */
-    terminalKind: WorkflowTerminalKind | null;
-    /** forced_closeout 时 SDK 写入的未关闭 child scope */
-    openChildIdentities: string[];
+    /** 宿主注入；Reducer 禁止写入 */
+    authority: WorkflowAuthoritySnapshot | null;
+    /** 事件投影 + 传输展示；不可驱动 phase */
+    display: WorkflowDisplayProjection;
     meta: {
         workflowRunId: string | null;
         startedAt: number | null;
@@ -301,12 +290,176 @@ interface WorkflowSessionState {
     /** P2：completed hydrated loop LRU 热缓存（最近使用在数组尾部） */
     hotCompletedLoopSessionIds: string[];
     activeLoopSessionId: string | null;
+    /** D36 P4：snapshot hydrate 后的 tail 游标 */
+    projectionCursor: string | null;
+    snapshotVersion: number | null;
+    reconnectSuppressedReason: string | null;
+    /** D36 T6：snapshot 404/409 时展示降级，禁止 history fallback */
+    snapshotHydrateFailed: boolean;
     /** @deprecated P1 起由 containerTree.activeContainerIds 替代 */
     openScopeStack: WorkflowScopeFrame[];
     internalErrors: ReducerError[];
 }
 declare function createEmptyWorkflowSessionState(): WorkflowSessionState;
 
+/**
+ * workflowSnapshot.ts — WorkflowDisplaySnapshot DTO（D36 P3）
+ *
+ * 职责：
+ *     remount hydrate SSOT；与 AgentEvent 协议独立。
+ *
+ * 链路位置：
+ *     GET /projection/snapshot → hydrateWorkflowFromSnapshot（P4）。
+ *
+ * 当前裁剪范围：
+ *     类型定义 + fixture 契约；不含 hydrate 实现。
+ */
+
+type WorkflowSnapshotProjectionStatus = 'complete' | 'degraded' | 'running';
+interface WorkflowCoalescedBlock {
+    scopeKey: string;
+    kind: 'reasoning' | 'text' | 'tool';
+    tailPreview: string;
+    droppedDeltaCount: number;
+}
+interface WorkflowDisplaySnapshotMetadata {
+    projection_status?: WorkflowSnapshotProjectionStatus;
+    s0_event_count?: number;
+    dropped_s2_count?: number;
+}
+/** remount SSOT — 对齐 WorkflowSessionState 投影子集，非 AgentEvent[] */
+interface WorkflowDisplaySnapshot {
+    taskId: string;
+    /** 单调；SSE tail 只发严格 > cursor 的帧（evt_{n:06d}） */
+    cursor: string;
+    /** hydrate 时写入 store；tail 事件须 version 一致或更新 */
+    snapshotVersion: number;
+    capturedAt: number;
+    display: WorkflowDisplayProjection;
+    /** 与 WorkflowContainerTreeState 同构 */
+    containerTree: WorkflowContainerTreeState;
+    /** P4 可选；degraded 首屏 tail 预览 */
+    coalescedBlocks?: WorkflowCoalescedBlock[];
+    metadata?: WorkflowDisplaySnapshotMetadata;
+}
+
+/**
+ * workflowAuthoritySource.ts — 宿主 workflow 业务权威输入契约（D33 §6.1）
+ *
+ * 职责：
+ *     定义 WorkflowSession 必填的 authority 订阅接口。
+ *
+ * 链路位置：
+ *     WorkflowSession → workflowSessionStore.applyAuthoritySnapshot。
+ *
+ * 当前裁剪范围：
+ *     createPollingAuthoritySource 于 Phase 3；此处仅基线接口。
+ */
+
+/** 基线契约：hydrate + 推送订阅 */
+interface WorkflowAuthoritySource {
+    getSnapshot(): WorkflowAuthoritySnapshot | null;
+    subscribe(cb: (snap: WorkflowAuthoritySnapshot) => void): () => void;
+}
+
+interface WorkflowSessionProps {
+    source: Source | null;
+    /** 宿主业务权威（必填）；测试可用 createMockAuthoritySource */
+    authoritySource: WorkflowAuthoritySource;
+    /** D36 P4：remount 时 GET snapshot 结果（先于 SSE tail hydrate） */
+    snapshotBootstrap?: WorkflowDisplaySnapshot | null;
+    /** T6：snapshot GET 失败时标记，禁止 history fallback */
+    snapshotHydrateFailed?: boolean;
+    initialEvents?: LangchainAgentEvent[];
+    registry?: NodeRegistry;
+    tierOverrides?: TierOverrides;
+    onError?: (error: Error) => void;
+    interactionBus?: InteractionBus;
+    toolDisplayRegistry?: ToolDisplayRegistry;
+    defaultBodyMode?: ToolBodyMode;
+    permissionUiMode?: PermissionUiMode;
+    markdownRenderer?: MarkdownRenderer;
+    displayMode?: DisplayMode;
+    verbose?: boolean;
+    exploreFullscreenBash?: boolean;
+    memoryDir?: string | null;
+    workspaceRoot?: string | null;
+    virtualized?: boolean;
+    virtualizeThreshold?: number;
+    groupParallelTools?: boolean;
+    /** P1–P4：大规模 workflow 缩放选项 */
+    workflowScale?: Partial<WorkflowScaleOptions>;
+    /** P2：展开已淘汰 loop 时由宿主 replay 事件 */
+    onRequestLoopReplay?: WorkflowLoopReplayHandler;
+    /** authority 首次进入 terminal 时触发（phase SSOT） */
+    onAuthorityTerminal?: (snapshot: WorkflowAuthoritySnapshot) => void;
+    /** SSE 传输 resolve；仅 analytics / 非 phase */
+    onDisplayStreamEnded?: () => void;
+    children?: ReactNode;
+}
+declare function WorkflowSession({ source, authoritySource, snapshotBootstrap, snapshotHydrateFailed, initialEvents, registry, tierOverrides, onError, interactionBus, toolDisplayRegistry, defaultBodyMode, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, virtualized, virtualizeThreshold, groupParallelTools, workflowScale, onRequestLoopReplay, onAuthorityTerminal, onDisplayStreamEnded, children, }: WorkflowSessionProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * createMockAuthoritySource.ts — 测试 / demo 用 authority 源
+ *
+ * 职责：
+ *     提供 instant terminal 或可控 push 的 mock，避免测试依赖 registry。
+ *
+ * 链路位置：
+ *     Vitest · simple workflow 页（Phase 3 前临时 mock）。
+ */
+
+interface MockAuthoritySourceOptions {
+    snapshot?: WorkflowAuthoritySnapshot | null;
+    /** subscribe 后依次推送（模拟 SSE / poll） */
+    pendingUpdates?: WorkflowAuthoritySnapshot[];
+}
+declare function createMockAuthoritySource(snapshotOrOptions?: WorkflowAuthoritySnapshot | null | MockAuthoritySourceOptions): WorkflowAuthoritySource;
+declare function createDoneAuthoritySource(taskId?: string): WorkflowAuthoritySource;
+declare function createRunningAuthoritySource(taskId?: string): WorkflowAuthoritySource;
+declare function createControllableAuthoritySource(initial: WorkflowAuthoritySnapshot): WorkflowAuthoritySource & {
+    push: (snapshot: WorkflowAuthoritySnapshot) => void;
+};
+
+/**
+ * createPollingAuthoritySource.ts — REST 轮询 authority 源（D33 §6.1 · §6.6）
+ *
+ * 职责：
+ *     宿主兜底轮询 registry；terminal hydrate 短路；AbortSignal 清理 interval。
+ *
+ * 链路位置：
+ *     宿主 workflow 页 · Phase 5 前 simple 可选接入。
+ *
+ * 当前裁剪范围：
+ *     不含 SSE task_complete；优先由宿主 push 订阅。
+ */
+
+interface PollingAuthoritySourceOptions {
+    intervalMs?: number;
+    signal?: AbortSignal;
+    /** hydrate 已 terminal 时注入，subscribe 不启动 poll */
+    initialSnapshot?: WorkflowAuthoritySnapshot | null;
+}
+declare function createPollingAuthoritySource(taskId: string, fetchFn: (id: string) => Promise<WorkflowAuthoritySnapshot>, options?: PollingAuthoritySourceOptions): WorkflowAuthoritySource;
+
+declare const WorkflowScaleContext: react.Context<WorkflowScaleOptions>;
+
+interface WorkflowStageListPartition {
+    visible: WorkflowContainerRuntimeNode[];
+    hiddenCount: number;
+    total: number;
+    /** 当前已展示的 done stage 数量 */
+    visibleDoneCount: number;
+    /** done stage 总数 */
+    totalDoneCount: number;
+}
+/**
+ * P3：running / failed / pending / blocked 全显；
+ * done 按 maxVisibleDoneCount 分页展示（默认最近 completedStagePageSize 条）。
+ * maxVisibleDoneCount 由 WorkflowStageListPanel 的 "Show N more" 逐页递增。
+ */
+declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[], maxVisibleDoneCount: number, containersById?: Record<string, WorkflowContainerRuntimeNode>): WorkflowStageListPartition;
+
 /**
  * workflowSessionStore.ts — Workflow 页 zustand store
  *
@@ -338,14 +491,25 @@ interface WorkflowSessionStoreState {
     applyEvents: (events: LangchainAgentEvent[]) => void;
     reset: () => void;
     markAsError: (error?: Error) => void;
-    /** SSE 正常结束：推断 done 并收口 running loop（嵌套 parallel 缺 workflow-end 兜底） */
-    markStreamComplete: () => void;
+    /** SSE 传输结束：仅 display.streamEnded；不 infer 业务 done（D33） */
+    markStreamEnded: () => void;
+    /** 宿主 authority 快照写入（唯一业务终态入口） */
+    applyAuthoritySnapshot: (snapshot: WorkflowAuthoritySnapshot) => void;
+    /** §5.4：streamEnded + authority running 超时展示 */
+    setAwaitingAuthority: (value: boolean) => void;
+    setAuthoritySyncFailed: (value: boolean) => void;
+    setAuthoritySubscribeFailed: (value: boolean) => void;
     /** P2：展开 done stage 时 pin，避免淘汰 */
     pinLoopSession: (loopSessionId: string) => void;
     /** P2：宿主 replay 后灌入 loop 树（同步；测试与小批量） */
     hydrateLoopSession: (loopSessionId: string, events: LangchainAgentEvent[]) => void;
     /** DES-1：宿主默认 replay 路径 — 分批 + rAF yield */
     hydrateLoopSessionAsync: (loopSessionId: string, events: LangchainAgentEvent[], options?: HydrateLoopSessionAsyncOptions) => Promise<void>;
+    /** D36 P4：remount snapshot hydrate */
+    hydrateFromSnapshot: (snapshot: WorkflowDisplaySnapshot, options?: {
+        preserveAuthority?: boolean;
+    }) => void;
+    markSnapshotHydrateFailed: () => void;
 }
 interface HydrateLoopSessionAsyncOptions {
     chunkSize?: number;
@@ -355,7 +519,8 @@ type WorkflowSessionStore = StoreApi<WorkflowSessionStoreState>;
 declare function createWorkflowSessionStore(initialState?: WorkflowSessionState, storeOptions?: WorkflowSessionStoreOptions): WorkflowSessionStore;
 
 declare function useWorkflowSessionStoreApi(): WorkflowSessionStore;
-declare function useWorkflowSessionStatus(): SessionStatus;
+/** 投影展示态（非 phase SSOT；phase 用 isAuthorityTerminal）。 */
+declare function useWorkflowSessionStatus(): WorkflowDisplayProjectionStatus;
 
 interface WorkflowChromeProps {
     containerTree: WorkflowContainerTreeState;
@@ -478,6 +643,8 @@ interface ReduceOptions {
     tierOverrides?: TierOverrides;
     /** true 时 debug tier 也写入 debugEvents（AgentSession debug prop） */
     collectDebug?: boolean;
+    /** D19 §5.3 / D34 P2：leak main-tier tool-call 合成父 Agent progress；默认 off */
+    subagentLeakGate?: boolean;
 }
 declare function streamChunk(data: {
     delta?: string;
@@ -968,9 +1135,12 @@ declare class MissingApplicationKindError extends Error {
  * 职责：SSE transport profile / policy 解析与终态、重连预算语义（D31 P1）。
  * 链路位置：createAgentxSseSource 入口 → resolveSseTransportPolicy → 连接状态机。
  * 当前裁剪范围：三预设 profile + 显式 policy 覆写；不含 backend replayMode。
+ *
+ * D33 分层：本模块 terminal 集合仅表示<strong>传输层</strong>字节流结束（finish / workflow-end 等），
+ * 不等于 workflow 业务终态（authority）；phase / spinner 读 WorkflowAuthoritySnapshot（见 D33）。
  */
 
-type SseTransportProfile = 'oneshot' | 'oneshot-workflow' | 'replayable-workflow';
+type SseTransportProfile = 'oneshot' | 'oneshot-workflow' | 'replayable-workflow' | 'workflow-tail';
 type SseReplayMode = 'none' | 'resume' | 'history';
 type SseReconnectMode = 'off' | 'bounded' | 'unbounded';
 interface SseReconnectPolicy {
@@ -1084,6 +1254,7 @@ declare function createMockSource(events: LangchainAgentEvent[]): Source;
 interface ReplayOptions {
     tierOverrides?: TierOverrides;
     collectDebug?: boolean;
+    subagentLeakGate?: boolean;
 }
 /** 从空树回放完整事件序列。 */
 declare function replayEvents(events: LangchainAgentEvent[], options?: ReplayOptions): SessionTree;
@@ -1155,9 +1326,41 @@ declare function createReplaySource(events: LangchainAgentEvent[], opts?: Replay
 
 /** Pure reducer：Workflow 会话状态 + 单条事件。 */
 declare function reduceWorkflowSession(state: WorkflowSessionState, event: LangchainAgentEvent, eventIndex: number, options?: ReduceOptions): WorkflowSessionState;
+/**
+ * SSE 传输结束：仅设 display.streamEnded；不 infer projection done（D33）。
+ * authority 已 terminal 时可选 force-settle 容器以对齐展示。
+ */
+declare function finalizeWorkflowDisplayOnStreamEnded(state: WorkflowSessionState): WorkflowSessionState;
 /** 从空状态回放 workflow 事件序列。 */
 declare function reduceWorkflowEvents(events: LangchainAgentEvent[], options?: ReduceOptions): WorkflowSessionState;
 
+/**
+ * workflowAuthoritySelectors.ts — Workflow authority/display 读法 SSOT
+ *
+ * 职责：
+ *     宿主 phase、全局 spinner、警告条的唯一判定入口；禁止直接读 display 做 phase。
+ *
+ * 链路位置：
+ *     WorkflowSession · WorkflowChrome · workflowTaskListMerge。
+ *
+ * 当前裁剪范围：
+ *     Phase 1：核心 selector；resolveWorkflowBanner 组合矩阵 Phase 2 扩展。
+ */
+
+declare function isAuthorityTerminalStatus(status: WorkflowAuthorityStatus | undefined): boolean;
+declare function isAuthorityTerminal(state: WorkflowSessionState): boolean;
+/** 全局 workflow spinner：authority 非 terminal 时保持（含 projection 已 done 的 T2）。 */
+declare function shouldShowGlobalSpinner(state: WorkflowSessionState): boolean;
+interface WorkflowBannerDescriptor {
+    kind: 'none' | 'authority_error' | 'partial_success' | 'forced_closeout' | 'projection_degraded' | 'snapshot_unavailable' | 'awaiting_authority' | 'sync_failed';
+    message: string;
+}
+/** D36 §00.1 Banner 优先级栈（高→低）— 返回最高优先级一条。 */
+declare function resolveWorkflowBanner(state: WorkflowSessionState): WorkflowBannerDescriptor;
+/** UI 读投影态（非 phase SSOT）。 */
+declare function getDisplayProjectionStatus(state: WorkflowSessionState): WorkflowSessionState['display']['projectionStatus'];
+declare function applyAuthoritySnapshotToState(state: WorkflowSessionState, snapshot: WorkflowAuthoritySnapshot): WorkflowSessionState;
+
 /** 与 backend/langchain_agentx_stream_ui_backend/task_sync/multi_sse_bridge.py 对齐 */
 declare const WORKFLOW_STRUCTURE_EVENT_PREFIXES: readonly string[];
 /** 显式 SSOT（文档/契约测试）；新增结构类型应同时满足前缀规则或补入此集合 */
@@ -1183,6 +1386,24 @@ declare function filterAgentLoopReplayEvents<T extends {
 /** agent 事件缺 session_id 时，从 workflow_id (或 workflow_path 兜底) + scope key 推导。 */
 declare function deriveLoopSessionIdFromAgentEvent(event: LangchainAgentEvent): string | null;
 
+/**
+ * hydrateWorkflowSnapshot.ts — remount SSOT（D36 P4）
+ *
+ * 职责：
+ *     WorkflowDisplaySnapshot → WorkflowSessionState 投影子集替换。
+ *
+ * 链路位置：
+ *     GET /projection/snapshot → workflowSessionStore.hydrateFromSnapshot。
+ */
+
+interface HydrateWorkflowSnapshotOptions {
+    preserveAuthority?: boolean;
+}
+/** 判断 SSE event id 是否 ≤ projectionCursor（duplicate tail 丢弃）。 */
+declare function isAtOrBeforeProjectionCursor(projectionCursor: string | null | undefined, eventId: string | undefined): boolean;
+/** 冻结算法：替换投影子集，禁止写 authority（除非 preserveAuthority）。 */
+declare function hydrateWorkflowFromSnapshot(state: WorkflowSessionState, snapshot: WorkflowDisplaySnapshot, options?: HydrateWorkflowSnapshotOptions): WorkflowSessionState;
+
 /**
  * 职责：事件分级类型（V2-A classify 层公共契约）。
  * 链路位置：classify.ts → reducer；AgentSession tierOverrides 传入。
@@ -1211,4 +1432,4 @@ interface ClassifyContext {
 declare function resolveEventTier(eventType: string, overrides?: TierOverrides): EventTier;
 declare function classifyEvent(event: LangchainAgentEvent, ctx: ClassifyContext, overrides?: TierOverrides, eventIndex?: number): ClassifiedEvent;
 
-export { Agent, AgentLoopView, type AgentLoopViewProps, AgentSession, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, type ApplicationKind, ApplicationKindMismatchError, AskUserQuestion, BOUNDED_DEFAULTS, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, type DiagramFitLayout, DiagramZoomShell, type DiagramZoomShellProps, DiagramZoomView, type DiagramZoomViewProps, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, type HydrateLoopSessionAsyncOptions, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, NodeRegistry, PROFILE_PRESETS, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, ReconnectBudget, type ReduceOptions, ReducerError, RenderableEntry, RenderableTimelineProjector, type ReplayOptions, type ReplaySourceOptions, RichMarkdown, type RichMarkdownProps, SHELL_PROGRESS_MIN_ELAPSED_SECONDS, SessionNode, SessionNodeKind, SessionStatus, SessionTree, Skill, Source, SourceEventContext, Spinner, type SpinnerProps, type SseReconnectMode, type SseReconnectPolicy, type SseReplayMode, type SseTerminalPolicy, type SseTransportFailureKind, type SseTransportPolicy, type SseTransportPolicyOverride, type SseTransportProfile, SseTransportTerminalError, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, WORKFLOW_STRUCTURE_EVENT_PREFIXES, WORKFLOW_STRUCTURE_EVENT_TYPES, WebFetch, WebSearch, WorkflowChrome, type WorkflowChromeProps, type WorkflowLoopReplayHandler, WorkflowLoopReplayProvider, type WorkflowProgressState, WorkflowScaleContext, type WorkflowScaleOptions, type WorkflowScopeFrame, WorkflowSession, type WorkflowSessionProps, type WorkflowSessionState, type WorkflowSessionStore, type WorkflowSessionStoreOptions, type WorkflowSessionStoreState, type WorkflowStageProgress, WorkflowTaskListFooter, type WorkflowTerminalKind, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, computeViewportFitTransform, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, deriveLoopSessionIdFromAgentEvent, entryKey, filterAgentLoopReplayEvents, fixDiagramSvg, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isAgentLoopReplayEventType, isGitOperationCommand, isGroupableToolName, isMcpToolName, isSseStreamTerminalEvent, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, resolveSseTransportPolicy, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };
+export { Agent, AgentLoopView, type AgentLoopViewProps, AgentSession, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, type ApplicationKind, ApplicationKindMismatchError, AskUserQuestion, BOUNDED_DEFAULTS, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, type DiagramFitLayout, DiagramZoomShell, type DiagramZoomShellProps, DiagramZoomView, type DiagramZoomViewProps, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, type HydrateLoopSessionAsyncOptions, type HydrateWorkflowSnapshotOptions, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, type MockAuthoritySourceOptions, NodeRegistry, PROFILE_PRESETS, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type PollingAuthoritySourceOptions, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, ReconnectBudget, type ReduceOptions, ReducerError, RenderableEntry, RenderableTimelineProjector, type ReplayOptions, type ReplaySourceOptions, RichMarkdown, type RichMarkdownProps, SHELL_PROGRESS_MIN_ELAPSED_SECONDS, SessionNode, SessionNodeKind, SessionStatus, SessionTree, Skill, Source, SourceEventContext, Spinner, type SpinnerProps, type SseReconnectMode, type SseReconnectPolicy, type SseReplayMode, type SseTerminalPolicy, type SseTransportFailureKind, type SseTransportPolicy, type SseTransportPolicyOverride, type SseTransportProfile, SseTransportTerminalError, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, WORKFLOW_STRUCTURE_EVENT_PREFIXES, WORKFLOW_STRUCTURE_EVENT_TYPES, WebFetch, WebSearch, type WorkflowAuthoritySnapshot, type WorkflowAuthoritySource, type WorkflowAuthorityStatus, type WorkflowBannerDescriptor, WorkflowChrome, type WorkflowChromeProps, type WorkflowCoalescedBlock, type WorkflowDisplayProjection, type WorkflowDisplayProjectionStatus, type WorkflowDisplaySnapshot, type WorkflowDisplaySnapshotMetadata, type WorkflowLoopReplayHandler, WorkflowLoopReplayProvider, type WorkflowProgressState, WorkflowScaleContext, type WorkflowScaleOptions, type WorkflowScopeFrame, WorkflowSession, type WorkflowSessionProps, type WorkflowSessionState, type WorkflowSessionStore, type WorkflowSessionStoreOptions, type WorkflowSessionStoreState, type WorkflowSnapshotProjectionStatus, type WorkflowStageProgress, WorkflowTaskListFooter, type WorkflowTerminalKind, Write, applyAuthoritySnapshotToState, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, computeViewportFitTransform, configureMermaid, configurePlantumlServer, createAgentxSseSource, createControllableAuthoritySource, createDefaultRegistry, createDoneAuthoritySource, createEmptyWorkflowSessionState, createMockAuthoritySource, createMockSource, createPollingAuthoritySource, createReplaySource, createRunningAuthoritySource, createWorkflowSessionStore, deriveLoopSessionIdFromAgentEvent, entryKey, filterAgentLoopReplayEvents, finalizeWorkflowDisplayOnStreamEnded, fixDiagramSvg, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getDisplayProjectionStatus, getMainStageIds, hydrateWorkflowFromSnapshot, isAgentLoopReplayEventType, isAtOrBeforeProjectionCursor, isAuthorityTerminal, isAuthorityTerminalStatus, isGitOperationCommand, isGroupableToolName, isMcpToolName, isSseStreamTerminalEvent, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, resolveSseTransportPolicy, resolveWorkflowBanner, shouldShowGlobalSpinner, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };