langchain_agentx_stream_ui 0.3.7 → 0.4.2

package/dist/index.d.ts

@@ -1,21 +1,44 @@
 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, R as ReducerError, r as SourceEventContext, T as Task, t as TaskPhase, l as SessionStatus, E as EventTier } from './multi-session-CsPvSE9d.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-CsPvSE9d.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 { W as WorkflowAuthoritySnapshot, u as Source, L as LangchainAgentEvent, N as NodeRegistry, z as TierOverrides, I as InteractionBus, M as MarkdownRenderer, a as AskDisplaySnapshot, s as SessionTree, H as WorkflowDisplayProjection, G as WorkflowContainerTreeState, F as WorkflowContainerRuntimeNode, Q as WorkflowSessionState, v as SourceEventContext, J as WorkflowDisplayProjectionStatus, T as Task, x as TaskPhase, o as SessionStatus, R as ReducerError, B as WorkflowAuthorityStatus, r as SessionStoreState, t as SessionTreeSnapshot, E as EventTier } from './multi-session--0z_-ut1.js';
+export { A as AskCoalescedBlock, b as AskDisplaySnapshotMetadata, c as AskSnapshotProjectionStatus, C as CommonFields, D as DEFAULT_EVENT_TIERS, d as EventType, e as InteractionBusHandlers, f as MarkdownRendererProps, g as MultiAgentSession, h as MultiAgentSessionProps, i as MultiSessionSourceConfig, j as MultiSessionStore, k as MultiSessionStoreOptions, l as MultiSessionStoreState, m as NodeWidget, n as NodeWidgetProps, P as PermissionResolvePayload, S as SessionSlice, p as SessionStore, q as SessionStoreOptions, w as SourceHandler, y as TaskStatus, K as WorkflowProgressState, O as WorkflowScopeFrame, U as WorkflowStageProgress, V as WorkflowTerminalKind, X as createActiveSessionBridge, Y as createEmptyTree, Z as createEmptyWorkflowSessionState, _ as createInteractionBus, $ as createMultiSessionStore, a0 as createSessionStore, a1 as getNoopInteractionBus, a2 as useActiveSession, a3 as useSessionIds } from './multi-session--0z_-ut1.js';
+import { T as ToolDisplayRegistry, P as PermissionUiMode, b as DisplayMode, c as ProjectionContext, R as RenderableEntry, C as CanonicalNodeRef } from './sessionViewOptions-EIBugOkf.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-EIBugOkf.js';
+import { a as ToolBodyMode } from './types-DAkw2VOv.js';
+export { T as ToolBodyComponent, b as ToolDisplayProps } from './types-DAkw2VOv.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-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';
+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-J8MqSUEs.js';
+import { S as SessionNode, a as SessionNodeKind } from './nodes-7_0rCAc4.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-7_0rCAc4.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-DeICJUtu.js';
+
+/**
+ * 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 AgentSessionProps {
     source: Source;
+    /** D38 P4：REST 执行权威；绑定时 Spinner phase 读 authority 而非 SSE status */
+    authoritySource?: WorkflowAuthoritySource;
+    /** authority 首次进入 terminal 时触发（phase SSOT） */
+    onAuthorityTerminal?: (snapshot: WorkflowAuthoritySnapshot) => void;
     /** 挂载时先 replay 预灌树（含 EventBuffer ingest 快照），再接 source 续流 */
     initialEvents?: LangchainAgentEvent[];
     registry?: NodeRegistry;
@@ -50,9 +73,13 @@ interface AgentSessionProps {
     workspaceRoot?: string | null;
     /** D34 P2 LeakGate synthesize；默认 false */
     subagentLeakGate?: boolean;
+    /** D39 P2：remount hydrate SSOT；挂载时写入 store */
+    snapshotBootstrap?: AskDisplaySnapshot | null;
+    /** GET snapshot 404 / 重试耗尽 */
+    snapshotHydrateFailed?: 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, subagentLeakGate, children, }: AgentSessionProps): react_jsx_runtime.JSX.Element;
+declare function AgentSession({ source, authoritySource, onAuthorityTerminal, initialEvents, registry, tierOverrides: _tierOverrides, onError, autoReconnect: _autoReconnect, debug, virtualized, virtualizeThreshold, interactionBus, toolDisplayRegistry, defaultBodyMode, groupParallelTools, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, subagentLeakGate, snapshotBootstrap, snapshotHydrateFailed, children, }: AgentSessionProps): react_jsx_runtime.JSX.Element;
 
 interface AgentLoopViewProps {
     /** 传入时使用隔离 store（workflow scoped）；省略则使用上层 SessionStoreContext */
@@ -96,213 +123,6 @@ interface WorkflowScaleOptions {
 }
 declare const DEFAULT_WORKFLOW_SCALE_OPTIONS: WorkflowScaleOptions;
 
-/**
- * workflowDisplay.ts — SDK WorkflowDisplayPayload 契约（TS）
- *
- * 职责：
- *     对齐 langchain_agentx WorkflowDisplayPayload；结构事件 data.display 类型。
- *
- * 链路位置：
- *     workflowContainerProjector → WorkflowChrome（P2+）。
- *
- * 当前裁剪范围：
- *     只读消费；不计算 display（由 SDK enricher 注入）。
- */
-type WorkflowDisplayScope = 'workflow' | 'stage' | 'item' | 'branch' | 'aggregate' | 'subworkflow';
-type WorkflowDisplayStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled' | 'blocked' | 'retrying';
-/** 对齐 SDK display_resolver.WorkflowDisplayPayload */
-interface WorkflowDisplayPayload {
-    version?: number;
-    scope?: WorkflowDisplayScope;
-    title?: string;
-    description?: string;
-    workflow_title?: string;
-    workflow_description?: string;
-    parent_title?: string;
-    breadcrumb?: string[];
-    progress_current?: number;
-    progress_total?: number;
-    progress_label?: string;
-    progress_indeterminate?: boolean;
-    status?: WorkflowDisplayStatus;
-    status_reason?: string;
-    icon?: string;
-    item_index?: number;
-    item_total?: number;
-    metrics_completed?: number;
-    metrics_running?: number;
-    metrics_failed?: number;
-    metrics_total?: number;
-    decision_label?: string;
-    pattern?: string;
-    debug_key?: string;
-}
-
-/**
- * workflowContainer.ts — Workflow 容器树投影类型
- *
- * 职责：
- *     容器节点、正文块、快照；对齐 SDK workflow_container_projector。
- *
- * 链路位置：
- *     workflowContainerProjector → workflowReducer（P1+）→ WorkflowChrome（P2+）。
- *
- * 当前裁剪范围：
- *     不含 React 视图 props；仅投影层 state。
- */
-
-type WorkflowContainerScope = 'workflow' | 'stage' | 'item' | 'branch' | 'aggregate' | 'subworkflow';
-type WorkflowContainerStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled' | 'blocked' | 'retrying';
-type ContentBlockKind = 'reasoning' | 'text' | 'tool';
-interface WorkflowContentBlock {
-    kind: ContentBlockKind;
-    preview: string;
-    tool_name: string | null;
-}
-interface WorkflowContainerNode {
-    container_id: string;
-    scope: WorkflowContainerScope;
-    workflow_path: string;
-    workflow_depth: number;
-    scope_key: string;
-    title: string;
-    subtitle: string;
-    status: WorkflowContainerStatus;
-    pattern: string;
-    parent_container_id: string | null;
-    display: WorkflowDisplayPayload | null;
-    content_blocks: WorkflowContentBlock[];
-    is_open: boolean;
-}
-/** reducer 运行时节点：投影字段 + loop 绑定（P1） */
-interface WorkflowContainerRuntimeNode extends WorkflowContainerNode {
-    loopSessionId: string | null;
-}
-/** WorkflowSession 容器树 state（P1+） */
-interface WorkflowContainerTreeState {
-    rootContainerIds: string[];
-    activeContainerIds: string[];
-    containersById: Record<string, WorkflowContainerRuntimeNode>;
-}
-
-/**
- * workflowSession.ts — Workflow 会话顶层状态
- *
- * 职责：
- *     定义 /workflow 页专用 WorkflowSessionState（与 /chat SessionTree 隔离）。
- *
- * 链路位置：
- *     workflowReducer → workflowSessionStore → WorkflowSession / WorkflowChrome。
- *
- * 当前裁剪范围：
- *     不含合并 TaskListFooter（P3）；parallel 结构仅基础字段。
- */
-
-/** 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;
-    teaser: string;
-    extraLines: number;
-    fullMarkdown?: string;
-}
-type WorkflowRunStatus = 'running' | 'done' | 'error';
-interface WorkflowStageProgress {
-    stageKey: string;
-    stageIndex: number;
-    stageTotal?: number;
-    status: 'pending' | 'running' | 'done' | 'failed';
-    error?: string;
-}
-interface ParallelItemProgress {
-    itemKey: string;
-    itemIndex: number;
-    itemTotal?: number;
-    status: 'pending' | 'running' | 'done' | 'failed';
-    loopSessionId: string | null;
-    error?: string;
-}
-interface WorkflowProgressState {
-    workflowId: string | null;
-    workflowPath: string | null;
-    status: WorkflowRunStatus;
-    stages: WorkflowStageProgress[];
-    parallelItems: Record<string, ParallelItemProgress>;
-}
-type WorkflowScopeKind = 'stage' | 'parallel-item' | 'subworkflow';
-interface WorkflowScopeFrame {
-    kind: WorkflowScopeKind;
-    key: string;
-    loopSessionId: string | null;
-}
-interface WorkflowSessionState {
-    /** 宿主注入；Reducer 禁止写入 */
-    authority: WorkflowAuthoritySnapshot | null;
-    /** 事件投影 + 传输展示；不可驱动 phase */
-    display: WorkflowDisplayProjection;
-    meta: {
-        workflowRunId: string | null;
-        startedAt: number | null;
-        lastEventId: string | null;
-    };
-    /** SDK 容器树投影 + loopSessionId 绑定（P1 主模型） */
-    containerTree: WorkflowContainerTreeState;
-    /** 过渡期 dual-write；P2+ UI 逐步改读 containerTree */
-    workflowProgress: WorkflowProgressState;
-    loopTreesBySessionId: Record<string, SessionTree>;
-    /** P2：container_id → done 摘要（loop 淘汰后） */
-    stageDoneSummariesByContainerId: Record<string, CachedStageDoneSummary>;
-    /** 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）
  *
@@ -344,25 +164,6 @@ interface WorkflowDisplaySnapshot {
     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 */
@@ -441,6 +242,12 @@ interface PollingAuthoritySourceOptions {
     /** hydrate 已 terminal 时注入，subscribe 不启动 poll */
     initialSnapshot?: WorkflowAuthoritySnapshot | null;
 }
+/** 404/410：run 已从 registry 消失，继续轮询无意义。 */
+declare function isFatalAuthorityPollStatus(status: number): boolean;
+declare class AuthorityPollFatalError extends Error {
+    readonly status: number;
+    constructor(status: number, message?: string);
+}
 declare function createPollingAuthoritySource(taskId: string, fetchFn: (id: string) => Promise<WorkflowAuthoritySnapshot>, options?: PollingAuthoritySourceOptions): WorkflowAuthoritySource;
 
 declare const WorkflowScaleContext: react.Context<WorkflowScaleOptions>;
@@ -646,6 +453,8 @@ interface ReduceOptions {
     collectDebug?: boolean;
     /** D19 §5.3 / D34 P2：leak main-tier tool-call 合成父 Agent progress；默认 off */
     subagentLeakGate?: boolean;
+    /** P2：缺父 Agent tool-call 时在 subagent-start 合成骨架；默认 off */
+    syntheticAgentToolOnSubagentStart?: boolean;
 }
 declare function streamChunk(data: {
     delta?: string;
@@ -1141,7 +950,7 @@ declare class MissingApplicationKindError extends Error {
  * 不等于 workflow 业务终态（authority）；phase / spinner 读 WorkflowAuthoritySnapshot（见 D33）。
  */
 
-type SseTransportProfile = 'oneshot' | 'oneshot-workflow' | 'replayable-workflow' | 'workflow-tail';
+type SseTransportProfile = 'oneshot' | 'oneshot-workflow' | 'replayable-workflow' | 'workflow-tail' | 'replayable-ask' | 'ask-tail';
 type SseReplayMode = 'none' | 'resume' | 'history';
 type SseReconnectMode = 'off' | 'bounded' | 'unbounded';
 interface SseReconnectPolicy {
@@ -1298,6 +1107,9 @@ declare function useSessionMeta(): {
     startedAt: number | null;
     lastEventId: string | null;
 };
+/** D38 P4：AgentSession authority 快照（无绑定时为 null） */
+declare function useAgentAuthority(): WorkflowAuthoritySnapshot | null;
+declare function useAgentAuthoritySubscribeFailed(): boolean;
 
 /**
  * 职责：内存事件源，按序投递 events 实现 Source 接口。
@@ -1362,6 +1174,18 @@ declare function resolveWorkflowBanner(state: WorkflowSessionState): WorkflowBan
 declare function getDisplayProjectionStatus(state: WorkflowSessionState): WorkflowSessionState['display']['projectionStatus'];
 declare function applyAuthoritySnapshotToState(state: WorkflowSessionState, snapshot: WorkflowAuthoritySnapshot): WorkflowSessionState;
 
+/**
+ * agentAuthoritySelectors.ts — AgentSession authority / spinner 读法（D38 P4）
+ *
+ * 职责：authority 绑定时 Spinner phase 读 REST 快照，非 SSE reducer status。
+ */
+
+declare function shouldShowAgentSpinner(state: SessionStoreState): boolean;
+type AgentAuthorityMetadata = WorkflowAuthoritySnapshot['metadata'] & {
+    projection_status?: 'complete' | 'degraded' | 'running';
+    projection_dropped_count?: number;
+};
+
 /** 与 backend/langchain_agentx_stream_ui_backend/task_sync/multi_sse_bridge.py 对齐 */
 declare const WORKFLOW_STRUCTURE_EVENT_PREFIXES: readonly string[];
 /** 显式 SSOT（文档/契约测试）；新增结构类型应同时满足前缀规则或补入此集合 */
@@ -1405,6 +1229,41 @@ declare function isAtOrBeforeProjectionCursor(projectionCursor: string | null |
 /** 冻结算法：替换投影子集，禁止写 authority（除非 preserveAuthority）。 */
 declare function hydrateWorkflowFromSnapshot(state: WorkflowSessionState, snapshot: WorkflowDisplaySnapshot, options?: HydrateWorkflowSnapshotOptions): WorkflowSessionState;
 
+/**
+ * hydrateAskSnapshot.ts — remount SSOT（D39 P2 · A04 §08 P-ASK-CLIENT-REDUCER）
+ * Live 展示由 SessionStore.applyEvent → reducer；本模块仅服务 snapshot hydrate。
+ *
+ * 职责：AskDisplaySnapshot → SessionStoreState 投影子集替换。
+ * 链路：GET /projection/snapshot → SessionStore.hydrateFromSnapshot。
+ */
+
+interface HydrateAskSnapshotState {
+    authority: WorkflowAuthoritySnapshot | null;
+    authoritySubscribeFailed: boolean;
+    authorityBindingActive: boolean;
+}
+declare function sessionTreeSnapshotToTree(snapshot: SessionTreeSnapshot): SessionTree;
+/** 冻结算法：替换投影子集；保留 authority 绑定字段。 */
+declare function hydrateAskFromSnapshot(state: HydrateAskSnapshotState, snapshot: AskDisplaySnapshot): {
+    tree: SessionTree;
+    eventCount: number;
+    projectionCursor: string;
+    snapshotVersion: number;
+    snapshotHydrateFailed: false;
+    reconnectSuppressedReason: null;
+    authority: WorkflowAuthoritySnapshot | null;
+    authoritySubscribeFailed: boolean;
+    authorityBindingActive: boolean;
+};
+
+/**
+ * AgentSessionBanners.tsx — snapshot hydrate 失败黄条（D39 P2）
+ */
+interface AgentSessionBannersProps {
+    snapshotHydrateFailed: boolean;
+}
+declare function AgentSessionBanners({ snapshotHydrateFailed }: AgentSessionBannersProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * 职责：事件分级类型（V2-A classify 层公共契约）。
  * 链路位置：classify.ts → reducer；AgentSession tierOverrides 传入。
@@ -1433,4 +1292,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, 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 };
+export { Agent, type AgentAuthorityMetadata, type WorkflowAuthoritySource as AgentAuthoritySource, AgentLoopView, type AgentLoopViewProps, AgentSession, AgentSessionBanners, type AgentSessionBannersProps, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, type ApplicationKind, ApplicationKindMismatchError, AskDisplaySnapshot, AskUserQuestion, AuthorityPollFatalError, 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 HydrateAskSnapshotState, 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, SessionStoreState, SessionTree, SessionTreeSnapshot, 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, WorkflowAuthoritySnapshot, type WorkflowAuthoritySource, WorkflowAuthorityStatus, type WorkflowBannerDescriptor, WorkflowChrome, type WorkflowChromeProps, type WorkflowCoalescedBlock, WorkflowDisplayProjection, WorkflowDisplayProjectionStatus, type WorkflowDisplaySnapshot, type WorkflowDisplaySnapshotMetadata, type WorkflowLoopReplayHandler, WorkflowLoopReplayProvider, WorkflowScaleContext, type WorkflowScaleOptions, WorkflowSession, type WorkflowSessionProps, WorkflowSessionState, type WorkflowSessionStore, type WorkflowSessionStoreOptions, type WorkflowSessionStoreState, type WorkflowSnapshotProjectionStatus, WorkflowTaskListFooter, Write, applyAuthoritySnapshotToState, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, computeViewportFitTransform, configureMermaid, configurePlantumlServer, createAgentxSseSource, createControllableAuthoritySource, createDefaultRegistry, createDoneAuthoritySource, createMockAuthoritySource, createMockSource, createPollingAuthoritySource, createReplaySource, createRunningAuthoritySource, createWorkflowSessionStore, deriveLoopSessionIdFromAgentEvent, entryKey, filterAgentLoopReplayEvents, finalizeWorkflowDisplayOnStreamEnded, fixDiagramSvg, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getDisplayProjectionStatus, getMainStageIds, hydrateAskFromSnapshot, hydrateWorkflowFromSnapshot, isAgentLoopReplayEventType, isAtOrBeforeProjectionCursor, isAuthorityTerminal, isAuthorityTerminalStatus, isFatalAuthorityPollStatus, isGitOperationCommand, isGroupableToolName, isMcpToolName, isSseStreamTerminalEvent, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, resolveSseTransportPolicy, resolveWorkflowBanner, sessionTreeSnapshotToTree, shouldShowAgentSpinner, shouldShowGlobalSpinner, shouldShowTaskListFooter, streamChunk, useAgentAuthority, useAgentAuthoritySubscribeFailed, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };