langchain_agentx_stream_ui 0.3.0 → 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, R as ReducerError, r as SourceEventContext, T as Task, t as TaskPhase, l as SessionStatus, 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 */
@@ -213,6 +215,8 @@ interface WorkflowAuthoritySnapshot {
         execution_authority?: true;
         orphan_items_reaped?: number;
         partial_success_kind?: string;
+        projection_status?: 'complete' | 'degraded' | 'running';
+        projection_dropped_count?: number;
     };
 }
 /** 纯投影 / 传输展示态 — 不可驱动宿主 phase（D33） */
@@ -286,12 +290,59 @@ 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）
  *
@@ -312,9 +363,13 @@ interface WorkflowAuthoritySource {
 }
 
 interface WorkflowSessionProps {
-    source: Source;
+    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;
@@ -342,7 +397,7 @@ interface WorkflowSessionProps {
     onDisplayStreamEnded?: () => void;
     children?: ReactNode;
 }
-declare function WorkflowSession({ source, authoritySource, 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;
+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 源
@@ -450,6 +505,11 @@ interface WorkflowSessionStoreState {
     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;
@@ -583,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;
@@ -1078,7 +1140,7 @@ declare class MissingApplicationKindError extends Error {
  * 不等于 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 {
@@ -1192,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;
@@ -1289,10 +1352,10 @@ declare function isAuthorityTerminal(state: WorkflowSessionState): boolean;
 /** 全局 workflow spinner：authority 非 terminal 时保持（含 projection 已 done 的 T2）。 */
 declare function shouldShowGlobalSpinner(state: WorkflowSessionState): boolean;
 interface WorkflowBannerDescriptor {
-    kind: 'none' | 'partial_success' | 'forced_closeout' | 'awaiting_authority' | 'sync_failed';
+    kind: 'none' | 'authority_error' | 'partial_success' | 'forced_closeout' | 'projection_degraded' | 'snapshot_unavailable' | 'awaiting_authority' | 'sync_failed';
     message: string;
 }
-/** Phase 1 基础文案；Phase 2 扩展 partial_success × forced_closeout 矩阵。 */
+/** D36 §00.1 Banner 优先级栈（高→低）— 返回最高优先级一条。 */
 declare function resolveWorkflowBanner(state: WorkflowSessionState): WorkflowBannerDescriptor;
 /** UI 读投影态（非 phase SSOT）。 */
 declare function getDisplayProjectionStatus(state: WorkflowSessionState): WorkflowSessionState['display']['projectionStatus'];
@@ -1323,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 传入。
@@ -1351,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, 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 WorkflowDisplayProjection, type WorkflowDisplayProjectionStatus, 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, 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, isAgentLoopReplayEventType, 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, 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 };

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   fixDiagramSvg,
   markEventIdSeen,
   shouldSkipDuplicateEvent
-} from "./chunk-CUKNUCGU.js";
+} from "./chunk-ISQ7JWGD.js";
 import {
   DefaultToolBody,
   InteractionBusContext,
@@ -32,8 +32,8 @@ import {
   getNoopInteractionBus,
   resolveToolBody,
   useInteractionBus
-} from "./chunk-6DYISADG.js";
-import "./chunk-DP7V33X7.js";
+} from "./chunk-TCKOXX7O.js";
+import "./chunk-6Z4ZF36Z.js";
 import {
   CollapseKind,
   CollapsedExploreNode,
@@ -72,7 +72,6 @@ import {
   createEmptyTree,
   createProjectionContext,
   entryKey,
-  formatExploreSummaryText,
   formatHookFinishedSummary,
   formatShellProgressSuffix,
   formatTaskFooterLabel,
@@ -111,7 +110,7 @@ import {
   useSessionStatus,
   useSessionViewOptions,
   useTimeline
-} from "./chunk-SUEMZC4U.js";
+} from "./chunk-6ORA5RMV.js";
 import {
   Agent,
   AgentToolBody,
@@ -137,8 +136,9 @@ import {
   Write,
   WriteToolBody,
   createDefaultToolRegistry,
-  formatAgentTitle
-} from "./chunk-7CLAU74Y.js";
+  formatAgentTitle,
+  formatExploreSummaryText
+} from "./chunk-FL2G7SV3.js";
 import {
   BodyBlockList,
   DiffView,
@@ -154,7 +154,7 @@ import {
   formatTimeoutFooter,
   parseDiffText,
   truncateCommand
-} from "./chunk-4RIOBLGB.js";
+} from "./chunk-GBY5DJ7L.js";
 
 // src/view/AgentSession.tsx
 import { useEffect as useEffect2, useMemo, useRef as useRef2 } from "react";
@@ -184,7 +184,8 @@ function safeReduce(tree, event, eventIndex, options) {
 function createSessionStore(initialTree = createEmptyTree(), storeOptions) {
   const reduceOpts = {
     tierOverrides: storeOptions?.tierOverrides,
-    collectDebug: storeOptions?.debug === true
+    collectDebug: storeOptions?.debug === true,
+    subagentLeakGate: storeOptions?.subagentLeakGate === true
   };
   const initialEventCount = storeOptions?.initialEventCount ?? 0;
   const seenEventIds = new Set(storeOptions?.initialSeenEventIds);
@@ -317,6 +318,15 @@ var PROFILE_PRESETS = {
       ...BOUNDED_DEFAULTS
     },
     terminal: WORKFLOW_TERMINAL_WITH_FALLBACK
+  },
+  "workflow-tail": {
+    profile: "workflow-tail",
+    replay: "none",
+    reconnect: {
+      mode: "bounded",
+      ...BOUNDED_DEFAULTS
+    },
+    terminal: WORKFLOW_TERMINAL_WITH_FALLBACK
   }
 };
 function legacyTerminal(expectedApplicationKind) {
@@ -778,19 +788,22 @@ function AgentSession({
   exploreFullscreenBash = true,
   memoryDir = null,
   workspaceRoot = null,
+  subagentLeakGate = false,
   children
 }) {
   const storeRef = useRef2(null);
   if (storeRef.current === null) {
     const replayOpts = {
       tierOverrides: _tierOverrides,
-      collectDebug: debug
+      collectDebug: debug,
+      subagentLeakGate
     };
     const initialTree = initialEvents && initialEvents.length > 0 ? replayEvents(initialEvents, replayOpts) : void 0;
     storeRef.current = createSessionStore(initialTree, {
       tierOverrides: _tierOverrides,
       debug,
-      initialEventCount: initialEvents?.length ?? 0
+      initialEventCount: initialEvents?.length ?? 0,
+      subagentLeakGate
     });
   }
   const registryRef = useMemo(() => registry ?? createDefaultRegistry(), [registry]);
@@ -815,7 +828,8 @@ function AgentSession({
       verbose,
       exploreFullscreenBash,
       memoryDir,
-      workspaceRoot
+      workspaceRoot,
+      subagentLeakGate
     }),
     [
       groupParallelTools,
@@ -825,7 +839,8 @@ function AgentSession({
       verbose,
       exploreFullscreenBash,
       memoryDir,
-      workspaceRoot
+      workspaceRoot,
+      subagentLeakGate
     ]
   );
   const onErrorRef = useRef2(onError);
@@ -901,10 +916,19 @@ function resolveWorkflowBanner(state) {
   if (state.display.authoritySyncFailed) {
     return { kind: "sync_failed", message: "\u540C\u6B65\u72B6\u6001\u5931\u8D25\uFF0C\u8BF7\u5237\u65B0" };
   }
+  const auth = state.authority?.status;
+  if (auth === "error") {
+    return { kind: "authority_error", message: "Workflow \u6267\u884C\u5931\u8D25" };
+  }
+  if (state.snapshotHydrateFailed) {
+    return {
+      kind: "snapshot_unavailable",
+      message: "\u65E0\u6CD5\u52A0\u8F7D projection snapshot\uFF0C\u5C55\u793A\u53EF\u80FD\u4E0D\u5B8C\u6574"
+    };
+  }
   if (state.display.awaitingAuthority) {
     return { kind: "awaiting_authority", message: "\u6536\u5C3E\u4E2D\u2026" };
   }
-  const auth = state.authority?.status;
   if (auth === "partial_success") {
     const forced = state.display.terminalKind === "forced_closeout";
     return {
@@ -912,6 +936,15 @@ function resolveWorkflowBanner(state) {
       message: forced ? "\u90E8\u5206\u5B8C\u6210\uFF08\u90E8\u5206\u5BB9\u5668\u672A\u6B63\u5E38\u7ED3\u675F\uFF09" : "\u90E8\u5206\u5B8C\u6210\uFF08\u6240\u6709\u5BB9\u5668\u6B63\u5E38\u7ED3\u675F\uFF09"
     };
   }
+  const meta = state.authority?.metadata;
+  if (auth === "done" && meta?.projection_status === "degraded") {
+    const dropped = meta.projection_dropped_count;
+    const suffix = dropped != null && dropped > 0 ? `\uFF08\u7EA6 ${dropped} \u6761\u4E8B\u4EF6\u672A\u5B8C\u6574\u5C55\u793A\uFF09` : "";
+    return {
+      kind: "projection_degraded",
+      message: `\u5C55\u793A\u53EF\u80FD\u4E0D\u5B8C\u6574${suffix}`
+    };
+  }
   if (state.display.terminalKind === "forced_closeout" && auth === "done") {
     return { kind: "forced_closeout", message: "Workflow \u5DF2\u7ED3\u675F\uFF08\u90E8\u5206\u5BB9\u5668\u672A\u6B63\u5E38\u5173\u95ED\uFF09" };
   }
@@ -1031,6 +1064,10 @@ function createEmptyWorkflowSessionState() {
     stageDoneSummariesByContainerId: {},
     hotCompletedLoopSessionIds: [],
     activeLoopSessionId: null,
+    projectionCursor: null,
+    snapshotVersion: null,
+    reconnectSuppressedReason: null,
+    snapshotHydrateFailed: false,
     openScopeStack: [],
     internalErrors: []
   };
@@ -2753,6 +2790,41 @@ function reduceWorkflowEvents(events, options) {
   );
 }
 
+// src/core/workflow/hydrateWorkflowSnapshot.ts
+function isAtOrBeforeProjectionCursor(projectionCursor, eventId) {
+  if (!projectionCursor || !eventId) return false;
+  const cursorNum = Number.parseInt(projectionCursor, 10);
+  const eventNum = Number.parseInt(eventId, 10);
+  if (!Number.isNaN(cursorNum) && !Number.isNaN(eventNum)) {
+    return eventNum <= cursorNum;
+  }
+  return eventId <= projectionCursor;
+}
+function hydrateWorkflowFromSnapshot(state, snapshot, options = {}) {
+  const authority = options.preserveAuthority ? state.authority : null;
+  return {
+    ...createEmptyWorkflowSessionState(),
+    authority,
+    display: {
+      ...snapshot.display,
+      streamEnded: false
+    },
+    containerTree: structuredClone(snapshot.containerTree),
+    projectionCursor: snapshot.cursor,
+    snapshotVersion: snapshot.snapshotVersion,
+    meta: {
+      ...state.meta,
+      workflowRunId: snapshot.taskId,
+      lastEventId: snapshot.cursor,
+      startedAt: state.meta.startedAt ?? snapshot.capturedAt
+    },
+    loopTreesBySessionId: {},
+    internalErrors: [],
+    reconnectSuppressedReason: null,
+    snapshotHydrateFailed: false
+  };
+}
+
 // src/core/workflowSessionStore.ts
 var DEFAULT_HYDRATE_CHUNK_SIZE = 50;
 function nextAnimationFrame() {
@@ -2841,8 +2913,12 @@ function createWorkflowSessionStore(initialState = createEmptyWorkflowSessionSta
     hydratingLoopSessionIds: {},
     applyEvent(event, ctx) {
       const sseEventId = ctx?.sseEventId;
-      if (shouldSkipDuplicateEvent(seenEventIds, sseEventId)) return;
       const { state, eventCount } = get();
+      if (isAtOrBeforeProjectionCursor(state.projectionCursor, sseEventId)) {
+        markEventIdSeen(seenEventIds, sseEventId);
+        return;
+      }
+      if (shouldSkipDuplicateEvent(seenEventIds, sseEventId)) return;
       const { state: reduced } = safeReduceWorkflow(state, event, eventCount, reduceOpts);
       const evicted = finalizeState(reduced);
       const nextMeta = sseEventId ? { ...evicted.meta, lastEventId: sseEventId } : evicted.meta;
@@ -3039,6 +3115,23 @@ function createWorkflowSessionStore(initialState = createEmptyWorkflowSessionSta
           loopSessionId
         )
       }));
+    },
+    hydrateFromSnapshot(snapshot, options) {
+      const { state } = get();
+      const next = finalizeState(
+        hydrateWorkflowFromSnapshot(state, snapshot, options)
+      );
+      markEventIdSeen(seenEventIds, snapshot.cursor);
+      set({ state: next });
+    },
+    markSnapshotHydrateFailed() {
+      set((current) => ({
+        state: {
+          ...current.state,
+          snapshotHydrateFailed: true,
+          reconnectSuppressedReason: "snapshot_unavailable"
+        }
+      }));
     }
   }));
 }
@@ -4642,7 +4735,35 @@ function WorkflowSessionBanners({ state }) {
   if (banner.kind === "none" && display.projectionStatus !== "error" && display.projectionStatus !== "done_with_warning" && state.internalErrors.length === 0) {
     return null;
   }
+  const showTransportError = (display.projectionStatus === "error" || state.internalErrors.length > 0) && banner.kind !== "projection_degraded" && banner.kind !== "authority_error";
   return /* @__PURE__ */ jsxs12(Fragment3, { children: [
+    banner.kind === "authority_error" ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-banner lax-workflow-banner--authority-error",
+        "data-testid": "lax-workflow-authority-error-banner",
+        role: "alert",
+        children: banner.message
+      }
+    ) : null,
+    banner.kind === "projection_degraded" ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-banner lax-workflow-banner--projection-degraded",
+        "data-testid": "lax-workflow-projection-degraded-banner",
+        role: "status",
+        children: banner.message
+      }
+    ) : null,
+    banner.kind === "snapshot_unavailable" ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-banner lax-workflow-banner--snapshot-unavailable",
+        "data-testid": "lax-workflow-snapshot-unavailable-banner",
+        role: "status",
+        children: banner.message
+      }
+    ) : null,
     banner.kind === "partial_success" ? /* @__PURE__ */ jsx17(
       "div",
       {
@@ -4686,7 +4807,7 @@ function WorkflowSessionBanners({ state }) {
         children: banner.message
       }
     ) : null,
-    display.projectionStatus === "error" || state.internalErrors.length > 0 ? /* @__PURE__ */ jsx17(
+    showTransportError ? /* @__PURE__ */ jsx17(
       "div",
       {
         className: "lax-workflow-error",
@@ -4825,6 +4946,8 @@ import { jsx as jsx19, jsxs as jsxs14 } from "react/jsx-runtime";
 function WorkflowSession({
   source,
   authoritySource,
+  snapshotBootstrap,
+  snapshotHydrateFailed = false,
   initialEvents,
   registry,
   tierOverrides,
@@ -4863,6 +4986,16 @@ function WorkflowSession({
   const streamEnded = useStore5(store, (s) => s.state.display.streamEnded);
   const authorityStatus = useStore5(store, (s) => s.state.authority?.status);
   useWorkflowAwaitingAuthorityTimers(store, streamEnded, authorityStatus);
+  useEffect10(() => {
+    if (snapshotBootstrap) {
+      store.getState().hydrateFromSnapshot(snapshotBootstrap, { preserveAuthority: true });
+    }
+  }, [snapshotBootstrap, store]);
+  useEffect10(() => {
+    if (snapshotHydrateFailed) {
+      store.getState().markSnapshotHydrateFailed();
+    }
+  }, [snapshotHydrateFailed, store]);
   const scaleOptions = useMemo9(
     () => ({ ...DEFAULT_WORKFLOW_SCALE_OPTIONS, ...workflowScale }),
     [workflowScale]
@@ -4905,10 +5038,13 @@ function WorkflowSession({
   const loopTreesBySessionId = sessionState.loopTreesBySessionId;
   const onErrorRef = useRef4(onError);
   const onDisplayStreamEndedRef = useRef4(onDisplayStreamEnded);
+  const streamAbortRef = useRef4(null);
   onErrorRef.current = onError;
   onDisplayStreamEndedRef.current = onDisplayStreamEnded;
   useEffect10(() => {
+    if (!source) return void 0;
     const controller = new AbortController();
+    streamAbortRef.current = controller;
     void source.start((event, ctx) => {
       store.getState().applyEvent(event, ctx);
     }, controller.signal).then(() => {
@@ -4924,8 +5060,14 @@ function WorkflowSession({
     });
     return () => {
       controller.abort();
+      streamAbortRef.current = null;
     };
   }, [source, store]);
+  useEffect10(() => {
+    if (isAuthorityTerminalStatus(authorityStatus)) {
+      streamAbortRef.current?.abort();
+    }
+  }, [authorityStatus]);
   return /* @__PURE__ */ jsx19(WorkflowSessionStoreContext.Provider, { value: store, children: /* @__PURE__ */ jsx19(WorkflowScaleContext.Provider, { value: scaleOptions, children: /* @__PURE__ */ jsx19(WorkflowLoopReplayProvider, { onRequestLoopReplay, children: /* @__PURE__ */ jsx19(InteractionBusContext.Provider, { value: busRef, children: /* @__PURE__ */ jsx19(NodeRegistryContext.Provider, { value: registryRef, children: /* @__PURE__ */ jsx19(MarkdownRendererContext.Provider, { value: markdownRenderer, children: /* @__PURE__ */ jsx19(ToolDisplayOptionsContext.Provider, { value: toolDisplayRef, children: /* @__PURE__ */ jsx19(SessionViewOptionsContext.Provider, { value: sessionViewRef, children: /* @__PURE__ */ jsxs14(
     "div",
     {
@@ -5315,7 +5457,9 @@ export {
   getDisplayProjectionStatus,
   getMainStageIds,
   getNoopInteractionBus,
+  hydrateWorkflowFromSnapshot,
   isAgentLoopReplayEventType,
+  isAtOrBeforeProjectionCursor,
   isAuthorityTerminal,
   isAuthorityTerminalStatus,
   isGitOperationCommand,