langchain_agentx_stream_ui 0.2.7 → 0.3.0

package/dist/index.js

@@ -864,11 +864,67 @@ function AgentSession({
 }
 
 // src/view/workflow/WorkflowSession.tsx
-import { useEffect as useEffect8, useMemo as useMemo9, useRef as useRef3 } from "react";
+import { useEffect as useEffect10, useMemo as useMemo9, useRef as useRef4 } from "react";
 
 // src/core/context/WorkflowSessionContext.tsx
 import { createContext, useContext } from "react";
 import { useStore } from "zustand";
+
+// src/core/workflow/workflowAuthoritySelectors.ts
+var AUTHORITY_TERMINAL = /* @__PURE__ */ new Set([
+  "done",
+  "error",
+  "canceled",
+  "partial_success"
+]);
+function isAuthorityTerminalStatus(status) {
+  return status != null && AUTHORITY_TERMINAL.has(status);
+}
+function isAuthorityTerminal(state) {
+  return isAuthorityTerminalStatus(state.authority?.status);
+}
+function shouldShowGlobalSpinner(state) {
+  const auth = state.authority?.status;
+  if (auth === "canceled") return false;
+  if (isAuthorityTerminalStatus(auth)) return false;
+  if (state.display.awaitingAuthority) return false;
+  if (auth == null || auth === "pending" || auth === "running") {
+    return true;
+  }
+  const proj = state.display.projectionStatus;
+  return proj === "running" || proj === "connecting";
+}
+function resolveWorkflowBanner(state) {
+  if (state.display.authoritySubscribeFailed) {
+    return { kind: "sync_failed", message: "\u72B6\u6001\u540C\u6B65\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5" };
+  }
+  if (state.display.authoritySyncFailed) {
+    return { kind: "sync_failed", message: "\u540C\u6B65\u72B6\u6001\u5931\u8D25\uFF0C\u8BF7\u5237\u65B0" };
+  }
+  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 {
+      kind: "partial_success",
+      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"
+    };
+  }
+  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" };
+  }
+  return { kind: "none", message: "" };
+}
+function getDisplayProjectionStatus(state) {
+  return state.display.projectionStatus;
+}
+function applyAuthoritySnapshotToState(state, snapshot) {
+  return { ...state, authority: snapshot };
+}
+
+// src/core/context/WorkflowSessionContext.tsx
 var WorkflowSessionStoreContext = createContext(null);
 function useWorkflowSessionStoreApi() {
   const store = useContext(WorkflowSessionStoreContext);
@@ -879,7 +935,7 @@ function useWorkflowSessionStoreApi() {
 }
 function useWorkflowSessionStatus() {
   const store = useWorkflowSessionStoreApi();
-  return useStore(store, (s) => s.state.status);
+  return useStore(store, (s) => getDisplayProjectionStatus(s.state));
 }
 
 // src/core/context/WorkflowLoopReplayContext.tsx
@@ -944,6 +1000,17 @@ function containerTreeToSnapshot(tree) {
 }
 
 // src/types/workflowSession.ts
+function createEmptyWorkflowDisplayProjection() {
+  return {
+    streamEnded: false,
+    projectionStatus: "connecting",
+    terminalKind: null,
+    openChildIdentities: [],
+    awaitingAuthority: false,
+    authoritySyncFailed: false,
+    authoritySubscribeFailed: false
+  };
+}
 function createEmptyWorkflowProgress() {
   return {
     workflowId: null,
@@ -955,9 +1022,8 @@ function createEmptyWorkflowProgress() {
 }
 function createEmptyWorkflowSessionState() {
   return {
-    status: "connecting",
-    terminalKind: null,
-    openChildIdentities: [],
+    authority: null,
+    display: createEmptyWorkflowDisplayProjection(),
     meta: { workflowRunId: null, startedAt: null, lastEventId: null },
     containerTree: createEmptyWorkflowContainerTreeState(),
     workflowProgress: createEmptyWorkflowProgress(),
@@ -2150,7 +2216,10 @@ function readOpenChildIdentities(data) {
   if (!Array.isArray(raw)) return [];
   return raw.filter((item) => typeof item === "string");
 }
-function isWorkflowSessionTerminal(status) {
+function projectionStatusFromTerminalKind(kind, isWorkflowFailedEvent) {
+  return sessionStatusFromTerminalKind(kind, isWorkflowFailedEvent);
+}
+function isDisplayProjectionTerminal(status) {
   return status === "done" || status === "done_with_warning" || status === "error";
 }
 
@@ -2523,18 +2592,16 @@ function applyStructureEvent(state, event) {
     containerTree,
     state.workflowProgress
   );
-  let status = nextState.status;
-  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;
+  let projectionStatus = nextState.display.projectionStatus;
+  if (projectionStatus === "connecting") projectionStatus = "running";
+  let terminalKind = state.display.terminalKind;
+  let openChildIdentities = state.display.openChildIdentities;
   if (projectedEvent.event_type === "workflow-end" || projectedEvent.event_type === "workflow-failed") {
     const resolved = resolveWorkflowTerminalKind(
       structureData,
       projectedEvent.event_type
     );
-    status = sessionStatusFromTerminalKind(
+    projectionStatus = projectionStatusFromTerminalKind(
       resolved,
       projectedEvent.event_type === "workflow-failed"
     );
@@ -2543,9 +2610,12 @@ function applyStructureEvent(state, event) {
   }
   const base = {
     ...nextState,
-    status,
-    terminalKind,
-    openChildIdentities,
+    display: {
+      ...nextState.display,
+      projectionStatus,
+      terminalKind,
+      openChildIdentities
+    },
     containerTree,
     workflowProgress
   };
@@ -2613,11 +2683,9 @@ function reduceWorkflowSession(state, event, eventIndex, options) {
     next.containerTree,
     next.workflowProgress
   );
-  let status = next.status;
-  if (workflowProgress.status === "done") status = "done";
-  else if (workflowProgress.status === "error") status = "error";
-  else if (reducedLoop.status === "error") status = "error";
-  else if (status === "connecting") status = "running";
+  let projectionStatus = next.display.projectionStatus;
+  if (reducedLoop.status === "error") projectionStatus = "error";
+  else if (projectionStatus === "connecting") projectionStatus = "running";
   return {
     ...next,
     workflowProgress,
@@ -2626,61 +2694,38 @@ function reduceWorkflowSession(state, event, eventIndex, options) {
       [loopSessionId]: reducedLoop
     },
     activeLoopSessionId: loopSessionId,
-    status
+    display: {
+      ...next.display,
+      projectionStatus
+    }
   };
 }
-function finalizeWorkflowSessionOnStreamComplete(state) {
-  if (isWorkflowSessionTerminal(state.status)) {
-    return { ...state, activeLoopSessionId: null };
-  }
-  const tree = state.containerTree;
-  const rootId = tree.rootContainerIds[0];
-  if (!rootId) {
-    return { ...state, status: "done", activeLoopSessionId: null };
-  }
-  const root = tree.containersById[rootId];
-  if (!root) {
-    return { ...state, status: "done", activeLoopSessionId: null };
+function finalizeWorkflowDisplayOnStreamEnded(state) {
+  if (isDisplayProjectionTerminal(state.display.projectionStatus)) {
+    return {
+      ...state,
+      display: { ...state.display, streamEnded: true },
+      activeLoopSessionId: null
+    };
   }
-  const topLevelStages = Object.values(tree.containersById).filter(
-    (node) => node.scope === "stage" && node.workflow_path === root.workflow_path && node.workflow_depth === root.workflow_depth
-  );
-  const progressTotal = root.display?.progress_total ?? (topLevelStages.reduce(
-    (max, s) => Math.max(max, s.display?.progress_total ?? 0),
-    0
-  ) || topLevelStages.length);
-  const settledStageCount = topLevelStages.filter(
-    (s) => s.status === "completed" || s.status === "failed" || s.status === "skipped"
-  ).length;
-  const progressCurrent = Math.max(
-    root.display?.progress_current ?? 0,
-    settledStageCount
-  );
-  const rootParallelItems = Object.values(tree.containersById).filter(
-    (node) => node.scope === "item" && node.workflow_path === root.workflow_path && node.workflow_depth === root.workflow_depth
-  );
-  const rootParallelSettled = topLevelStages.length === 0 && rootParallelItems.length > 0 && rootParallelItems.every(
-    (item) => item.status === "completed" || item.status === "failed" || item.status === "skipped"
-  ) && !Object.values(tree.containersById).some(
-    (node) => node.container_id !== rootId && node.workflow_path === root.workflow_path && node.workflow_depth === root.workflow_depth && (node.status === "running" || node.status === "retrying" || node.status === "pending")
-  );
-  const workflowVisuallyComplete = root.status === "completed" || root.status === "failed" || progressTotal > 0 && progressCurrent >= progressTotal || rootParallelSettled;
-  if (!workflowVisuallyComplete) {
-    return state;
+  const withStreamEnded = {
+    ...state,
+    display: { ...state.display, streamEnded: true },
+    activeLoopSessionId: null
+  };
+  if (isAuthorityTerminalStatus(state.authority?.status)) {
+    return forceSettleRunningContainersForDisplay(withStreamEnded);
   }
+  return withStreamEnded;
+}
+function forceSettleRunningContainersForDisplay(state) {
+  const tree = state.containerTree;
   let containersById = { ...tree.containersById };
   for (const [id, node] of Object.entries(containersById)) {
     if (node.status === "running" || node.status === "pending") {
       containersById[id] = { ...node, status: "completed", is_open: false };
     }
   }
-  const settledRoot = containersById[rootId] ?? root;
-  if (settledRoot.status !== "completed" && settledRoot.status !== "failed") {
-    containersById = {
-      ...containersById,
-      [rootId]: { ...settledRoot, status: "completed", is_open: false }
-    };
-  }
   const loopTreesBySessionId = { ...state.loopTreesBySessionId };
   for (const [loopSessionId, loopTree] of Object.entries(loopTreesBySessionId)) {
     if (loopTree.status === "running" || loopTree.status === "connecting") {
@@ -2694,15 +2739,9 @@ function finalizeWorkflowSessionOnStreamComplete(state) {
       (id) => containersById[id]?.is_open
     )
   };
-  const workflowProgress = syncWorkflowProgressFromContainerTree(
-    containerTree,
-    state.workflowProgress
-  );
   return {
     ...state,
-    status: workflowProgress.status === "error" ? "error" : "done",
     containerTree,
-    workflowProgress,
     loopTreesBySessionId,
     activeLoopSessionId: null
   };
@@ -2764,7 +2803,10 @@ function finalizeWorkflowSessionOnStreamError(state, message, eventIndex, stack)
   }
   return {
     ...state,
-    status: "error",
+    display: {
+      ...state.display,
+      projectionStatus: "error"
+    },
     containerTree: {
       ...state.containerTree,
       containersById,
@@ -2809,7 +2851,10 @@ function createWorkflowSessionStore(initialState = createEmptyWorkflowSessionSta
         state: {
           ...evicted,
           meta: nextMeta,
-          status: evicted.status === "connecting" ? "running" : evicted.status
+          display: {
+            ...evicted.display,
+            projectionStatus: evicted.display.projectionStatus === "connecting" ? "running" : evicted.display.projectionStatus
+          }
         },
         eventCount: eventCount + 1
       });
@@ -2839,13 +2884,59 @@ function createWorkflowSessionStore(initialState = createEmptyWorkflowSessionSta
         )
       });
     },
-    markStreamComplete() {
+    markStreamEnded() {
       set((current) => ({
         state: finalizeState(
-          finalizeWorkflowSessionOnStreamComplete(current.state)
+          finalizeWorkflowDisplayOnStreamEnded(current.state)
         )
       }));
     },
+    applyAuthoritySnapshot(snapshot) {
+      set((current) => ({
+        state: {
+          ...current.state,
+          authority: snapshot,
+          display: {
+            ...current.state.display,
+            awaitingAuthority: false,
+            authoritySyncFailed: false
+          }
+        }
+      }));
+    },
+    setAwaitingAuthority(value) {
+      set((current) => ({
+        state: {
+          ...current.state,
+          display: {
+            ...current.state.display,
+            awaitingAuthority: value
+          }
+        }
+      }));
+    },
+    setAuthoritySyncFailed(value) {
+      set((current) => ({
+        state: {
+          ...current.state,
+          display: {
+            ...current.state.display,
+            authoritySyncFailed: value
+          }
+        }
+      }));
+    },
+    setAuthoritySubscribeFailed(value) {
+      set((current) => ({
+        state: {
+          ...current.state,
+          display: {
+            ...current.state.display,
+            authoritySubscribeFailed: value
+          }
+        }
+      }));
+    },
     /**
      * P2：将 completed loop 加入 LRU 热缓存并淘汰溢出。
      * running 保护由 collectProtectedLoopSessionIds 按状态自动覆盖，不再依赖永久 pin。
@@ -2952,11 +3043,93 @@ function createWorkflowSessionStore(initialState = createEmptyWorkflowSessionSta
   }));
 }
 
+// src/core/workflow/useWorkflowAuthorityBinding.ts
+import { useEffect as useEffect3, useRef as useRef3 } from "react";
+
+// src/core/workflow/normalizeAuthoritySnapshot.ts
+var KNOWN = /* @__PURE__ */ new Set([
+  "pending",
+  "running",
+  "done",
+  "error",
+  "canceled",
+  "partial_success"
+]);
+function normalizeAuthoritySnapshot(snapshot) {
+  if (KNOWN.has(snapshot.status)) {
+    return snapshot;
+  }
+  if (import.meta.env?.DEV) {
+    console.warn(
+      `[langchain_agentx_stream_ui] unknown authority.status "${String(snapshot.status)}"; defaulting to running`
+    );
+  }
+  return { ...snapshot, status: "running" };
+}
+
+// src/core/workflow/useWorkflowAuthorityBinding.ts
+function useWorkflowAuthorityBinding(store, authoritySource, callbacks) {
+  const onAuthorityTerminalRef = useRef3(callbacks.onAuthorityTerminal);
+  onAuthorityTerminalRef.current = callbacks.onAuthorityTerminal;
+  const terminalFiredRef = useRef3(false);
+  useEffect3(() => {
+    terminalFiredRef.current = false;
+    const apply = (raw) => {
+      const snapshot = normalizeAuthoritySnapshot(raw);
+      store.getState().applyAuthoritySnapshot(snapshot);
+      if (!terminalFiredRef.current && isAuthorityTerminalStatus(snapshot.status)) {
+        terminalFiredRef.current = true;
+        onAuthorityTerminalRef.current?.(snapshot);
+      }
+    };
+    const initial = authoritySource.getSnapshot();
+    if (initial) {
+      apply(initial);
+    }
+    let unsubscribe;
+    try {
+      unsubscribe = authoritySource.subscribe(apply);
+    } catch (err) {
+      if (import.meta.env?.DEV) {
+        console.error("[langchain_agentx_stream_ui] authoritySource.subscribe failed:", err);
+      }
+      store.getState().setAuthoritySubscribeFailed(true);
+    }
+    return () => {
+      unsubscribe?.();
+    };
+  }, [store, authoritySource]);
+}
+
+// src/core/workflow/useWorkflowAwaitingAuthorityTimers.ts
+import { useEffect as useEffect4 } from "react";
+var AWAITING_MS = 3e4;
+var SYNC_FAILED_MS = 12e4;
+function useWorkflowAwaitingAuthorityTimers(store, streamEnded, authorityStatus) {
+  useEffect4(() => {
+    if (!streamEnded || authorityStatus !== "running") {
+      store.getState().setAwaitingAuthority(false);
+      store.getState().setAuthoritySyncFailed(false);
+      return;
+    }
+    const tAwait = window.setTimeout(() => {
+      store.getState().setAwaitingAuthority(true);
+    }, AWAITING_MS);
+    const tFail = window.setTimeout(() => {
+      store.getState().setAuthoritySyncFailed(true);
+    }, SYNC_FAILED_MS);
+    return () => {
+      window.clearTimeout(tAwait);
+      window.clearTimeout(tFail);
+    };
+  }, [store, streamEnded, authorityStatus]);
+}
+
 // src/view/workflow/WorkflowChrome.tsx
 import { useMemo as useMemo7, useState as useState6 } from "react";
 
 // src/view/workflow/WorkflowAggregateContainer.tsx
-import { useCallback, useEffect as useEffect3, useMemo as useMemo2, useState, memo } from "react";
+import { useCallback, useEffect as useEffect5, useMemo as useMemo2, useState, memo } from "react";
 
 // src/view/workflow/WorkflowContainerLine.tsx
 import { Fragment, jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
@@ -3366,7 +3539,7 @@ function WorkflowAggregateContainerInner({
   const uiStatus = mapAggregateUiStatus(node);
   const statusLabel = buildAggregateStatusLabel(node, siblingItems);
   const [expanded, setExpanded] = useState(isRunning);
-  useEffect3(() => {
+  useEffect5(() => {
     if (isRunning) setExpanded(true);
     if (isDone) setExpanded(false);
   }, [isRunning, isDone]);
@@ -3485,7 +3658,7 @@ var WorkflowAggregateContainer = memo(
 );
 
 // src/view/workflow/WorkflowParallelGroup.tsx
-import { useCallback as useCallback3, useEffect as useEffect5, useMemo as useMemo4, useState as useState3, memo as memo3 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect7, useMemo as useMemo4, useState as useState3, memo as memo3 } from "react";
 
 // src/core/workflow/workflowParallelGroupMetrics.ts
 var ACTIVE_ITEM_STATUSES = /* @__PURE__ */ new Set([
@@ -3579,7 +3752,7 @@ function formatParallelGroupSummary(metrics) {
 }
 
 // src/view/workflow/WorkflowStageContainer.tsx
-import { useCallback as useCallback2, useEffect as useEffect4, useMemo as useMemo3, useState as useState2, memo as memo2 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect6, useMemo as useMemo3, useState as useState2, memo as memo2 } from "react";
 import { useStore as useStore2 } from "zustand";
 
 // src/core/workflow/loopTreeUtils.ts
@@ -3666,7 +3839,7 @@ function WorkflowStageContainerInner({
   const doneSummary = doneSummaryFromTree ?? (isDone ? cachedSummary : null);
   const shouldAutoExpandRunning = effectivelyRunning && !isSkipped;
   const [expanded, setExpanded] = useState2(shouldAutoExpandRunning);
-  useEffect4(() => {
+  useEffect6(() => {
     if (shouldAutoExpandRunning) {
       setExpanded(true);
       return;
@@ -3691,7 +3864,7 @@ function WorkflowStageContainerInner({
       return next;
     });
   }, [isDone, node.loopSessionId, loopTree, requestLoopHydration]);
-  useEffect4(() => {
+  useEffect6(() => {
     const onKeyDown = (event) => {
       if (!(event.ctrlKey || event.metaKey) || event.key.toLowerCase() !== "o") return;
       setExpanded(true);
@@ -3844,7 +4017,7 @@ function WorkflowParallelGroupInner({
   );
   const allSettled = metrics.total > 0 && metrics.running === 0 && metrics.completed + metrics.failed >= metrics.total;
   const [expanded, setExpanded] = useState3(hasActiveWork);
-  useEffect5(() => {
+  useEffect7(() => {
     if (hasActiveWork) {
       setExpanded(true);
       return;
@@ -3856,7 +4029,7 @@ function WorkflowParallelGroupInner({
   const toggleExpanded = useCallback3(() => {
     setExpanded((prev) => !prev);
   }, []);
-  useEffect5(() => {
+  useEffect7(() => {
     const onKeyDown = (event) => {
       if (!(event.ctrlKey || event.metaKey) || event.key.toLowerCase() !== "o") return;
       setExpanded(true);
@@ -3956,7 +4129,7 @@ function WorkflowRootContainer({
 }
 
 // src/view/workflow/WorkflowRouteContainer.tsx
-import { useCallback as useCallback4, useEffect as useEffect6, useMemo as useMemo5, useState as useState4 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect8, useMemo as useMemo5, useState as useState4 } from "react";
 import { jsx as jsx13, jsxs as jsxs8 } from "react/jsx-runtime";
 function WorkflowRouteContainer({
   node,
@@ -3981,7 +4154,7 @@ function WorkflowRouteContainer({
   const expandHint = doneSummary ? formatTeaserExpandHint(doneSummary.extraLines, verbose) : null;
   const doneLabel = doneSummary?.label ?? "done";
   const [expanded, setExpanded] = useState4(isRunning);
-  useEffect6(() => {
+  useEffect8(() => {
     if (isSkipped) return;
     if (isRunning) setExpanded(true);
     if (isDone) setExpanded(false);
@@ -4057,7 +4230,7 @@ function WorkflowRouteContainer({
 }
 
 // src/view/workflow/WorkflowSubworkflowContainer.tsx
-import { useCallback as useCallback5, useEffect as useEffect7, useMemo as useMemo6, useState as useState5 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect9, useMemo as useMemo6, useState as useState5 } from "react";
 import { jsx as jsx14, jsxs as jsxs9 } from "react/jsx-runtime";
 function buildDoneSummary(node) {
   const display = node.display;
@@ -4088,7 +4261,7 @@ function WorkflowSubworkflowContainer({
     return node.content_blocks[node.content_blocks.length - 1]?.preview ?? "";
   }, [node.content_blocks]);
   const [expanded, setExpanded] = useState5(effectivelyRunning);
-  useEffect7(() => {
+  useEffect9(() => {
     if (effectivelyRunning) setExpanded(true);
     else if (effectivelyDone) setExpanded(false);
   }, [effectivelyRunning, effectivelyDone]);
@@ -4440,9 +4613,94 @@ function WorkflowChrome({
   )) });
 }
 
+// src/view/workflow/WorkflowGlobalSpinner.tsx
+import { useStore as useStore3 } from "zustand";
+import { jsx as jsx16, jsxs as jsxs11 } from "react/jsx-runtime";
+function WorkflowGlobalSpinner() {
+  const store = useWorkflowSessionStoreApi();
+  const show = useStore3(store, (s) => shouldShowGlobalSpinner(s.state));
+  if (!show) return null;
+  return /* @__PURE__ */ jsx16(
+    "div",
+    {
+      className: "lax-workflow-global-spinner lax-spinner-container",
+      "data-testid": "lax-workflow-global-spinner",
+      role: "status",
+      children: /* @__PURE__ */ jsxs11("span", { className: "lax-spinner lax-workflow-global-spinner__inner", children: [
+        /* @__PURE__ */ jsx16("span", { className: "lax-spinner-frame", children: "\u280B" }),
+        /* @__PURE__ */ jsx16("span", { className: "lax-spinner-verb lax-spinner-verb--shimmer", children: "Workflow" })
+      ] })
+    }
+  );
+}
+
+// src/view/workflow/WorkflowSessionBanners.tsx
+import { Fragment as Fragment3, jsx as jsx17, jsxs as jsxs12 } from "react/jsx-runtime";
+function WorkflowSessionBanners({ state }) {
+  const banner = resolveWorkflowBanner(state);
+  const { display } = state;
+  if (banner.kind === "none" && display.projectionStatus !== "error" && display.projectionStatus !== "done_with_warning" && state.internalErrors.length === 0) {
+    return null;
+  }
+  return /* @__PURE__ */ jsxs12(Fragment3, { children: [
+    banner.kind === "partial_success" ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-banner lax-workflow-banner--partial-success",
+        "data-testid": "lax-workflow-partial-success-banner",
+        role: "status",
+        children: banner.message
+      }
+    ) : null,
+    banner.kind === "forced_closeout" || display.projectionStatus === "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."
+          ] }),
+          display.openChildIdentities.length > 0 ? /* @__PURE__ */ jsx17("ul", { className: "lax-workflow-closeout-warning__scopes", children: display.openChildIdentities.map((identity) => /* @__PURE__ */ jsx17("li", { children: identity }, identity)) }) : null
+        ]
+      }
+    ) : null,
+    banner.kind === "awaiting_authority" ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-banner lax-workflow-banner--awaiting",
+        "data-testid": "lax-workflow-awaiting-authority-banner",
+        role: "status",
+        children: banner.message
+      }
+    ) : null,
+    banner.kind === "sync_failed" ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-banner lax-workflow-banner--sync-failed",
+        "data-testid": "lax-workflow-authority-sync-failed-banner",
+        role: "alert",
+        children: banner.message
+      }
+    ) : null,
+    display.projectionStatus === "error" || state.internalErrors.length > 0 ? /* @__PURE__ */ jsx17(
+      "div",
+      {
+        className: "lax-workflow-error",
+        "data-testid": "lax-workflow-error",
+        role: "alert",
+        children: state.internalErrors[state.internalErrors.length - 1]?.message ?? "Workflow stream error"
+      }
+    ) : null
+  ] });
+}
+
 // src/view/workflow/WorkflowTaskListFooter.tsx
 import { useMemo as useMemo8, useState as useState7 } from "react";
-import { useStore as useStore3 } from "zustand";
+import { useStore as useStore4 } from "zustand";
 
 // src/view/workflow/workflowTaskListMerge.ts
 var STATUS_ORDER = {
@@ -4483,7 +4741,7 @@ function deriveWorkflowTaskFooterState(state) {
     tasks: mergeWorkflowLoopTasks(state.loopTreesBySessionId),
     taskPhase: deriveWorkflowTaskPhase(trees),
     hasEverShownTaskList: trees.some((tree) => tree.hasEverShownTaskList),
-    sessionStatus: state.status
+    sessionStatus: getDisplayProjectionStatus(state)
   };
 }
 function shouldShowWorkflowTaskListFooter(state) {
@@ -4513,16 +4771,16 @@ function loopSessionDisplayLabel(loopSessionId) {
 }
 
 // src/view/workflow/WorkflowTaskListFooter.tsx
-import { jsx as jsx16, jsxs as jsxs11 } from "react/jsx-runtime";
+import { jsx as jsx18, jsxs as jsxs13 } from "react/jsx-runtime";
 function MessageResponse({ children }) {
-  return /* @__PURE__ */ jsxs11("div", { className: "lax-message-response", children: [
-    /* @__PURE__ */ jsx16("span", { className: "lax-message-response__marker", children: "\u23BF " }),
-    /* @__PURE__ */ jsx16("span", { className: "lax-message-response__content", children })
+  return /* @__PURE__ */ jsxs13("div", { className: "lax-message-response", children: [
+    /* @__PURE__ */ jsx18("span", { className: "lax-message-response__marker", children: "\u23BF " }),
+    /* @__PURE__ */ jsx18("span", { className: "lax-message-response__content", children })
   ] });
 }
 function WorkflowTaskListFooter() {
   const store = useWorkflowSessionStoreApi();
-  const state = useStore3(store, (s) => s.state);
+  const state = useStore4(store, (s) => s.state);
   const [expanded, setExpanded] = useState7(false);
   const footerState = useMemo8(() => deriveWorkflowTaskFooterState(state), [state]);
   const visible = shouldShowWorkflowTaskListFooter(state);
@@ -4531,8 +4789,8 @@ function WorkflowTaskListFooter() {
   }
   const label = formatWorkflowTaskFooterLabel(state);
   const groups = groupWorkflowTasksByLoop(footerState.tasks);
-  return /* @__PURE__ */ jsxs11("div", { className: "lax-workflow-task-list-footer", "data-testid": "lax-workflow-task-list-footer", children: [
-    /* @__PURE__ */ jsxs11(
+  return /* @__PURE__ */ jsxs13("div", { className: "lax-workflow-task-list-footer", "data-testid": "lax-workflow-task-list-footer", children: [
+    /* @__PURE__ */ jsxs13(
       "button",
       {
         type: "button",
@@ -4542,18 +4800,18 @@ function WorkflowTaskListFooter() {
         onClick: () => setExpanded((v) => !v),
         children: [
           label,
-          /* @__PURE__ */ jsx16("span", { className: "lax-task-list-footer__hint", children: expanded ? " \xB7 \u2191 to hide" : " \xB7 \u2193 to view" })
+          /* @__PURE__ */ jsx18("span", { className: "lax-task-list-footer__hint", children: expanded ? " \xB7 \u2191 to hide" : " \xB7 \u2193 to view" })
         ]
       }
     ),
-    expanded ? /* @__PURE__ */ jsx16(MessageResponse, { children: /* @__PURE__ */ jsx16("div", { className: "lax-workflow-task-list-groups", children: groups.map((group) => /* @__PURE__ */ jsxs11(
+    expanded ? /* @__PURE__ */ jsx18(MessageResponse, { children: /* @__PURE__ */ jsx18("div", { className: "lax-workflow-task-list-groups", children: groups.map((group) => /* @__PURE__ */ jsxs13(
       "div",
       {
         className: "lax-workflow-task-list-group",
         "data-testid": `lax-workflow-task-group-${group.loopSessionId}`,
         children: [
-          /* @__PURE__ */ jsx16("div", { className: "lax-workflow-task-list-group-title", children: loopSessionDisplayLabel(group.loopSessionId) }),
-          /* @__PURE__ */ jsx16(TaskList, { tasks: group.tasks })
+          /* @__PURE__ */ jsx18("div", { className: "lax-workflow-task-list-group-title", children: loopSessionDisplayLabel(group.loopSessionId) }),
+          /* @__PURE__ */ jsx18(TaskList, { tasks: group.tasks })
         ]
       },
       group.loopSessionId
@@ -4562,10 +4820,11 @@ function WorkflowTaskListFooter() {
 }
 
 // src/view/workflow/WorkflowSession.tsx
-import { useStore as useStore4 } from "zustand";
-import { jsx as jsx17, jsxs as jsxs12 } from "react/jsx-runtime";
+import { useStore as useStore5 } from "zustand";
+import { jsx as jsx19, jsxs as jsxs14 } from "react/jsx-runtime";
 function WorkflowSession({
   source,
+  authoritySource,
   initialEvents,
   registry,
   tierOverrides,
@@ -4585,10 +4844,11 @@ function WorkflowSession({
   groupParallelTools = false,
   workflowScale,
   onRequestLoopReplay,
-  onStreamComplete,
+  onAuthorityTerminal,
+  onDisplayStreamEnded,
   children
 }) {
-  const storeRef = useRef3(null);
+  const storeRef = useRef4(null);
   if (storeRef.current === null) {
     const initialState = initialEvents && initialEvents.length > 0 ? reduceWorkflowEvents(initialEvents, { tierOverrides }) : void 0;
     storeRef.current = createWorkflowSessionStore(initialState, {
@@ -4598,6 +4858,11 @@ function WorkflowSession({
       maxHydratedCompletedLoops: workflowScale?.maxHydratedCompletedLoops ?? DEFAULT_WORKFLOW_SCALE_OPTIONS.maxHydratedCompletedLoops
     });
   }
+  const store = storeRef.current;
+  useWorkflowAuthorityBinding(store, authoritySource, { onAuthorityTerminal });
+  const streamEnded = useStore5(store, (s) => s.state.display.streamEnded);
+  const authorityStatus = useStore5(store, (s) => s.state.authority?.status);
+  useWorkflowAwaitingAuthorityTimers(store, streamEnded, authorityStatus);
   const scaleOptions = useMemo9(
     () => ({ ...DEFAULT_WORKFLOW_SCALE_OPTIONS, ...workflowScale }),
     [workflowScale]
@@ -4635,38 +4900,20 @@ function WorkflowSession({
       workspaceRoot
     ]
   );
-  const containerTree = useStore4(
-    storeRef.current,
-    (s) => s.state.containerTree
-  );
-  const loopTreesBySessionId = useStore4(
-    storeRef.current,
-    (s) => s.state.loopTreesBySessionId
-  );
-  const openChildIdentities = useStore4(
-    storeRef.current,
-    (s) => s.state.openChildIdentities
-  );
-  const sessionStatus = useStore4(
-    storeRef.current,
-    (s) => s.state.status
-  );
-  const internalErrors = useStore4(
-    storeRef.current,
-    (s) => s.state.internalErrors
-  );
-  const onErrorRef = useRef3(onError);
-  const onStreamCompleteRef = useRef3(onStreamComplete);
+  const sessionState = useStore5(store, (s) => s.state);
+  const containerTree = sessionState.containerTree;
+  const loopTreesBySessionId = sessionState.loopTreesBySessionId;
+  const onErrorRef = useRef4(onError);
+  const onDisplayStreamEndedRef = useRef4(onDisplayStreamEnded);
   onErrorRef.current = onError;
-  onStreamCompleteRef.current = onStreamComplete;
-  useEffect8(() => {
-    const store = storeRef.current;
+  onDisplayStreamEndedRef.current = onDisplayStreamEnded;
+  useEffect10(() => {
     const controller = new AbortController();
     void source.start((event, ctx) => {
       store.getState().applyEvent(event, ctx);
     }, controller.signal).then(() => {
-      store.getState().markStreamComplete();
-      onStreamCompleteRef.current?.();
+      store.getState().markStreamEnded();
+      onDisplayStreamEndedRef.current?.();
     }).catch((err) => {
       if (err instanceof SseTransportTerminalError) {
         store.getState().markAsError(err);
@@ -4678,39 +4925,16 @@ function WorkflowSession({
     return () => {
       controller.abort();
     };
-  }, [source]);
-  return /* @__PURE__ */ jsx17(WorkflowSessionStoreContext.Provider, { value: storeRef.current, children: /* @__PURE__ */ jsx17(WorkflowScaleContext.Provider, { value: scaleOptions, children: /* @__PURE__ */ jsx17(WorkflowLoopReplayProvider, { onRequestLoopReplay, children: /* @__PURE__ */ jsx17(InteractionBusContext.Provider, { value: busRef, children: /* @__PURE__ */ jsx17(NodeRegistryContext.Provider, { value: registryRef, children: /* @__PURE__ */ jsx17(MarkdownRendererContext.Provider, { value: markdownRenderer, children: /* @__PURE__ */ jsx17(ToolDisplayOptionsContext.Provider, { value: toolDisplayRef, children: /* @__PURE__ */ jsx17(SessionViewOptionsContext.Provider, { value: sessionViewRef, children: /* @__PURE__ */ jsxs12(
+  }, [source, store]);
+  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",
     {
       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",
-          {
-            className: "lax-workflow-error",
-            "data-testid": "lax-workflow-error",
-            role: "alert",
-            children: internalErrors[internalErrors.length - 1]?.message ?? "Workflow stream error"
-          }
-        ) : null,
-        /* @__PURE__ */ jsx17(
+        /* @__PURE__ */ jsx19(WorkflowSessionBanners, { state: sessionState }),
+        /* @__PURE__ */ jsx19(WorkflowGlobalSpinner, {}),
+        /* @__PURE__ */ jsx19(
           WorkflowChrome,
           {
             containerTree,
@@ -4720,13 +4944,158 @@ function WorkflowSession({
             groupParallelTools
           }
         ),
-        /* @__PURE__ */ jsx17(WorkflowTaskListFooter, {}),
+        /* @__PURE__ */ jsx19(WorkflowTaskListFooter, {}),
         children
       ]
     }
   ) }) }) }) }) }) }) }) });
 }
 
+// src/core/workflow/createMockAuthoritySource.ts
+function defaultDoneSnapshot() {
+  return {
+    taskId: "mock-task",
+    status: "done",
+    updatedAt: Date.now()
+  };
+}
+function defaultRunningSnapshot() {
+  return {
+    taskId: "mock-task",
+    status: "running",
+    updatedAt: Date.now()
+  };
+}
+function createMockAuthoritySource(snapshotOrOptions) {
+  let snapshot = null;
+  let pendingUpdates = [];
+  if (snapshotOrOptions == null) {
+    snapshot = defaultRunningSnapshot();
+  } else if (typeof snapshotOrOptions === "object" && ("pendingUpdates" in snapshotOrOptions || "snapshot" in snapshotOrOptions) && !("status" in snapshotOrOptions)) {
+    const opts = snapshotOrOptions;
+    snapshot = opts.snapshot ?? defaultDoneSnapshot();
+    pendingUpdates = opts.pendingUpdates ?? [];
+  } else if (snapshotOrOptions === null) {
+    snapshot = null;
+  } else {
+    snapshot = snapshotOrOptions;
+  }
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(cb) {
+      if (snapshot) {
+        cb(snapshot);
+      }
+      for (const update of pendingUpdates) {
+        snapshot = update;
+        cb(update);
+      }
+      return () => {
+      };
+    }
+  };
+}
+function createDoneAuthoritySource(taskId = "mock-task") {
+  return createMockAuthoritySource({
+    taskId,
+    status: "done",
+    updatedAt: Date.now()
+  });
+}
+function createRunningAuthoritySource(taskId = "mock-task") {
+  return createMockAuthoritySource({
+    taskId,
+    status: "running",
+    updatedAt: Date.now()
+  });
+}
+function createControllableAuthoritySource(initial) {
+  let snapshot = initial;
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(cb) {
+      listeners.add(cb);
+      cb(snapshot);
+      return () => {
+        listeners.delete(cb);
+      };
+    },
+    push(next) {
+      snapshot = next;
+      for (const listener of listeners) {
+        listener(next);
+      }
+    }
+  };
+}
+
+// src/core/workflow/createPollingAuthoritySource.ts
+var DEFAULT_INTERVAL_MS = 2e3;
+function createPollingAuthoritySource(taskId, fetchFn, options) {
+  let cached = options?.initialSnapshot ?? null;
+  let intervalId;
+  let pollInFlight = false;
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = (snap) => {
+    cached = snap;
+    for (const listener of listeners) {
+      listener(snap);
+    }
+  };
+  const stopPoll = () => {
+    if (intervalId != null) {
+      clearInterval(intervalId);
+      intervalId = void 0;
+    }
+  };
+  const pollOnce = async () => {
+    if (pollInFlight || options?.signal?.aborted) return;
+    pollInFlight = true;
+    try {
+      const snap = await fetchFn(taskId);
+      const prev = cached;
+      if (prev == null || prev.status !== snap.status || prev.updatedAt !== snap.updatedAt) {
+        notify(snap);
+      }
+      if (isAuthorityTerminalStatus(snap.status)) {
+        stopPoll();
+      }
+    } finally {
+      pollInFlight = false;
+    }
+  };
+  const startPoll = () => {
+    if (intervalId != null || options?.signal?.aborted) return;
+    if (cached != null && isAuthorityTerminalStatus(cached.status)) {
+      return;
+    }
+    void pollOnce();
+    intervalId = setInterval(() => {
+      void pollOnce();
+    }, options?.intervalMs ?? DEFAULT_INTERVAL_MS);
+  };
+  options?.signal?.addEventListener("abort", stopPoll, { once: true });
+  return {
+    getSnapshot: () => cached,
+    subscribe(cb) {
+      listeners.add(cb);
+      if (cached != null) {
+        cb(cached);
+      }
+      if (cached == null || !isAuthorityTerminalStatus(cached.status)) {
+        startPoll();
+      }
+      return () => {
+        listeners.delete(cb);
+        if (listeners.size === 0) {
+          stopPoll();
+        }
+      };
+    }
+  };
+}
+
 // src/view/tools/groupParallelTools.ts
 function buildTimelineEntries(rootIds, byId, options = {}) {
   const filtered = options.hideStandalonePermissions ? rootIds.filter((id) => byId[id]?.kind !== "permission") : [...rootIds];
@@ -4764,18 +5133,18 @@ function buildTimelineEntries(rootIds, byId, options = {}) {
 }
 
 // src/view/nodes/SubAgentNode.tsx
-import { jsx as jsx18, jsxs as jsxs13 } from "react/jsx-runtime";
+import { jsx as jsx20, jsxs as jsxs15 } from "react/jsx-runtime";
 function SubAgentBlock({ nodeId }) {
   const node = useNodeTyped(nodeId, "subagent");
   const childIds = useChildren(nodeId);
   const registry = useNodeRegistry();
   if (!node) return null;
-  return /* @__PURE__ */ jsxs13("div", { className: "lax-subagent-block", "data-status": node.status, children: [
-    /* @__PURE__ */ jsxs13("div", { className: "lax-subagent-block__header", children: [
+  return /* @__PURE__ */ jsxs15("div", { className: "lax-subagent-block", "data-status": node.status, children: [
+    /* @__PURE__ */ jsxs15("div", { className: "lax-subagent-block__header", children: [
       "SubAgent: ",
       node.subagentId
     ] }),
-    /* @__PURE__ */ jsx18("div", { className: "lax-subagent-block__children", children: childIds.map((childId) => /* @__PURE__ */ jsx18(TimelineItem, { nodeId: childId, registry }, childId)) })
+    /* @__PURE__ */ jsx20("div", { className: "lax-subagent-block__children", children: childIds.map((childId) => /* @__PURE__ */ jsx20(TimelineItem, { nodeId: childId, registry }, childId)) })
   ] });
 }
 
@@ -4894,6 +5263,7 @@ export {
   WorkflowTaskListFooter,
   Write,
   WriteToolBody,
+  applyAuthoritySnapshotToState,
   buildBashBodyBlocks,
   buildCanonicalFromTree,
   buildProjectionContext,
@@ -4909,21 +5279,27 @@ export {
   configurePlantumlServer,
   createActiveSessionBridge,
   createAgentxSseSource,
+  createControllableAuthoritySource,
   createDefaultRegistry,
   createDefaultToolRegistry,
+  createDoneAuthoritySource,
   createEmptyTree,
   createEmptyWorkflowSessionState,
   createInteractionBus,
+  createMockAuthoritySource,
   createMockSource,
   createMultiSessionStore,
+  createPollingAuthoritySource,
   createProjectionContext,
   createReplaySource,
+  createRunningAuthoritySource,
   createSessionStore,
   createWorkflowSessionStore,
   deriveLoopSessionIdFromAgentEvent,
   displayPath,
   entryKey,
   filterAgentLoopReplayEvents,
+  finalizeWorkflowDisplayOnStreamEnded,
   fixDiagramSvg,
   formatAgentTitle,
   formatDiffFromStrings,
@@ -4936,9 +5312,12 @@ export {
   formatTimeoutFooter,
   formatToolTitle,
   getChildIds,
+  getDisplayProjectionStatus,
   getMainStageIds,
   getNoopInteractionBus,
   isAgentLoopReplayEventType,
+  isAuthorityTerminal,
+  isAuthorityTerminalStatus,
   isGitOperationCommand,
   isGroupableToolName,
   isMcpToolName,
@@ -4962,8 +5341,10 @@ export {
   resolveShellProgressFromPayload,
   resolveSseTransportPolicy,
   resolveToolBody,
+  resolveWorkflowBanner,
   shouldApplyGrouping,
   shouldShowExploreDetail,
+  shouldShowGlobalSpinner,
   shouldShowTaskListFooter,
   streamChunk,
   truncateCommand,