@blade-hq/agent-react 2610.0.0-beta.7 → 2610.0.0-beta.70

package/dist/components/AgentChat.d.ts

@@ -1,4 +1,5 @@
 import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client";
+import { type ReactNode } from "react";
 import { type ChatPresentationProps } from "./ChatSurface";
 import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 export interface AgentChatProps extends ChatPresentationProps {
@@ -13,6 +14,8 @@ export interface AgentChatProps extends ChatPresentationProps {
     onSessionReady?: (session: AgentSession) => void;
     /** 智能体下发给宿主页面的指令处理器（action → handler）。 */
     commands?: Record<string, (data: unknown) => void>;
+    /** 覆盖默认会话插件选择器。 */
+    sessionPluginControls?: (sessionId: string) => ReactNode;
 }
 /**
  * 智能体模式的聊天界面：连接（或新建）一个 Blade 会话，渲染消息流与输入框。

package/dist/components/AgentLoopBlock.d.ts

@@ -2,9 +2,6 @@ import type { ToolCallInfo } from "@blade-hq/agent-client";
 interface Props {
     toolCall: ToolCallInfo;
 }
-/**
- * 子智能体（fork Agent）状态块的 SDK 简化版：只展示描述、状态与最终结果，
- * 不再嵌套渲染子循环的完整消息流（那是第一方界面的能力）。
- */
+/** SDK 没有第一方子循环消息流，只保留轻量意图行和可展开的最终结果。 */
 export declare function AgentLoopBlock({ toolCall }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/AskUserQuestionBlock.d.ts

@@ -28,4 +28,13 @@ interface Props {
 export declare function AskUserQuestionBlock({ data, answered, toolCallId, sessionStatus, answerData, onAnswer, }: Props): import("react/jsx-runtime").JSX.Element;
 /** 解析 AskUserQuestion 的工具结果/参数，容错 LLM 把 questions 输出为字符串的情况。 */
 export declare function parseAskUserQuestion(toolResult: string | null | undefined): AskUserQuestionData | null;
+export interface AskUserQuestionError {
+    message: string;
+    detail: string | null;
+}
+/**
+ * Keep this parser synchronized with apps/web/AskUserQuestionBlock.tsx.
+ * The built-in Web cannot import agent-react, and this is not a public SDK protocol API.
+ */
+export declare function parseAskUserQuestionError(toolResult: string | null | undefined): AskUserQuestionError | null;
 export {};

package/dist/components/AssistantTurnBlock.d.ts

@@ -1,4 +1,4 @@
-import type { AskUserAnswerData, ChatMessage } from "@blade-hq/agent-client";
+import type { AskUserAnswerData, ChatMessage, MemoryRefInfo } from "@blade-hq/agent-client";
 import { type ToolCallRenderer } from "./ToolCallBlock";
 interface Props {
     messages: ChatMessage[];
@@ -7,12 +7,26 @@ interface Props {
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     sessionStatus?: string;
     toolCallRenderer?: ToolCallRenderer;
+    /** Agent 模式把 update_plan 收口到输入框上方的任务面板；纯 LLM 同名工具照常展示。 */
+    hidePlanUpdateTools?: boolean;
     /** 会话 id；传给 Markdown 渲染的统一上下文。 */
     sessionId?: string;
 }
-/**
- * 一轮助手回复：按消息顺序渲染 thinking 折叠块、正文 Markdown 与工具调用。
- * 相比第一方版本去掉了紧凑/详细模式切换、文件交付卡片与内联资源 iframe。
- */
-export declare function AssistantTurnBlock({ messages, isStreaming, askAnswers, onAnswer, sessionStatus, toolCallRenderer, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
+export type TurnDisplayMode = "compact" | "detail";
+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;
+/** 一轮助手回复：执行过程默认折叠，最终正文始终显示在摘要下方。 */
+export declare function AssistantTurnBlock({ messages, isStreaming, askAnswers, onAnswer, sessionStatus, toolCallRenderer, hidePlanUpdateTools, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function collectMemoryRefs(messages: ChatMessage[]): MemoryRefInfo[];
+export declare function MemoryRefsHint({ refs }: {
+    refs: MemoryRefInfo[];
+}): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatInput.d.ts

@@ -6,13 +6,27 @@ interface Props {
     onStop: () => void;
     isStreaming: boolean;
     isStopping?: boolean;
+    /**
+     * 宿主是否渲染了队列面板。没有面板时不给"运行中提交"入口：消息进了队列却看不见，
+     * 比明确提示用户等一等更糟。ChatSurface 按 queuePanel 是否存在传入。
+     */
+    queueWhileRunning?: boolean;
+    /**
+     * 上方紧贴着一个比自己窄的面板（队列面板）时置 true：上两角改直角。
+     *
+     * 面板比输入框窄一圈，输入框上角留圆弧的话，那两段弧会从面板两侧露出来，
+     * 看着就是两个尖角。跟内置 Web 的 ChatInput 是同一个判据。
+     */
+    mergesWithPanelAbove?: boolean;
     placeholder?: string;
     className?: 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, queueKey, hasAttachments, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatSurface.d.ts

@@ -1,5 +1,5 @@
 import type { AskUserAnswerData, ChatMessage, ConnectionStatus, PostChatFollowup } from "@blade-hq/agent-client";
-import type { ReactNode } from "react";
+import { type ReactNode } from "react";
 import type { ToolCallRenderer } from "./ToolCallBlock";
 import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 import type { ResultFeedback } from "@blade-hq/agent-client";
@@ -55,8 +55,35 @@ interface ChatSurfaceProps extends ChatPresentationProps {
     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>;
+    };
     /** 连接状态条下方的横幅（回放模式条用）。不传时不渲染任何节点。 */
     banner?: ReactNode;
+    /**
+     * 打字机式显示节流是否还没追平目标全文——调用方需要跟 isStreaming 做
+     * `||` 判断输入框"运行中"状态。
+     */
+    onRevealingChange?: (revealing: boolean) => void;
+    /** 是否正在回放（演示 / 彩排）而非真正的实时直播——透传给 MessageList。 */
+    isReplay?: boolean;
 }
 /**
  * 消息流 + 输入框：智能体模式与纯 LLM 模式共用同一套外观，差别只在谁喂数据。
@@ -64,5 +91,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, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, 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, banner, onRevealingChange, isReplay, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 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,3 +1,5 @@
+/** Keep inline formatting markers from being consumed by URL autolinking. */
+export declare function normalizeAdjacentUrlFormatting(value: string): string;
 export interface MarkdownContentProps {
     children: string;
     className?: string;

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/MessageList.d.ts

@@ -11,6 +11,7 @@ interface Props {
     askAnswers?: Record<string, AskUserAnswerData>;
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     toolCallRenderer?: ToolCallRenderer;
+    hidePlanUpdateTools?: boolean;
     emptyState?: ReactNode;
     className?: string;
     /** 会话 id；传给助手消息的统一上下文。 */
@@ -19,10 +20,34 @@ interface Props {
     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>;
+    };
+    /**
+     * 用户点了停止（还没等服务端确认）——打字机式显示节流要在这一刻立刻整段
+     * 显示已到达内容，不能等 chat:stop 的服务端回包才响应。跟 isStreaming
+     * 翻转成 false 不是一回事：那个信号来得晚，点击到服务端确认之间有一段
+     * 网络往返，这段时间里节流动画不该继续播。
+     */
+    isStopping?: boolean;
+    /**
+     * 打字机式显示节流是否还没追平目标全文——调用方需要跟 isStreaming 做
+     * `||` 判断输入框"运行中"状态，否则输入框会先于文字播完就翻回可输入。
+     */
+    onRevealingChange?: (revealing: boolean) => void;
+    /**
+     * 是否正在回放（演示 / 彩排）而非真正的实时直播——回放期间即使内容在
+     * 增长也不进入打字机式节流，直接整段显示：这是"流式与历史必须产生相同
+     * 结果"这条硬规则的一部分，节流只在真正的实时直播里生效。
+     */
+    isReplay?: boolean;
 }
 /**
  * 消息列表：use-stick-to-bottom 自动滚动 + 按轮次分组渲染。
  * 相比第一方版本去掉了轮次导航栏、吸顶状态条与规划摘要卡片。
  */
-export declare function MessageList({ messages, postChatFollowup, onSuggestion, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, emptyState, className, sessionId, isViewer, onFollowupInteraction, resultFeedbackByEntry, onResultFeedbackSaved, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, postChatFollowup, onSuggestion, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, hidePlanUpdateTools, emptyState, className, sessionId, isViewer, onFollowupInteraction, resultFeedbackByEntry, onResultFeedbackSaved, historyPaging, isStopping, onRevealingChange, isReplay, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/PlanUpdateBlock.d.ts

@@ -0,0 +1,31 @@
+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, }: {
+    toolCall: ToolCallInfo;
+    running?: boolean;
+    /** 实时收到的新进度短暂展开；加载历史时保持默认收起。 */
+    autoReveal?: boolean;
+}): 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/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;

package/dist/components/SessionPluginConfigDialog.d.ts

@@ -0,0 +1,10 @@
+import type { BladeClient, SessionPlugin, SessionPluginConfigState } from "@blade-hq/agent-client";
+export interface SessionPluginConfigDialogProps {
+    client: BladeClient;
+    sessionId: string;
+    plugin: Pick<SessionPlugin, "name" | "display_name" | "icon">;
+    /** Called after every successful save with the freshly published state. */
+    onSaved?: (state: SessionPluginConfigState) => void;
+    onClose: () => void;
+}
+export declare function SessionPluginConfigDialog({ client, sessionId, plugin, ...props }: SessionPluginConfigDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginConfigForm.d.ts

@@ -0,0 +1,14 @@
+import type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client";
+export interface SessionPluginConfigDraft {
+    set: SessionPluginConfigSet[];
+    remove: string[];
+}
+export interface SessionPluginConfigFormProps {
+    config: SessionPluginConfigState;
+    submitting: boolean;
+    errors: SessionPluginConfigError[];
+    failure: string | null;
+    onSubmit: (draft: SessionPluginConfigDraft) => void;
+    onCancel: () => void;
+}
+export declare function SessionPluginConfigForm({ config, submitting, errors, failure, onSubmit, onCancel, }: SessionPluginConfigFormProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginIcon.d.ts

@@ -0,0 +1,30 @@
+import type { BladeClient, SessionPlugin } from "@blade-hq/agent-client";
+export interface SessionPluginIconProps {
+    client: BladeClient;
+    /**
+     * 会话内已准备的包。传 `null` 时改用账号级目录图标（`/api/plugins/{name}/icon`），
+     * 这样首页这种还没有会话的地方也能显示包内图标。
+     */
+    sessionId: string | null;
+    plugin: Pick<SessionPlugin, "name" | "icon">;
+    /** 边长，默认 20。 */
+    size?: number;
+    /**
+     * 外框形状：`rounded`（默认，面板列表里的小方角）或 `circle`（触发器上的头像堆叠）。
+     * 默认值不动，避免改到列表与第三方接入方的观感。
+     */
+    shape?: "rounded" | "circle";
+    className?: string;
+}
+export interface SessionPluginLabelProps {
+    plugin: Pick<SessionPlugin, "name" | "display_name">;
+}
+/**
+ * Business name for a plugin, falling back to the technical ID.
+ *
+ * The ID stays authoritative for paths, authorization, caching and calls; this
+ * helper only decides what a user reads. Keep it shared — one place decides.
+ */
+export declare function sessionPluginLabel(plugin: Pick<SessionPlugin, "name" | "display_name">): string;
+/** Package-local plugin icon, with a stable generic placeholder. */
+export declare function SessionPluginIcon({ client, sessionId, plugin, size, shape, className }: SessionPluginIconProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginSelector.d.ts

@@ -0,0 +1,10 @@
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+export interface SessionPluginSelectorProps {
+    client: BladeClient;
+    sessionId: string;
+    className?: string;
+    side?: "top" | "bottom";
+    onChange?: (plugin: SessionPluginActivation) => void;
+}
+/** Shared selector for AgentChat and the built-in Web; no external query provider required. */
+export declare function SessionPluginSelector(props: SessionPluginSelectorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionQueuePanel.d.ts

@@ -0,0 +1,74 @@
+import { type QueuedMessage, type SessionQueueSnapshot } from "@blade-hq/agent-client";
+import { type JSX } from "react";
+export interface SessionQueuePanelProps {
+    snapshot: SessionQueueSnapshot;
+    /** 当前是否有可接收补充的运行任务（决定「立刻发送」是否可用） */
+    canDeliver: boolean;
+    /** 正在等服务端确认的条目 id：禁用该条目的操作，避免重复提交 */
+    pendingItemId?: string | null;
+    /** 冲突/失败提示，例如「该消息已开始执行」；展示在面板顶部 */
+    notice?: string | null;
+    onResume: () => void;
+    onCancel: (item: QueuedMessage) => void;
+    onEdit: (item: QueuedMessage, content: string) => boolean | undefined | Promise<boolean>;
+    onRequeue?: (content: string) => Promise<boolean>;
+    onMove: (item: QueuedMessage, delta: -1 | 1) => void;
+    onReorder: (orderedIds: string[]) => void;
+    onDeliver: (item: QueuedMessage) => void;
+    /**
+     * 队列内容与外层留白的宽度类，要和下面输入框用同一个值。
+     *
+     * 队列卡片是"比输入框窄一圈、露在它上方"的形态，所以这里的宽度必须跟着
+     * 输入框走：输入框宽度由调用方决定（内置 Web 默认 max-w-3xl，软件工厂用
+     * `max-w-[748px]!` 覆盖，SDK 侧是 max-w-[748px]）。写死一个值的话，两种
+     * 布局里总有一种对不齐——之前写死 max-w-[748px] 且外层 px-4，而输入框
+     * 外层是 px-5，软件工厂恰好都是 748 看着还行，普通聊天里输入框是 768，
+     * 队列连缩进一起窄了 22px。
+     */
+    contentWidthClassName?: string;
+    /** 根节点附加类。宿主用它在根上重设 `--blade-chat-queue-gutter`（或别的变量）。 */
+    rootClassName?: string;
+    /**
+     * 面板占位状态变化时回调（true = 正在占位）。
+     *
+     * 面板有本地 `editing` 状态：用户编辑到一半、那条等待消息被服务端拿走后，
+     * 面板仍要留在原地保住没保存的正文（见 `detachedEdit`）。这时 `items` 是空的，
+     * 光凭 snapshot 判不出面板还在，宿主就会把输入框上两角恢复成圆角、接缝上露出
+     * 尖角。让面板自己上报，宿主不必也无法复刻这个判据。
+     */
+    onVisibleChange?: (visible: boolean) => void;
+    /**
+     * 面板是否真的紧贴下面的输入框。
+     *
+     * 中间夹着别的内容时（MCP 暂存内容、内置 Web 的 `composerBanner`）两者并不
+     * 相接，这时面板下两角也要圆起来——直角是"被下面的输入框接住"的表示，露出
+     * 直角却下面空着一块，看起来像被削掉一角。
+     *
+     * 不传时读 context（见 `QueuePanelAdjacencyContext`）：面板通常由宿主创建、
+     * 挂进 `ChatSurface`，而"中间有没有内容"是 `ChatSurface` 内部的 state，
+     * 宿主拿不到。内置 Web 自己管布局，直接把值传进来即可。
+     */
+    mergesWithInputBelow?: boolean;
+}
+/**
+ * 队列面板此刻会不会占位。
+ *
+ * 输入框要据此把自己的上两角改成直角：队列贴在它上方、而且比它窄一圈，
+ * 输入框上角若还是 22px 圆弧，那两段弧会从队列两侧露出来，形成两个尖角。
+ *
+ * 抽成一个函数而不是两边各判一次，是为了让"面板可见"和"输入框顶角改直角"
+ * 永远同步——这正是仓库里反复出现的"改了一个入口漏了另一个"。
+ * 传入的 `editing` 是面板自己的本地编辑态，默认 false。
+ */
+export declare function isQueuePanelVisible(snapshot: Pick<SessionQueueSnapshot, "items" | "paused">, notice: string | null | undefined, editing?: boolean): boolean;
+/**
+ * 会话消息队列面板：输入框上方的「待执行 · N」区域。
+ *
+ * 一行一条：左边三条横向的拖动手柄、中间单行截断的正文、右边 hover 才出现的操作
+ * （立刻发送 / 编辑 / 删除）。顺序靠拖动整行调整，手柄上也能用 Alt+↑/↓ 调（键盘
+ * 可达性不能因为去掉上下箭头按钮就没了）。
+ *
+ * 纯展示组件，不持有会话状态；能否编辑/删除/补充全部用 agent-client 的判定函数，
+ * 不在本包重写一份。拖动与键盘调整最终都由调用方提交完整的 pending id 顺序。
+ */
+export declare function SessionQueuePanel({ snapshot, canDeliver, pendingItemId, notice, onResume, onCancel, onEdit, onRequeue, onMove, onReorder, onDeliver, contentWidthClassName, rootClassName, onVisibleChange, mergesWithInputBelow: mergesWithInputBelowProp, }: SessionQueuePanelProps): JSX.Element | null;

package/dist/components/ToolCallBlock.d.ts

@@ -8,6 +8,7 @@ interface Props {
     answered?: boolean;
     answerData?: AskUserAnswerData;
     sessionStatus?: string;
+    isActiveQuestion?: boolean;
     renderer?: ToolCallRenderer;
 }
 /**
@@ -19,10 +20,11 @@ interface Props {
  * 会同时把已经回答过的旧提问重新变成可作答（历史加载不会带回 answerData），
  * 而且会盖住投影层的错误——这个 bug 就是这么藏住的。
  */
-export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, }: {
+export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, fallbackAwaiting, }: {
     toolStatus: ToolCallInfo["status"];
     hasAnswerData: boolean;
     fallbackAnswered?: boolean;
+    fallbackAwaiting?: boolean;
 }): {
     awaitingAnswer: boolean;
     answered: boolean;
@@ -31,5 +33,5 @@ export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fal
  * 极简工具调用块：状态 + 展示名一行，点开后是参数/结果的 <pre> 折叠展示。
  * AskUserQuestion 特殊处理为提问选项卡片。
  */
-export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionStatus, renderer, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionStatus, isActiveQuestion, renderer, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ToolUiCardView.d.ts

@@ -0,0 +1,9 @@
+import { type ToolUiCard } from "@blade-hq/agent-client";
+/**
+ * MCP Apps 使用 SDK/Web 共享的 AppBridge；恢复只消费留档，不重读资源。
+ * 普通资源卡片仍使用 agent-client 的共享内容判定。
+ */
+export declare function ToolUiCardView({ card, sessionId }: {
+    card: ToolUiCard;
+    sessionId?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/UserMessageBubble.d.ts

@@ -11,7 +11,7 @@ interface UserMessageProps {
     message: UserChatMessage;
     className?: string;
 }
-/** 用户消息气泡：文本 + 图片/文件附件展示（不含第一方的预览弹窗与 what-if 徽章）。 */
+/** 用户消息气泡：文本、canonical 引用消息与图片/文件附件。 */
 export declare function UserMessageBubble({ message, className }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
 /** 错误消息：居中红色提示条。 */
 export declare function ErrorMessageBlock({ message, className, }: {

package/dist/components/WhatIfUserBubble.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedWhatIfPrompt } from "../lib/whatif-prompt";
+export interface WhatIfUserBubbleProps {
+    parsed: ParsedWhatIfPrompt;
+    onQuoteClick?: (stepNumber: number) => void;
+}
+/** SDK 与内置 Web 共用的 canonical 引用消息渲染。 */
+export declare function WhatIfUserBubble({ parsed, onQuoteClick }: WhatIfUserBubbleProps): import("react/jsx-runtime").JSX.Element;