@blade-hq/agent-react 2610.0.1-alpha.1 → 2610.0.2

package/dist/components/ChatInput.d.ts

@@ -6,13 +6,33 @@ interface Props {
     onStop: () => void;
     isStreaming: boolean;
     isStopping?: boolean;
+    /**
+     * 宿主是否渲染了队列面板。没有面板时不给"运行中提交"入口：消息进了队列却看不见，
+     * 比明确提示用户等一等更糟。ChatSurface 按 queuePanel 是否存在传入。
+     */
+    queueWhileRunning?: boolean;
+    /**
+     * 上方紧贴着一个比自己窄的面板（队列面板）时置 true：上两角改直角。
+     *
+     * 面板比输入框窄一圈，输入框上角留圆弧的话，那两段弧会从面板两侧露出来，
+     * 看着就是两个尖角。跟内置 Web 的 ChatInput 是同一个判据。
+     */
+    mergesWithPanelAbove?: boolean;
     placeholder?: string;
     className?: string;
+    /** 输入框卡片（`.blade-chat-input-inner`）：边框、圆角、底色在这里。 */
+    innerClassName?: string;
+    /** 文本输入框（`.blade-chat-textarea`）。 */
+    textareaClassName?: string;
+    /** 右侧按钮组（`.blade-chat-input-toolbar`）。 */
+    toolbarClassName?: string;
+    queueKey?: string;
+    hasAttachments?: boolean;
 }
 /**
  * 轻量聊天输入框：textarea（Enter 发送 / Shift+Enter 换行）+ 发送/停止按钮。
  * 不含第一方版本的富文本编辑、@ 补全、技能菜单、语音输入与模型选择。
  * 内容受控，session.attach() / insertText() 通过 ChatView 注入到这里。
  */
-export declare function ChatInput({ value, onValueChange, onSend, onStop, isStreaming, isStopping, placeholder, className, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ChatInput({ value, onValueChange, onSend, onStop, isStreaming, isStopping, queueWhileRunning, mergesWithPanelAbove, placeholder, className, innerClassName, textareaClassName, toolbarClassName, queueKey, hasAttachments, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatSurface.d.ts

@@ -1,15 +1,119 @@
-import type { AskUserAnswerData, ChatMessage, ConnectionStatus } from "@blade-hq/agent-client";
-import type { ReactNode } from "react";
+import type { AskUserAnswerData, ChatMessage, ConnectionStatus, PostChatFollowup } from "@blade-hq/agent-client";
+import { type ReactNode } from "react";
+import type { TurnNavigationSource } from "../hooks/use-turn-navigation";
 import type { ToolCallRenderer } from "./ToolCallBlock";
+import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
+import type { ResultFeedback } from "@blade-hq/agent-client";
+import { type PlanUpdateData } from "./PlanUpdateBlock";
+import type { AskUserQuestionData } from "./AskUserQuestionBlock";
+/**
+ * 每个可见区块的 className 落点，键名与元素上的 `blade-chat-*` 语义锚点一一对应。
+ *
+ * 传进来的类会与 SDK 自己的类一起经过 `cn`（clsx + tailwind-merge），放在
+ * 最后一个参数，因此 `classNames={{ chatInput: "p-0" }}` 能盖掉组件内部的 `p-4`，
+ * 不依赖 CSS 输出顺序、也不需要 `!important`。锚点本身不带视觉规则（清单见
+ * README「样式定制」与 src/style.css 顶部），用普通 CSS 选它们同样稳定生效。
+ */
 export interface ChatViewClassNames {
+    /** 聊天根容器（`.blade-chat`）。 */
     root?: string;
+    /** 连接状态提示条（`.blade-chat-banner`）。 */
     banner?: string;
+    /** 顶部出错条（`.blade-chat-error-bar`）。 */
+    errorBar?: string;
+    /** 消息区（`.blade-chat-messages`）。 */
     messageList?: string;
+    /** 消息区滚动内容（`.blade-chat-messages-scroll`）：内边距在这里。 */
+    messagesScroll?: string;
+    /** 消息内容列（`.blade-chat-messages-content`）：居中与最大宽度在这里。 */
+    messagesContent?: string;
+    /** 无消息时的空状态（`.blade-chat-empty`）。 */
+    empty?: string;
+    /** 「滚动到底部」按钮（`.blade-chat-scroll-bottom`）。 */
+    scrollToBottom?: string;
+    /** 用户消息行（`.blade-chat-user-row`）。 */
+    userMessage?: string;
+    /** 用户气泡（`.blade-chat-user-bubble`）。 */
+    userBubble?: string;
+    /** 消息里的文件附件卡（`.blade-chat-file-card`）。 */
+    fileCard?: string;
+    /** 消息流里的出错块（`.blade-chat-error-row`）。 */
+    errorMessage?: string;
+    /** 一轮助手回复（`.blade-chat-assistant-turn`）。 */
+    assistantTurn?: string;
+    /** 思考过程（`.blade-chat-thinking`）。 */
+    thinking?: string;
+    /** 助手正文（`.blade-chat-assistant-text`）。 */
+    assistantText?: string;
+    /** 记忆引用（`.blade-chat-memory-refs`）。 */
+    memoryRefs?: string;
+    /** 执行过程里的工具行（`.blade-chat-tool-row`）：智能体模式下工具调用都走这条路径。 */
+    toolRow?: string;
+    /** 子智能体行（`.blade-chat-agent-loop`）。 */
+    agentLoop?: string;
+    /** 提问卡（`.blade-chat-ask-card`）。 */
+    askCard?: string;
+    /** 提问卡的每个选项（`.blade-chat-ask-option`）。 */
+    askOption?: string;
+    /** 计划面板（`.blade-chat-plan`）。 */
+    planPanel?: string;
+    /** 会话队列面板（`.blade-chat-queue`）。 */
+    queuePanel?: string;
+    /** 本轮小结与跟进区（`.blade-chat-followup`）。 */
+    followup?: string;
+    /** 跟进建议按钮（`.blade-chat-followup-action`）。 */
+    followupAction?: string;
+    /** 输入区外层（`.blade-chat-input`）。 */
     chatInput?: string;
+    /** 输入框卡片（`.blade-chat-input-inner`）：边框、圆角、底色在这里。 */
+    inputInner?: string;
+    /** 文本输入框（`.blade-chat-textarea`）。 */
+    textarea?: string;
+    /** 输入框右侧按钮组（`.blade-chat-input-toolbar`）。 */
+    inputToolbar?: string;
+}
+/** 用户消息渲染器：`message` 是投影层给出的用户消息。 */
+export interface UserMessageRendererProps {
+    message: ChatMessage;
 }
+/** 助手正文渲染器：`compact` 为真时正文在执行过程里，字号更小。 */
+export interface AssistantTextRendererProps {
+    message: ChatMessage;
+    streaming: boolean;
+    compact: boolean;
+    sessionId?: string;
+}
+/** 提问卡渲染器：字段与 `AskUserQuestionBlock` 的 props 一致。 */
+export interface AskUserQuestionRendererProps {
+    data: AskUserQuestionData;
+    answered: boolean;
+    toolCallId: string;
+    sessionStatus: string;
+    answerData?: AskUserAnswerData;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+}
+/** 计划面板渲染器：`plan` 是最近一次成功的 update_plan 解析结果。 */
+export interface PlanUpdateRendererProps {
+    plan: PlanUpdateData;
+    running: boolean;
+    sessionId?: string;
+}
+/**
+ * 区块级渲染器：每个都返回 `ReactNode`，返回 `null` 走 SDK 默认渲染。
+ *
+ * 与 `toolCall` 的老签名一致：参数是一个描述该区块的对象，而不是裸数据。
+ */
 export interface ChatViewRenderers {
     /** 自定义工具调用渲染；返回 null 走默认渲染。 */
     toolCall?: ToolCallRenderer;
+    /** 自定义用户消息渲染；返回 null 走默认渲染。 */
+    userMessage?: (props: UserMessageRendererProps) => ReactNode | null;
+    /** 自定义助手正文渲染；返回 null 走默认渲染。 */
+    assistantText?: (props: AssistantTextRendererProps) => ReactNode | null;
+    /** 自定义提问卡渲染；返回 null 走默认渲染。 */
+    askUserQuestion?: (props: AskUserQuestionRendererProps) => ReactNode | null;
+    /** 自定义计划面板渲染；返回 null 走默认渲染。 */
+    planUpdate?: (props: PlanUpdateRendererProps) => ReactNode | null;
 }
 export interface ChatViewSlots {
     /** 消息列表上方的自定义区域。 */
@@ -31,23 +135,59 @@ export interface ChatPresentationProps {
 /** 主题落到聊天根节点上：深色变量挂在 [data-theme="dark"] 上，由它继承给整棵子树。 */
 export declare function themeAttr(theme: ChatPresentationProps["theme"]): "dark" | undefined;
 interface ChatSurfaceProps extends ChatPresentationProps {
+    /** follow-up、成果和评分交互；SDK 不绑定任何分析厂商。 */
+    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
     connection: ConnectionStatus;
     errorMessage: string | null;
     messages: ChatMessage[];
+    postChatFollowup?: PostChatFollowup | null;
     isStreaming: boolean;
     isStopping: boolean;
     inputText: string;
     onInputChange: (value: string) => void;
+    onSuggestion?: (value: string) => void;
     onSend: (text: string) => Promise<boolean>;
     onStop: () => void;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     sessionId?: string;
+    isViewer?: boolean;
+    resultFeedbackByEntry?: ReadonlyMap<string, ResultFeedback>;
+    onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
     /** 输入框上方的内部区域（纯 LLM 模式的高级设置用）。不传时不渲染任何节点。 */
     beforeInput?: ReactNode;
+    /** 输入框上方的会话队列面板（智能体模式用）。不传时不渲染任何节点。 */
+    queuePanel?: ReactNode;
+    /**
+     * 队列面板此刻是否真的占位（由面板的 `onVisibleChange` 上报）。
+     *
+     * 不能用 `queuePanel != null` 代替：面板有本地编辑态（编辑到一半、那条等待
+     * 消息被服务端拿走时仍留在原地保住草稿），这时它显示但 snapshot 里没有条目，
+     * 光看节点是否存在判不出来，输入框上两角就会在面板还开着的时候恢复成圆角。
+     */
+    queuePanelVisible?: boolean;
+    /** 仅 Agent 模式启用 Blade 的 update_plan 面板。 */
+    showPlanUpdates?: boolean;
+    /** 仅实时成功的 update_plan 递增；历史 hydration 不得改变。 */
+    planRevealRevision?: number;
+    historyPaging?: {
+        hasOlder: boolean;
+        loading: boolean;
+        /** Resolves true only when the paging cursor advanced. */
+        loadOlder: (beforeCommit?: () => void) => Promise<boolean>;
+    };
+    /** 消息导航的数据源（目录 + 定位）；不传就没有导航轨道。 */
+    turnNavigation?: TurnNavigationSource;
     /** 连接状态条下方的横幅（回放模式条用）。不传时不渲染任何节点。 */
     banner?: ReactNode;
+    /**
+     * 打字机式显示节流是否还没追平目标全文——调用方需要跟 isStreaming 做
+     * `||` 判断输入框"运行中"状态。
+     */
+    onRevealingChange?: (revealing: boolean) => void;
+    /** 是否正在回放（演示 / 彩排）而非真正的实时直播——透传给 MessageList。 */
+    isReplay?: boolean;
 }
 /**
  * 消息流 + 输入框：智能体模式与纯 LLM 模式共用同一套外观，差别只在谁喂数据。
@@ -55,5 +195,5 @@ interface ChatSurfaceProps extends ChatPresentationProps {
  * 这里的 DOM 结构受 tests/chat-view-compat.test.tsx 的快照保护——接入方拿
  * .blade-chat-* 类名写了自己的样式，结构一动他们的页面就歪。
  */
-export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, isStreaming, isStopping, inputText, onInputChange, onSend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, beforeInput, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, queuePanel, queuePanelVisible, showPlanUpdates, planRevealRevision, historyPaging, turnNavigation, banner, onRevealingChange, isReplay, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatView.d.ts

@@ -2,7 +2,8 @@ import { type AgentChatProps } from "./AgentChat";
 import { type LlmChatHandle } from "./LlmChat";
 import type { LlmAdvancedSettings, LlmOverride } from "./LlmAdvancedSettings";
 import type { LlmChatOptions } from "../hooks/use-llm-chat";
-export type { ChatViewClassNames, ChatViewRenderers, ChatViewSlots, } from "./ChatSurface";
+export type { AssistantTextRendererProps, AskUserQuestionRendererProps, ChatViewClassNames, ChatViewRenderers, ChatViewSlots, PlanUpdateRendererProps, UserMessageRendererProps, } from "./ChatSurface";
+export type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 export interface ChatViewProps extends AgentChatProps {
     /** 挂哪个下层组件。默认 `agent`——不传就是接 Blade 智能体会话的原有行为。 */
     mode?: "agent" | "llm";

package/dist/components/ConnectionBanner.d.ts

@@ -3,6 +3,6 @@ interface Props {
     connection: ConnectionStatus;
     className?: string;
 }
-/** 连接状态提示条：数据来自 SessionState.connection，正常连接时不渲染。 */
+/** 连接状态提示条：短暂断线静默，超过容错时间后再逐级提示。 */
 export declare function ConnectionBanner({ connection, className }: Props): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/ConnectorPanel.d.ts

@@ -0,0 +1,41 @@
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+import { type ReactNode } from "react";
+import { type PluginConnectorItem } from "./plugin-connector";
+import { type PluginConnectorSelection } from "./connector-panel-types";
+export interface ConnectorPanelProps {
+    client: BladeClient;
+    /**
+     * `null` 表示首页：插件开关只记下本次输入的待选，不激活任何东西、不建会话、
+     * 不启动沙盒或 MCP。待选项随首条消息一起交给宿主处理。
+     */
+    sessionId: string | null;
+    /** 首页待选插件；`sessionId` 为 null 时使用。 */
+    pendingPlugins?: PluginConnectorSelection[];
+    onPendingPluginsChange?: (next: PluginConnectorSelection[]) => void;
+    /** 首页候选开关不可用时的说明（例如软件工厂模式会先建项目再启动）。 */
+    pendingDisabledReason?: string | null;
+    /** 会话内插件启用/停用结果；宿主据此刷新技能统计。 */
+    onPluginsChanged?: (plugin: SessionPluginActivation) => void;
+    /**
+     * 当前已选（首页待选 / 会话内已启用）的插件，按行原样报给宿主。
+     *
+     * 触发器要在不打开面板时就能显示「选了哪几个、几个」，它自己拿不到这份状态，
+     * 所以由面板单向汇报；面板未挂载时宿主保留上一次的结果。
+     */
+    onSelectedChange?: (items: PluginConnectorItem[]) => void;
+    /** 宿主注入：电脑分区。参数是搜索词，宿主自己决定怎么过滤。 */
+    renderComputerSection?: (query: string) => ReactNode;
+    /** 宿主注入：外部账号分区（飞书 / GitHub 等固定连接入口）。 */
+    renderExternalAccounts?: (query: string) => ReactNode;
+    /** 宿主注入：底部操作区；不注入就不渲染这一块。 */
+    renderFooterActions?: () => ReactNode;
+    className?: string;
+}
+/**
+ * 统一连接器面板：顶部搜索、按「电脑 / 插件 / 外部账号」分区、底部添加与管理。
+ *
+ * 插件分区是这一层唯一的共享实现：首页和会话用同一个列表、同一套启用判定，
+ * 判定不各写一份。电脑与外部账号由宿主注入——那些入口需要宿主的路由与 CLI
+ * 引导，SDK 不硬编码内部路径，也不替第三方决定跳到哪里。
+ */
+export declare function ConnectorPanel({ client, sessionId, pendingPlugins, onPendingPluginsChange, pendingDisabledReason, onPluginsChanged, onSelectedChange, renderComputerSection, renderExternalAccounts, renderFooterActions, className, }: ConnectorPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ContextCard.d.ts

@@ -0,0 +1,20 @@
+import { type ContextProjectionData } from "@blade-hq/agent-client";
+export interface ContextCardProps {
+    context: ContextProjectionData;
+    className?: string;
+}
+/** Business-facing Context summary. Native details keeps every card collapsed by default. */
+export declare function ContextCard({ context, className }: ContextCardProps): import("react/jsx-runtime").JSX.Element;
+export interface ContextGroupCardProps {
+    contexts: readonly ContextProjectionData[];
+    className?: string;
+}
+/**
+ * 一批上下文注入折叠成一行。会话首轮会一次注入十几个原子，一条一张卡片会把
+ * 真正的对话挤出屏幕。
+ *
+ * 单条和多条**共用同一个 details 外壳**，不在数量变化时切换组件：流式时第二条
+ * 到达会让这一行从单条变成多条，组件类型一换 React 就重挂 <details>，
+ * 用户刚展开的行会被收起来。同理，key 由调用方按组内第一条给，不能带数量。
+ */
+export declare function ContextGroupCard({ contexts, className }: ContextGroupCardProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/MarkdownContent.d.ts

@@ -1,16 +1,30 @@
+import { type ComponentPropsWithRef } from "react";
+/** 内置 Web（`apps/web/src/agent/components/markdown/MarkdownContent.tsx`）
+ * 有一份同名同签名的实现，两处共用同一套"跳过代码区间"的判定逻辑，改动
+ * 时要一起确认。这里作为 SDK 侧的规范实现导出，内置 Web 直接复用，不要
+ * 各写一份（对齐 CLAUDE.md"判定逻辑不许各写一份"）。 */
+export declare function stripSystemReminders(text: string): string;
+/** Keep inline formatting markers from being consumed by URL autolinking. */
+export declare function normalizeAdjacentUrlFormatting(value: string): string;
+type AnchorProps = ComponentPropsWithRef<"a">;
+/** 链接一律新窗口打开并断开 opener，SDK 不接管站内跳转。
+ * 页内锚点（脚注引用/回链这类 `href="#fn-note"`）不能套"新窗口打开"这套
+ * 逻辑——新开一个标签页访问 `#片段` 只是把整篇文档重新打开一次，不是
+ * 滚动到页内位置，会破坏脚注的跳转体验。只有真正的外部链接才需要新窗口
+ * + 断开 opener。导出给内置 Web 直接复用——两处原来各写了一份完全相同的
+ * 判定逻辑，对齐 CLAUDE.md"判定逻辑不允许两处各写一份"。 */
+export declare function ExternalAnchor({ children, href, ...props }: AnchorProps): import("react/jsx-runtime").JSX.Element;
 export interface MarkdownContentProps {
     children: string;
     className?: string;
     /** 流式渲染传 "streaming"，历史静态内容默认 "static"。 */
     mode?: "streaming" | "static";
-    /**
-     * 会话 id。传了才会把 `MEDIA:` 行折叠成文件下载卡片——下载要用它。
-     * 不要给用户消息传：用户自己在输入框打一行 `MEDIA:` 不该被当成平台产物。
-     */
+    /** 会话 id；保留给聊天组件统一透传上下文。 */
     sessionId?: string;
 }
 /**
- * SDK 版 Markdown 渲染：附带代码块复制按钮、智能体产出文件的下载卡片；
- * 相比第一方版本去掉了 mermaid、外链确认弹窗与文件预览。
+ * SDK 版 Markdown 渲染：附带代码块复制按钮；相比第一方版本去掉了
+ * mermaid、外链确认弹窗与文件预览。
  */
 export declare function MarkdownContent({ children, className, mode, sessionId }: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/McpAppCard.d.ts

@@ -0,0 +1,14 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+export interface McpAppMessage {
+    sessionId: string;
+    sourceId: string;
+    label: string;
+    content: string;
+}
+export declare const McpAppMessageContext: import("react").Context<((message: McpAppMessage) => void) | null>;
+export declare function McpAppCard({ sessionId, sourceId, client: suppliedClient, onMessage: suppliedOnMessage }: {
+    sessionId: string;
+    sourceId: string;
+    client?: BladeClient;
+    onMessage?: (message: McpAppMessage) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/MessageImage.d.ts

@@ -0,0 +1,9 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+import { type ImgHTMLAttributes } from "react";
+export interface MessageImageProps extends ImgHTMLAttributes<HTMLImageElement> {
+    client?: BladeClient | null;
+    /** Load the original only when explicitly requested, such as a lightbox. */
+    original?: boolean;
+}
+/** Shared image transport for live messages, history, tool results and lightboxes. */
+export declare const MessageImage: import("react").ForwardRefExoticComponent<MessageImageProps & import("react").RefAttributes<HTMLImageElement>>;

package/dist/components/MessageList.d.ts

@@ -1,21 +1,62 @@
-import type { AskUserAnswerData, ChatMessage } from "@blade-hq/agent-client";
+import type { AskUserAnswerData, ChatMessage, PostChatFollowup, ResultFeedback } from "@blade-hq/agent-client";
 import { type ReactNode } from "react";
-import type { ToolCallRenderer } from "./ToolCallBlock";
+import { type TurnNavigationSource } from "../hooks/use-turn-navigation";
+import { type FollowupInteractionEvent } from "./PostChatFollowupBlock";
+import type { ChatViewClassNames, ChatViewRenderers } from "./ChatSurface";
 interface Props {
     messages: ChatMessage[];
+    postChatFollowup?: PostChatFollowup | null;
+    onSuggestion?: (value: string) => void;
     isStreaming: boolean;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
-    toolCallRenderer?: ToolCallRenderer;
+    hidePlanUpdateTools?: boolean;
+    /** 无消息时替换默认空状态。 */
     emptyState?: ReactNode;
-    className?: string;
-    /** 传给助手消息的 Markdown 渲染，用于把 MEDIA 行折叠成文件下载卡片。 */
+    /** 各可见区块的 className 落点；键与元素上的 `blade-chat-*` 锚点一一对应。 */
+    classNames?: ChatViewClassNames;
+    /** 区块级渲染器；返回 null 走默认渲染。 */
+    renderers?: ChatViewRenderers;
+    /** 会话 id；传给助手消息的统一上下文。 */
     sessionId?: string;
+    isViewer?: boolean;
+    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
+    resultFeedbackByEntry?: ReadonlyMap<string, ResultFeedback>;
+    onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
+    historyPaging?: {
+        hasOlder: boolean;
+        loading: boolean;
+        /** Resolves true only when the paging cursor advanced. */
+        loadOlder: (beforeCommit?: () => void) => Promise<boolean>;
+    };
+    /**
+     * 消息导航的数据源（目录 + 定位）。不传就没有导航轨道，也不会请求目录——
+     * 纯 LLM 会话与自带入口的宿主都属于这种。
+     */
+    turnNavigation?: TurnNavigationSource;
+    /**
+     * 用户点了停止（还没等服务端确认）——打字机式显示节流要在这一刻立刻整段
+     * 显示已到达内容，不能等 chat:stop 的服务端回包才响应。跟 isStreaming
+     * 翻转成 false 不是一回事：那个信号来得晚，点击到服务端确认之间有一段
+     * 网络往返，这段时间里节流动画不该继续播。
+     */
+    isStopping?: boolean;
+    /**
+     * 打字机式显示节流是否还没追平目标全文——调用方需要跟 isStreaming 做
+     * `||` 判断输入框"运行中"状态，否则输入框会先于文字播完就翻回可输入。
+     */
+    onRevealingChange?: (revealing: boolean) => void;
+    /**
+     * 是否正在回放（演示 / 彩排）而非真正的实时直播——回放期间即使内容在
+     * 增长也不进入打字机式节流，直接整段显示：这是"流式与历史必须产生相同
+     * 结果"这条硬规则的一部分，节流只在真正的实时直播里生效。
+     */
+    isReplay?: boolean;
 }
 /**
  * 消息列表：use-stick-to-bottom 自动滚动 + 按轮次分组渲染。
  * 相比第一方版本去掉了轮次导航栏、吸顶状态条与规划摘要卡片。
  */
-export declare function MessageList({ messages, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, emptyState, className, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, postChatFollowup, onSuggestion, isStreaming, sessionStatus, askAnswers, onAnswer, hidePlanUpdateTools, emptyState, classNames, renderers, sessionId, isViewer, onFollowupInteraction, resultFeedbackByEntry, onResultFeedbackSaved, historyPaging, turnNavigation, isStopping, onRevealingChange, isReplay, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/PlanUpdateBlock.d.ts

@@ -0,0 +1,32 @@
+import type { ChatMessage, ToolCallInfo } from "@blade-hq/agent-client";
+export type PlanStepStatus = "pending" | "in_progress" | "completed";
+export interface PlanUpdateData {
+    plan: Array<{
+        step: string;
+        status: PlanStepStatus;
+    }>;
+}
+export declare const PLAN_AUTO_COLLAPSE_MS = 5000;
+export declare function isPlanUpdateTool(toolCall: Pick<ToolCallInfo, "name">): boolean;
+export interface PlanUpdateDisplayState {
+    current: ToolCallInfo | null;
+    updating: boolean;
+}
+export declare function getPlanUpdateDisplayState(messages: ChatMessage[]): PlanUpdateDisplayState;
+export declare function parsePlanUpdate(argumentsJson: string): PlanUpdateData | null;
+export declare function pickCurrentPlanStep(plan: PlanUpdateData["plan"]): PlanUpdateData["plan"][number] | null;
+export declare function PlanUpdateBlock({ toolCall, running, autoReveal, className, }: {
+    toolCall: ToolCallInfo;
+    running?: boolean;
+    /** 实时收到的新进度短暂展开；加载历史时保持默认收起。 */
+    autoReveal?: boolean;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function CurrentPlanPanel({ messages, running, revealRevision, sessionId, className, }: {
+    messages: ChatMessage[];
+    running?: boolean;
+    /** 仅实时成功的 update_plan 递增；历史 hydration 不得改变。 */
+    revealRevision?: number;
+    sessionId?: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/PluginConnectorList.d.ts

@@ -0,0 +1,47 @@
+import type { BladeClient, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { PluginConnectorItem } from "./plugin-connector";
+export interface ConfiguringPlugin {
+    name: string;
+    /**
+     * 这次打开表单是不是「为了启用它」。
+     *
+     * 只有用户在开关上表达了启用意图时才为 true：已经跑起来的插件再保存配置
+     * 不应该顺手重启 / 重新激活（见 SessionPluginSelector 的历史约定）。
+     */
+    pendingActivation: boolean;
+}
+export interface PluginConnectorListProps {
+    client: BladeClient;
+    /** 会话内插件用会话接口取图标；首页候选（null）用账号级目录。 */
+    sessionId: string | null;
+    items: PluginConnectorItem[];
+    /** 正在提交意图的行；开关转圈，但仍然可点（点是取消）。 */
+    inFlight: Record<string, true>;
+    /** 有启用/停用请求在飞，会写服务端的行先锁住次要操作。 */
+    busy: boolean;
+    /** 上一次操作失败，给出重试入口。 */
+    mutationError: boolean;
+    onToggle: (item: PluginConnectorItem, next: boolean) => void;
+    onRetry: (item: PluginConnectorItem) => void;
+    onEditConfig: (item: PluginConnectorItem) => void;
+    configuring: ConfiguringPlugin | null;
+    onConfigSaved: (state: SessionPluginConfigState) => void;
+    onConfigClose: () => void;
+    /** 开关不可用时说明原因，而不是静默禁用。 */
+    disabledReason?: string | null;
+    /**
+     * 列表本身不可用（读取失败 / 搜索无结果）时的说明；有值时不再叠加「还没装插件」，
+     * 否则会把一次故障或一次没搜到说成「你这个账号没装东西」。
+     */
+    unavailableText?: string | null;
+    emptyText: string;
+    /** 首页待选模式：开关的语义是"待选"，不是"已经启用"。 */
+    draft?: boolean;
+}
+/**
+ * 连接器面板里的插件列表。
+ *
+ * 首页与会话共用同一份渲染：开关是开关，候选是候选，行的存在与状态无关——
+ * 没启用、没图标也要显示名称和占位，不隐藏整行。
+ */
+export declare function PluginConnectorList({ client, sessionId, items, inFlight, busy, mutationError, onToggle, onRetry, onEditConfig, configuring, onConfigSaved, onConfigClose, disabledReason, unavailableText, emptyText, draft, }: PluginConnectorListProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/PluginTriggerStack.d.ts

@@ -0,0 +1,22 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+import type { TriggerSummary } from "./connector-panel-types";
+export interface PluginTriggerStackProps {
+    client: BladeClient;
+    /** 会话内图标走会话接口；首页待选传 `null`（走账号级目录图标）。 */
+    sessionId: string | null;
+    /** 折叠结果，来自 `triggerSummary`——折叠规则只有那一处。 */
+    summary: TriggerSummary;
+    className?: string;
+}
+/**
+ * 触发器上的插件头像堆叠：前三枚圆形头像 + 其余折成 `+N`。
+ *
+ * 没有图标 token 的插件也用显示名首字占一枚圆——它和别的插件长得不一样，
+ * 「我选过它」就看得见；早先把这类项直接剔掉，选中后入口毫无变化。
+ *
+ * 圆环色取 `--background`（盖住被压住的那枚），与整站头像堆叠同一约定，见
+ * `apps/web/src/components/agent-board/ProjectMembers.tsx`：容器没有自己的底色时，
+ * 环就等于容器露出来的那层底。图标裁成圆形：插件 logo 多是方的，套在圆按钮里
+ * 「方套圆」才是那个视觉冲突的来源。
+ */
+export declare function PluginTriggerStack({ client, sessionId, summary, className }: PluginTriggerStackProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/PostChatFollowupBlock.d.ts

@@ -0,0 +1,63 @@
+import type { FinalArtifact, PostChatFollowup, ResultFeedback as SavedResultFeedback, ResultFeedbackReason } from "@blade-hq/agent-client";
+export type FollowupInteractionEvent = {
+    type: "suggestions_shown";
+    sessionId?: string;
+    assistantEntryId: string;
+    count: number;
+} | {
+    type: "suggestion_adopted";
+    sessionId?: string;
+    assistantEntryId: string;
+    suggestionIndex: number;
+} | {
+    type: "artifact_shown";
+    sessionId?: string;
+    assistantEntryId: string;
+    artifactIndex: number;
+    artifactKind: FinalArtifact["kind"];
+} | {
+    type: "artifact_opened";
+    sessionId?: string;
+    assistantEntryId: string;
+    artifactIndex: number;
+    artifactKind: FinalArtifact["kind"];
+} | {
+    type: "artifact_download_started";
+    sessionId?: string;
+    assistantEntryId: string;
+    artifactIndex: number;
+    artifactKind: "file";
+} | {
+    type: "artifact_download_succeeded";
+    sessionId?: string;
+    assistantEntryId: string;
+    artifactIndex: number;
+    artifactKind: "file";
+} | {
+    type: "result_feedback_shown";
+    sessionId?: string;
+    assistantEntryId: string;
+} | {
+    type: "result_feedback_submitted";
+    sessionId?: string;
+    assistantEntryId: string;
+    helpful: boolean;
+    reason: ResultFeedbackReason | null;
+    updatedAt: string;
+};
+export declare function HistoricalResultFeedback({ feedback }: {
+    feedback: SavedResultFeedback;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PostChatFollowupBlock({ followup, sessionId, onSuggestion, isViewer, onInteraction, savedFeedback, onFeedbackSaved, className, suggestionClassName, }: {
+    followup: PostChatFollowup;
+    sessionId?: string;
+    onSuggestion?: (value: string) => void;
+    isViewer?: boolean;
+    onInteraction?: (event: FollowupInteractionEvent) => void;
+    savedFeedback?: SavedResultFeedback;
+    onFeedbackSaved?: (feedback: SavedResultFeedback) => void;
+    /** 追加到跟进区根节点的类（`ChatViewClassNames.followup`）。 */
+    className?: string;
+    /** 追加到每个「下一步」建议按钮的类（`ChatViewClassNames.followupAction`）。 */
+    suggestionClassName?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/SessionBranchPicker.d.ts

@@ -0,0 +1,11 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+type CheckpointTree = Awaited<ReturnType<BladeClient["sessions"]["getSessionCheckpoints"]>>;
+export interface SessionBranchPickerProps {
+    tree: CheckpointTree;
+    /** Disable changes while this session is running or read-only. */
+    disabled?: boolean;
+    /** Restore only the conversation; the host owns history refresh and composer drafts. */
+    onCheckout: (checkpointId: string, position: "before" | "turn_end") => Promise<void>;
+}
+export declare function SessionBranchPicker({ tree, disabled, onCheckout, }: SessionBranchPickerProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/SessionMemoryToggle.d.ts

@@ -0,0 +1,19 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+export interface SessionMemoryToggleProps {
+    sessionId: string;
+    enabled: boolean;
+    /** 不在 BladeProvider 内使用时显式传入，与宿主现有 BladeClient 复用连接和鉴权。 */
+    client?: BladeClient;
+    disabled?: boolean;
+    label?: string;
+    className?: string;
+    labelClassName?: string;
+    inputClassName?: string;
+    onSaved?: (sessionId: string, enabled: boolean) => void;
+    onError?: (error: unknown) => void;
+}
+/**
+ * 当前会话记忆开关。同一 client + sessionId 的所有实例共享保存锁，避免多个聊天入口
+ * 或会话切换时发出乱序更新；服务端成功后才通过 onSaved 交还权威值。
+ */
+export declare function SessionMemoryToggle({ sessionId, enabled, client: clientProp, disabled, label, className, labelClassName, inputClassName, onSaved, onError, }: SessionMemoryToggleProps): import("react/jsx-runtime").JSX.Element;