langchain_agentx_stream_ui 0.2.3 → 0.2.6

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';
@@ -240,6 +240,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 +279,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;
@@ -955,6 +961,67 @@ declare class MissingApplicationKindError extends Error {
     constructor();
 }
 
+/**
+ * 职责：SSE transport profile / policy 解析与终态、重连预算语义（D31 P1）。
+ * 链路位置：createAgentxSseSource 入口 → resolveSseTransportPolicy → 连接状态机。
+ * 当前裁剪范围：三预设 profile + 显式 policy 覆写；不含 backend replayMode。
+ */
+
+type SseTransportProfile = 'oneshot' | 'oneshot-workflow' | 'replayable-workflow';
+type SseReplayMode = 'none' | 'resume' | 'history';
+type SseReconnectMode = 'off' | 'bounded' | 'unbounded';
+interface SseReconnectPolicy {
+    mode: SseReconnectMode;
+    maxReconnects: number;
+    reconnectTimeoutMs: number;
+    reconnectDelayMs: number;
+}
+interface SseTerminalPolicy {
+    primary: readonly string[];
+    allowFinishFallback: boolean;
+}
+interface SseTransportPolicy {
+    profile?: SseTransportProfile;
+    replay: SseReplayMode;
+    reconnect: SseReconnectPolicy;
+    terminal: SseTerminalPolicy;
+}
+interface SseTransportPolicyOverride {
+    replay?: SseReplayMode;
+    reconnect?: Partial<SseReconnectPolicy>;
+    terminal?: Partial<SseTerminalPolicy>;
+}
+interface ResolveSseTransportPolicyInput {
+    profile?: SseTransportProfile;
+    policy?: SseTransportPolicyOverride;
+    /** @deprecated 使用 profile 或 policy.reconnect */
+    autoReconnect?: boolean;
+    /** @deprecated 使用 policy.reconnect.reconnectDelayMs */
+    reconnectDelayMs?: number;
+    expectedApplicationKind?: ApplicationKind;
+}
+declare const BOUNDED_DEFAULTS: {
+    readonly maxReconnects: 5;
+    readonly reconnectTimeoutMs: 60000;
+    readonly reconnectDelayMs: 1000;
+};
+declare const PROFILE_PRESETS: Record<SseTransportProfile, SseTransportPolicy>;
+/** 将 profile / policy / 旧 autoReconnect 选项解析为完整 transport 策略。 */
+declare function resolveSseTransportPolicy(input: ResolveSseTransportPolicyInput): SseTransportPolicy;
+/** 判断 agentx 帧是否为传输层终态（触发 benign close / 停止重连）。 */
+declare function isSseStreamTerminalEvent(agentEvent: LangchainAgentEvent, terminal: SseTerminalPolicy, expectedApplicationKind?: ApplicationKind): boolean;
+/** bounded reconnect 预算：次数 + 总时长双门禁。 */
+declare class ReconnectBudget {
+    private readonly maxReconnects;
+    private readonly timeoutMs;
+    private readonly startedAtMs;
+    private attemptCount;
+    constructor(maxReconnects: number, timeoutMs: number, startedAtMs?: number);
+    get attempts(): number;
+    canRetry(nowMs?: number): boolean;
+    recordAttempt(): void;
+}
+
 /**
  * 职责：浏览器 EventSource 封装，解码 meta/agentx 命名帧并校验协议版本。
  * 链路位置：业务页面 createAgentxSseSource({ url }) → AgentSession source prop。
@@ -967,14 +1034,24 @@ declare class MissingApplicationKindError extends Error {
 
 declare const EXPECTED_PROTOCOL_VERSION = "1";
 /** 传输层 terminal 失败（须排查/fix）；与 agentx error 帧（业务错误）分离。 */
-type SseTransportFailureKind = 'handshake_failed' | 'premature_close';
+type SseTransportFailureKind = 'handshake_failed' | 'premature_close' | 'reconnect_budget_exhausted';
 declare class SseTransportTerminalError extends Error {
     readonly kind: SseTransportFailureKind;
     constructor(kind: SseTransportFailureKind, message: string);
 }
 interface AgentxSseSourceOptions {
     url: string;
+    /** D31：预设 transport 策略（ask / 短 workflow / 可回放 workflow） */
+    profile?: SseTransportProfile;
+    /** D31：在 profile 基础上显式覆写策略字段 */
+    policy?: SseTransportPolicyOverride;
+    /**
+     * @deprecated 使用 profile 或 policy.reconnect；未指定 profile 时仍生效
+     */
     autoReconnect?: boolean;
+    /**
+     * @deprecated 使用 policy.reconnect.reconnectDelayMs
+     */
     reconnectDelayMs?: number;
     /** 每收到 agentx 帧 SSE id 时回调（含续传重叠 id） */
     onLastEventId?: (id: string) => void;
@@ -989,6 +1066,7 @@ interface AgentxMetaFrame {
     started_at?: number;
     application_kind?: ApplicationKind;
 }
+/** 手动重连时追加 resume 查询参数（EventSource 无法设 Last-Event-ID 请求头）。 */
 declare function buildResumeStreamUrl(baseUrl: string, lastEventId: string | null | undefined, queryParam?: string): string;
 declare function createAgentxSseSource(options: AgentxSseSourceOptions): Source;
 /** 测试/Story 用：内存事件源 */
@@ -1130,4 +1208,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, 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, 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, computeViewportFitTransform, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, deriveLoopSessionIdFromAgentEvent, entryKey, filterAgentLoopReplayEvents, fixDiagramSvg, 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 };
+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-DGC43A5L.js";
+} from "./chunk-CUKNUCGU.js";
 import {
   DefaultToolBody,
   InteractionBusContext,
@@ -32,8 +32,8 @@ import {
   getNoopInteractionBus,
   resolveToolBody,
   useInteractionBus
-} from "./chunk-T626YBJX.js";
-import "./chunk-6Z4ZF36Z.js";
+} from "./chunk-6DYISADG.js";
+import "./chunk-DP7V33X7.js";
 import {
   CollapseKind,
   CollapsedExploreNode,
@@ -111,7 +111,7 @@ import {
   useSessionStatus,
   useSessionViewOptions,
   useTimeline
-} from "./chunk-OFXC2GZI.js";
+} from "./chunk-SUEMZC4U.js";
 import {
   Agent,
   AgentToolBody,
@@ -138,7 +138,7 @@ import {
   WriteToolBody,
   createDefaultToolRegistry,
   formatAgentTitle
-} from "./chunk-YUZXTGJJ.js";
+} from "./chunk-7CLAU74Y.js";
 import {
   BodyBlockList,
   DiffView,
@@ -154,7 +154,7 @@ import {
   formatTimeoutFooter,
   parseDiffText,
   truncateCommand
-} from "./chunk-GBY5DJ7L.js";
+} from "./chunk-4RIOBLGB.js";
 
 // src/view/AgentSession.tsx
 import { useEffect as useEffect2, useMemo, useRef as useRef2 } from "react";
@@ -257,6 +257,163 @@ var MissingApplicationKindError = class extends Error {
   }
 };
 
+// src/transport/sseTransportPolicy.ts
+var BOUNDED_DEFAULTS = {
+  maxReconnects: 5,
+  reconnectTimeoutMs: 6e4,
+  reconnectDelayMs: 1e3
+};
+var AGENT_TERMINAL = {
+  primary: ["finish"],
+  allowFinishFallback: false
+};
+var WORKFLOW_TERMINAL_STRICT = {
+  primary: ["workflow-end", "workflow-failed"],
+  allowFinishFallback: false
+};
+var WORKFLOW_TERMINAL_WITH_FALLBACK = {
+  primary: ["workflow-end", "workflow-failed"],
+  allowFinishFallback: true
+};
+var PROFILE_PRESETS = {
+  oneshot: {
+    profile: "oneshot",
+    replay: "none",
+    reconnect: {
+      mode: "off",
+      maxReconnects: 0,
+      reconnectTimeoutMs: 0,
+      reconnectDelayMs: BOUNDED_DEFAULTS.reconnectDelayMs
+    },
+    terminal: AGENT_TERMINAL
+  },
+  "oneshot-workflow": {
+    profile: "oneshot-workflow",
+    replay: "none",
+    reconnect: {
+      mode: "off",
+      maxReconnects: 0,
+      reconnectTimeoutMs: 0,
+      reconnectDelayMs: BOUNDED_DEFAULTS.reconnectDelayMs
+    },
+    terminal: WORKFLOW_TERMINAL_WITH_FALLBACK
+  },
+  "replayable-workflow": {
+    profile: "replayable-workflow",
+    replay: "history",
+    reconnect: {
+      mode: "bounded",
+      ...BOUNDED_DEFAULTS
+    },
+    terminal: WORKFLOW_TERMINAL_WITH_FALLBACK
+  }
+};
+function legacyTerminal(expectedApplicationKind) {
+  if (expectedApplicationKind === "workflow") {
+    return WORKFLOW_TERMINAL_STRICT;
+  }
+  return AGENT_TERMINAL;
+}
+function legacyReconnect(autoReconnect, reconnectDelayMs) {
+  if (autoReconnect === false) {
+    return {
+      mode: "off",
+      maxReconnects: 0,
+      reconnectTimeoutMs: 0,
+      reconnectDelayMs: reconnectDelayMs ?? BOUNDED_DEFAULTS.reconnectDelayMs
+    };
+  }
+  return {
+    mode: "unbounded",
+    maxReconnects: Number.POSITIVE_INFINITY,
+    reconnectTimeoutMs: Number.POSITIVE_INFINITY,
+    reconnectDelayMs: reconnectDelayMs ?? BOUNDED_DEFAULTS.reconnectDelayMs
+  };
+}
+function mergePolicy(base, override) {
+  if (!override) return base;
+  return {
+    profile: base.profile,
+    replay: override.replay ?? base.replay,
+    reconnect: {
+      ...base.reconnect,
+      ...override.reconnect
+    },
+    terminal: {
+      primary: override.terminal?.primary ?? base.terminal.primary,
+      allowFinishFallback: override.terminal?.allowFinishFallback ?? base.terminal.allowFinishFallback
+    }
+  };
+}
+function resolveSseTransportPolicy(input) {
+  const {
+    profile,
+    policy: policyOverride,
+    autoReconnect,
+    reconnectDelayMs,
+    expectedApplicationKind
+  } = input;
+  let base;
+  if (profile) {
+    base = { ...PROFILE_PRESETS[profile] };
+  } else {
+    base = {
+      replay: "history",
+      reconnect: legacyReconnect(autoReconnect, reconnectDelayMs),
+      terminal: legacyTerminal(expectedApplicationKind)
+    };
+  }
+  return mergePolicy(base, policyOverride);
+}
+function isSseStreamTerminalEvent(agentEvent, terminal, expectedApplicationKind) {
+  const eventType = agentEvent.event_type;
+  if (eventType === "error") return true;
+  if (terminal.primary.includes(eventType)) return true;
+  if (terminal.allowFinishFallback && eventType === "finish" && expectedApplicationKind === "workflow") {
+    return true;
+  }
+  if (!profileUsesWorkflowTerminal(terminal) && expectedApplicationKind !== "workflow" && eventType === "finish") {
+    return true;
+  }
+  return false;
+}
+function profileUsesWorkflowTerminal(terminal) {
+  return terminal.primary.includes("workflow-end") || terminal.primary.includes("workflow-failed");
+}
+var ReconnectBudget = class {
+  constructor(maxReconnects, timeoutMs, startedAtMs = Date.now()) {
+    this.maxReconnects = maxReconnects;
+    this.timeoutMs = timeoutMs;
+    this.startedAtMs = startedAtMs;
+  }
+  maxReconnects;
+  timeoutMs;
+  startedAtMs;
+  attemptCount = 0;
+  get attempts() {
+    return this.attemptCount;
+  }
+  canRetry(nowMs = Date.now()) {
+    if (this.maxReconnects <= 0) return false;
+    if (!Number.isFinite(this.maxReconnects) && !Number.isFinite(this.timeoutMs)) {
+      return true;
+    }
+    if (Number.isFinite(this.maxReconnects) && this.attemptCount >= this.maxReconnects) {
+      return false;
+    }
+    if (Number.isFinite(this.timeoutMs) && nowMs - this.startedAtMs > this.timeoutMs) {
+      return false;
+    }
+    return true;
+  }
+  recordAttempt() {
+    this.attemptCount += 1;
+  }
+};
+function shouldAutoReconnect(reconnect) {
+  return reconnect.mode !== "off";
+}
+
 // src/transport/createAgentxSseSource.ts
 var EXPECTED_PROTOCOL_VERSION = "1";
 var SseTransportTerminalError = class extends Error {
@@ -275,14 +432,6 @@ function transportLog(message, level = "warn") {
     console.warn(line);
   }
 }
-function isSseStreamTerminalEvent(agentEvent, expectedApplicationKind) {
-  const eventType = agentEvent.event_type;
-  if (eventType === "error") return true;
-  if (expectedApplicationKind === "workflow") {
-    return eventType === "workflow-end" || eventType === "workflow-failed";
-  }
-  return eventType === "finish";
-}
 function buildResumeStreamUrl(baseUrl, lastEventId, queryParam = "last_event_id") {
   if (!lastEventId) return baseUrl;
   const sep = baseUrl.includes("?") ? "&" : "?";
@@ -291,12 +440,26 @@ function buildResumeStreamUrl(baseUrl, lastEventId, queryParam = "last_event_id"
 function createAgentxSseSource(options) {
   const {
     url,
-    autoReconnect = true,
-    reconnectDelayMs = 1e3,
+    profile,
+    policy: policyOverride,
+    autoReconnect,
+    reconnectDelayMs,
     onLastEventId,
     EventSourceImpl = EventSource,
     expectedApplicationKind
   } = options;
+  const transportPolicy = resolveSseTransportPolicy({
+    profile,
+    policy: policyOverride,
+    autoReconnect,
+    reconnectDelayMs,
+    expectedApplicationKind
+  });
+  const reconnectDelay = transportPolicy.reconnect.reconnectDelayMs;
+  const reconnectBudget = transportPolicy.reconnect.mode === "bounded" ? new ReconnectBudget(
+    transportPolicy.reconnect.maxReconnects,
+    transportPolicy.reconnect.reconnectTimeoutMs
+  ) : null;
   return {
     start(handler, signal) {
       return new Promise((resolve, reject) => {
@@ -428,7 +591,11 @@ function createAgentxSseSource(options) {
               } else {
                 flushBufferedDelta();
                 handler(agentEvent, ctx);
-                if (isSseStreamTerminalEvent(agentEvent, expectedApplicationKind)) {
+                if (isSseStreamTerminalEvent(
+                  agentEvent,
+                  transportPolicy.terminal,
+                  expectedApplicationKind
+                )) {
                   streamTerminal = true;
                 }
               }
@@ -454,9 +621,22 @@ function createAgentxSseSource(options) {
               finish(error);
               return;
             }
-            if (autoReconnect) {
+            if (shouldAutoReconnect(transportPolicy.reconnect)) {
+              if (transportPolicy.reconnect.mode === "bounded" && reconnectBudget && !reconnectBudget.canRetry()) {
+                const error = new SseTransportTerminalError(
+                  "reconnect_budget_exhausted",
+                  "SSE reconnect budget exhausted"
+                );
+                transportLog(error.message, "error");
+                cleanup();
+                finish(error);
+                return;
+              }
+              if (reconnectBudget) {
+                reconnectBudget.recordAttempt();
+              }
               cleanup();
-              setTimeout(() => connect(lastEventId), reconnectDelayMs);
+              setTimeout(() => connect(lastEventId), reconnectDelay);
               return;
             }
             failPrematureClose();
@@ -762,6 +942,8 @@ function createEmptyWorkflowProgress() {
 function createEmptyWorkflowSessionState() {
   return {
     status: "connecting",
+    terminalKind: null,
+    openChildIdentities: [],
     meta: { workflowRunId: null, startedAt: null, lastEventId: null },
     containerTree: createEmptyWorkflowContainerTreeState(),
     workflowProgress: createEmptyWorkflowProgress(),
@@ -1926,6 +2108,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];
@@ -2299,9 +2513,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
   };
@@ -2386,7 +2616,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;
@@ -2968,7 +3198,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";
@@ -3681,9 +3914,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(
@@ -4393,6 +4629,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
@@ -4431,6 +4671,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",
           {
@@ -4546,6 +4802,7 @@ export {
   ApplicationKindMismatchError,
   AskUserQuestion,
   AskUserQuestionToolBody,
+  BOUNDED_DEFAULTS,
   Bash,
   BashToolBody,
   BodyBlockList,
@@ -4578,6 +4835,7 @@ export {
   MissingApplicationKindError,
   MultiAgentSession,
   NodeRegistry,
+  PROFILE_PRESETS,
   PermissionCard,
   PlantUMLBlock,
   PlantUMLDiagram,
@@ -4585,6 +4843,7 @@ export {
   Read,
   ReadToolBody,
   ReasoningBubble,
+  ReconnectBudget,
   RenderableTimelineProjector,
   RichMarkdown,
   SHELL_PROGRESS_MIN_ELAPSED_SECONDS,
@@ -4669,6 +4928,7 @@ export {
   isGitOperationCommand,
   isGroupableToolName,
   isMcpToolName,
+  isSseStreamTerminalEvent,
   isWorkflowStructureEventType,
   iterMountCandidates,
   parseDiffText,
@@ -4686,6 +4946,7 @@ export {
   resolveEventTier,
   resolveResponseId,
   resolveShellProgressFromPayload,
+  resolveSseTransportPolicy,
   resolveToolBody,
   shouldApplyGrouping,
   shouldShowExploreDetail,