@blade-hq/agent-react 2612.0.0-beta.0 → 2612.0.0-beta.10

package/dist/chat/AssistantTurnBlock.d.ts

@@ -0,0 +1,50 @@
+import type { ChatMessage, MemoryRefInfo } from "@blade-hq/agent-client/internal";
+import type { AskUserAnswerData } from "./AskUserQuestionBlock";
+import { type ChatViewCustomization } from "./customization";
+export { collectTurnMessages, getPersistentAskUserQuestions } from "./assistant-turn-questions";
+interface Props {
+    turnKey: string;
+    sessionId: string;
+    messages: ChatMessage[];
+    isStreaming?: boolean;
+    /**
+     * 打字机式显示节流下，"正文还没播完"跟"思考过程本身有没有说完"是两条
+     * 独立时间线——正文通常比思考过程晚播完很久。"正在思考"/"已思考" 这个
+     * 标签只该看思考过程自己有没有播完，不能被 isStreaming（含正文节流）
+     * 拖着一起等正文播完才翻，否则会出现"正文都在吐字好几秒了，还显示正在
+     * 思考"这种跟视觉进度对不上的观感。不传时按旧行为处理（等价于思考过程
+     * 跟 isStreaming 同步）。
+     */
+    isReasoningRevealing?: boolean;
+    isLastTurn?: boolean;
+    askAnswers?: Record<string, AskUserAnswerData>;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+    sessionStatus?: string;
+    level?: 1 | 2;
+    forceExpanded?: boolean;
+    customization?: ChatViewCustomization;
+}
+export type TurnDisplayMode = "compact" | "detail";
+export declare function defaultTurnDisplayMode({ forceExpanded, hasActionableToolCall, isStreaming, }: {
+    forceExpanded: boolean;
+    hasActionableToolCall: boolean;
+    isStreaming: boolean;
+}): TurnDisplayMode;
+export declare function resolveTurnDisplayMode({ isStreaming: _isStreaming, displayMode, }: {
+    isStreaming: boolean;
+    displayMode: TurnDisplayMode;
+}): TurnDisplayMode;
+export declare function formatExecutionDuration(durationMs: number): string;
+export declare function getExecutionDurationMs({ messages, isStreaming, now, }: {
+    messages: ChatMessage[];
+    isStreaming: boolean;
+    now?: number;
+}): number;
+declare function AssistantTurnBlockBase({ sessionId, messages: rawMessages, isStreaming, isReasoningRevealing, askAnswers, onAnswer, sessionStatus, level, forceExpanded, customization, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare const AssistantTurnBlock: import("react").MemoExoticComponent<typeof AssistantTurnBlockBase>;
+/** 一轮消息里引用到的记忆（按 id 去重，保持首次出现的顺序）。 */
+export declare function collectMemoryRefs(messages: ChatMessage[]): MemoryRefInfo[];
+export declare function MemoryRefsHint({ refs: rawRefs, className }: {
+    refs: MemoryRefInfo[];
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/chat/AttachmentPreviewDialog.d.ts

@@ -0,0 +1,26 @@
+/**
+ * R6：用户上传的附件（文本 / 未知类型）预览弹窗。
+ *
+ * 图片走独立的 ImageLightbox；本组件处理：
+ * - .md → markdown 渲染
+ * - .json / .txt / .yaml / .yml / 其他文本 → 纯文本等宽展示
+ * - 不可在浏览器内渲染的类型 → 下载链接兜底
+ *
+ * 无 URL 时兜底为只显示文件名 + 下载入口。
+ */
+interface Props {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    filename: string;
+    /**
+     * 由调用方用 `getAuthedUrl()` 构造的完整 URL（baseUrl + 路径 + ?token=…）。
+     * 内部 fetch 直接用原串，**不**再走 `apiFetchText` —— 否则会二次拼 baseUrl，
+     * 在独立前后端部署时会得到形如 `http://api.xxxhttp://api.xxx/…` 的非法 URL。
+     * token 靠 query 字符串携带，因此也不需要再挂 Authorization header。
+     */
+    url: string | null;
+    /** text-like 视为"可文本预览"；其他只显示下载按钮。 */
+    mode: "markdown" | "text" | "default";
+}
+export declare function AttachmentPreviewDialog({ open, onOpenChange, filename, url, mode }: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/chat/ChatPanel.d.ts

@@ -0,0 +1,62 @@
+import { type ReactNode } from "react";
+import { type MessageContent, type QueuedMessage } from "@blade-hq/agent-client/internal";
+import { type ChatViewCustomization } from "./customization";
+import { type FollowupInteractionEvent } from "./followup-interaction";
+import { type ChatRenderMode } from "./runtime/environment";
+/**
+ * 队列条目上移 / 下移后的完整 pending 顺序；越界或条目不在 pending 里返回 null。
+ *
+ * 服务端要求 `ordered_ids` 是当前 pending 条目的完整集合（顺序任意），所以这里
+ * 始终提交全量，而不是只报移动的那一条；`delivering` 条目固定位置、不参与。
+ */
+export declare function nextQueuedOrder(items: QueuedMessage[], itemId: string, delta: -1 | 1): string[] | null;
+export interface ChatPanelProps extends ChatViewCustomization {
+    sessionId: string;
+    /** 配色主题；宿主已经在祖先元素上写了 data-theme 时不用传。 */
+    theme?: "light" | "dark";
+    /** 下一条消息的模式与切换（内置 Web 由会话 store 管）；不传时用会话自己的模式、不给切换。 */
+    mode?: "planning" | "executing";
+    onToggleMode?: () => void;
+    /** 连接状态条下方的横幅（插件选择、回放冲突提示等）。 */
+    banner?: ReactNode;
+    /** 消息列表上方 / 输入框下方的自定义区域，无消息时的空状态。 */
+    header?: ReactNode;
+    footer?: ReactNode;
+    emptyState?: ReactNode;
+    /**
+     * 回放条的「退出回放」。SDK 外壳用 `useReplay` 接管了「输入对不上录制内容」的决定，退出要先了结
+     * 待定的那次决定，所以由它传入；不传时回放条直接退出回放。
+     */
+    onExitReplay?: () => void;
+    /** 额外的出错说明（例如 SDK 外壳的连接失败），显示在出错条里。 */
+    errorMessage?: string | null;
+    placeholder?: string;
+    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
+    renderAttachments?: () => ReactNode;
+    onBeforeSend?: (content: MessageContent) => MessageContent | Promise<MessageContent>;
+    onCommand?: (commandId: string) => void | Promise<void>;
+    /** 宿主是否接住了「创建后台任务」；见输入框上的说明。 */
+    canCreateBoardTask?: boolean;
+    canShareSession?: boolean;
+    /** 打开技能页；由宿主导航。 */
+    onOpenSkills?: () => void;
+    inputLabel?: string;
+    onDoubleEscape?: (anchorRect: DOMRect | null) => void;
+    composerHint?: ReactNode;
+    composerBanner?: ReactNode;
+    scrollToStartKey?: string | null;
+    scrollToEntryKey?: string | null;
+    initialDraft?: string;
+    initialDraftKey?: string;
+    renderMode?: ChatRenderMode;
+    /**
+     * 开发者视图专用的输入框底部统计插槽。宿主（内置 Web 页面）注入；普通与精简视图不会调用它，
+     * 因此也不会发出统计请求。
+     */
+    renderComposerStats?: (sessionId: string) => ReactNode;
+}
+/**
+ * 聊天面板：消息流 + 队列 + 输入框。数据只来自 SessionSourceProvider 提供的会话实例与 props；
+ * 内置 Web、浏览器插件与 SDK 的 ChatView / `<blade-chat>` 渲染的都是它。
+ */
+export declare function ChatPanel({ sessionId, theme, mode: providedMode, onToggleMode, banner, header, footer, emptyState, errorMessage: externalError, onExitReplay, placeholder, onFollowupInteraction, renderAttachments, onBeforeSend, onCommand, canCreateBoardTask, canShareSession, onOpenSkills, inputLabel, onDoubleEscape, composerHint, composerBanner, scrollToStartKey, scrollToEntryKey, initialDraft, initialDraftKey, renderMode: requestedRenderMode, renderComposerStats, classNames, components, renderers, }: ChatPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/CompactionCard.d.ts

@@ -0,0 +1,6 @@
+import type { CompactionInfo } from "@blade-hq/agent-client/internal";
+export declare function CompactionCard({ sessionId, compaction, status, }: {
+    sessionId: string;
+    compaction?: CompactionInfo | null;
+    status?: "streaming" | "completed" | "paused" | "failed" | "interrupted";
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/ConnectionBanner.d.ts

@@ -0,0 +1,10 @@
+import type { ConnectionStatus } from "@blade-hq/agent-client/internal";
+/**
+ * 连接状态提示：短暂断线不打扰（3 秒容错），恢复不了再提示。`hasEverConnected` 不传时按本组件
+ * 挂载以来是否连上过判断（决定文案是「无法恢复」还是「无法连接」）。
+ */
+export declare function ConnectionBanner({ connection, hasEverConnected: hasEverConnectedProp, className, }: {
+    connection: ConnectionStatus;
+    hasEverConnected?: boolean;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/CurrentPlanPanel.d.ts

@@ -0,0 +1,20 @@
+import type { ChatMessage } from "@blade-hq/agent-client/internal";
+export declare function CurrentPlanPanelContent({ messages, running, autoReveal, sessionId, hideTodo, }: {
+    messages: ChatMessage[];
+    /** 会话是否还在执行；停止或加载历史时进度里的步骤不再转圈。 */
+    running?: boolean;
+    /** 仅当前这次消息变更来自实时成功的 update_plan 时为 true。 */
+    autoReveal?: boolean;
+    /** Key the plan block by session so switching sessions resets its local UI state. */
+    sessionId?: string;
+    hideTodo?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function CurrentPlanPanel({ sessionId, className, }: {
+    sessionId: string;
+    /**
+     * Wrapper classes applied only when there is a plan to show, so callers can
+     * add chrome (e.g. the composer's bottom divider) without leaving an empty
+     * bordered strip behind when the session never called `update_plan`.
+     */
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/FileDeliveryCards.d.ts

@@ -0,0 +1,26 @@
+import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
+/** 从该轮工具调用中提取智能体写入的工作区文件（去重、按出现顺序）。 */
+export declare function collectDeliveredFiles(toolCalls: ToolCallInfo[], sessionId: string): Array<{
+    relPath: string;
+    name: string;
+}>;
+export declare function DeliveryCard({ path, name, sessionId, description, displayName, compact, onOpen, onDownloadStarted, onDownloadSucceeded, }: {
+    /** 文件路径：工作目录下的相对路径，或容器内的绝对路径。 */
+    path: string;
+    name: string;
+    sessionId: string;
+    /** 副标题；不传时按扩展名显示「Markdown · AI 生成」这类默认说明。 */
+    description?: string;
+    /** 卡片可读名称；下载文件名仍使用 name。 */
+    displayName?: string;
+    /** 会话总结使用正文 MEDIA 卡片的紧凑样式。 */
+    compact?: boolean;
+    onOpen?: () => void;
+    onDownloadStarted?: () => void;
+    onDownloadSucceeded?: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+/** 文件交付卡片组（需求 10）：助手在本轮写入的工作区文件，以卡片形式内联展示。 */
+export declare function FileDeliveryCards({ toolCalls, sessionId, }: {
+    toolCalls: ToolCallInfo[];
+    sessionId: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/FinalArtifactCards.d.ts

@@ -0,0 +1,8 @@
+import type { FinalArtifact } from "@blade-hq/agent-client/internal";
+/** 会话小结里的产物卡片：本轮交付的文件和网址，点击直接打开。 */
+export declare function FinalArtifactCards({ artifacts, sessionId, assistantEntryId, }: {
+    artifacts: FinalArtifact[];
+    sessionId: string;
+    /** 所属回复；交互事件（`onFollowupInteraction`）用它指明是哪一轮的成果。 */
+    assistantEntryId: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/ImageLightbox.d.ts

@@ -0,0 +1,11 @@
+interface ImageLightboxProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    images: {
+        src: string;
+        alt: string;
+    }[];
+    initialIndex?: number;
+}
+export declare function ImageLightbox({ open, onOpenChange, images, initialIndex }: ImageLightboxProps): import("react").ReactPortal | null;
+export {};

package/dist/chat/LightComposer.d.ts

@@ -0,0 +1,7 @@
+import type { ComposerProps } from "./customization";
+/**
+ * 轻输入（SDK 与 `<blade-chat>` 的默认输入框）：textarea 和通用插件条目选择，不带富文本编辑、`/` 菜单、
+ * 语音与模型选择。`AgentSession.attach()` / `insertText()`（页面协作、跟进建议、MCP 应用消息）
+ * 都落进这里的文本。
+ */
+export declare function LightComposer({ sessionId, onSend, onStop, isStreaming, isStopping, queueWhileRunning, mergesWithPanelAbove, planPanel, placeholderText, className, innerClassName, maxWidthClassName, initialDraft, initialDraftKey, }: ComposerProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/LiteMessageList.d.ts

@@ -0,0 +1,82 @@
+import { type CitationEntry } from "./lib/citations";
+import type { ChatMessage, ToolCallInfo } from "@blade-hq/agent-client/internal";
+import type { PostChatFollowup } from "@blade-hq/agent-client/internal";
+import type { ResultFeedback as SavedResultFeedback } from "@blade-hq/agent-client/internal";
+import type { AskUserAnswerData } from "./AskUserQuestionBlock";
+type TextRow = {
+    type: "text";
+    key: string;
+    role: "user" | "assistant" | "error";
+    text: string;
+    entryIds: string[];
+    failed?: boolean;
+    /** 本轮（含子智能体循环）真实检索到的引用证据，只有 assistant 文本行才有——
+     * 跟 AssistantTurnBlock.tsx 的 turnToolCalls/citations 同一套算法，不然轻量
+     * 模式下 插件引用的 [n] 角标只能停在纯文本，点不开、也 hover 不出来源。 */
+    citations?: Record<number, CitationEntry>;
+};
+type MemoryRefsRow = {
+    type: "memory-refs";
+    key: string;
+    refs: NonNullable<ChatMessage["memory_refs"]>;
+};
+type FollowupRow = {
+    type: "followup";
+    key: string;
+    followup: PostChatFollowup;
+};
+type HistoricalFeedbackRow = {
+    type: "historical-feedback";
+    key: string;
+    feedback: SavedResultFeedback;
+};
+type QuestionRow = {
+    type: "question";
+    key: string;
+    toolCall: ToolCallInfo;
+    turnBlocks: ChatMessage["blocks"];
+};
+type ToolDescriptionRow = {
+    type: "tool-description";
+    key: string;
+    description: string;
+    running: boolean;
+};
+type ContextGroupRow = {
+    type: "context-group";
+    key: string;
+    contexts: NonNullable<ChatMessage["context"]>[];
+};
+type ContextDividerRow = {
+    type: "context-divider";
+    key: string;
+};
+type LiteRow = {
+    type: "background-wakeup";
+    key: string;
+} | TextRow | MemoryRefsRow | FollowupRow | HistoricalFeedbackRow | QuestionRow | ToolDescriptionRow | ContextGroupRow | ContextDividerRow;
+export declare function buildLiteRows({ messages, followup, sessionMessages, agentLoops, resultFeedbackByEntry, showContexts, }: {
+    messages: ChatMessage[];
+    followup: PostChatFollowup | null;
+    sessionMessages?: ChatMessage[];
+    agentLoops?: Record<string, {
+        toolCallId: string;
+    }>;
+    resultFeedbackByEntry?: ReadonlyMap<string, SavedResultFeedback>;
+    showContexts?: boolean;
+}): LiteRow[];
+export declare function LiteMessageList({ sessionId, messages, followup, isViewer, isLoadingHistory, sessionStatus, isStreaming, resultFeedbackByEntry, onResultFeedbackSaved, onAnswer, onLoadOlder, historyLoadRevision, }: {
+    sessionId: string;
+    messages: ChatMessage[];
+    followup: PostChatFollowup | null;
+    isViewer: boolean;
+    isLoadingHistory: boolean;
+    sessionStatus?: string;
+    isStreaming?: boolean;
+    resultFeedbackByEntry?: ReadonlyMap<string, SavedResultFeedback>;
+    onResultFeedbackSaved?: (feedback: SavedResultFeedback) => void;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+    onLoadOlder?: (beforeCommit?: () => void) => Promise<boolean>;
+    historyLoadRevision?: number;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/MessageActions.d.ts

@@ -0,0 +1,6 @@
+interface Props {
+    content: string;
+    className?: string;
+}
+export declare function MessageActions({ content, className }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/MessageContextPills.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedTextContext } from "@blade-hq/agent-client/internal";
+interface MessageContextPillsProps {
+    contexts: ParsedTextContext[];
+}
+export declare function MessageContextPills({ contexts }: MessageContextPillsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/chat/MessageFileAttachmentList.d.ts

@@ -0,0 +1,13 @@
+import type { FileContentPart } from "@blade-hq/agent-client/internal";
+interface MessageFileAttachmentListProps {
+    files: FileContentPart[];
+    className?: string;
+    /**
+     * R6：点击 pill 时的预览回调。不传时 pill 保持纯展示（向后兼容，Home /
+     * ChatDev 等复用点零改动）。调用方自己决定 URL 来源 + 渲染什么（lightbox /
+     * FilePreviewDialog / 下载等）。
+     */
+    onPreview?: (file: FileContentPart) => void;
+}
+export declare function MessageFileAttachmentList({ files, className, onPreview, }: MessageFileAttachmentListProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/chat/MessageList.d.ts

@@ -0,0 +1,55 @@
+import { type ReactNode } from "react";
+import type { ChatMessage } from "@blade-hq/agent-client/internal";
+import type { PostChatFollowup } from "@blade-hq/agent-client/internal";
+import type { ResultFeedback } from "@blade-hq/agent-client/internal";
+import type { AskUserAnswerData } from "./AskUserQuestionBlock";
+import type { ChatViewCustomization } from "./customization";
+export { shouldAppendPendingAssistantTurn } from "./message-list-blocks";
+export declare function isReasoningRevealingForMessage(message: ChatMessage | undefined, isRevealing: boolean, isStopping?: boolean): boolean;
+export interface MessageListProps {
+    sessionId: string;
+    messages: ChatMessage[];
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+    sessionStatus?: string;
+    onConfirmPlan?: (action: "execute" | "revise", text?: string) => void;
+    customization?: ChatViewCustomization;
+    scrollToStartKey?: string | null;
+    scrollToEntryKey?: string | null;
+    postChatFollowup?: PostChatFollowup | null;
+    resultFeedbackByEntry?: ReadonlyMap<string, ResultFeedback>;
+    onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
+    isViewer?: boolean;
+    /** 历史消息还在加载中（大会话要等几秒）。 */
+    isLoadingHistory?: boolean;
+    onLoadOlder?: (beforeCommit?: () => void) => Promise<boolean>;
+    historyLoadRevision?: number;
+    /** 外部改写 timeline（rewind / checkout / 修复重载）的次数：导航目录据此作废。 */
+    historyRewriteRevision?: number;
+    /**
+     * 用户点了停止（还没等服务端确认）——打字机式显示节流要在这一刻立刻整段
+     * 显示已到达内容，不能等 chat:stop 的服务端回包才响应。跟 sessionIsStreaming
+     * 翻转成 false 不是一回事：那个信号来得晚，点击到服务端确认之间有一段
+     * 网络往返，这段时间里节流动画不该继续播。
+     */
+    isStopping?: boolean;
+    /**
+     * 打字机式显示节流是否还没追平目标全文——调用方需要跟 isStreaming 做
+     * `||` 判断输入框"运行中"状态，否则输入框会先于文字播完就翻回可输入。
+     */
+    onRevealingChange?: (revealing: boolean) => void;
+    /**
+     * 是否正在回放（演示 / 彩排）而非真正的实时直播——回放期间即使内容在
+     * 增长也不进入打字机式节流，直接整段显示：这是"流式与历史必须产生相同
+     * 结果"这条硬规则的一部分，节流只在真正的实时直播里生效。
+     */
+    isReplay?: boolean;
+    /** 无消息时的空状态；不传时用默认的「开始对话」。 */
+    emptyState?: ReactNode;
+    /** 是否正在生成；不传时读会话状态（纯 LLM 模式没有会话，由调用方给）。 */
+    isStreaming?: boolean;
+}
+/**
+ * 消息列表。单独使用时（方案布局、开发调试页）没有聊天面板提供的「当前会话」，这里按传入的
+ * 会话补上，用户消息里的附件预览、工具卡的文件入口据此找到会话文件。
+ */
+export declare function MessageList(props: MessageListProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat/PostChatFollowupBlock.d.ts

@@ -0,0 +1,11 @@
+import type { ResultFeedback as SavedResultFeedback } from "@blade-hq/agent-client/internal";
+import type { PostChatFollowup } from "@blade-hq/agent-client/internal";
+interface Props {
+    sessionId: string;
+    followup: PostChatFollowup | null;
+    isViewer: boolean;
+    savedFeedback?: SavedResultFeedback;
+    onFeedbackSaved?: (feedback: SavedResultFeedback) => void;
+}
+export declare function PostChatFollowupBlock({ sessionId, followup, isViewer, savedFeedback, onFeedbackSaved, }: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/{components → chat}/RenderErrorBoundary.d.ts

@@ -9,7 +9,6 @@ interface State {
     componentStack: string;
     error: Error | null;
 }
-/** 消息级渲染错误边界：单条消息渲染崩溃时降级为提示卡片，不拖垮整个列表。 */
 export declare class RenderErrorBoundary extends Component<Props, State> {
     state: State;
     static getDerivedStateFromError(error: Error): State;

package/dist/chat/ResultFeedback.d.ts

@@ -0,0 +1,11 @@
+import type { PostChatFollowup, ResultFeedback as SavedResultFeedback } from "@blade-hq/agent-client/internal";
+export declare function HistoricalResultFeedback({ feedback }: {
+    feedback: SavedResultFeedback;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function ResultFeedback({ sessionId, followup, isViewer, savedFeedback, onSaved, }: {
+    sessionId: string;
+    followup: PostChatFollowup;
+    isViewer: boolean;
+    savedFeedback?: SavedResultFeedback;
+    onSaved?: (feedback: SavedResultFeedback) => void;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/SessionReplayBar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 回放会话的状态条：说明"现在是在重现之前的对话"，并给出倍速和退出。
+ *
+ * 没有它的话，带方案的回放会话（软件工厂、Solution 会话）看起来和普通对话一模一样——
+ * 既不知道自己在回放，也退不出来。只读身份也显示（控件禁用）。
+ */
+export declare function SessionReplayBar({ sessionId, className, onExit, }: {
+    sessionId: string;
+    className?: string;
+    /** 宿主自己接管了「输入对不上录制内容」的处理时传入：退出要先了结那次待定的决定。 */
+    onExit?: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/chat/TextAttachmentPills.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedTextAttachment } from "@blade-hq/agent-client/internal";
+interface TextAttachmentPillsProps {
+    attachments: ParsedTextAttachment[];
+    /**
+     * R6：点击 pill 时的预览回调。不传时保持纯展示（向后兼容）。
+     */
+    onPreview?: (attachment: ParsedTextAttachment) => void;
+}
+export declare function TextAttachmentPills({ attachments, onPreview }: TextAttachmentPillsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/chat/ToolCallBlock.d.ts

@@ -0,0 +1,48 @@
+import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
+import type { ContentBlock } from "@blade-hq/agent-client/internal";
+import { type AskUserAnswerData } from "./AskUserQuestionBlock";
+import type { ChatViewCustomization } from "./customization";
+export declare function getFilePreviewName(filePath: string): string;
+export declare function ToolFilePreviewAction({ toolCall, sessionId, className, }: {
+    toolCall: ToolCallInfo;
+    sessionId?: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;
+interface Props {
+    toolCall: ToolCallInfo;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+    answered?: boolean;
+    answerData?: AskUserAnswerData;
+    sessionId?: string;
+    sessionStatus?: string;
+    isActiveQuestion?: boolean;
+    level?: 1 | 2;
+    turnBlocks?: ContentBlock[];
+    reasoning?: string;
+    customization?: ChatViewCustomization;
+}
+export declare function ToolPreviewAction({ toolCall, sessionId: providedSessionId, turnBlocks, className, }: {
+    toolCall: ToolCallInfo;
+    sessionId?: string;
+    turnBlocks?: ContentBlock[];
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * 只认工具状态。改这里必须同步 packages/agent-react/src/components/ToolCallBlock.tsx
+ * 的同名函数，否则同一份会话在内置页面能点、在 SDK 里点不动。
+ *
+ * 不要再拿 sessionStatus 兜底。历史投影算错时用 waiting_for_input 补救，
+ * 会同时把已经回答过的旧提问重新变成可作答（历史加载不会带回 answerData），
+ * 而且会盖住投影层的错误——PR #1597 的 bug 就是这么藏住的。
+ */
+export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, fallbackAwaiting, }: {
+    toolStatus: ToolCallInfo["status"];
+    hasAnswerData: boolean;
+    fallbackAnswered?: boolean;
+    fallbackAwaiting?: boolean;
+}): {
+    awaitingAnswer: boolean;
+    answered: boolean;
+};
+export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionId: providedSessionId, sessionStatus, isActiveQuestion, level, turnBlocks, reasoning, customization, }: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/chat/ToolUiCard.d.ts

@@ -0,0 +1,6 @@
+import type { ToolUiCard as ToolUiCardData } from "@blade-hq/agent-client/internal";
+/** 消息里的 tool_ui 卡片：宿主注入了渲染器就用宿主的（内置 Web 的资源桥接），否则用 SDK 的。 */
+export declare function ToolUiCard({ card, sessionId }: {
+    card: ToolUiCardData;
+    sessionId: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/chat/TurnNavRail.d.ts

@@ -0,0 +1,17 @@
+export interface TurnNavItem {
+    id: string;
+    title: string;
+}
+interface TurnNavRailProps {
+    items: TurnNavItem[];
+    activeTurnId: string | null;
+    onSelectTurn: (turnId: string) => void;
+    /** 正在请求定位的目标；null / 不传表示没有在途定位（开发者列表不传）。 */
+    loadingTurnId?: string | null;
+    /** 定位失败提示。 */
+    error?: string | null;
+    /** 定位失败的那条发言；重试按钮就再点它一次。 */
+    failedTurnId?: string | null;
+}
+export declare function TurnNavRail({ items, activeTurnId, onSelectTurn, loadingTurnId, error, failedTurnId, }: TurnNavRailProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/chat/UserMessageBubble.d.ts

@@ -0,0 +1,20 @@
+import type { ChatMessage } from "@blade-hq/agent-client/internal";
+export type UserChatMessage = ChatMessage & {
+    role: "user";
+};
+export type ErrorChatMessage = ChatMessage & {
+    role: "error";
+};
+export declare function isUserMessage(message: ChatMessage): message is UserChatMessage;
+export declare function isErrorMessage(message: ChatMessage): message is ErrorChatMessage;
+interface UserMessageProps {
+    message: UserChatMessage;
+    className?: string;
+}
+export declare const USER_MESSAGE_MARKDOWN_CLASS = "prose prose-invert chat-prose max-w-none [&_li>p]:inline [&_li>p]:whitespace-pre-wrap [&_p]:whitespace-pre-wrap";
+export declare function UserMessageBubble({ message, className }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
+export declare function ErrorMessageBlock({ message, className, }: {
+    message: ErrorChatMessage;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/WorkflowRunBlock.d.ts

@@ -0,0 +1,29 @@
+import type { WorkflowRunEntry } from "@blade-hq/agent-client";
+import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
+interface Props {
+    /** 触发这次运行的 workflow:run 工具调用。 */
+    toolCall: ToolCallInfo;
+    sessionId: string;
+}
+type StepGroup = {
+    key: string;
+    desc: string;
+    stepId: string;
+    stepKind: string;
+    /** 落史的终态(刷新重建时有);实时运行中没有,由运行状态推断。 */
+    status?: string;
+    logs: string[];
+};
+/** 事件流 → 步骤分组:每个 step 事件开一张卡。log 行带所属步骤 id 时归到那一步
+ * (并行分支的输出不按宣告顺序到达,按位置归会挂错卡);旧记录没有 id 才归到上一步。 */
+export declare function groupWorkflowEntries(entries: readonly WorkflowRunEntry[]): {
+    prelude: string[];
+    groups: StepGroup[];
+};
+/**
+ * 「固定流程」块:一次 workflow:run(跑某个技能的 flows/*.yaml)的执行呈现——每个步骤
+ * 一张卡顺序铺开(agent 步骤=完整子智能体卡,命令/条件步骤=描述+输出的小卡),头部可整体折叠。
+ * 渲染在触发它的回合的「执行过程」折叠区里,和普通技能的工具调用同一个位置。
+ */
+export declare function WorkflowRunBlock({ toolCall, sessionId }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/ai-elements/reasoning.d.ts

@@ -0,0 +1,32 @@
+import type * as CollapsiblePrimitive from "@radix-ui/react-collapsible";
+import type { ComponentProps } from "react";
+interface ReasoningContextValue {
+    isStreaming: boolean;
+    isOpen: boolean;
+    setIsOpen: (open: boolean) => void;
+    duration: number | undefined;
+}
+export declare const useReasoning: () => ReasoningContextValue;
+export type ReasoningProps = ComponentProps<typeof CollapsiblePrimitive.Root> & {
+    isStreaming?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    duration?: number;
+};
+export declare const Reasoning: import("react").MemoExoticComponent<({ className, isStreaming, open, defaultOpen, onOpenChange, duration: durationProp, children, ...props }: ReasoningProps) => import("react/jsx-runtime").JSX.Element>;
+export type ReasoningTriggerProps = ComponentProps<typeof CollapsiblePrimitive.Trigger> & {
+    wordCount: number;
+};
+export declare const ReasoningTrigger: import("react").MemoExoticComponent<({ className, children, wordCount, ...props }: ReasoningTriggerProps) => import("react/jsx-runtime").JSX.Element>;
+export type ReasoningContentProps = ComponentProps<typeof CollapsiblePrimitive.Content> & {
+    children: string;
+};
+export declare const ReasoningContent: import("react").MemoExoticComponent<({ className, children, ...props }: ReasoningContentProps) => import("react/jsx-runtime").JSX.Element>;
+export type ThinkingBadgeProps = {
+    reasoning: string;
+    variant?: "inline" | "block";
+    onClick?: ComponentProps<"button">["onClick"];
+};
+export declare function ThinkingBadge({ reasoning, variant, onClick }: ThinkingBadgeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/chat/ai-elements/shimmer.d.ts

@@ -0,0 +1,15 @@
+import type { ElementType } from "react";
+export interface TextShimmerProps {
+    children: string;
+    as?: ElementType;
+    className?: string;
+    duration?: number;
+    spread?: number;
+}
+/**
+ * 流式等待时的扫光文字。动画是纯 CSS（`blade-shimmer-sweep`，定义在 chat.css），
+ * 不引入动画库。
+ */
+declare const ShimmerComponent: ({ children, as: Component, className, duration, spread, }: TextShimmerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Shimmer: import("react").MemoExoticComponent<typeof ShimmerComponent>;
+export {};