langchain_agentx_stream_ui 0.2.5 → 0.2.7

package/dist/default.css

@@ -2050,6 +2050,24 @@
   --lax-workflow-indent: calc(var(--lax-workflow-depth, 0) * var(--lax-workflow-indent-unit, 1rem));
 }
 
+.lax-workflow-closeout-warning {
+  margin: 0 0 0.75rem;
+  padding: 0.65rem 0.85rem;
+  border-radius: var(--lax-radius, 8px);
+  border: 1px solid color-mix(in srgb, var(--lax-color-warning, #b8860b) 45%, transparent);
+  background: var(--lax-bg-warning, #fdf8ec);
+  color: color-mix(in srgb, var(--lax-color-warning, #b8860b) 85%, #000);
+  font-size: 0.875rem;
+  line-height: 1.45;
+}
+
+.lax-workflow-closeout-warning__scopes {
+  margin: 0.45rem 0 0 1.1rem;
+  padding: 0;
+  font-family: Consolas, monospace;
+  font-size: 0.8125rem;
+}
+
 .lax-workflow-chrome {
   display: flex;
   flex-direction: column;
@@ -2267,6 +2285,11 @@
   color: var(--lax-color-done, var(--lax-accent-primary));
 }
 
+.lax-workflow-container-line__status-dot[data-status='warning'],
+.lax-workflow-stage-container__status-dot[data-status='warning'] {
+  color: var(--lax-color-warning, #b8860b);
+}
+
 .lax-workflow-stage-container__status-dot[data-status='pending'] {
   color: var(--lax-muted);
   opacity: 0.5;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, PointerEventHandler } from 'react';
-import { q as Source, L as LangchainAgentEvent, N as NodeRegistry, v as TierOverrides, I as InteractionBus, M as MarkdownRenderer, p as SessionTree, l as SessionStatus, R as ReducerError, r as SourceEventContext, T as Task, t as TaskPhase, E as EventTier } from './multi-session-Dxyo3y7w.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-Dxyo3y7w.js';
+import { q as Source, L as LangchainAgentEvent, N as NodeRegistry, v as TierOverrides, I as InteractionBus, M as MarkdownRenderer, p as SessionTree, l as SessionStatus, R as ReducerError, r as SourceEventContext, T as Task, t as TaskPhase, E as EventTier } from './multi-session-xvSZstSN.js';
+export { C as CommonFields, D as DEFAULT_EVENT_TIERS, a as EventType, b as InteractionBusHandlers, c as MarkdownRendererProps, d as MultiAgentSession, e as MultiAgentSessionProps, f as MultiSessionSourceConfig, g as MultiSessionStore, h as MultiSessionStoreOptions, i as MultiSessionStoreState, j as NodeWidget, k as NodeWidgetProps, P as PermissionResolvePayload, S as SessionSlice, m as SessionStore, n as SessionStoreOptions, o as SessionStoreState, s as SourceHandler, u as TaskStatus, w as createActiveSessionBridge, x as createEmptyTree, y as createInteractionBus, z as createMultiSessionStore, A as createSessionStore, B as getNoopInteractionBus, F as useActiveSession, G as useSessionIds } from './multi-session-xvSZstSN.js';
 import { T as ToolDisplayRegistry, P as PermissionUiMode, b as DisplayMode, c as ProjectionContext, R as RenderableEntry, C as CanonicalNodeRef } from './sessionViewOptions-WM00Fpcn.js';
 export { a as CollapsedExplorePayload, D as DEFAULT_SESSION_VIEW_OPTIONS, S as SessionViewOptions, d as ToolUseSnapshot, e as buildProjectionContext, f as buildProjectionViewContext, g as createDefaultToolRegistry, h as createProjectionContext, r as resolveEffectiveToolBodyMode, s as shouldApplyGrouping, i as shouldShowExploreDetail } from './sessionViewOptions-WM00Fpcn.js';
 import { a as ToolBodyMode } from './types-BEXSHQG7.js';
@@ -21,6 +21,9 @@ interface AgentSessionProps {
     registry?: NodeRegistry;
     tierOverrides?: TierOverrides;
     onError?: (error: Error) => void;
+    /**
+     * @deprecated 重连策略由 Source（如 createAgentxSseSource 的 profile）承载；本 prop 未接入 store
+     */
     autoReconnect?: boolean;
     debug?: boolean;
     /** 为 true 且主舞台节点数超过阈值时使用 VirtualTimeline（V2-E） */
@@ -240,6 +243,8 @@ declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[],
  *     不含合并 TaskListFooter（P3）；parallel 结构仅基础字段。
  */
 
+/** SDK v1.9.0 根 workflow 终态语义 SSOT */
+type WorkflowTerminalKind = 'healthy' | 'forced_closeout' | 'failed';
 /** P2：stage 完成摘要缓存（loop 树淘汰后仍显示 teaser） */
 interface CachedStageDoneSummary {
     label: string;
@@ -277,6 +282,10 @@ interface WorkflowScopeFrame {
 }
 interface WorkflowSessionState {
     status: SessionStatus;
+    /** SDK v1.9.0 根终态语义；stream 推断 done 时为 null */
+    terminalKind: WorkflowTerminalKind | null;
+    /** forced_closeout 时 SDK 写入的未关闭 child scope */
+    openChildIdentities: string[];
     meta: {
         workflowRunId: string | null;
         startedAt: number | null;
@@ -1202,4 +1211,4 @@ interface ClassifyContext {
 declare function resolveEventTier(eventType: string, overrides?: TierOverrides): EventTier;
 declare function classifyEvent(event: LangchainAgentEvent, ctx: ClassifyContext, overrides?: TierOverrides, eventIndex?: number): ClassifiedEvent;
 
-export { Agent, AgentLoopView, type AgentLoopViewProps, AgentSession, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, type ApplicationKind, ApplicationKindMismatchError, AskUserQuestion, BOUNDED_DEFAULTS, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, type DiagramFitLayout, DiagramZoomShell, type DiagramZoomShellProps, DiagramZoomView, type DiagramZoomViewProps, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, type HydrateLoopSessionAsyncOptions, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, NodeRegistry, PROFILE_PRESETS, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, ReconnectBudget, type ReduceOptions, ReducerError, RenderableEntry, RenderableTimelineProjector, type ReplayOptions, type ReplaySourceOptions, RichMarkdown, type RichMarkdownProps, SHELL_PROGRESS_MIN_ELAPSED_SECONDS, SessionNode, SessionNodeKind, SessionStatus, SessionTree, Skill, Source, SourceEventContext, Spinner, type SpinnerProps, type SseReconnectMode, type SseReconnectPolicy, type SseReplayMode, type SseTerminalPolicy, type SseTransportFailureKind, type SseTransportPolicy, type SseTransportPolicyOverride, type SseTransportProfile, SseTransportTerminalError, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, WORKFLOW_STRUCTURE_EVENT_PREFIXES, WORKFLOW_STRUCTURE_EVENT_TYPES, WebFetch, WebSearch, WorkflowChrome, type WorkflowChromeProps, type WorkflowLoopReplayHandler, WorkflowLoopReplayProvider, type WorkflowProgressState, WorkflowScaleContext, type WorkflowScaleOptions, type WorkflowScopeFrame, WorkflowSession, type WorkflowSessionProps, type WorkflowSessionState, type WorkflowSessionStore, type WorkflowSessionStoreOptions, type WorkflowSessionStoreState, type WorkflowStageProgress, WorkflowTaskListFooter, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, computeViewportFitTransform, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, deriveLoopSessionIdFromAgentEvent, entryKey, filterAgentLoopReplayEvents, fixDiagramSvg, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isAgentLoopReplayEventType, isGitOperationCommand, isGroupableToolName, isMcpToolName, isSseStreamTerminalEvent, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, resolveSseTransportPolicy, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };
+export { Agent, AgentLoopView, type AgentLoopViewProps, AgentSession, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, type ApplicationKind, ApplicationKindMismatchError, AskUserQuestion, BOUNDED_DEFAULTS, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, type DiagramFitLayout, DiagramZoomShell, type DiagramZoomShellProps, DiagramZoomView, type DiagramZoomViewProps, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, type HydrateLoopSessionAsyncOptions, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, NodeRegistry, PROFILE_PRESETS, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, ReconnectBudget, type ReduceOptions, ReducerError, RenderableEntry, RenderableTimelineProjector, type ReplayOptions, type ReplaySourceOptions, RichMarkdown, type RichMarkdownProps, SHELL_PROGRESS_MIN_ELAPSED_SECONDS, SessionNode, SessionNodeKind, SessionStatus, SessionTree, Skill, Source, SourceEventContext, Spinner, type SpinnerProps, type SseReconnectMode, type SseReconnectPolicy, type SseReplayMode, type SseTerminalPolicy, type SseTransportFailureKind, type SseTransportPolicy, type SseTransportPolicyOverride, type SseTransportProfile, SseTransportTerminalError, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, WORKFLOW_STRUCTURE_EVENT_PREFIXES, WORKFLOW_STRUCTURE_EVENT_TYPES, WebFetch, WebSearch, WorkflowChrome, type WorkflowChromeProps, type WorkflowLoopReplayHandler, WorkflowLoopReplayProvider, type WorkflowProgressState, WorkflowScaleContext, type WorkflowScaleOptions, type WorkflowScopeFrame, WorkflowSession, type WorkflowSessionProps, type WorkflowSessionState, type WorkflowSessionStore, type WorkflowSessionStoreOptions, type WorkflowSessionStoreState, type WorkflowStageProgress, WorkflowTaskListFooter, type WorkflowTerminalKind, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, computeViewportFitTransform, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, deriveLoopSessionIdFromAgentEvent, entryKey, filterAgentLoopReplayEvents, fixDiagramSvg, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isAgentLoopReplayEventType, isGitOperationCommand, isGroupableToolName, isMcpToolName, isSseStreamTerminalEvent, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, resolveSseTransportPolicy, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   fixDiagramSvg,
   markEventIdSeen,
   shouldSkipDuplicateEvent
-} from "./chunk-AVSPJ252.js";
+} from "./chunk-CUKNUCGU.js";
 import {
   DefaultToolBody,
   InteractionBusContext,
@@ -111,7 +111,7 @@ import {
   useSessionStatus,
   useSessionViewOptions,
   useTimeline
-} from "./chunk-D4BG3I7P.js";
+} from "./chunk-SUEMZC4U.js";
 import {
   Agent,
   AgentToolBody,
@@ -263,6 +263,17 @@ var BOUNDED_DEFAULTS = {
   reconnectTimeoutMs: 6e4,
   reconnectDelayMs: 1e3
 };
+var legacyAutoReconnectWarned = false;
+function warnLegacyAutoReconnectOnce() {
+  if (legacyAutoReconnectWarned) return;
+  if (typeof process !== "undefined" && process.env.NODE_ENV === "production") {
+    return;
+  }
+  legacyAutoReconnectWarned = true;
+  console.warn(
+    "[langchain_agentx_stream_ui] autoReconnect is deprecated; use profile or policy.reconnect instead."
+  );
+}
 var AGENT_TERMINAL = {
   primary: ["finish"],
   allowFinishFallback: false
@@ -353,6 +364,9 @@ function resolveSseTransportPolicy(input) {
     reconnectDelayMs,
     expectedApplicationKind
   } = input;
+  if (profile === void 0 && policyOverride === void 0 && autoReconnect !== void 0) {
+    warnLegacyAutoReconnectOnce();
+  }
   let base;
   if (profile) {
     base = { ...PROFILE_PRESETS[profile] };
@@ -942,6 +956,8 @@ function createEmptyWorkflowProgress() {
 function createEmptyWorkflowSessionState() {
   return {
     status: "connecting",
+    terminalKind: null,
+    openChildIdentities: [],
     meta: { workflowRunId: null, startedAt: null, lastEventId: null },
     containerTree: createEmptyWorkflowContainerTreeState(),
     workflowProgress: createEmptyWorkflowProgress(),
@@ -2106,6 +2122,38 @@ function readWorkflowId(data) {
   return readWorkflowIdFromData(data);
 }
 
+// src/core/workflow/workflowTerminalKind.ts
+function resolveWorkflowTerminalKind(data, eventType) {
+  const raw = data.terminal_kind;
+  if (raw === "healthy" || raw === "forced_closeout" || raw === "failed") {
+    return raw;
+  }
+  if (data.closeout_forced === true) {
+    return "forced_closeout";
+  }
+  if (eventType === "workflow-failed") {
+    return "failed";
+  }
+  return "healthy";
+}
+function sessionStatusFromTerminalKind(kind, isWorkflowFailedEvent) {
+  if (isWorkflowFailedEvent || kind === "failed") {
+    return "error";
+  }
+  if (kind === "forced_closeout") {
+    return "done_with_warning";
+  }
+  return "done";
+}
+function readOpenChildIdentities(data) {
+  const raw = data.open_child_identities;
+  if (!Array.isArray(raw)) return [];
+  return raw.filter((item) => typeof item === "string");
+}
+function isWorkflowSessionTerminal(status) {
+  return status === "done" || status === "done_with_warning" || status === "error";
+}
+
 // src/core/workflowReducer.ts
 function readString5(data, key) {
   const value = data[key];
@@ -2479,9 +2527,25 @@ function applyStructureEvent(state, event) {
   if (workflowProgress.status === "done") status = "done";
   else if (workflowProgress.status === "error") status = "error";
   else if (status === "connecting") status = "running";
+  let terminalKind = state.terminalKind;
+  let openChildIdentities = state.openChildIdentities;
+  if (projectedEvent.event_type === "workflow-end" || projectedEvent.event_type === "workflow-failed") {
+    const resolved = resolveWorkflowTerminalKind(
+      structureData,
+      projectedEvent.event_type
+    );
+    status = sessionStatusFromTerminalKind(
+      resolved,
+      projectedEvent.event_type === "workflow-failed"
+    );
+    terminalKind = resolved;
+    openChildIdentities = resolved === "forced_closeout" ? readOpenChildIdentities(structureData) : [];
+  }
   const base = {
     ...nextState,
     status,
+    terminalKind,
+    openChildIdentities,
     containerTree,
     workflowProgress
   };
@@ -2566,7 +2630,7 @@ function reduceWorkflowSession(state, event, eventIndex, options) {
   };
 }
 function finalizeWorkflowSessionOnStreamComplete(state) {
-  if (state.status === "done" || state.status === "error") {
+  if (isWorkflowSessionTerminal(state.status)) {
     return { ...state, activeLoopSessionId: null };
   }
   const tree = state.containerTree;
@@ -3148,7 +3212,10 @@ function mapContainerStatusLabel(status) {
       return "pending";
   }
 }
-function mapWorkflowRootStatusLabel(status) {
+function mapWorkflowRootStatusLabel(status, sessionStatus) {
+  if (sessionStatus === "done_with_warning" && status === "completed") {
+    return "done (warning)";
+  }
   switch (status) {
     case "completed":
       return "done";
@@ -3861,9 +3928,12 @@ function WorkflowRootContainer({
   containersById
 }) {
   const { verbose } = useSessionViewOptions();
+  const sessionStatus = useWorkflowSessionStatus();
   const visuallyActive = containersById ? isWorkflowRootVisuallyActive(node, containersById) : node.status === "running" || node.status === "retrying";
-  const uiStatus = mapContainerUiStatus(visuallyActive ? "running" : node.status);
-  const statusLabel = mapWorkflowRootStatusLabel(visuallyActive ? "running" : node.status);
+  const nodeStatus = visuallyActive ? "running" : node.status;
+  const forcedCloseout = sessionStatus === "done_with_warning" && nodeStatus === "completed";
+  const uiStatus = forcedCloseout ? "warning" : mapContainerUiStatus(nodeStatus);
+  const statusLabel = mapWorkflowRootStatusLabel(nodeStatus, sessionStatus);
   const meta = containersById ? buildEffectiveWorkflowRootMeta(node, containersById) : buildWorkflowRootMeta(node);
   return /* @__PURE__ */ jsxs7("div", { className: "lax-workflow-root", "data-testid": "lax-workflow-root", children: [
     /* @__PURE__ */ jsx12(
@@ -4573,6 +4643,10 @@ function WorkflowSession({
     storeRef.current,
     (s) => s.state.loopTreesBySessionId
   );
+  const openChildIdentities = useStore4(
+    storeRef.current,
+    (s) => s.state.openChildIdentities
+  );
   const sessionStatus = useStore4(
     storeRef.current,
     (s) => s.state.status
@@ -4611,6 +4685,22 @@ function WorkflowSession({
       className: "lax-agent-session lax-workflow-session",
       "data-testid": "lax-workflow-session",
       children: [
+        sessionStatus === "done_with_warning" ? /* @__PURE__ */ jsxs12(
+          "div",
+          {
+            className: "lax-workflow-closeout-warning",
+            "data-testid": "lax-workflow-closeout-warning",
+            role: "status",
+            children: [
+              /* @__PURE__ */ jsx17("strong", { children: "Workflow forced closeout" }),
+              /* @__PURE__ */ jsxs12("span", { children: [
+                " ",
+                "\u2014 stream ended with unresolved child scopes; not a healthy completion."
+              ] }),
+              openChildIdentities.length > 0 ? /* @__PURE__ */ jsx17("ul", { className: "lax-workflow-closeout-warning__scopes", children: openChildIdentities.map((identity) => /* @__PURE__ */ jsx17("li", { children: identity }, identity)) }) : null
+            ]
+          }
+        ) : null,
         sessionStatus === "error" || internalErrors.length > 0 ? /* @__PURE__ */ jsx17(
           "div",
           {