langchain_agentx_stream_ui 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,17 +1,18 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
 import { ReactNode } from 'react';
-import { q as Source, L as LangchainAgentEvent, N as NodeRegistry, v as TierOverrides, I as InteractionBus, M as MarkdownRenderer, T as Task, t as TaskPhase, l as SessionStatus, p as SessionTree, R as ReducerError, E as EventTier } from './multi-session-CviqerRl.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, r as SourceEventContext, 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-CviqerRl.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-DAHwfTNb.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-DAHwfTNb.js';
 import { T as ToolDisplayRegistry, P as PermissionUiMode, b as DisplayMode, c as ProjectionContext, R as RenderableEntry, C as CanonicalNodeRef } from './sessionViewOptions-DLSFRQwZ.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-DLSFRQwZ.js';
 import { a as ToolBodyMode } from './types-aXj5TYSP.js';
 export { T as ToolBodyComponent, b as ToolDisplayProps } from './types-aXj5TYSP.js';
+import { StoreApi } from 'zustand/vanilla';
 export { DEFAULT_ESTIMATE_SIZE, DEFAULT_VIRTUALIZE_THRESHOLD, SessionTimeline, SessionTimelineProps, VirtualTimeline, VirtualTimelineProps } from './virtual.js';
 export { A as AgentToolBody, a as AskUserQuestionToolBody, B as BashToolBody, D as DefaultToolBody, E as EditToolBody, G as GlobToolBody, b as GrepToolBody, R as ReadToolBody, S as SkillToolBody, W as WebFetchToolBody, c as WebSearchToolBody, d as WriteToolBody, f as formatToolTitle, r as resolveToolBody } from './AskUserQuestionToolBody-CyuNy_k5.js';
 import { S as SessionNode, a as SessionNodeKind } from './nodes-DqhaBW7M.js';
 export { E as ErrorNode, N as NodeDetail, P as PermissionNode, R as ReasoningNode, b as StepDetail, c as StepNode, d as SubAgentNode, T as TextNode, g as ToolCallNode, U as UnknownNode } from './nodes-DqhaBW7M.js';
 export { B as BodyBlock, a as BodyBlockList, D as DiffView, M as MAX_PREVIEW_LINES, b as MarkdownBlock, T as TruncatedContent, c as buildBashBodyBlocks, d as displayPath, f as formatDiffFromStrings, e as formatPatternTitle, g as formatSearchResultBody, h as formatTimeoutFooter, p as parseDiffText, t as truncateCommand } from './MarkdownBlock-3iEW0Ubm.js';
-import 'zustand/vanilla';
 
 interface AgentSessionProps {
     source: Source;
@@ -48,13 +49,313 @@ interface AgentSessionProps {
 }
 declare function AgentSession({ source, initialEvents, registry, tierOverrides: _tierOverrides, onError, autoReconnect: _autoReconnect, debug, virtualized, virtualizeThreshold, interactionBus, toolDisplayRegistry, defaultBodyMode, groupParallelTools, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, children, }: AgentSessionProps): react_jsx_runtime.JSX.Element;
 
+interface AgentLoopViewProps {
+    /** 传入时使用隔离 store（workflow scoped）；省略则使用上层 SessionStoreContext */
+    tree?: SessionTree;
+    showTaskListFooter?: boolean;
+    virtualized?: boolean;
+    virtualizeThreshold?: number;
+    groupParallelTools?: boolean;
+}
+declare function AgentLoopView({ tree, showTaskListFooter, virtualized, virtualizeThreshold, groupParallelTools, }: AgentLoopViewProps): react_jsx_runtime.JSX.Element;
+
+/** 宿主按需 replay 某 loopSessionId 的事件（P2 懒加载） */
+type WorkflowLoopReplayHandler = (loopSessionId: string) => void | Promise<void>;
+declare function WorkflowLoopReplayProvider({ onRequestLoopReplay, children, }: {
+    onRequestLoopReplay?: WorkflowLoopReplayHandler;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+/** Workflow 大规模编排 UI 缩放选项（P1–P4） */
+interface WorkflowScaleOptions {
+    /**
+     * P1：已弃用 — stage 壳列表不再使用虚拟滚动。
+     * 保留字段以保证向后兼容，工作流主链路不再读取此值。
+     * @deprecated D25 Phase 1 移除 stage shell virtualization 后不再生效。
+     */
+    stageVirtualizeThreshold: number;
+    /** P3：默认展示的 completed done stage 上限（running/failed/pending 始终展示） */
+    completedStagePageSize: number;
+    /** P2：completed 且未 pin 的 loop 树移出内存，保留摘要 */
+    evictCompletedLoops: boolean;
+    /** P4：running 容器仅 active 自动展开 AgentLoopView */
+    onlyExpandActiveRunning: boolean;
+    /**
+     * P1：已弃用 — parallel item shell 不再使用虚拟滚动（最大并行跨度仅 4）。
+     * 保留字段以保证向后兼容，工作流主链路不再读取此值。
+     * @deprecated D25 Phase 1 移除 parallel item virtualization 后不再生效。
+     */
+    parallelItemVirtualizeThreshold: number;
+    /** P2：completed hydrated loop 热缓存上限（默认 4，与最大并行跨度对齐） */
+    maxHydratedCompletedLoops: number;
+}
+declare const DEFAULT_WORKFLOW_SCALE_OPTIONS: WorkflowScaleOptions;
+
+interface WorkflowSessionProps {
+    source: Source;
+    initialEvents?: LangchainAgentEvent[];
+    registry?: NodeRegistry;
+    tierOverrides?: TierOverrides;
+    onError?: (error: Error) => void;
+    interactionBus?: InteractionBus;
+    toolDisplayRegistry?: ToolDisplayRegistry;
+    defaultBodyMode?: ToolBodyMode;
+    permissionUiMode?: PermissionUiMode;
+    markdownRenderer?: MarkdownRenderer;
+    displayMode?: DisplayMode;
+    verbose?: boolean;
+    exploreFullscreenBash?: boolean;
+    memoryDir?: string | null;
+    workspaceRoot?: string | null;
+    virtualized?: boolean;
+    virtualizeThreshold?: number;
+    groupParallelTools?: boolean;
+    /** P1–P4：大规模 workflow 缩放选项 */
+    workflowScale?: Partial<WorkflowScaleOptions>;
+    /** P2：展开已淘汰 loop 时由宿主 replay 事件 */
+    onRequestLoopReplay?: WorkflowLoopReplayHandler;
+    children?: ReactNode;
+}
+declare function WorkflowSession({ source, initialEvents, registry, tierOverrides, onError, interactionBus, toolDisplayRegistry, defaultBodyMode, permissionUiMode, markdownRenderer, displayMode, verbose, exploreFullscreenBash, memoryDir, workspaceRoot, virtualized, virtualizeThreshold, groupParallelTools, workflowScale, onRequestLoopReplay, children, }: WorkflowSessionProps): react_jsx_runtime.JSX.Element;
+
+declare const WorkflowScaleContext: react.Context<WorkflowScaleOptions>;
+
+/**
+ * workflowDisplay.ts — SDK WorkflowDisplayPayload 契约（TS）
+ *
+ * 职责：
+ *     对齐 langchain_agentx WorkflowDisplayPayload；结构事件 data.display 类型。
+ *
+ * 链路位置：
+ *     workflowContainerProjector → WorkflowChrome（P2+）。
+ *
+ * 当前裁剪范围：
+ *     只读消费；不计算 display（由 SDK enricher 注入）。
+ */
+type WorkflowDisplayScope = 'workflow' | 'stage' | 'item' | 'branch' | 'aggregate' | 'subworkflow';
+type WorkflowDisplayStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled' | 'blocked' | 'retrying';
+/** 对齐 SDK display_resolver.WorkflowDisplayPayload */
+interface WorkflowDisplayPayload {
+    version?: number;
+    scope?: WorkflowDisplayScope;
+    title?: string;
+    description?: string;
+    workflow_title?: string;
+    workflow_description?: string;
+    parent_title?: string;
+    breadcrumb?: string[];
+    progress_current?: number;
+    progress_total?: number;
+    progress_label?: string;
+    progress_indeterminate?: boolean;
+    status?: WorkflowDisplayStatus;
+    status_reason?: string;
+    icon?: string;
+    item_index?: number;
+    item_total?: number;
+    metrics_completed?: number;
+    metrics_running?: number;
+    metrics_failed?: number;
+    metrics_total?: number;
+    decision_label?: string;
+    pattern?: string;
+    debug_key?: string;
+}
+
+/**
+ * workflowContainer.ts — Workflow 容器树投影类型
+ *
+ * 职责：
+ *     容器节点、正文块、快照；对齐 SDK workflow_container_projector。
+ *
+ * 链路位置：
+ *     workflowContainerProjector → workflowReducer（P1+）→ WorkflowChrome（P2+）。
+ *
+ * 当前裁剪范围：
+ *     不含 React 视图 props；仅投影层 state。
+ */
+
+type WorkflowContainerScope = 'workflow' | 'stage' | 'item' | 'branch' | 'aggregate' | 'subworkflow';
+type WorkflowContainerStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled' | 'blocked' | 'retrying';
+type ContentBlockKind = 'reasoning' | 'text' | 'tool';
+interface WorkflowContentBlock {
+    kind: ContentBlockKind;
+    preview: string;
+    tool_name: string | null;
+}
+interface WorkflowContainerNode {
+    container_id: string;
+    scope: WorkflowContainerScope;
+    workflow_path: string;
+    workflow_depth: number;
+    scope_key: string;
+    title: string;
+    subtitle: string;
+    status: WorkflowContainerStatus;
+    pattern: string;
+    parent_container_id: string | null;
+    display: WorkflowDisplayPayload | null;
+    content_blocks: WorkflowContentBlock[];
+    is_open: boolean;
+}
+/** reducer 运行时节点：投影字段 + loop 绑定（P1） */
+interface WorkflowContainerRuntimeNode extends WorkflowContainerNode {
+    loopSessionId: string | null;
+}
+/** WorkflowSession 容器树 state（P1+） */
+interface WorkflowContainerTreeState {
+    rootContainerIds: string[];
+    activeContainerIds: string[];
+    containersById: Record<string, WorkflowContainerRuntimeNode>;
+}
+
+interface WorkflowStageListPartition {
+    visible: WorkflowContainerRuntimeNode[];
+    hiddenCount: number;
+    total: number;
+    /** 当前已展示的 done stage 数量 */
+    visibleDoneCount: number;
+    /** done stage 总数 */
+    totalDoneCount: number;
+}
+/**
+ * P3：running / failed / pending / blocked 全显；
+ * done 按 maxVisibleDoneCount 分页展示（默认最近 completedStagePageSize 条）。
+ * maxVisibleDoneCount 由 WorkflowStageListPanel 的 "Show N more" 逐页递增。
+ */
+declare function partitionWorkflowStages(stages: WorkflowContainerRuntimeNode[], maxVisibleDoneCount: number): WorkflowStageListPartition;
+
+/**
+ * workflowSession.ts — Workflow 会话顶层状态
+ *
+ * 职责：
+ *     定义 /workflow 页专用 WorkflowSessionState（与 /chat SessionTree 隔离）。
+ *
+ * 链路位置：
+ *     workflowReducer → workflowSessionStore → WorkflowSession / WorkflowChrome。
+ *
+ * 当前裁剪范围：
+ *     不含合并 TaskListFooter（P3）；parallel 结构仅基础字段。
+ */
+
+/** P2：stage 完成摘要缓存（loop 树淘汰后仍显示 teaser） */
+interface CachedStageDoneSummary {
+    label: string;
+    teaser: string;
+    extraLines: number;
+}
+type WorkflowRunStatus = 'running' | 'done' | 'error';
+interface WorkflowStageProgress {
+    stageKey: string;
+    stageIndex: number;
+    stageTotal?: number;
+    status: 'pending' | 'running' | 'done' | 'failed';
+    error?: string;
+}
+interface ParallelItemProgress {
+    itemKey: string;
+    itemIndex: number;
+    itemTotal?: number;
+    status: 'pending' | 'running' | 'done' | 'failed';
+    loopSessionId: string | null;
+    error?: string;
+}
+interface WorkflowProgressState {
+    workflowId: string | null;
+    workflowPath: string | null;
+    status: WorkflowRunStatus;
+    stages: WorkflowStageProgress[];
+    parallelItems: Record<string, ParallelItemProgress>;
+}
+type WorkflowScopeKind = 'stage' | 'parallel-item' | 'subworkflow';
+interface WorkflowScopeFrame {
+    kind: WorkflowScopeKind;
+    key: string;
+    loopSessionId: string | null;
+}
+interface WorkflowSessionState {
+    status: SessionStatus;
+    meta: {
+        workflowRunId: string | null;
+        startedAt: number | null;
+        lastEventId: string | null;
+    };
+    /** SDK 容器树投影 + loopSessionId 绑定（P1 主模型） */
+    containerTree: WorkflowContainerTreeState;
+    /** 过渡期 dual-write；P2+ UI 逐步改读 containerTree */
+    workflowProgress: WorkflowProgressState;
+    loopTreesBySessionId: Record<string, SessionTree>;
+    /** P2：container_id → done 摘要（loop 淘汰后） */
+    stageDoneSummariesByContainerId: Record<string, CachedStageDoneSummary>;
+    /** P2：completed hydrated loop LRU 热缓存（最近使用在数组尾部） */
+    hotCompletedLoopSessionIds: string[];
+    activeLoopSessionId: string | null;
+    /** @deprecated P1 起由 containerTree.activeContainerIds 替代 */
+    openScopeStack: WorkflowScopeFrame[];
+    internalErrors: ReducerError[];
+}
+declare function createEmptyWorkflowSessionState(): WorkflowSessionState;
+
+/**
+ * workflowSessionStore.ts — Workflow 页 zustand store
+ *
+ * 职责：
+ *     Source 事件写入 WorkflowSessionState；与 SessionStore 平行隔离。
+ *
+ * 链路位置：
+ *     WorkflowSession Provider → applyEvent。
+ *
+ * 当前裁剪范围：
+ *     无多会话 Tab；dedupe 与 SessionStore 同构。
+ */
+
+interface WorkflowSessionStoreOptions {
+    tierOverrides?: TierOverrides;
+    initialEventCount?: number;
+    initialSeenEventIds?: Iterable<string>;
+    /** P2：completed loop 树内存淘汰（默认 true） */
+    evictCompletedLoops?: boolean;
+    /** P2：completed hydrated loop 热缓存上限（默认 4） */
+    maxHydratedCompletedLoops?: number;
+}
+interface WorkflowSessionStoreState {
+    state: WorkflowSessionState;
+    eventCount: number;
+    applyEvent: (event: LangchainAgentEvent, ctx?: SourceEventContext) => void;
+    applyEvents: (events: LangchainAgentEvent[]) => void;
+    reset: () => void;
+    markAsError: (error?: Error) => void;
+    /** P2：展开 done stage 时 pin，避免淘汰 */
+    pinLoopSession: (loopSessionId: string) => void;
+    /** P2：宿主 replay 后灌入 loop 树 */
+    hydrateLoopSession: (loopSessionId: string, events: LangchainAgentEvent[]) => void;
+}
+type WorkflowSessionStore = StoreApi<WorkflowSessionStoreState>;
+declare function createWorkflowSessionStore(initialState?: WorkflowSessionState, storeOptions?: WorkflowSessionStoreOptions): WorkflowSessionStore;
+
+declare function useWorkflowSessionStoreApi(): WorkflowSessionStore;
+declare function useWorkflowSessionStatus(): SessionStatus;
+
+interface WorkflowChromeProps {
+    containerTree: WorkflowContainerTreeState;
+    loopTreesBySessionId?: Record<string, SessionTree>;
+    virtualized?: boolean;
+    virtualizeThreshold?: number;
+    groupParallelTools?: boolean;
+}
+declare function WorkflowChrome({ containerTree, loopTreesBySessionId, virtualized, virtualizeThreshold, groupParallelTools, }: WorkflowChromeProps): react_jsx_runtime.JSX.Element;
+
+declare function WorkflowTaskListFooter(): react_jsx_runtime.JSX.Element | null;
+
 interface TimelineItemProps {
     nodeId: string;
     registry: NodeRegistry;
 }
 declare function TimelineItem({ nodeId, registry }: TimelineItemProps): react_jsx_runtime.JSX.Element | null;
 
-declare function Timeline(): react_jsx_runtime.JSX.Element;
+declare function Timeline({ showTaskListFooter }: {
+    showTaskListFooter?: boolean;
+}): react_jsx_runtime.JSX.Element;
 
 interface SpinnerElapsedInput {
     /** 当前 wall-clock（ms） */
@@ -164,6 +465,8 @@ declare function streamChunk(data: {
 }): string;
 /** Pure reducer: tree + event → new tree. */
 declare function reduceTree(tree: SessionTree, event: LangchainAgentEvent, eventIndex: number, options?: ReduceOptions): SessionTree;
+/** Agent loop 归约（/chat 根树与 workflow per-loop 子树共用）。 */
+declare const reduceAgentLoopEvent: typeof reduceTree;
 /** Reduce a sequence of events from empty tree. */
 declare function reduceEvents(events: LangchainAgentEvent[], options?: ReduceOptions): SessionTree;
 /** Collect main-stage node ids for Timeline rendering. */
@@ -469,6 +772,53 @@ declare function buildTimelineEntries(rootIds: string[], byId: Record<string, Se
 
 declare function formatAgentTitle(input: unknown, display: unknown): string;
 
+interface RichMarkdownProps {
+    content: string;
+    className?: string;
+}
+/** Web 向富 Markdown（TextNode S1）；含 Mermaid、GFM、代码高亮。 */
+declare function RichMarkdown({ content, className }: RichMarkdownProps): react_jsx_runtime.JSX.Element | null;
+
+interface MermaidDiagramProps {
+    chart: string;
+    className?: string;
+    /** 画布内 svg-pan-zoom */
+    zoomingEnabled?: boolean;
+    /** 工具栏全屏与点击放大 */
+    fullscreenEnabled?: boolean;
+}
+declare function MermaidDiagram({ chart, className, zoomingEnabled, fullscreenEnabled, }: MermaidDiagramProps): react_jsx_runtime.JSX.Element;
+
+type MermaidThemeName = 'neutral' | 'default' | 'dark' | 'forest' | 'base';
+interface MermaidInitOptions {
+    theme?: MermaidThemeName;
+    maxTextSize?: number;
+}
+
+/** 覆盖默认 mermaid 初始化（需在首次 render 前调用） */
+declare function configureMermaid(options: MermaidInitOptions): void;
+
+interface PlantUMLBlockProps {
+    content: string;
+    className?: string;
+}
+/** PlantUML 源码块（高亮 + 拷贝；供 sourceOnly / 降级展示） */
+declare function PlantUMLBlock({ content, className }: PlantUMLBlockProps): react_jsx_runtime.JSX.Element;
+
+interface PlantUMLDiagramProps {
+    content: string;
+    className?: string;
+    /** Kroki 或兼容渲染服务根 URL */
+    serverUrl?: string;
+    fullscreenEnabled?: boolean;
+    /** 仅源码高亮，不请求渲染 */
+    sourceOnly?: boolean;
+}
+declare function PlantUMLDiagram({ content, className, serverUrl, fullscreenEnabled, sourceOnly, }: PlantUMLDiagramProps): react_jsx_runtime.JSX.Element;
+
+/** 配置 PlantUML 渲染服务（默认 Kroki：https://kroki.io） */
+declare function configurePlantumlServer(url: string): void;
+
 /**
  * toolNames.ts — CC PascalCase 工具名 SSOT（对齐 SDK registry_names.py）
  *
@@ -527,27 +877,63 @@ declare function useMinDisplayTime<T>(value: T, minMs?: number): T;
 
 declare function useInteractionBus(): InteractionBus;
 
+/**
+ * applicationKind.ts — SSE meta application_kind 契约
+ *
+ * 职责：
+ *     定义双轨 SSE 出口 kind 枚举与 mismatch 错误类型。
+ *
+ * 链路位置：
+ *     createAgentxSseSource meta 握手校验。
+ *
+ * 当前裁剪范围：
+ *     仅 agent_session / workflow；无自动推断。
+ */
+type ApplicationKind = 'agent_session' | 'workflow';
+declare class ApplicationKindMismatchError extends Error {
+    readonly name = "ApplicationKindMismatchError";
+    readonly expected: ApplicationKind;
+    readonly actual: string | undefined;
+    constructor(expected: ApplicationKind, actual: string | undefined);
+}
+declare class MissingApplicationKindError extends Error {
+    readonly name = "MissingApplicationKindError";
+    constructor();
+}
+
 /**
  * 职责：浏览器 EventSource 封装，解码 meta/agentx 命名帧并校验协议版本。
  * 链路位置：业务页面 createAgentxSseSource({ url }) → AgentSession source prop。
- * 当前裁剪范围：protocol_version "1"；SSE id 行续传；网络错误依赖 EventSource 原生重连（Last-Event-ID）。
+ *
+ * 错误分层（对齐 claude-code SSETransport / Messages 管线）：
+ * - 传输 terminal：握手前/未 finish 断连 → reject(SseTransportTerminalError)，不进 Timeline
+ * - 传输 benign：finish/error 帧后的 EventSource.onerror → resolve
+ * - 业务层：agentx event_type=error → reducer → ErrorNode（唯一用户可见错误文案）
  */
 
 declare const EXPECTED_PROTOCOL_VERSION = "1";
+/** 传输层 terminal 失败（须排查/fix）；与 agentx error 帧（业务错误）分离。 */
+type SseTransportFailureKind = 'handshake_failed' | 'premature_close';
+declare class SseTransportTerminalError extends Error {
+    readonly kind: SseTransportFailureKind;
+    constructor(kind: SseTransportFailureKind, message: string);
+}
 interface AgentxSseSourceOptions {
     url: string;
-    onError?: (error: Error) => void;
     autoReconnect?: boolean;
     reconnectDelayMs?: number;
     /** 每收到 agentx 帧 SSE id 时回调（含续传重叠 id） */
     onLastEventId?: (id: string) => void;
     /** 测试注入：替换全局 EventSource */
     EventSourceImpl?: typeof EventSource;
+    /** /chat 与 /workflow 必填：校验 meta.application_kind */
+    expectedApplicationKind?: ApplicationKind;
 }
 interface AgentxMetaFrame {
     protocol_version: string;
     session_id?: string | null;
     started_at?: number;
+    application_kind?: ApplicationKind;
 }
 /** 手动重连时追加 resume 查询参数（EventSource 无法设 Last-Event-ID 请求头）。 */
 declare function buildResumeStreamUrl(baseUrl: string, lastEventId: string | null | undefined, queryParam?: string): string;
@@ -619,6 +1005,40 @@ interface ReplaySourceOptions extends ReplayOptions {
 }
 declare function createReplaySource(events: LangchainAgentEvent[], opts?: ReplaySourceOptions): Source;
 
+/**
+ * workflowReducer.ts — WorkflowSession 容器树 + agent loop 双轨归约
+ *
+ * 职责：
+ *     结构事件经 WorkflowContainerTreeProjector 更新 containerTree；
+ *     agent 事件 bind loopSessionId 并写入 loopTreesBySessionId。
+ *
+ * 链路位置：
+ *     workflowSessionStore.applyEvent → reduceWorkflowSession。
+ *
+ * 当前裁剪范围：
+ *     workflowProgress 为过渡期 dual-write；P2+ UI 改读 containerTree。
+ */
+
+/** Pure reducer：Workflow 会话状态 + 单条事件。 */
+declare function reduceWorkflowSession(state: WorkflowSessionState, event: LangchainAgentEvent, eventIndex: number, options?: ReduceOptions): WorkflowSessionState;
+/** 从空状态回放 workflow 事件序列。 */
+declare function reduceWorkflowEvents(events: LangchainAgentEvent[], options?: ReduceOptions): WorkflowSessionState;
+
+/**
+ * workflowStructureEvents.ts — Workflow 结构事件类型守卫
+ *
+ * 职责：
+ *     区分 workflow 编排结构 event_type 与 agent loop 事件。
+ *
+ * 链路位置：
+ *     workflowReducer 路由 · Source application_kind 守卫（并行契约）。
+ *
+ * 当前裁剪范围：
+ *     与 backend WORKFLOW_STRUCTURE_EVENT_TYPES 对齐；不进 tier-1 白名单。
+ */
+declare const WORKFLOW_STRUCTURE_EVENT_TYPES: ReadonlySet<string>;
+declare function isWorkflowStructureEventType(eventType: string): boolean;
+
 /**
  * 职责：事件分级类型（V2-A classify 层公共契约）。
  * 链路位置：classify.ts → reducer；AgentSession tierOverrides 传入。
@@ -647,4 +1067,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, AgentSession, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, AskUserQuestion, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, NodeRegistry, PermissionCard, PermissionUiMode, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, type ReduceOptions, ReducerError, RenderableEntry, RenderableTimelineProjector, type ReplayOptions, type ReplaySourceOptions, SHELL_PROGRESS_MIN_ELAPSED_SECONDS, SessionNode, SessionNodeKind, SessionStatus, SessionTree, Skill, Source, Spinner, type SpinnerProps, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, WebFetch, WebSearch, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, createAgentxSseSource, createDefaultRegistry, createMockSource, createReplaySource, entryKey, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isGitOperationCommand, isGroupableToolName, isMcpToolName, iterMountCandidates, projectCanonical, projectTimeline, reduceEvents, reduceTree, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline };
+export { Agent, AgentLoopView, type AgentLoopViewProps, AgentSession, type AgentSessionProps, type AgentxMetaFrame, type AgentxSseSourceOptions, type ApplicationKind, ApplicationKindMismatchError, AskUserQuestion, Bash, CanonicalNodeRef, type ClassifiedEvent, type ClassifyContext, CollapseKind, CollapsedExploreNode, type CollapsedExploreNodeProps, DEFAULT_WORKFLOW_SCALE_OPTIONS, DisplayMode, EXPECTED_PROTOCOL_VERSION, Edit, ErrorCard, EventTier, ExploreCollapseAccumulator, GROUPABLE_TOOL_NAMES, Glob, Grep, GroupedToolUseAccumulator, InteractionBus, LangchainAgentEvent, MIN_HINT_DISPLAY_MS, MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps, type MermaidInitOptions, type MermaidThemeName, MissingApplicationKindError, NodeRegistry, PermissionCard, PermissionUiMode, PlantUMLBlock, type PlantUMLBlockProps, PlantUMLDiagram, type PlantUMLDiagramProps, type ProjectedTimelineItem, ProjectionContext, DisplayMode as ProjectionDisplayMode, Read, ReasoningBubble, type ReduceOptions, ReducerError, RenderableEntry, RenderableTimelineProjector, type ReplayOptions, type ReplaySourceOptions, RichMarkdown, type RichMarkdownProps, SHELL_PROGRESS_MIN_ELAPSED_SECONDS, SessionNode, SessionNodeKind, SessionStatus, SessionTree, Skill, Source, SourceEventContext, Spinner, type SpinnerProps, type SseTransportFailureKind, SseTransportTerminalError, StepCard, SubAgentBlock, SystemSummaryAccumulator, SystemSummaryNode, Task, TaskList, TaskListFooter, TextBubble, TierOverrides, Timeline, TimelineItem, ToolBodyMode, ToolCallCard, ToolDisplayRegistry, ToolProjectionClassifier, UnknownCard, WORKFLOW_STRUCTURE_EVENT_TYPES, WebFetch, WebSearch, WorkflowChrome, type WorkflowChromeProps, type WorkflowLoopReplayHandler, WorkflowLoopReplayProvider, type WorkflowProgressState, WorkflowScaleContext, type WorkflowScaleOptions, type WorkflowScopeFrame, WorkflowSession, type WorkflowSessionProps, type WorkflowSessionState, type WorkflowSessionStore, type WorkflowSessionStoreOptions, type WorkflowSessionStoreState, type WorkflowStageProgress, WorkflowTaskListFooter, Write, buildCanonicalFromTree, buildRelevantMemoriesCanonical, buildResumeStreamUrl, buildSystemEventCanonical, buildTimelineEntries, classifyEvent, commandAsHint, configureMermaid, configurePlantumlServer, createAgentxSseSource, createDefaultRegistry, createEmptyWorkflowSessionState, createMockSource, createReplaySource, createWorkflowSessionStore, entryKey, formatAgentTitle, formatExploreSummaryText, formatHookFinishedSummary, formatShellProgressSuffix, formatTaskFooterLabel, getChildIds, getMainStageIds, isGitOperationCommand, isGroupableToolName, isMcpToolName, isWorkflowStructureEventType, iterMountCandidates, partitionWorkflowStages, projectCanonical, projectTimeline, reduceAgentLoopEvent, reduceEvents, reduceTree, reduceWorkflowEvents, reduceWorkflowSession, replayEvents, replayTree, resolveEventTier, resolveResponseId, resolveShellProgressFromPayload, shouldShowTaskListFooter, streamChunk, useChildren, useInteractionBus, useInternalErrors, useMinDisplayTime, useNode, useNodeTyped, useProjectedTimeline, useReplayTree, useSessionMeta, useSessionStatus, useTimeline, useWorkflowSessionStatus, useWorkflowSessionStoreApi };