@blade-hq/agent-react 2612.0.0-beta.8 → 2612.0.0-beta.80

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 与浏览器插件用的聊天内部块、判定逻辑和连接器组件。
@@ -489,3 +493,46 @@ 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 原生协议共用。
+
+## 飞书授权接入
+
+`ConnectorConnection` 通过 `type="device"` 或 `type="managed"` 选择连接方式，并接收对应连接组件的宿主回调。
+
+`DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。未传 `detail` 的授权界面可用 `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` 用于只补当前操作需要的能力；已有有效二维码会继续使用，不重复生成。生成二维码不代表用户授权或企业审核已通过。
+
+首次连接默认只申请机器人能力；需要本人能力时按操作补充授权。已有连接的选择和授权不受影响。
+
+### 连接器管理详情
+
+`ConnectorConnection` 的 `detail` 传入名称、图标和 `rules` 内容，使用共享的紧凑头部、更多操作、权限/诊断二级页与确认框。只在 PA 等拥有对应能力的宿主传入 `bindDelivery`、`detail.preferences`、`detail.onOpenPush`；不提供的能力不会生成空标签。停用只改变本地启用意图，移除才会清除托管凭据并停止收推，两者分别确认。
+
+普通 schema / 网页登录连接使用 `ConfigConnection`，宿主提供表单或登录内容、连接状态及已鉴权的动作回调。`ConnectorDetail` 可组合其他连接方式；动作可通过 `description` 提供菜单中的影响说明；动作类型为 `ConnectorDetailAction`，宿主插槽类型为 `ConnectorDetailOptions`，签名见 [公开 API](public-api.md)。切换连接器或认证身份时按身份重建组件，授权轮询只由连接组件持有。
+
+源码集成时扫描新增的 `ConnectorDetail.tsx` / `ConfigConnection.tsx`、使用的 UI composites；Shadow DOM 宿主沿用 `OverlayRootProvider`。生产集成保留浏览器与 schema 表单的按需加载，不为使用详情而加载整套聊天 UI。
+
+### ConnectorRulesPanel
+
+从 `@blade-hq/agent-react/connectors` 导入 `ConnectorRulesPanel`，传入稳定的 `read` 和 `update` 回调（调用 `client.connectors.rules/updateRules`）。组件展示分组、分类、三档设置与恢复默认；保存成功才替换当前值，失败保留原设置。宿主通过 `className` 与继承主题接入已有样式；`onCountChange` 返回可设置规则组数。详情中的 `compact` 隐藏重复标题，并默认显示第一个业务分类；仍可选择全部及恢复所有分类的默认设置。
+
+连接器宿主可通过 `ConnectorDetailOptions.name` 提供连接器名。飞书待开通权限提醒按连接器名、连接身份与权限集合摘要记忆展开状态；缺失权限归零时清理该连接器的旧记录；直接组合 `ConnectorDetail` 时可用 `noticeStorageKey` 指定本地记忆键。localStorage 不可用时保留内存内交互。

package/dist/SessionPluginConfigForm-7LJ5SUNY.js

@@ -0,0 +1,9 @@
+import {
+  SessionPluginConfigForm
+} from "./chunk-SK43YNRX.js";
+import "./chunk-KHJEIHMJ.js";
+import "./chunk-PR4QN5HX.js";
+export {
+  SessionPluginConfigForm
+};
+//# sourceMappingURL=SessionPluginConfigForm-7LJ5SUNY.js.map

package/dist/SessionPluginConfigForm-7LJ5SUNY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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 同一套算法，不然轻量
-     * 模式下 插件引用的 [n] 角标只能停在纯文本，点不开、也 hover 不出来源。 */
+    sending?: boolean;
     citations?: Record<number, CitationEntry>;
 };
 type MemoryRefsRow = {
@@ -54,6 +52,10 @@ type ContextDividerRow = {
 type LiteRow = {
     type: "background-wakeup";
     key: string;
+} | {
+    type: "pack-event";
+    key: string;
+    title: string;
 } | TextRow | MemoryRefsRow | FollowupRow | HistoricalFeedbackRow | QuestionRow | ToolDescriptionRow | ContextGroupRow | ContextDividerRow;
 export declare function buildLiteRows({ messages, followup, sessionMessages, agentLoops, resultFeedbackByEntry, showContexts, }: {
     messages: ChatMessage[];

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

@@ -1,16 +1,10 @@
-export interface TurnNavItem {
-    id: string;
-    title: string;
-}
+import type { TurnNavItem } from "../hooks/use-turn-navigation";
 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" | "refs" | "topicAssetRefs" | "queueWhenRunning"> {
+export interface ChatSendOptions extends Pick<ChatSendExtras, "thinkingOverride" | "reasoningLevel" | "refs" | "contextAttachments" | "topicAssetRefs" | "queueWhenRunning"> {
     /** 附件实际上传到的会话（首页新建会话时由输入框给出）。 */
     targetSessionId?: string;
     /** 本条消息用的模型；null 表示沿用会话已保存的模型。 */

package/dist/chat/index.d.ts

@@ -27,7 +27,8 @@ export { TextAttachmentPills } from "./TextAttachmentPills";
 export { getFilePreviewName, ToolFilePreviewAction, ToolPreviewAction, resolveAskQuestionState, ToolCallBlock } from "./ToolCallBlock";
 export { ToolUiCard } from "./ToolUiCard";
 export { TurnNavRail } from "./TurnNavRail";
-export type { TurnNavItem } from "./TurnNavRail";
+export { turnLocateChannel, useTurnLocateRequest, useTurnLocateStatus } from "./turn-locate-channel";
+export type { TurnLocateRequest, TurnLocateStatus } from "./turn-locate-channel";
 export { isUserMessage, isErrorMessage, USER_MESSAGE_MARKDOWN_CLASS, UserMessageBubble, ErrorMessageBlock } from "./UserMessageBubble";
 export type { UserChatMessage, ErrorChatMessage } from "./UserMessageBubble";
 export { WorkflowRunBlock } from "./WorkflowRunBlock";
@@ -91,7 +92,7 @@ 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 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/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,13 +9,13 @@ export interface ChatSendExtras {
     model?: string;
     thinkingOverride?: boolean;
     reasoningLevel?: string;
+    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

@@ -64,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[];
@@ -92,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/turn-locate-channel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 跨组件「定位到某条发言」的请求通道。
+ *
+ * 消息列表（MessageList）与右侧脉络面板不在同一棵组件树里，而定位到窗口外
+ * 的历史发言需要 MessageList 内部的虚拟列表状态（isEntryLoaded / revealEntry /
+ * 滚动容器），脉络面板拿不到这些。这里用一个模块级 store 把「点击脉络里的
+ * 某条发言」变成一条带序号的信令，MessageList 监听后在它自己的
+ * useTurnNavigation.selectEntry 里执行完整定位（跨页加载 + 滚动 + 高亮）。
+ *
+ * 与 composer-channels 同一模式：module singleton + 订阅回调，
+ * 不依赖任何宿主 store，SDK 内可复用。
+ */
+export interface TurnLocateRequest {
+    entryId: string;
+    /** 单调递增，避免「同一条发言点两次」或「晚到的旧信号」被误判成新请求。 */
+    seq: number;
+}
+/** 执行侧回传的进度：面板据此显示「正在定位」/失败提示。 */
+export interface TurnLocateStatus {
+    seq: number;
+    entryId: string;
+    state: "pending" | "failed";
+}
+export declare const turnLocateChannel: {
+    getState: () => Record<string, TurnLocateRequest>;
+    getStatus: () => Record<string, TurnLocateStatus>;
+    request(sessionId: string, entryId: string): void;
+    /** 执行侧回传进度；只有最新一次请求的结果会被接受。 */
+    report(sessionId: string, seq: number, state: TurnLocateStatus["state"]): void;
+    /** 定位完成（成功）：清掉进度，面板不再显示「正在定位」。 */
+    clearStatus(sessionId: string, seq: number): void;
+    subscribe(listener: () => void): () => void;
+    /** 某条信令已被消费：同 seq 不再重复定位（避免重新挂载时又跳一次）。 */
+    consume(sessionId: string, seq: number): void;
+    /** 只清进度、不动未消费的请求（列表卸载时用）。 */
+    clearStatusForSession(sessionId: string): void;
+    clearSession(sessionId: string): void;
+    reset(): void;
+};
+/**
+ * 订阅某个会话的定位请求。
+ *
+ * 用「命令式订阅 + useState」而不是 useSyncExternalStore：每条信令都是一次
+ * **一次性事件**（点一下就执行一次），store 里不留状态，消费完立即清空。
+ * useSyncExternalStore 要的是「可重复读取的快照」，在这种事件通道上反而容易
+ * 因为快照被清空/重读而漏掉那一次更新。
+ */
+export declare function useTurnLocateRequest(sessionId: string | null | undefined): TurnLocateRequest | null;
+/**
+ * 订阅某个会话最近一次定位的进度。面板用它显示「正在定位」和失败提示——
+ * 定位实际由消息列表执行，面板自己的 useTurnNavigation 拿不到这份状态。
+ */
+export declare function useTurnLocateStatus(sessionId: string | null | undefined): TurnLocateStatus | null;

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;