langchain_agentx_stream_ui 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,650 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+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 { 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';
+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;
+    /** 挂载时先 replay 预灌树（含 EventBuffer ingest 快照），再接 source 续流 */
+    initialEvents?: LangchainAgentEvent[];
+    registry?: NodeRegistry;
+    tierOverrides?: TierOverrides;
+    onError?: (error: Error) => void;
+    autoReconnect?: boolean;
+    debug?: boolean;
+    /** 为 true 且主舞台节点数超过阈值时使用 VirtualTimeline（V2-E） */
+    virtualized?: boolean;
+    virtualizeThreshold?: number;
+    /** 权限回写薄层；PermissionCard 触发 onPermissionResolve（V2-D） */
+    interactionBus?: InteractionBus;
+    /** 按工具名注册 Body 组件（V3-T0） */
+    toolDisplayRegistry?: ToolDisplayRegistry;
+    /** 工具正文默认 preview / full（V3-T0） */
+    defaultBodyMode?: ToolBodyMode;
+    /** @deprecated Phase 4 起由 projection GroupedToolUseAccumulator 自动分组；保留 prop 兼容 */
+    groupParallelTools?: boolean;
+    /** 权限 UI：standalone | inline | both（V3-T4.6）；后台 bypass 时通常无 pending */
+    permissionUiMode?: PermissionUiMode;
+    /** 富 Markdown 渲染（simple demo 可注入 react-markdown + mermaid） */
+    markdownRenderer?: MarkdownRenderer;
+    /** 对齐 CLI display mode（normal / brief_only / transcript） */
+    displayMode?: DisplayMode;
+    /** 对齐 CC verbose；为 true 时跳过分组并展开 explore detail */
+    verbose?: boolean;
+    exploreFullscreenBash?: boolean;
+    memoryDir?: string | null;
+    workspaceRoot?: string | null;
+    children?: ReactNode;
+}
+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 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;
+
+interface SpinnerElapsedInput {
+    /** 当前 wall-clock（ms） */
+    nowMs: number;
+    /** Turn 加载开始时间（ms） */
+    loadingStartTimeMs: number;
+    /** 已累计 pause 时长（ms）；SDK 无 pause 事件时为 0 */
+    totalPausedMs?: number;
+    /** pause 开始时间；非 null 表示当前处于 pause 冻结 */
+    pauseStartTimeMs?: number | null;
+}
+
+interface SpinnerProps {
+    /** Session 启动时间（毫秒时间戳） */
+    startedAt: number | null;
+    /** 当前内容字符数（用于估算 Token） */
+    contentCharCount?: number;
+    /** 当前模式（用于跟踪 thinking 状态） */
+    mode?: 'idle' | 'requesting' | 'tool-use' | 'thinking';
+    /** 对齐 CC verbose：30s 前仍显示 timer/token 后缀 */
+    verbose?: boolean;
+    /** pause 扣除（SDK 无事件时省略） */
+    timing?: Pick<SpinnerElapsedInput, 'totalPausedMs' | 'pauseStartTimeMs'>;
+}
+declare function Spinner({ startedAt, contentCharCount, mode, verbose, timing, }: SpinnerProps): react_jsx_runtime.JSX.Element | null;
+
+interface TaskListProps {
+    tasks: Task[];
+    /** 省略时按视口高度动态计算（对齐 CC 终端行数档位） */
+    maxDisplay?: number;
+    /** false = Spinner 内嵌模式，不显示统计行（对齐 CC TaskListV2） */
+    isStandalone?: boolean;
+}
+declare function TaskList({ tasks, maxDisplay: maxDisplayProp, isStandalone, }: TaskListProps): react_jsx_runtime.JSX.Element | null;
+
+/** 纯函数：footer pill 文案（供单测） */
+declare function formatTaskFooterLabel(tasks: Task[]): string;
+/** 纯函数：是否展示 footer（供单测） */
+declare function shouldShowTaskListFooter(taskPhase: TaskPhase, tasks: Task[], hasEverShownTaskList: boolean, sessionStatus: SessionStatus): boolean;
+declare function TaskListFooter(): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * 职责：默认 registry 工厂别名，供 AgentSession 内部使用。
+ * 链路位置：AgentSession 未传 registry 时的 fallback。
+ * 当前裁剪范围：委托 NodeRegistry.default()。
+ */
+
+declare function createDefaultRegistry(): NodeRegistry;
+
+interface TextBubbleProps {
+    nodeId: string;
+}
+declare function TextBubble({ nodeId }: TextBubbleProps): react_jsx_runtime.JSX.Element | null;
+
+interface ReasoningBubbleProps {
+    nodeId: string;
+}
+declare function ReasoningBubble({ nodeId }: ReasoningBubbleProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * SystemSummaryNode.tsx — system_summary 摘要行
+ *
+ * 对齐 CC / CLI hook · compact 单行系统摘要。
+ */
+interface SystemSummaryNodeProps {
+    summaryText: string;
+}
+declare function SystemSummaryNode({ summaryText }: SystemSummaryNodeProps): react_jsx_runtime.JSX.Element;
+
+interface ToolCallCardProps {
+    nodeId: string;
+    layout?: 'default' | 'grouped';
+}
+declare function ToolCallCard({ nodeId, layout }: ToolCallCardProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * constants.ts — Renderable Projection 常量 SSOT
+ *
+ * 职责：
+ *     分组工具名等与 CLI D13、grouped_tool_use.py 对齐的 frozen 集合。
+ *
+ * 链路位置：
+ *     Phase 1+ classifier / GroupedToolUseAccumulator 消费；Phase 0 定标与单测。
+ *
+ * 当前裁剪范围：
+ *     不含 explore CollapseKind 枚举（Phase 2 classify.ts）。
+ */
+/** 对齐 CLI GROUPABLE_TOOL_NAMES · CC applyGrouping 仅 Agent */
+declare const GROUPABLE_TOOL_NAMES: ReadonlySet<string>;
+declare function isGroupableToolName(toolName: string): boolean;
+
+/**
+ * 合并 call 与 result 侧 candidate；call 优先。
+ * message_id 缺失 → null → GroupedToolUseAccumulator 不分组（对齐 CLI 保守策略）。
+ */
+declare function resolveResponseId(toolPayload: Record<string, unknown> | undefined | null, resultMeta: unknown): string | null;
+
+interface ReduceOptions {
+    tierOverrides?: TierOverrides;
+    /** true 时 debug tier 也写入 debugEvents（AgentSession debug prop） */
+    collectDebug?: boolean;
+}
+declare function streamChunk(data: {
+    delta?: string;
+    text?: string;
+    content?: string;
+}): string;
+/** Pure reducer: tree + event → new tree. */
+declare function reduceTree(tree: SessionTree, event: LangchainAgentEvent, eventIndex: number, options?: ReduceOptions): SessionTree;
+/** Reduce a sequence of events from empty tree. */
+declare function reduceEvents(events: LangchainAgentEvent[], options?: ReduceOptions): SessionTree;
+/** Collect main-stage node ids for Timeline rendering. */
+declare function getMainStageIds(tree: SessionTree): string[];
+declare function getChildIds(tree: SessionTree, parentId: string): string[];
+
+/**
+ * memoryPaths.ts — memory 工具路径识别 SSOT（对齐 CLI memory_paths.py）
+ *
+ * 职责：
+ *     判断 write/read/grep/glob/bash 是否针对 auto-managed memory 目录。
+ *
+ * 链路位置：
+ *     ToolProjectionClassifier.memorySubkind() → ExploreCollapseAccumulator。
+ *
+ * 当前裁剪范围：
+ *     基于 memoryDir + workspaceRoot 路径前缀；不含 SDK is_agent_memory_path。
+ */
+declare const MemoryKind: {
+    readonly Write: "Write";
+    readonly Read: "Read";
+    readonly Search: "Search";
+};
+type MemoryToolKind = (typeof MemoryKind)[keyof typeof MemoryKind];
+
+/**
+ * classify.ts — 工具投影分类（CollapseKind）
+ *
+ * 职责：
+ *     将 tool_use 归类为 Read / Search / List / Bash / Memory / None。
+ *
+ * 链路位置：
+ *     RenderableTimelineProjector → ToolProjectionClassifier（Phase 2+ accumulator 消费）。
+ *
+ * 当前裁剪范围：
+ *     bash 重分类与 memory 路径识别；对齐 CLI classify.py。
+ */
+
+declare enum CollapseKind {
+    None = "None",
+    Read = "Read",
+    Search = "Search",
+    List = "List",
+    Bash = "Bash",
+    Memory = "Memory",
+    Mcp = "Mcp"
+}
+declare class ToolProjectionClassifier {
+    private readonly context;
+    constructor(context: ProjectionContext);
+    getContext(): ProjectionContext;
+    isSilentTool(toolName: string | null | undefined): boolean;
+    classifyTool(toolName: string | null | undefined, toolInput?: Record<string, unknown> | null, display?: Record<string, unknown> | null): CollapseKind;
+    isExploreCollapsible(toolName: string | null | undefined, toolInput?: Record<string, unknown> | null, display?: Record<string, unknown> | null): boolean;
+    memorySubkind(toolName: string | null | undefined, toolInput?: Record<string, unknown> | null, display?: Record<string, unknown> | null): MemoryToolKind | null;
+}
+
+declare function commandAsHint(command: string): string;
+/** G06：bash 内 git 写操作（commit/push 等），不计入 explore bash 桶 */
+declare function isGitOperationCommand(command: string): boolean;
+/** G06：MCP 工具名识别 */
+declare function isMcpToolName(toolName: string | null | undefined): boolean;
+
+/**
+ * exploreSummary.ts — collapsed_explore 摘要文案（对齐 CC / CLI）
+ *
+ * 职责：
+ *     生成与 CC CollapsedReadSearchContent / getSearchReadSummaryText 一致的 plain 摘要。
+ *
+ * 链路位置：
+ *     ExploreCollapseAccumulator → payload.summaryText。
+ *
+ * 当前裁剪范围：
+ *     仅 plain text；Rich/bold 渲染在 CollapsedExploreNode（Phase 3）。
+ */
+interface ExploreSummaryCounts {
+    searchCount: number;
+    readCount: number;
+    listCount: number;
+    bashCount: number;
+    memorySearchCount: number;
+    memoryReadCount: number;
+    memoryWriteCount: number;
+    relevantRecallCount: number;
+    gitOpBashCount: number;
+    mcpCallCount: number;
+}
+declare function formatExploreSummaryText(counts: ExploreSummaryCounts, options?: {
+    active: boolean;
+    prefix?: string;
+    joiner?: string;
+    /** Thought 前缀已占用句首时，explore 动词用小写续写 */
+    continuingSentence?: boolean;
+}): string | null;
+
+/**
+ * exploreCollapse.ts — ExploreCollapseAccumulator
+ *
+ * 职责：
+ *     将连续探索类 tool_use 节点折叠为 collapsed_explore RenderableEntry。
+ *
+ * 链路位置：
+ *     RenderableTimelineProjector.projectImpl → collapse()。
+ *
+ * 当前裁剪范围：
+ *     前端 canonical 为单节点 tool_call（input+result 合并）；对齐 CLI 计数与 payload 字段。
+ */
+
+declare class ExploreCollapseAccumulator {
+    private readonly classifier;
+    /** 当前活跃轮次 ID */
+    private currentRoundId;
+    /** 当前活跃 reasoning 节点 ID */
+    private currentReasoningNodeId;
+    constructor(classifier: ToolProjectionClassifier);
+    collapse(entries: RenderableEntry[]): RenderableEntry[];
+    private newGroup;
+    private breaksGroup;
+    private waitingPermission;
+    private toolKind;
+    private absorbToolEntry;
+    private groupCounts;
+    private resolveShellProgressSuffix;
+    private buildPayload;
+    private serializeToolUses;
+    private readPath;
+    private recordSearchArg;
+    private recordDisplayHint;
+    private resolveDisplayHint;
+}
+
+/**
+ * groupedToolUse.ts — GroupedToolUseAccumulator
+ *
+ * 职责：
+ *     同一 response（message_id）内 2+ 个同类 Agent/Task 合成 grouped_tool_use。
+ *
+ * 链路位置：
+ *     RenderableTimelineProjector.projectImpl → group()（在 explore collapse 之前）。
+ *
+ * 当前裁剪范围：
+ *     对齐 CLI grouped_tool_use.py；前端单节点 tool_call（无独立 tool_result 行）。
+ */
+
+declare class GroupedToolUseAccumulator {
+    group(entries: RenderableEntry[]): RenderableEntry[];
+    private buildGrouped;
+}
+
+/**
+ * systemSummary.ts — SystemSummaryAccumulator
+ *
+ * 职责：连续 hook / compact 系统事件 → system_summary RenderableEntry。
+ *
+ * 链路位置：
+ *     RenderableTimelineProjector.projectImpl → collapseSystemSummary()。
+ */
+
+declare class SystemSummaryAccumulator {
+    collapse(entries: RenderableEntry[]): RenderableEntry[];
+}
+
+/**
+
+ * treeAdapter.ts — SessionTree → CanonicalNodeRef[]
+
+ *
+
+ * 职责：
+
+ *     从 reducer 保真 SessionTree 抽取主舞台 canonical 列表（不改 reducer）。
+
+ *
+
+ * 链路位置：
+
+ *     projectTimeline(tree) → buildCanonicalFromTree → RenderableTimelineProjector。
+
+ *
+
+ * 当前裁剪范围：
+
+ *     systemEvents（hook/compact）按 timestamp 与主舞台交错；不含 debug tier 其它事件。
+
+ */
+
+/** relevant_memories 单测 / 未来 recall 事件适配 */
+declare function buildRelevantMemoriesCanonical(options: {
+    nodeId?: string;
+    count: number;
+}): CanonicalNodeRef;
+declare function buildCanonicalFromTree(tree: SessionTree): CanonicalNodeRef[];
+declare function buildSystemEventCanonical(options: {
+    eventIndex: number;
+    eventType: string;
+    data?: Record<string, unknown>;
+    timestamp?: number;
+}): CanonicalNodeRef;
+
+/**
+ * systemSummaryText.ts — system_summary 摘要文案
+ *
+ * 对齐 CC collapseHookSummaries / CLI system_summary.py 感官。
+ */
+declare function formatHookFinishedSummary(data: Record<string, unknown>): string;
+
+/**
+ * shellProgress.ts — G05 collapsed_explore shell 进度后缀
+ *
+ * 对齐 CC CollapsedReadSearchContent：bash 运行 ≥2s 时在摘要后追加 elapsed/lines。
+ */
+declare const SHELL_PROGRESS_MIN_ELAPSED_SECONDS = 2;
+declare function formatShellProgressSuffix(elapsedSeconds: number | undefined, totalLines: number | undefined): string | null;
+declare function resolveShellProgressFromPayload(payload: Record<string, unknown>): string | null;
+
+/**
+ * projector.ts — RenderableTimelineProjector
+ *
+ * 职责：
+ *     接收 canonical 列表，产出 RenderableEntry[]。
+ *     Phase 4：group → explore collapse pass 顺序对齐 CLI。
+ *
+ * 链路位置：
+ *     projectTimeline(tree, context) → 本类 → Timeline（Phase 3 接入）。
+ *
+ * 当前裁剪范围：
+ *     pass 顺序 group → explore → systemSummary；异常时 atomic 回退。
+ */
+
+declare class RenderableTimelineProjector {
+    private readonly context;
+    private readonly classifier;
+    constructor(context: ProjectionContext);
+    getContext(): ProjectionContext;
+    getClassifier(): ToolProjectionClassifier;
+    project(canonical: CanonicalNodeRef[]): RenderableEntry[];
+    private projectImpl;
+    private shouldOmitFromRenderable;
+    private toRenderableEntry;
+    private atomicPassThrough;
+}
+
+/**
+ * projectTimeline.ts — 薄封装入口
+ *
+ * 职责：
+ *     SessionTree + ProjectionContext → RenderableEntry[]。
+ *
+ * 链路位置：
+ *     useProjectedTimeline（Phase 3）/ 公开 API 消费。
+ *
+ * 当前裁剪范围：
+ *     仅委托 RenderableTimelineProjector；不 mount DOM。
+ */
+
+declare function projectTimeline(tree: SessionTree, context: ProjectionContext): RenderableEntry[];
+declare function projectCanonical(canonical: CanonicalNodeRef[], context: ProjectionContext): RenderableEntry[];
+
+/**
+ * mountCandidates.ts — renderable → Timeline mount 候选
+ *
+ * 职责：
+ *     根据 RenderableEntry[] 计算 entryKey、过滤被 collapsed / grouped 吸收的原子行。
+ *
+ * 链路位置：
+ *     useProjectedTimeline / TimelineEntries 消费。
+ *
+ * 当前裁剪范围：
+ *     对齐 CLI renderable_mount.py；B02 禁止 explore 双重 mount。
+ */
+
+declare function entryKey(entry: RenderableEntry): string;
+declare function iterMountCandidates(entries: RenderableEntry[], options: {
+    classifier: ToolProjectionClassifier | null;
+    exploreDetail: boolean;
+    hideStandalonePermissions?: boolean;
+    showReasoningInTimeline?: boolean;
+    compactNarrative?: boolean;
+}): Array<[string, RenderableEntry]>;
+
+/**
+ * groupParallelTools.ts — 主舞台 Timeline 条目分组（过渡实现）
+ *
+ * @deprecated Phase 4 由 core/projection GroupedToolUseAccumulator + mountCandidates 替代。
+ * 对齐参考：CC GroupedToolUseContent · buildMessageLookups 并行同工具分组语义
+ */
+
+type TimelineEntry = {
+    kind: 'node';
+    nodeId: string;
+} | {
+    kind: 'tool_group';
+    toolName: string;
+    nodeIds: string[];
+};
+interface BuildTimelineEntriesOptions {
+    /** @deprecated 使用 projection grouped_tool_use；保留至 Phase 4 迁移完成 */
+    groupParallelTools?: boolean;
+    hideStandalonePermissions?: boolean;
+}
+/** @deprecated 见 core/projection；Phase 4 删除 */
+declare function buildTimelineEntries(rootIds: string[], byId: Record<string, SessionNode | undefined>, options?: BuildTimelineEntriesOptions): TimelineEntry[];
+
+declare function formatAgentTitle(input: unknown, display: unknown): string;
+
+/**
+ * toolNames.ts — CC PascalCase 工具名 SSOT（对齐 SDK registry_names.py）
+ *
+ * 职责：Stream UI widget / projection / reducer 消费的工具名字面量唯一来源。
+ * 链路位置：registry.ts、classify.ts、memoryPaths.ts、reducer.ts。
+ * 当前裁剪范围：无 legacy alias、无 *Tool 后缀变体、无 REMOVED 双轨表。
+ */
+declare const Read = "Read";
+declare const Write = "Write";
+declare const Edit = "Edit";
+declare const Glob = "Glob";
+declare const Grep = "Grep";
+declare const Bash = "Bash";
+declare const Skill = "Skill";
+declare const Agent = "Agent";
+declare const AskUserQuestion = "AskUserQuestion";
+declare const WebSearch = "WebSearch";
+declare const WebFetch = "WebFetch";
+
+interface SubAgentBlockProps {
+    nodeId: string;
+}
+declare function SubAgentBlock({ nodeId }: SubAgentBlockProps): react_jsx_runtime.JSX.Element | null;
+
+interface StepCardProps {
+    nodeId: string;
+}
+declare function StepCard({ nodeId }: StepCardProps): react_jsx_runtime.JSX.Element | null;
+
+interface ErrorCardProps {
+    nodeId: string;
+}
+declare function ErrorCard({ nodeId }: ErrorCardProps): react_jsx_runtime.JSX.Element | null;
+
+interface UnknownCardProps {
+    nodeId: string;
+}
+declare function UnknownCard({ nodeId }: UnknownCardProps): react_jsx_runtime.JSX.Element | null;
+
+interface PermissionCardProps {
+    nodeId: string;
+}
+declare function PermissionCard({ nodeId }: PermissionCardProps): react_jsx_runtime.JSX.Element | null;
+
+interface CollapsedExploreNodeProps {
+    entry: RenderableEntry;
+    registry: NodeRegistry;
+}
+declare function CollapsedExploreNode({ entry, registry }: CollapsedExploreNodeProps): react_jsx_runtime.JSX.Element;
+
+declare const MIN_HINT_DISPLAY_MS = 700;
+/**
+ * 每个 distinct value 至少展示 minMs，避免 hint 闪烁过快。
+ */
+declare function useMinDisplayTime<T>(value: T, minMs?: number): T;
+
+declare function useInteractionBus(): InteractionBus;
+
+/**
+ * 职责：浏览器 EventSource 封装，解码 meta/agentx 命名帧并校验协议版本。
+ * 链路位置：业务页面 createAgentxSseSource({ url }) → AgentSession source prop。
+ * 当前裁剪范围：protocol_version "1"；SSE id 行续传；网络错误依赖 EventSource 原生重连（Last-Event-ID）。
+ */
+
+declare const EXPECTED_PROTOCOL_VERSION = "1";
+interface AgentxSseSourceOptions {
+    url: string;
+    onError?: (error: Error) => void;
+    autoReconnect?: boolean;
+    reconnectDelayMs?: number;
+    /** 每收到 agentx 帧 SSE id 时回调（含续传重叠 id） */
+    onLastEventId?: (id: string) => void;
+    /** 测试注入：替换全局 EventSource */
+    EventSourceImpl?: typeof EventSource;
+}
+interface AgentxMetaFrame {
+    protocol_version: string;
+    session_id?: string | null;
+    started_at?: number;
+}
+/** 手动重连时追加 resume 查询参数（EventSource 无法设 Last-Event-ID 请求头）。 */
+declare function buildResumeStreamUrl(baseUrl: string, lastEventId: string | null | undefined, queryParam?: string): string;
+declare function createAgentxSseSource(options: AgentxSseSourceOptions): Source;
+/** 测试/Story 用：内存事件源 */
+declare function createMockSource(events: LangchainAgentEvent[]): Source;
+
+/**
+ * 职责：离线回放纯函数，将 events[] 归并为 SessionTree。
+ * 链路位置：测试、历史页、createReplaySource、AgentSession initialEvents 共用。
+ * 当前裁剪范围：纯函数；禁止网络与 Date.now()；复用 classify + reducer。
+ */
+
+interface ReplayOptions {
+    tierOverrides?: TierOverrides;
+    collectDebug?: boolean;
+}
+/** 从空树回放完整事件序列。 */
+declare function replayEvents(events: LangchainAgentEvent[], options?: ReplayOptions): SessionTree;
+/** 从已有树继续回放；startEventIndex 默认 0，续流时传 initialEvents.length。 */
+declare function replayTree(initialTree: SessionTree, events: LangchainAgentEvent[], options?: ReplayOptions & {
+    startEventIndex?: number;
+}): SessionTree;
+
+declare function useReplayTree(events: LangchainAgentEvent[], options?: ReplayOptions): SessionTree;
+
+/**
+ * useProjectedTimeline.ts — SessionTree → mount 候选 RenderableEntry[]
+ *
+ * 职责：
+ *     memo 订阅 tree + SessionViewOptions，运行 projectTimeline + iterMountCandidates。
+ *
+ * 链路位置：
+ *     TimelineEntries / VirtualTimeline 消费。
+ *
+ * 当前裁剪范围：
+ *     grouped_tool_use / system_summary 由 Phase 4+ 渲染分支处理。
+ */
+
+interface ProjectedTimelineItem {
+    key: string;
+    entry: RenderableEntry;
+}
+declare function useProjectedTimeline(): ProjectedTimelineItem[];
+
+declare function useTimeline(): string[];
+declare function useNode(id: string): SessionNode | undefined;
+declare function useNodeTyped<K extends SessionNodeKind>(id: string, kind: K): Extract<SessionNode, {
+    kind: K;
+}> | undefined;
+declare function useChildren(parentId: string): string[];
+declare function useSessionStatus(): SessionStatus;
+declare function useInternalErrors(): ReducerError[];
+declare function useSessionMeta(): {
+    sessionId: string | null;
+    startedAt: number | null;
+    lastEventId: string | null;
+};
+
+/**
+ * 职责：内存事件源，按序投递 events 实现 Source 接口。
+ * 链路位置：历史回放、测试、AgentSession 只读时间线。
+ * 当前裁剪范围：可选 delayMs 模拟流式；不含 SSE 续传。
+ */
+
+interface ReplaySourceOptions extends ReplayOptions {
+    /** 事件间隔毫秒；默认 0 立即投递 */
+    delayMs?: number;
+}
+declare function createReplaySource(events: LangchainAgentEvent[], opts?: ReplaySourceOptions): Source;
+
+/**
+ * 职责：事件分级类型（V2-A classify 层公共契约）。
+ * 链路位置：classify.ts → reducer；AgentSession tierOverrides 传入。
+ * 当前裁剪范围：四级 tier；不含多会话/Replay 选项。
+ */
+
+interface ClassifiedEvent {
+    event: LangchainAgentEvent;
+    tier: EventTier;
+    /** 折叠/debug 事件写入的父节点 id（tool:*） */
+    parentNodeId?: string;
+}
+/** classify 只读上下文（由 reducer 从 SessionTree 派生） */
+interface ClassifyContext {
+    openSubAgentStack: string[];
+    /** 当前流式 tool 节点（tool-input-delta 无 tool_call_id 时回退） */
+    streamingToolNodeId?: string;
+}
+
+/**
+ * 职责：LangchainAgentEvent → tier + parentNodeId（纯函数，不改树）。
+ * 链路位置：store.applyEvent → classifyEvent → reduceTree。
+ * 当前裁剪范围：DEFAULT_EVENT_TIERS + tierOverrides；subagent 折叠事件挂 Agent ToolCallNode。
+ */
+
+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 };