langchain_agentx_stream_ui 0.1.1 → 0.1.3

package/dist/{chunk-R35BQYAY.js → chunk-A4W6B7C3.js}

@@ -24,7 +24,7 @@ import {
   useSessionStatus,
   useSessionViewOptions,
   useToolDisplayOptions
-} from "./chunk-Q4HRD7EM.js";
+} from "./chunk-3B4WC67E.js";
 import {
   createDefaultToolRegistry
 } from "./chunk-MHK53ZHC.js";
@@ -1426,4 +1426,4 @@ export {
   createActiveSessionBridge,
   MultiAgentSession
 };
-//# sourceMappingURL=chunk-R35BQYAY.js.map
+//# sourceMappingURL=chunk-A4W6B7C3.js.map

package/dist/default.css

@@ -1961,6 +1961,10 @@
   padding: 0;
 }
 
+/*
+ * D25 Phase 1：.lax-workflow-virtual-list 及其变体不再被 workflow 主链路引用。
+ * 保留样式定义以兼容仍可能引用 WorkflowVirtualRowList 的回滚路径（风险 R1）。
+ */
 .lax-workflow-virtual-list {
   position: relative;
   overflow: auto;
@@ -1994,6 +1998,13 @@
   border-color: var(--lax-accent-primary, currentColor);
 }
 
+.lax-workflow-stage-list__hidden-hint {
+  margin: 0.35rem 0 0;
+  font-size: 0.75rem;
+  color: var(--lax-muted);
+  font-style: italic;
+}
+
 .lax-workflow-loop-replay-pending__hint {
   color: var(--lax-muted);
   font-size: 0.8125rem;

package/dist/index.d.ts

@@ -68,16 +68,26 @@ declare function WorkflowLoopReplayProvider({ onRequestLoopReplay, children, }:
 
 /** Workflow 大规模编排 UI 缩放选项（P1–P4） */
 interface WorkflowScaleOptions {
-    /** P1：根 stage 列表超过此数量启用虚拟滚动 */
+    /**
+     * P1：已弃用 — stage 壳列表不再使用虚拟滚动。
+     * 保留字段以保证向后兼容，工作流主链路不再读取此值。
+     * @deprecated D25 Phase 1 移除 stage shell virtualization 后不再生效。
+     */
     stageVirtualizeThreshold: number;
-    /** P3：默认展示的 done stage 上限（running/failed/pending 始终展示） */
-    stagePageSize: number;
+    /** P3：默认展示的 completed done stage 上限（running/failed/pending 始终展示） */
+    completedStagePageSize: number;
     /** P2：completed 且未 pin 的 loop 树移出内存，保留摘要 */
     evictCompletedLoops: boolean;
     /** P4：running 容器仅 active 自动展开 AgentLoopView */
     onlyExpandActiveRunning: boolean;
-    /** Parallel 组内 item 虚拟滚动阈值 */
+    /**
+     * P1：已弃用 — parallel item shell 不再使用虚拟滚动（最大并行跨度仅 4）。
+     * 保留字段以保证向后兼容，工作流主链路不再读取此值。
+     * @deprecated D25 Phase 1 移除 parallel item virtualization 后不再生效。
+     */
     parallelItemVirtualizeThreshold: number;
+    /** P2：completed hydrated loop 热缓存上限（默认 4，与最大并行跨度对齐） */
+    maxHydratedCompletedLoops: number;
 }
 declare const DEFAULT_WORKFLOW_SCALE_OPTIONS: WorkflowScaleOptions;
 
@@ -203,9 +213,17 @@ interface WorkflowStageListPartition {
     visible: WorkflowContainerRuntimeNode[];
     hiddenCount: number;
     total: number;
+    /** 当前已展示的 done stage 数量 */
+    visibleDoneCount: number;
+    /** done stage 总数 */
+    totalDoneCount: number;
 }
-/** P3：running / failed / pending 全显；done 仅保留最近 pageSize 条 */
-declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[], pageSize: number, showAll: boolean): WorkflowStageListPartition;
+/**
+ * P3：running / failed / pending / blocked 全显；
+ * done 按 maxVisibleDoneCount 分页展示（默认最近 completedStagePageSize 条）。
+ * maxVisibleDoneCount 由 WorkflowStageListPanel 的 "Show N more" 逐页递增。
+ */
+declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[], maxVisibleDoneCount: number): WorkflowStageListPartition;
 
 /**
  * workflowSession.ts — Workflow 会话顶层状态
@@ -269,6 +287,8 @@ interface WorkflowSessionState {
     loopTreesBySessionId: Record<string, SessionTree>;
     /** P2：container_id → done 摘要（loop 淘汰后） */
     stageDoneSummariesByContainerId: Record<string, CachedStageDoneSummary>;
+    /** P2：completed hydrated loop LRU 热缓存（最近使用在数组尾部） */
+    hotCompletedLoopSessionIds: string[];
     activeLoopSessionId: string | null;
     /** @deprecated P1 起由 containerTree.activeContainerIds 替代 */
     openScopeStack: WorkflowScopeFrame[];
@@ -295,6 +315,8 @@ interface WorkflowSessionStoreOptions {
     initialSeenEventIds?: Iterable<string>;
     /** P2：completed loop 树内存淘汰（默认 true） */
     evictCompletedLoops?: boolean;
+    /** P2：completed hydrated loop 热缓存上限（默认 4） */
+    maxHydratedCompletedLoops?: number;
 }
 interface WorkflowSessionStoreState {
     state: WorkflowSessionState;
@@ -1002,20 +1024,21 @@ declare function reduceWorkflowSession(state: WorkflowSessionState, event: Langc
 /** 从空状态回放 workflow 事件序列。 */
 declare function reduceWorkflowEvents(events: LangchainAgentEvent[], options?: ReduceOptions): WorkflowSessionState;
 
-/**
- * workflowStructureEvents.ts — Workflow 结构事件类型守卫
- *
- * 职责：
- *     区分 workflow 编排结构 event_type 与 agent loop 事件。
- *
- * 链路位置：
- *     workflowReducer 路由 · Source application_kind 守卫（并行契约）。
- *
- * 当前裁剪范围：
- *     与 backend WORKFLOW_STRUCTURE_EVENT_TYPES 对齐；不进 tier-1 白名单。
- */
+/** 与 backend/langchain_agentx_stream_ui_backend/task_sync/multi_sse_bridge.py 对齐 */
+declare const WORKFLOW_STRUCTURE_EVENT_PREFIXES: readonly string[];
+/** 显式 SSOT（文档/契约测试）；新增结构类型应同时满足前缀规则或补入此集合 */
 declare const WORKFLOW_STRUCTURE_EVENT_TYPES: ReadonlySet<string>;
 declare function isWorkflowStructureEventType(eventType: string): boolean;
+/** agent loop hydrate/replay 允许进入 reduceTree 的事件（正文 + state/debug tier） */
+declare function isAgentLoopReplayEventType(eventType: string): boolean;
+/**
+ * hydrateLoopSession / 宿主 replay：
+ * 1. 白名单：只保留 reduceTree 已知 event_type
+ * 2. 结构前缀/集合：双重排除 workflow 编排帧（含 session_id 误绑的 dual emission）
+ */
+declare function filterAgentLoopReplayEvents<T extends {
+    event_type: string;
+}>(events: T[]): T[];
 
 /**
  * 职责：事件分级类型（V2-A classify 层公共契约）。
@@ -1045,4 +1068,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, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, NodeRegistry, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, 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 SseTransportFailureKind, SseTransportTerminalError, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, 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, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, entryKey, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isGitOperationCommand, isGroupableToolName, isMcpToolName, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, 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, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, NodeRegistry, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, 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 SseTransportFailureKind, 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, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, entryKey, filterAgentLoopReplayEvents, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isAgentLoopReplayEventType, isGitOperationCommand, isGroupableToolName, isMcpToolName, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };