@blade-hq/agent-react 2612.0.0-beta.6 → 2612.0.0-beta.60

package/README.md

@@ -460,6 +460,10 @@ blade-chat::part(input-toolbar) { gap: 12px; }
 
 不需要本包——用后端托管的单文件产物 `<script src=".../sdk/blade-agent.js">` + `<blade-chat>` 自定义元素，行为与 `ChatView` 一致。Vue 项目用 `@blade-hq/agent-vue` 的 `<BladeChat>` 组件；区块定制用挂载式渲染器（`<blade-chat>` 元素的 `renderers` 属性），详见 agent-client README「`<blade-chat>` 的挂载式渲染器」。
 
+## 独立工具详情
+
+自行维护消息时间线的应用可按需使用公开入口 `@blade-hq/agent-react/tool-details`，无需依赖 `/internal` 或挂载完整聊天视图。入口导出 `getRenderer(name)`、`formatToolName`、`getToolDisplayLabel`、`parsePlanUpdate`、`ToolUiCardView`、`isToolUiCard`，以及 `ToolRendererProps`、`ToolUiCard` 类型。`getRenderer` 对内置工具返回共享组件，未注册的名称返回 `null`，宿主可组合自己的通用展示。工具组件接收公开的 `ToolCallInfo`，主题及 Tailwind 编译方式与聊天视图相同；涉及会话资源的工具卡片仍需 `BladeProvider` 与对应会话权限。
+
 ## 第一方内部入口
 
 - `@blade-hq/agent-react/internal`：内置 Web 与浏览器插件用的聊天内部块、判定逻辑和连接器组件。
@@ -478,7 +482,7 @@ blade-chat::part(input-toolbar) { gap: 12px; }
 
 主题资产候选通过当前主题的资产列表获取，使用专用 `TopicAssetMention` 药丸；没有关联主题时不展示候选。首页与会话输入框复用候选查询、引用序列化和展示结构。
 
-`useReferenceCandidates(getScope, { kbs, topics, files })` 在富输入子入口提供固定三组候选的并发查询、短等待与迟到刷新；作用域为 client、鉴权身份、session、topic，菜单使用 query 返回数组绑定 observe，退出时 cancel。宿主继续提供原有数据适配，控制器不执行工具或改写发送协议。
+`useReferenceCandidates(getScope, { plugins, topics, files })` 在富输入子入口提供固定三组候选的并发查询、短等待与迟到刷新；作用域为 client、鉴权身份、session、topic，菜单使用 query 返回数组绑定 observe，退出时 cancel。宿主继续提供原有数据适配，控制器不执行工具或改写发送协议。
 
 `queueTopicAssetReference(sessionId, { topic_id, path })`（`@blade-hq/agent-react/rich-input`）可在导航到当前用户的同主题会话前预填引用。发送只携带引用身份，元数据和权限由服务端重新判断；本轮续跑保留引用，下一条消息默认不继承。
 
@@ -489,3 +493,28 @@ blade-chat::part(input-toolbar) { gap: 12px; }
 ### 选择插件条目
 
 ChatView 和 `<blade-chat>` 的默认轻量输入支持 @ 搜索插件条目，候选显示中文插件名和图标。选中条目在输入框上方显示，可点 × 移除；发送后保留选择，刷新后恢复最近用户消息的选择。富输入使用同样的候选接口与 PluginRef 身份。自动读取失败时模型会收到明确失败说明。
+
+### 应用资料展示
+
+共享聊天视图展示消息级 `context_attachments`：气泡只显示正文，资料标签可展开查看纯文本详情，`data` 中的内部 JSON 与 ID 不显示。`ChatSendOptions.contextAttachments` 可沿共享发送入口传入 SDK；可靠后台发送使用 `AgentSession.prepareSend` / `sendPrepared`。文件读取使用当前 `BladeProvider` 的 `BladeClient` 和资料指定的会话权限，失效或没有来源的文件显示「文件不可用」。内置 Web、扩展和嵌入视图使用相同实现。
+
+### 独立嵌入提问卡片（React 19+）
+
+自行管理消息时间线的宿主可从 `@blade-hq/agent-react/questions` 按需导入 `QuestionnaireQuestionBlock`（也导出为 `AskUserQuestionBlock`），无需加载整个 `ChatView`。该入口基于官方 shadcn Questionnaire，遵循 `@shadcn/react` 的 React 19+ 要求；原有 `ChatView` 入口及其问答渲染器保留 React 18 支持。
+
+入口同时导出 `AskUserQuestionData` 和 `AskUserAnswerData` 类型。通过 `data`、`answered`、`answerData` 和 `sessionStatus` 提供问题及状态；`onAnswer(text, toolCallId, answerData)` 交给宿主，使用 `session.send(text, { askUserAnswer: { tool_call_id: toolCallId, ...answerData } })` 将原生结构化回答送回原始会话，不能送入普通文本队列。
+
+Questionnaire 负责必答校验、原生单选/多选、自填和前后分页，不提供跳过问题的业务行为。宿主负责传输、提交失败反馈、刷新已保存的回答及主题样式；提交失败时以 `sessionStatus="failed"` 恢复当前选择供重试。问题类型及文本格式化函数与 BA 原生协议共用。
+
+## 飞书授权接入
+
+`DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。宿主可用 `initialPage="manage"` 在首次挂载时直达管理页；尚未关联应用时仍进入连接入口，不会自动创建应用或授权。初始权限采用飞书平台默认模板及官方 CLI 推荐清单，不以机器人/本人身份或 SW 已实现能力筛选。权限状态按企业侧开通、本人授权分别展示，未知不等于拒绝；工作能力目录另外说明当前能执行的操作。
+
+首次关联应用后继续确认官方推荐的本人授权，允许两次扫码。企业审核要求以飞书页面为准；添加能力仍按当前操作核验和补充，核验失败保留连接与错误。统一授权流程按 `authorize` / `poll` 逐步展示当前飞书官方二维码，完成后显式 `finish`；PA 通过 `bindDelivery` 接入机器人消息，接入失败保留授权，可单独重试。完整分类选择在完成时替换启用集合，局部补权保留其他已选项；取消申请保留已有授权。增加能力时保留此助手原有停用状态，按钮显示“授权并保存”，暂停推送也不会被自动恢复。日志、历史步骤和原生错误编号放在连接帮助的高级排查内。
+
+PA 等只需要授权界面的宿主可从 `@blade-hq/agent-react/connectors` 导入，避免加载整套聊天 UI。组件仅接收公开授权链接，二维码在本地生成。宿主须扫描组件源码（含 `FeishuCapabilitySelection.tsx`）的 Tailwind 样式，或使用 SDK 完整样式。认证身份变化时重建组件，避免沿用前一账号的视图。
+
+
+### 聊天中的飞书连接
+
+`@blade-hq/agent-react/connectors` 的 `DeviceConnection` 可传 `autoAuthorize`：仅在用户主动打开聊天授权卡片时开始准备官方二维码，设置页默认仍手动发起。`authorizationCapabilities` 用于只补当前操作需要的能力；已有有效二维码会继续使用，不重复生成。生成二维码不代表用户授权或企业审核已通过。

package/dist/chat/AgentLoopBlock.d.ts

@@ -5,9 +5,7 @@ interface Props {
     sessionId: string;
     reasoning?: string;
     hideAskUserQuestions?: boolean;
-    /** 初始展开(工作流步骤卡默认摊开,老 #1841 体验);等待回答仍强制展开。 */
     defaultExpanded?: boolean;
-    /** 自定义卡头描述渲染(工作流用它把 {{ref}} 画成引用胶囊)。 */
     renderDescription?: (description: string) => ReactNode;
 }
 export declare function AgentLoopBlock({ toolCall, sessionId, reasoning, hideAskUserQuestions, defaultExpanded, renderDescription, }: Props): import("react/jsx-runtime").JSX.Element;

package/dist/chat/AskUserQuestionBlock.d.ts

@@ -1,22 +1,6 @@
-import type { AskUserAnswerData } from "@blade-hq/agent-client";
-export type { AskUserAnswerData };
-interface OptionItem {
-    label: string;
-    description: string;
-}
-interface QuestionItem {
-    question: string;
-    options: OptionItem[];
-    multiSelect?: boolean;
-}
-interface SourceLoopInfo {
-    loop_name: string;
-    description: string;
-}
-export interface AskUserQuestionData {
-    questions: QuestionItem[];
-    source_loop?: SourceLoopInfo | null;
-}
+import type { AskUserAnswerData, AskUserQuestionData } from "@blade-hq/agent-client";
+export { parseAskUserQuestion } from "@blade-hq/agent-client";
+export type { AskUserAnswerData, AskUserQuestionData };
 interface Props {
     data: AskUserQuestionData;
     answered: boolean;
@@ -26,7 +10,6 @@ interface Props {
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
 }
 export declare function AskUserQuestionBlock({ data, answered, toolCallId, sessionStatus, answerData, onAnswer, }: Props): import("react/jsx-runtime").JSX.Element;
-export declare function parseAskUserQuestion(toolResult: string | null | undefined): AskUserQuestionData | null;
 export interface AskUserQuestionError {
     message: string;
     detail: string | null;

package/dist/chat/AssistantTurnBlock.d.ts

@@ -7,14 +7,6 @@ interface Props {
     sessionId: string;
     messages: ChatMessage[];
     isStreaming?: boolean;
-    /**
-     * 打字机式显示节流下，"正文还没播完"跟"思考过程本身有没有说完"是两条
-     * 独立时间线——正文通常比思考过程晚播完很久。"正在思考"/"已思考" 这个
-     * 标签只该看思考过程自己有没有播完，不能被 isStreaming（含正文节流）
-     * 拖着一起等正文播完才翻，否则会出现"正文都在吐字好几秒了，还显示正在
-     * 思考"这种跟视觉进度对不上的观感。不传时按旧行为处理（等价于思考过程
-     * 跟 isStreaming 同步）。
-     */
     isReasoningRevealing?: boolean;
     isLastTurn?: boolean;
     askAnswers?: Record<string, AskUserAnswerData>;
@@ -38,7 +30,7 @@ export declare function formatExecutionDuration(durationMs: number): string;
 export declare function getExecutionDurationMs({ messages, isStreaming, now, }: {
     messages: ChatMessage[];
     isStreaming: boolean;
-    now?: number;
+    now?: number | null;
 }): 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>;

package/dist/chat/AttachmentPreviewDialog.d.ts

@@ -19,7 +19,6 @@ interface Props {
      * 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;

package/dist/chat/ChatLoadingIndicator.d.ts

@@ -0,0 +1,7 @@
+export declare function isPreparingReply(messages: readonly {
+    role: string;
+    kind?: string;
+}[]): boolean;
+export declare function ChatLoadingIndicator({ preparing }: {
+    preparing?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/chat/ContextAttachmentPills.d.ts

@@ -0,0 +1,4 @@
+import type { ContextAttachment } from "@blade-hq/agent-client";
+export declare function ContextAttachmentPills({ attachments }: {
+    attachments?: ContextAttachment[];
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/chat/CurrentPlanPanel.d.ts

@@ -1,11 +1,8 @@
 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;

package/dist/chat/FileDeliveryCards.d.ts

@@ -5,15 +5,11 @@ export declare function collectDeliveredFiles(toolCalls: ToolCallInfo[], session
     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;

package/dist/chat/FinalArtifactCards.d.ts

@@ -3,6 +3,5 @@ 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

@@ -7,5 +7,5 @@ interface ImageLightboxProps {
     }[];
     initialIndex?: number;
 }
-export declare function ImageLightbox({ open, onOpenChange, images, initialIndex }: ImageLightboxProps): import("react").ReactPortal | null;
+export declare function ImageLightbox({ open, onOpenChange, images, initialIndex }: ImageLightboxProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/chat/LiteMessageList.d.ts

@@ -10,9 +10,7 @@ type TextRow = {
     text: string;
     entryIds: string[];
     failed?: boolean;
-    /** 本轮（含子智能体循环）真实检索到的引用证据，只有 assistant 文本行才有——
-     * 跟 AssistantTurnBlock.tsx 的 turnToolCalls/citations 同一套算法，不然轻量
-     * 模式下 kb_search 的 [n] 角标只能停在纯文本，点不开、也 hover 不出来源。 */
+    sending?: boolean;
     citations?: Record<number, CitationEntry>;
 };
 type MemoryRefsRow = {

package/dist/chat/MessageFileAttachmentList.d.ts

@@ -2,11 +2,6 @@ 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;

package/dist/chat/QuestionnaireQuestionBlock.d.ts

@@ -0,0 +1,11 @@
+import type { AskUserAnswerData, AskUserQuestionData } from "@blade-hq/agent-client";
+export type { AskUserAnswerData, AskUserQuestionData };
+interface Props {
+    data: AskUserQuestionData;
+    answered: boolean;
+    toolCallId: string;
+    sessionStatus: string;
+    answerData?: AskUserAnswerData | undefined;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+}
+export declare function QuestionnaireQuestionBlock({ data, answered, toolCallId, sessionStatus, answerData, onAnswer }: Props): import("react/jsx-runtime").JSX.Element;

package/dist/chat/SessionReplayBar.d.ts

@@ -7,6 +7,5 @@
 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

@@ -1,9 +1,6 @@
 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;

package/dist/chat/TurnNavRail.d.ts

@@ -6,11 +6,8 @@ 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;

package/dist/chat/WorkflowRunBlock.d.ts

@@ -1,13 +1,30 @@
+import type { WorkflowRunEntry } from "@blade-hq/agent-client";
 import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
+import type { InputSessionSkill } from "./runtime/input-services";
 interface Props {
-    /** 触发这次运行的 workflow:run 工具调用。 */
     toolCall: ToolCallInfo;
     sessionId: string;
 }
+/** 标题里的技能 id 换成会话技能列表里的中文名;查不到(未加载/已卸载)就保留 id。 */
+export declare function workflowTitle(name: string, argumentsJson: string, skills: readonly Pick<InputSessionSkill, "skill_id" | "display_name">[]): 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 的执行呈现——每个步骤一张卡顺序铺开
- * (agent 步骤=完整子智能体卡,命令/条件步骤=描述+输出的小卡),头部可整体折叠。
- * 渲染在触发它的回合内部(思考折叠区之后、总结之前),随回合持久。
+ * 「固定流程」块:一次 workflow:run(跑某个技能的 flows/*.yaml)的执行呈现——每个步骤
+ * 一张卡顺序铺开(agent 步骤=完整子智能体卡,命令/条件步骤=描述+输出的小卡),头部可整体折叠。
+ * 渲染在触发它的回合的「执行过程」折叠区里,和普通技能的工具调用同一个位置。
  */
 export declare function WorkflowRunBlock({ toolCall, sessionId }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -6,10 +6,6 @@ export interface TextShimmerProps {
     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 {};

package/dist/chat/customization.d.ts

@@ -30,7 +30,7 @@ export type ChatViewClassNames = Partial<{
     skillStatusBarInner: string;
 }>;
 /** 输入框提交时的附加项（模型、推理档位、知识库等由富输入给出）。 */
-export interface ChatSendOptions extends Pick<ChatSendExtras, "thinkingOverride" | "reasoningLevel" | "kbIds" | "refs" | "topicAssetRefs" | "queueWhenRunning"> {
+export interface ChatSendOptions extends Pick<ChatSendExtras, "thinkingOverride" | "reasoningLevel" | "refs" | "contextAttachments" | "topicAssetRefs" | "queueWhenRunning"> {
     /** 附件实际上传到的会话（首页新建会话时由输入框给出）。 */
     targetSessionId?: string;
     /** 本条消息用的模型；null 表示沿用会话已保存的模型。 */

package/dist/chat/index.d.ts

@@ -85,16 +85,13 @@ export { ENTRY_SCROLL_MARGIN_PX, calculateStickyAwareMargin, normalizeScrollEntr
 export { BashRenderer } from "./tool-renderers/BashRenderer";
 export { FileEditRenderer } from "./tool-renderers/FileEditRenderer";
 export { FileReadRenderer } from "./tool-renderers/FileReadRenderer";
-export { KbSearchRenderer } from "./tool-renderers/KbSearchRenderer";
 export { SearchRenderer } from "./tool-renderers/SearchRenderer";
 export { SubmitResultRenderer } from "./tool-renderers/SubmitResultRenderer";
-export { parseKbSearchResult, formatKbSearchLabel } from "./tool-renderers/kb-search-result";
-export type { KbSearchHit, KbSearchResult } from "./tool-renderers/kb-search-result";
 export { getRenderer } from "./tool-renderers/registry";
 export { getResultText, getResultImages, parseJsonValue, isPlainObject, getStringValue, getNumberValue, getBooleanValue, extractErrorMessage, getFileName, getCodeLanguage, formatBytes, CodePreview } from "./tool-renderers/shared";
 export { shouldFollowWritePreview, scrollWritePreviewToLatest } from "./tool-renderers/write-preview-scroll";
 export { skillDisplayName } from "./lib/skill-name";
-export { type ConnectorComputerSectionProps, type InputConnection, type InputDataState, type InputKnowledgeBase, type InputModelCatalog, type InputModelOption, type InputModelPreferences, type InputSessionSkill, type InputSkillStats, type RichInputServices, parseModelReasoningLevels, RichInputServicesProvider, useRichInputServices, } from "./runtime/input-services";
+export { type ConnectorComputerSectionProps, type ConnectorPhoneSectionProps, type InputConnection, type InputDataState, type InputModelCatalog, type InputModelOption, type InputModelPreferences, type InputSessionSkill, type InputSkillStats, type RichInputServices, parseModelReasoningLevels, RichInputServicesProvider, useRichInputServices, } from "./runtime/input-services";
 export { backgroundTaskDismissals, useDismissedBackgroundTasks } from "./runtime/background-task-dismissals";
 export { visibleSkillIds, visibleSkills } from "./lib/skill-visibility";
 export { resetInputCaches } from "./runtime/input-cache-reset";

package/dist/chat/lib/citations.d.ts

@@ -1,34 +1,13 @@
 import type { ToolCallInfo } from "@blade-hq/agent-client/internal";
-/** 一条可点击引用的原文，来自保存的插件快照或旧知识库结果。 */
+/** 一条可点击引用的原文，来自保存的插件快照。 */
 export interface CitationEntry {
     n: number;
-    kbName: string;
     title: string;
-    path: string;
-    page: number | null;
-    heading: string | null;
     text: string;
     previewUrl: string | null;
     snapshot?: boolean;
     toolCallId?: string;
     itemId?: string;
 }
-/**
- * 从一轮里的工具调用抽取可引用证据。规则：
- * - 插件证据只读可信投影 evidence 字段，并核对具体调用；普通结果文本不产生证据。
- * - 旧知识库仅认成功完成的 kb_search 调用，清理由 #3311 完成。
- * - 汇总本轮全部 kb_search 调用的命中，不只看最后一次。后端（见
- *   `knowledge_base.py build_search_tool_output` 的 `start_index`、
- *   `EngineSkillMixin.allocate_kb_citation_range`）保证本轮内多次 kb_search
- *   调用的编号连续递增、不重叠、不归零，所以回答里的每个 `[n]` 在这一轮里
- *   本该全局唯一，直接汇总即可，不用再靠"只用最后一次"去猜模型引用的是哪次。
- * - 但前端不信任协议 100% 不出错：万一后端真出现同一个编号在不同调用间指向
- *   不同证据的异常情况，这里依然按"冲突就剔除"处理——发现冲突直接从返回的
- *   map 里删掉这个编号，而不是用后来者覆盖前者，避免一旦协议出岔子就退回到
- *   "看起来能点、点开却是错的文档"这个原始 bug。正常情况下这段防御代码不会
- *   被触发。
- *
- * 返回的 map 只包含真的有证据支撑、且没有歧义的编号——`[n]` 是否可点全靠这个
- * map 里有没有对应的 key，不额外维护一个"允许列表"，避免两处状态不同步。
- */
+/** Collect saved plugin sources; conflicting numbers remain unclickable. */
 export declare function buildCitationsFromToolCalls(toolCalls: ToolCallInfo[] | null | undefined): Record<number, CitationEntry>;

package/dist/chat/markdown/ExternalAnchor.d.ts

@@ -1,6 +1,6 @@
-import type { ComponentPropsWithRef } from "react";
+import { type ComponentPropsWithRef } from "react";
 type AnchorProps = ComponentPropsWithRef<"a">;
-/** 链接一律新窗口打开并断开 opener，SDK 不接管站内跳转。
+/** 连接器登录入口使用浮层，其余链接新窗口打开并断开 opener。
  * 页内锚点（脚注引用/回链这类 `href="#fn-note"`）不能套"新窗口打开"这套
  * 逻辑——新开一个标签页访问 `#片段` 只是把整篇文档重新打开一次，不是
  * 滚动到页内位置，会破坏脚注的跳转体验。只有真正的外部链接才需要新窗口

package/dist/chat/markdown/MarkdownContent.d.ts

@@ -1,12 +1,15 @@
 import { type MarkdownRendererProps } from "../../components/markdown";
 import { normalizeAdjacentUrlFormatting } from "./text";
+import { type ComponentPropsWithRef } from "react";
 import type { CitationEntry } from "../lib/citations";
 export { normalizeAdjacentUrlFormatting };
+type PreProps = ComponentPropsWithRef<"pre">;
 export declare function resolveCollapsedContent({ dataKeyAttribute, dataRawAttribute, children, }: {
     dataKeyAttribute?: string;
     dataRawAttribute?: string;
     children?: unknown;
 }): string;
+export declare function CodeBlockPre({ children, ...props }: PreProps): import("react/jsx-runtime").JSX.Element;
 export declare function collapseInlineToolCalls(children: string): string;
 /** `[n]` 形式的引用角标，只有在 `citations` 里能查到 n 对应的证据时才替换成可交互标签
  * `<blade-citation-ref data-n="n">`；查不到就原样留作纯文本——不给用户一个点了却没有

package/dist/chat/message-list-blocks.d.ts

@@ -78,7 +78,6 @@ export declare function selectActiveTurnAtViewportPosition({ visibleTurns, conta
     containerBottom: number;
     fallbackTurnId: string | null;
     currentTurnId?: string | null;
-    /** 滚动容器已到底。 */
     atBottom?: boolean;
 }): string | null;
 /** 测试双通道最终渲染计划时忽略仅影响布局的 wrapper。 */

package/dist/chat/runtime/actions.d.ts

@@ -9,14 +9,13 @@ export interface ChatSendExtras {
     model?: string;
     thinkingOverride?: boolean;
     reasoningLevel?: string;
-    kbIds?: number[];
+    contextAttachments?: SendOptions["contextAttachments"];
     refs?: SendOptions["refs"];
     topicAssetRefs?: SendOptions["topicAssetRefs"];
     whatif?: SendOptions["whatif"];
     replayDecision?: SendOptions["replayDecision"];
     /**
-     * 声明「会话在跑就把这条消息放进等待队列」。只有渲染了队列面板、能展示等待消息的宿主才该传：
-     * 没有面板时排队等于消息凭空消失。
+     * 默认发送引导消息；显式为 true 时，等待当前运行结束后处理。
      */
     queueWhenRunning?: boolean;
 }

package/dist/chat/runtime/background-task-dismissals.d.ts

@@ -3,7 +3,6 @@ export declare const backgroundTaskDismissals: {
     getState: () => Dismissed;
     subscribe(listener: () => void): () => void;
     dismiss(sessionId: string, taskId: string): void;
-    /** 换身份：清空。 */
     reset(): void;
 };
 export declare function useDismissedBackgroundTasks(sessionId: string): string[];

package/dist/chat/runtime/composer-channels.d.ts

@@ -38,11 +38,8 @@ export declare const composerChannels: {
     clearSendRequests(sessionId: string): void;
     setModelDraft(sessionId: string, model: string): void;
     clearModelDraft(sessionId: string): void;
-    /** 回退到某一步后，把那一步的用户原话放回输入框（null 清除）。 */
     setRewindDraft(sessionId: string, text: string | null): void;
-    /** 会话被关闭 / 删除：清掉它还没被取走的信号。 */
     clearSession(sessionId: string): void;
-    /** 换身份：清空全部通道。 */
     reset(): void;
 };
 export type ComposerChannels = typeof composerChannels;

package/dist/chat/runtime/input-cache-reset.d.ts

@@ -1,8 +1,3 @@
-/**
- * 换身份（登出、换账号、换后端）时清掉富输入按 client 缓存的数据（技能菜单、模型目录等），
- * 新身份不会看到上一个身份的清单。富输入的缓存在这里登记清理函数；宿主在身份变化时调用
- * `resetInputCaches`。放在 internal 入口，宿主调用它不必引入富输入。
- */
 import type { BladeClient } from "@blade-hq/agent-client";
 export declare function onInputCachesReset(client: BladeClient, reset: () => void): () => void;
 export declare function resetInputCaches(client: BladeClient): void;

package/dist/chat/runtime/input-services.d.ts

@@ -38,11 +38,6 @@ export interface InputModelPreferences {
 }
 /** 偏好里存的是 JSON 字符串（模型 id → 档位）；坏数据当作没有。 */
 export declare function parseModelReasoningLevels(value: string | null | undefined): Record<string, string>;
-export interface InputKnowledgeBase {
-    id: number;
-    name: string;
-    description?: string | null;
-}
 export interface InputSessionSkill {
     skill_id: string;
     display_name?: string | null;
@@ -69,6 +64,14 @@ export interface InputDataState<T> {
     error: unknown;
 }
 export interface ConnectorComputerSectionProps {
+    sessionId: string | null;
+    query: string;
+    excludedSelection?: string[];
+    onExcludedSelectionChange?: (ids: string[]) => void;
+    /** 收起连接器面板（打开设置之类的动作前调用）。 */
+    closePanel: () => void;
+}
+export interface ConnectorPhoneSectionProps {
     sessionId: string | null;
     query: string;
     pendingSelection?: string[];
@@ -80,7 +83,6 @@ export interface RichInputServices {
     useModelCatalog?: () => InputModelCatalog;
     useModelPreferences?: () => InputModelPreferences;
     /** 知识库清单（`@` 菜单打开时才调用）。 */
-    useKnowledgeBaseLoader?: () => () => Promise<InputKnowledgeBase[]>;
     /** 语音是否可用（部署可以关掉）；默认不可用，不显示麦克风。 */
     voiceEnabled?: boolean;
     /** 语音的 AudioWorklet 脚本地址。 */
@@ -98,6 +100,8 @@ export interface RichInputServices {
     };
     /** 连接器面板里的「电脑」分区；不提供时不显示。 */
     ConnectorComputerSection?: ComponentType<ConnectorComputerSectionProps>;
+    /** 连接器面板里的「手机」分区，渲染在「电脑」下面；不提供时不显示。 */
+    ConnectorPhoneSection?: ComponentType<ConnectorPhoneSectionProps>;
     /** 连接器面板里的「外部账号」分区；不提供时不显示。 */
     ConnectorAccountsSection?: ComponentType<{
         query: string;

package/dist/chat/runtime/session-source.d.ts

@@ -1,8 +1,3 @@
-/**
- * 聊天组件读会话状态的来源。组件只认 `AgentSession`，不关心实例由谁持有：
- * 内置 Web 用自己的会话登记表（含静态会话、保留区），SDK 的 ChatView / `<blade-chat>` / 插件
- * 用 `useAgentSession` 持有的那一个实例（`createSingleSessionSource`）。
- */
 import { type AgentSession, type SessionState } from "@blade-hq/agent-client/internal";
 import { type ReactNode } from "react";
 export interface SessionSource {

package/dist/chat/runtime/use-chat-actions.d.ts

@@ -1,7 +1,3 @@
-/**
- * 聊天面板的动作与交互态：发送（等待回答时自动当作作答）、停止（带「停止中」）、等待消息队列命令
- * （冲突提示与进行中的条目）。全部直接作用在会话实例上。
- */
 import type { MessageContent } from "@blade-hq/agent-client/internal";
 import { type ChatSendExtras } from "./actions";
 export declare function useChatActions(sessionId: string): {

package/dist/{chat-OCLOVB3H.css → chat-IHPRU35X.css}

@@ -1,9 +1,3 @@
-/*
- * 聊天组件共用的非 Tailwind 规则（Markdown 排版、入场动画、扫光）。内置 Web 与插件经 agent/style.css
- * 引入这一份；<blade-chat> 与 npm 样式由 scripts/gen-embed-styles.mjs 放进 blade-chat-overrides 层。
- * 只写聊天组件自己用到的规则，页面级补丁不放这里。
- */
-
 [data-theme="light"] .prose-invert {
   --tw-prose-body: hsl(var(--foreground));
   --tw-prose-headings: hsl(var(--foreground));
@@ -25,9 +19,7 @@
   color: hsl(var(--primary));
 }
 
-/* --- chat markdown density: 收紧块间距，避免松散 ---------------- */
-/* typography 插件默认 p/li/heading 外边距偏大（1.25em/0.5em），聊天里读起来太松。
-   plain 选择器特异性高于插件的 :where()，可直接覆盖。 */
+
 .chat-prose p {
   margin-top: 0.5em;
   margin-bottom: 0.5em;
@@ -85,12 +77,7 @@
   margin-bottom: 1.2em;
 }
 
-/* 未闭合的加粗/斜体/行内代码，在闭合符真正到达前先按最终标签
- * 渲染、只用透明度标出"待确认"——内容和标签结构全程不变，闭合符到达后
- * 这条规则自然不再匹配，恢复完全不透明，DOM 节点没有被替换过。这个属性
- * 只由 MarkdownRenderer 引擎自己产出，不区分调用方用的是哪套 prose 外壳
- * （`.chat-prose`/`.prose`/`.lite-chat-markdown`/无外壳），不按外壳类名
- * 逐个补，直接全局生效。 */
+
 [data-markdown-pending="true"] {
   opacity: 0.6;
 }
@@ -108,7 +95,7 @@
   overflow-x: auto;
 }
 
-/* Message entrance animation */
+
 @keyframes msg-in {
   from {
     opacity: 0;
@@ -124,7 +111,7 @@
   animation: msg-in 0.15s ease-out forwards;
 }
 
-/* Running-state sweep, borrowed from deepseek-harness's ReasoningRow. */
+
 .status-sweep::after {
   content: "";
   position: absolute;
@@ -153,7 +140,7 @@
   }
 }
 
-/* 流式等待的扫光文字（ai-elements/shimmer.tsx） */
+
 @keyframes blade-shimmer-sweep {
   from {
     background-position: 100% center;