langchain_agentx_stream_ui 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -1024,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 层公共契约）。
@@ -1067,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 };

package/dist/index.js

@@ -1249,6 +1249,13 @@ function loopTaskScopeForStructureOpen(eventType) {
 }
 
 // src/core/workflowStructureEvents.ts
+var WORKFLOW_STRUCTURE_EVENT_PREFIXES = [
+  "workflow-",
+  "stage-",
+  "parallel-",
+  "route-",
+  "subworkflow-"
+];
 var WORKFLOW_STRUCTURE_EVENT_TYPES = /* @__PURE__ */ new Set([
   "workflow-start",
   "workflow-end",
@@ -1268,8 +1275,20 @@ var WORKFLOW_STRUCTURE_EVENT_TYPES = /* @__PURE__ */ new Set([
   "route-branch-done",
   "route-branch-failed"
 ]);
+var AGENT_LOOP_REPLAY_EVENT_TYPES = new Set(
+  Object.keys(DEFAULT_EVENT_TIERS)
+);
 function isWorkflowStructureEventType(eventType) {
-  return WORKFLOW_STRUCTURE_EVENT_TYPES.has(eventType);
+  if (WORKFLOW_STRUCTURE_EVENT_TYPES.has(eventType)) return true;
+  return WORKFLOW_STRUCTURE_EVENT_PREFIXES.some((prefix) => eventType.startsWith(prefix));
+}
+function isAgentLoopReplayEventType(eventType) {
+  return AGENT_LOOP_REPLAY_EVENT_TYPES.has(eventType);
+}
+function filterAgentLoopReplayEvents(events) {
+  return events.filter(
+    (event) => isAgentLoopReplayEventType(event.event_type) && !isWorkflowStructureEventType(event.event_type)
+  );
 }
 
 // src/core/workflowReducer.ts
@@ -1421,16 +1440,17 @@ function findContainerByLoopSession(tree, loopSessionId) {
   return null;
 }
 var WORKFLOW_DEFAULT_LOOP_SESSION_ID = "workflow-loop-default";
-function resolveAgentLoopSessionId(event) {
+function resolveAgentLoopSessionId(event, activeLoopSessionId) {
   if (event.session_id) return event.session_id;
   if (isWorkflowStructureEventType(event.event_type)) return null;
   if (event.event_type === "task-list-snapshot") return null;
   const derived = deriveLoopSessionIdFromAgentEvent(event);
   if (derived) return derived;
+  if (activeLoopSessionId) return activeLoopSessionId;
   return WORKFLOW_DEFAULT_LOOP_SESSION_ID;
 }
-function bindLoopSessionToContainerTree(tree, event) {
-  const sessionId = resolveAgentLoopSessionId(event);
+function bindLoopSessionToContainerTree(tree, event, activeLoopSessionId) {
+  const sessionId = resolveAgentLoopSessionId(event, activeLoopSessionId);
   if (!sessionId) return tree;
   if (findContainerByLoopSession(tree, sessionId)) return tree;
   const data = event.data ?? {};
@@ -1536,8 +1556,12 @@ function reduceWorkflowSession(state, event, eventIndex, options) {
   if (isWorkflowStructureEventType(event.event_type)) {
     return applyStructureEvent(state, event);
   }
-  const loopSessionId = resolveAgentLoopSessionId(event) ?? WORKFLOW_DEFAULT_LOOP_SESSION_ID;
-  let containerTree = bindLoopSessionToContainerTree(state.containerTree, event);
+  const loopSessionId = resolveAgentLoopSessionId(event, state.activeLoopSessionId) ?? WORKFLOW_DEFAULT_LOOP_SESSION_ID;
+  let containerTree = bindLoopSessionToContainerTree(
+    state.containerTree,
+    event,
+    state.activeLoopSessionId
+  );
   containerTree = applyStructureToContainerTree(containerTree, event);
   let next = ensureLoopTree({ ...state, containerTree }, loopSessionId);
   const loopTree = next.loopTreesBySessionId[loopSessionId];
@@ -1812,7 +1836,7 @@ function createWorkflowSessionStore(initialState = createEmptyWorkflowSessionSta
       const { state, eventCount } = get();
       let tree = state.loopTreesBySessionId[loopSessionId] ?? createEmptyTree();
       let idx = eventCount;
-      for (const event of events) {
+      for (const event of filterAgentLoopReplayEvents(events)) {
         tree = reduceTree(tree, event, idx, reduceOpts);
         idx += 1;
       }
@@ -3489,6 +3513,7 @@ export {
   TruncatedContent,
   UnknownCard,
   VirtualTimeline,
+  WORKFLOW_STRUCTURE_EVENT_PREFIXES,
   WORKFLOW_STRUCTURE_EVENT_TYPES,
   WebFetch,
   WebFetchToolBody,
@@ -3528,6 +3553,7 @@ export {
   createWorkflowSessionStore,
   displayPath,
   entryKey,
+  filterAgentLoopReplayEvents,
   formatAgentTitle,
   formatDiffFromStrings,
   formatExploreSummaryText,
@@ -3541,6 +3567,7 @@ export {
   getChildIds,
   getMainStageIds,
   getNoopInteractionBus,
+  isAgentLoopReplayEventType,
   isGitOperationCommand,
   isGroupableToolName,
   isMcpToolName,