@kweaver-ai/chatkit 0.1.16 → 0.1.18

package/dist/components/base/ChatKitBase.d.ts

@@ -1,84 +1,84 @@
 import { Component } from 'react';
-import { ChatMessage, ApplicationContext, ChatKitInterface, OnboardingInfo, WebSearchQuery, ExecuteCodeResult, Text2SqlResult, Text2MetricResult, AfSailorResult, DatasourceFilterResult, DatasourceRerankResult, ChartDataSchema, DefaultToolResult, MessageContext } from '../../types';
+import { ChatMessage, ApplicationContext, ChatKitInterface, OnboardingInfo, WebSearchQuery, ExecuteCodeResult, Text2SqlResult, Text2MetricResult, AfSailorResult, DatasourceFilterResult, DatasourceRerankResult, ChartDataSchema, DefaultToolResult, MessageContext, WebProcessorDataSchema } from '../../types';
 /**
- * ChatKitBase 组件的属性接口
+ * ChatKitBase 组件的属性接�?
  */
 export interface ChatKitBaseProps {
     /** 会话 ID，每次新建会话时由后端返回新的会话唯一标识 */
     conversationID?: string;
-    /** 当没有指定的 inputContext 时的默认输入上下文 */
+    /** 当没有指定的 inputContext 时的默认输入上下�?*/
     defaultApplicationContext?: ApplicationContext;
     /** 组件标题 */
     title?: string;
     /** 是否显示组件 */
     visible?: boolean;
-    /** 关闭组件的回调函数 */
+    /** 关闭组件的回调函�?*/
     onClose?: () => void;
     /** 调用接口时携带的令牌，放置到请求头：Authorization:Bearer {token} */
     token?: string;
     /** 刷新 token 的方法，由集成方传入 */
     refreshToken?: () => Promise<string>;
     /**
-     * 初始用户问题。
+     * 初始用户问题�?
      *
-     * - 外层在挂载 Assistant / Copilot 等组件时传入
-     * - 当组件首次可见且当前没有任何消息时，会自动发送该问题并触发问答
+     * - 外层在挂�?Assistant / Copilot 等组件时传入
+     * - 当组件首次可见且当前没有任何消息时，会自动发送该问题并触发问�?
      */
     initialQuestion?: string;
 }
 /**
- * ChatKitBase 组件的状态接口
+ * ChatKitBase 组件的状态接�?
  */
 export interface ChatKitBaseState {
     /** 会话 ID，每次新建会话时由后端返回新的会话唯一标识 */
     conversationID: string;
-    /** 消息列表，这里仅记录渲染到界面上的对话消息 */
+    /** 消息列表，这里仅记录渲染到界面上的对话消�?*/
     messages: ChatMessage[];
-    /** 用户输入的文本 */
+    /** 用户输入的文�?*/
     textInput: string;
-    /** 和用户输入文本相关的上下文 */
+    /** 和用户输入文本相关的上下�?*/
     applicationContext?: ApplicationContext;
-    /** 是否正在发送消息 */
+    /** 是否正在发送消�?*/
     isSending: boolean;
-    /** 当前正在流式更新的消息 ID */
+    /** 当前正在流式更新的消�?ID */
     streamingMessageId: string | null;
-    /** 开场白信息，包含开场白文案和预置问题 */
+    /** 开场白信息，包含开场白文案和预置问�?*/
     onboardingInfo?: OnboardingInfo;
     /** 是否正在加载开场白信息 */
     isLoadingOnboarding: boolean;
 }
 /**
  * ChatKitBase 基础组件
- * AI 对话组件的核心类。该类是一个 React 组件，包含标准的交互界面和交互逻辑。
+ * AI 对话组件的核心类。该类是一�?React 组件，包含标准的交互界面和交互逻辑�?
  *
- * 注意：开发者不能够直接挂载 ChatKitBase 到 Web 应用，而是需要创建一个子类继承
- * ChatKitBase 和 ChatKitInterface，并实现 ChatKitInterface 中定义的方法。
+ * 注意：开发者不能够直接挂载 ChatKitBase �?Web 应用，而是需要创建一个子类继�?
+ * ChatKitBase �?ChatKitInterface，并实现 ChatKitInterface 中定义的方法�?
  *
- * 该类实现了 ChatKitInterface 接口，子类需要实现 sendMessage 和 reduceEventStreamMessage 方法
+ * 该类实现�?ChatKitInterface 接口，子类需要实�?sendMessage �?reduceEventStreamMessage 方法
  */
 export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBaseProps> extends Component<P, ChatKitBaseState> implements ChatKitInterface {
     /**
-     * 标记是否正在初始化或已经初始化
+     * 标记是否正在初始化或已经初始�?
      * 用于防止重复初始化（特别是在 React.StrictMode 下）
      */
     private isInitializing;
     private hasInitialized;
     /**
-     * 会话代数：用于区分「旧会话的流式更新」和「新会话」
-     * 每次清空/新建会话时自增，流式处理只在代数未变化时才继续写入 state
+     * 会话代数：用于区分「旧会话的流式更新」和「新会话�?
+     * 每次清空/新建会话时自增，流式处理只在代数未变化时才继续写�?state
      */
     private conversationSeq;
     /**
-     * 当前流式请求的 AbortController
-     * 子类在发起流式 fetch 时应设置该字段，便于在 handleStop / 新建会话时主动中断连接
+     * 当前流式请求�?AbortController
+     * 子类在发起流�?fetch 时应设置该字段，便于�?handleStop / 新建会话时主动中断连�?
      */
     protected currentStreamController?: AbortController;
     /**
-     * 是否已经根据 initialQuestion 触发过一次自动发送
+     * 是否已经根据 initialQuestion 触发过一次自动发�?
      */
     private hasSentInitialQuestion;
     /**
-     * 流式响应时是否处于「按 chunk 批处理」中，避免同一 chunk 内多行事件触发多次 setState 导致 Maximum update depth exceeded
+     * 流式响应时是否处于「按 chunk 批处理」中，避免同一 chunk 内多行事件触发多�?setState 导致 Maximum update depth exceeded
      */
     private _streamingBatch;
     private _pendingStreamingUpdates;
@@ -92,119 +92,119 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
     protected refreshToken?: () => Promise<string>;
     constructor(props: P);
     /**
-     * 组件挂载后自动创建会话
+     * 组件挂载后自动创建会�?
      * 根据设计文档要求：组件被初始化的时候会自动新建会话
      */
     componentDidMount(): Promise<void>;
     /**
      * 组件更新时检查是否需要初始化会话
-     * 当 visible 从 false 变为 true 时，如果还未初始化，则初始化会话
+     * �?visible �?false 变为 true 时，如果还未初始化，则初始化会话
      */
     componentDidUpdate(prevProps: P): Promise<void>;
     /**
      * 初始化会话的内部方法
-     * 仅在组件首次可见时调用，防止重复初始化
+     * 仅在组件首次可见时调用，防止重复初始�?
      */
     private initializeConversation;
     /**
-     * 根据 props.initialQuestion 在合适的时机自动触发一次问答
+     * 根据 props.initialQuestion 在合适的时机自动触发一次问�?
      *
-     * 触发条件：
-     * - 组件当前处于可见状态（visible !== false）
+     * 触发条件�?
+     * - 组件当前处于可见状态（visible !== false�?
      * - props.initialQuestion 为非空字符串
-     * - 当前还没有任何对话消息（messages.length === 0）
-     * - 仅触发一次（hasSentInitialQuestion 为 false）
+     * - 当前还没有任何对话消息（messages.length === 0�?
+     * - 仅触发一次（hasSentInitialQuestion �?false�?
      */
     private trySendInitialQuestion;
     /**
-     * 获取开场白和预置问题 (抽象方法，由子类实现)
-     * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口
-     * 返回开场白信息结构体
+     * 获取开场白和预置问�?(抽象方法，由子类实现)
+     * 该方法需要由子类继承并重写，以适配扣子、Dify �?LLMOps 平台的接�?
+     * 返回开场白信息结构�?
      * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
-     * @returns 返回开场白信息，包含开场白文案和预置问题
+     * @returns 返回开场白信息，包含开场白文案和预置问�?
      */
     abstract getOnboardingInfo(): Promise<OnboardingInfo>;
     /**
      * 新建会话 (抽象方法，由子类实现)
-     * 该方法需要由开发者实现，以适配扣子、Dify 等 LLMOps 平台的接口
+     * 该方法需要由开发者实现，以适配扣子、Dify �?LLMOps 平台的接�?
      * 成功返回会话 ID
      * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
-     * @param title 会话标题，通常是用户发送的第一条消息内容
+     * @param title 会话标题，通常是用户发送的第一条消息内�?
      * @returns 返回新创建的会话 ID
      */
     abstract generateConversation(title?: string): Promise<string>;
     /**
-     * 向后端发送消息 (抽象方法，由子类实现)
-     * 该方法需要由开发者实现，以适配扣子、Dify等 LLMOps 平台的接口
+     * 向后端发送消�?(抽象方法，由子类实现)
+     * 该方法需要由开发者实现，以适配扣子、Dify�?LLMOps 平台的接�?
      * 发送成功后，返回发送的消息结构
      * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
      * @param text 发送给后端的用户输入的文本
-     * @param ctx 随用户输入文本一起发送的应用上下文
+     * @param ctx 随用户输入文本一起发送的应用上下�?
      * @param conversationID 发送的对话消息所属的会话 ID
      * @returns 返回发送的消息结构
      */
     abstract sendMessage(text: string, ctx: ApplicationContext, conversationID?: string, regenerateMessageId?: string): Promise<ChatMessage>;
     /**
-     * 将 API 接口返回的 EventStream 增量解析成完整的 AssistantMessage 对象 (抽象方法，由子类实现)
+     * �?API 接口返回�?EventStream 增量解析成完整的 AssistantMessage 对象 (抽象方法，由子类实现)
      * 当接收到 SSE 消息时触发，该方法需要由子类实现
-     * 子类在该方法中应该调用以下方法来更新消息内容：
-     * - appendMarkdownBlock(): 添加 Markdown 文本块
-     * - appendWebSearchBlock(): 添加 Web 搜索结果块
-     * - appendExecuteCodeBlock(): 添加代码执行结果块
-     * 注意：该方法应该只处理数据解析逻辑，通过调用 append*Block 方法来更新界面
-     * @param eventMessage 接收到的一条 Event Message
-     * @param prev 上一次增量更新后的 AssistantMessage 对象
-     * @param messageId 当前正在更新的消息 ID，用于调用 append*Block 方法
+     * 子类在该方法中应该调用以下方法来更新消息内容�?
+     * - appendMarkdownBlock(): 添加 Markdown 文本�?
+     * - appendWebSearchBlock(): 添加 Web 搜索结果�?
+     * - appendExecuteCodeBlock(): 添加代码执行结果�?
+     * 注意：该方法应该只处理数据解析逻辑，通过调用 append*Block 方法来更新界�?
+     * @param eventMessage 接收到的一�?Event Message
+     * @param prev 上一次增量更新后�?AssistantMessage 对象
+     * @param messageId 当前正在更新的消�?ID，用于调�?append*Block 方法
      * @returns 返回更新后的 AssistantMessage 对象
      */
     abstract reduceAssistantMessage<T = any, K = any>(eventMessage: T, prev: K, messageId: string): K;
     /**
-     * 检查是否需要刷新 token (抽象方法，由子类实现)
-     * 当发生异常时检查是否需要刷新 token。返回 true 表示需要刷新 token，返回 false 表示无需刷新 token。
-     * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口。
-     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state。
+     * 检查是否需要刷�?token (抽象方法，由子类实现)
+     * 当发生异常时检查是否需要刷�?token。返�?true 表示需要刷�?token，返�?false 表示无需刷新 token�?
+     * 该方法需要由子类继承并重写，以适配扣子、Dify �?LLMOps 平台的接口�?
+     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state�?
      * @param status HTTP 状态码
-     * @param error 错误响应体
-     * @returns 返回是否需要刷新 token
+     * @param error 错误响应�?
+     * @returns 返回是否需要刷�?token
      */
     abstract shouldRefreshToken(status: number, error: any): boolean;
     /**
      * 终止会话 (抽象方法，由子类实现)
-     * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口。
-     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state。
+     * 该方法需要由子类继承并重写，以适配扣子、Dify �?LLMOps 平台的接口�?
+     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state�?
      * @param conversationId 要终止的会话 ID
      * @returns 返回 Promise，成功时 resolve，失败时 reject
      */
     abstract terminateConversation(conversationId: string): Promise<void>;
     /**
      * 获取历史会话列表 (抽象方法，由子类实现)
-     * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口。
-     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state。
+     * 该方法需要由子类继承并重写，以适配扣子、Dify �?LLMOps 平台的接口�?
+     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state�?
      * @param page 分页页码，默认为 1
      * @param size 每页返回条数，默认为 10
      * @returns 返回历史会话列表
      */
     abstract getConversations(page?: number, size?: number): Promise<import('../../types').ConversationHistory[]>;
     /**
-     * 获取指定会话 ID 的对话消息列表 (抽象方法，由子类实现)
-     * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口。
-     * 如果对话消息是 AI 助手消息，则需要调用 reduceAssistantMessage() 解析消息。
-     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state。
+     * 获取指定会话 ID 的对话消息列�?(抽象方法，由子类实现)
+     * 该方法需要由子类继承并重写，以适配扣子、Dify �?LLMOps 平台的接口�?
+     * 如果对话消息�?AI 助手消息，则需要调�?reduceAssistantMessage() 解析消息�?
+     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state�?
      * @param conversationId 会话 ID
      * @returns 返回对话消息列表
      */
     abstract getConversationMessages(conversationId: string): Promise<ChatMessage[]>;
     /**
-     * 删除指定 ID 的会话 (抽象方法，由子类实现)
-     * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口。
-     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state。
+     * 删除指定 ID 的会�?(抽象方法，由子类实现)
+     * 该方法需要由子类继承并重写，以适配扣子、Dify �?LLMOps 平台的接口�?
+     * 注意：该方法是一个无状态无副作用的函数，不允许修改 state�?
      * @param conversationID 会话 ID
      * @returns 返回 Promise，成功时 resolve，失败时 reject
      */
     abstract deleteConversation(conversationID: string): Promise<void>;
     /**
-     * 向 ChatKit 注入应用上下文
-     * @param ctx 要注入的应用上下文
+     * �?ChatKit 注入应用上下�?
+     * @param ctx 要注入的应用上下�?
      */
     injectApplicationContext: (ctx: ApplicationContext) => void;
     /**
@@ -212,100 +212,132 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      */
     removeApplicationContext: () => void;
     /**
-     * 添加或更新 Markdown 类型的消息块
-     * 该方法由子类调用，用于在消息中添加或更新 Markdown 内容块
-     * 如果最后一个块是 Markdown 块且内容为空或是 text 的前缀，则更新它（流式更新场景）
+     * 添加或更�?Markdown 类型的消息块
+     * 该方法由子类调用，用于在消息中添加或更新 Markdown 内容�?
+     * 如果最后一个块�?Markdown 块且内容为空或是 text 的前缀，则更新它（流式更新场景�?
      * 否则添加新的 Markdown 块（新阶段场景）
      * @param messageId 消息 ID
-     * @param text 要添加或更新的 Markdown 文本，每次都传完整的文本
+     * @param text 要添加或更新�?Markdown 文本，每次都传完整的文本
      */
     protected appendMarkdownBlock(messageId: string, text: string): void;
     /**
      * 添加 Web 搜索类型的消息块
-     * 该方法由子类调用，用于在消息中添加 Web 搜索结果
+     * 该方法由子类调用，用于在消息中添�?Web 搜索结果
      * @param messageId 消息 ID
-     * @param query Web 搜索的执行详情
+     * @param query Web 搜索的执行详�?
      */
     protected appendWebSearchBlock(messageId: string, query: WebSearchQuery): void;
     /**
      * 添加代码执行工具类型的消息块
-     * 该方法由子类调用，用于在消息中添加代码执行结果
+     * 该方法由子类调用，用于在消息中添加代码执行结�?
      * @param messageId 消息 ID
      * @param result 代码执行的输入和输出结果
      */
     protected appendExecuteCodeBlock(messageId: string, result: ExecuteCodeResult, consumeTime?: number): void;
     /**
      * 添加 Text2SQL 工具类型的消息块
-     * 该方法由子类调用，用于在消息中添加 Text2SQL 查询结果
+     * 该方法由子类调用，用于在消息中添�?Text2SQL 查询结果
      * @param messageId 消息 ID
      * @param result Text2SQL 的输入和输出结果
-     * @param consumeTime 耗时（毫秒），可选
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendText2SqlBlock(messageId: string, result: Text2SqlResult, consumeTime?: number): void;
     /**
      * 添加 Text2Metric 工具类型的消息块
-     * 该方法由子类调用，用于在消息中添加 Text2Metric 查询结果
+     * 该方法由子类调用，用于在消息中添�?Text2Metric 查询结果
      * @param messageId 消息 ID
      * @param result Text2Metric 的输入和输出结果
-     * @param consumeTime 耗时（毫秒），可选
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendText2MetricBlock(messageId: string, result: Text2MetricResult, consumeTime?: number): void;
     /**
      * 添加 JSON2Plot 图表类型的消息块
-     * 该方法由子类调用，用于在消息中添加 JSON2Plot 图表数据
+     * 该方法由子类调用，用于在消息中添�?JSON2Plot 图表数据
      * @param messageId 消息 ID
      * @param chartData 图表数据 Schema
-     * @param consumeTime 耗时（毫秒），可选
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendJson2PlotBlock(messageId: string, chartData: ChartDataSchema, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一�?JSON2Plot 图表块的内容（用于流式工�?json2plot 的组装）
+     * 如果不存�?JSON2Plot 块，则在流式更新时创建一个新的图表块
+     * @param messageId 消息 ID
+     * @param chartData 最新的图表数据 Schema
+     * @param consumeTime 耗时（毫秒），可�?
+     */
+    protected updateJson2PlotBlock(messageId: string, chartData: ChartDataSchema, consumeTime?: number): void;
+    /**
+     * 添加 WebProcessor 页面预览类型的消息块
+     */
+    protected appendWebProcessorBlock(messageId: string, data: WebProcessorDataSchema, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一�?WebProcessor �?
+     */
+    protected updateWebProcessorBlock(messageId: string, data: WebProcessorDataSchema, consumeTime?: number): void;
     /**
      * 添加 AfSailor 工具类型的消息块
-     * 该方法由子类调用，用于在消息中添加 AfSailor 查询结果
+     * 该方法由子类调用，用于在消息中添�?AfSailor 查询结果
      * @param messageId 消息 ID
      * @param result AfSailor 的输入和输出结果
-     * @param consumeTime 耗时（毫秒），可选
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendAfSailorBlock(messageId: string, result: AfSailorResult, consumeTime?: number): void;
     /**
      * 添加 DatasourceFilter 工具类型的消息块
-     * 该方法由子类调用，用于在消息中添加 DatasourceFilter 查询结果
+     * 该方法由子类调用，用于在消息中添�?DatasourceFilter 查询结果
      * @param messageId 消息 ID
      * @param result DatasourceFilter 的输入和输出结果
-     * @param consumeTime 耗时（毫秒），可选
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendDatasourceFilterBlock(messageId: string, result: DatasourceFilterResult, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一�?DatasourceFilter 工具块的内容（用于流式工�?datasource_filter 的组装）
+     * 如果不存�?DatasourceFilter 块，则在流式更新时创建一个新的工具块
+     * @param messageId 消息 ID
+     * @param result 最新的 DatasourceFilterResult
+     * @param consumeTime 耗时（毫秒），可�?
+     */
+    protected updateDatasourceFilterBlock(messageId: string, result: DatasourceFilterResult, consumeTime?: number): void;
     /**
      * 添加 DatasourceRerank 工具类型的消息块
-     * 该方法由子类调用，用于在消息中添加 DatasourceRerank 查询结果，与 datasource_filter 处理方式一致
+     * 该方法由子类调用，用于在消息中添�?DatasourceRerank 查询结果，与 datasource_filter 处理方式一�?
      * @param messageId 消息 ID
      * @param result DatasourceRerank 的输入和输出结果
-     * @param consumeTime 耗时（毫秒），可选
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendDatasourceRerankBlock(messageId: string, result: DatasourceRerankResult, consumeTime?: number): void;
+    /**
+     * 更新指定消息中最后一�?DatasourceRerank 工具块的内容（用于流式工�?datasource_rerank 的组装）
+     * 如果不存�?DatasourceRerank 块，则在流式更新时创建一个新的工具块
+     * @param messageId 消息 ID
+     * @param result 最新的 DatasourceRerankResult
+     * @param consumeTime 耗时（毫秒），可�?
+     */
+    protected updateDatasourceRerankBlock(messageId: string, result: DatasourceRerankResult, consumeTime?: number): void;
     /**
      * 添加默认工具类型的消息块
      * 用于那些没有单独渲染逻辑的通用工具
      * @param messageId 消息 ID
-     * @param toolName 工具名称（skill_name）
-     * @param result 默认工具的输入输出结果
-     * @param consumeTime 耗时（毫秒），可选
+     * @param toolName 工具名称（skill_name�?
+     * @param result 默认工具的输入输出结�?
+     * @param consumeTime 耗时（毫秒），可�?
      */
     protected appendDefaultToolBlock(messageId: string, toolName: string, result: DefaultToolResult, consumeTime?: number): void;
     /**
-     * 更新指定消息的 messageContext（合并更新）
-     * 用于在流式过程中或流结束时写入相关问题、耗时、Token 等辅助信息
+     * 更新指定消息�?messageContext（合并更新）
+     * 用于在流式过程中或流结束时写入相关问题、耗时、Token 等辅助信�?
      */
     protected updateMessageContext(messageId: string, patch: Partial<MessageContext>): void;
     /**
-     * 流式期间将状态更新入队，在 handleStreamResponse 每 chunk 结束时统一 flush，避免同一 chunk 内多行事件导致多次 setState 触发 Maximum update depth exceeded
+     * 流式期间将状态更新入队，�?handleStreamResponse �?chunk 结束时统一 flush，避免同一 chunk 内多行事件导致多�?setState 触发 Maximum update depth exceeded
      */
     protected applyStreamingUpdate(updater: (prev: ChatKitBaseState) => Partial<ChatKitBaseState>): void;
     /**
-     * 将当前批内的所有流式更新合并为一次 setState 执行
+     * 将当前批内的所有流式更新合并为一�?setState 执行
      */
     protected flushStreamingUpdates(): void;
     /**
-     * 更新指定工具名称对应的最后一个工具块的结果（用于流式工具如 contextloader_data_enhanced 的组装）
+     * 更新指定工具名称对应的最后一个工具块的结果（用于流式工具�?contextloader_data_enhanced 的组装）
      * @param messageId 消息 ID
      * @param toolName 工具名称
      * @param result 更新后的默认工具结果
@@ -313,7 +345,7 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
     protected updateDefaultToolBlockResult(messageId: string, toolName: string, result: DefaultToolResult): void;
     /**
      * 创建新的会话
-     * 内部会调用子类实现的 generateConversation() 和 getOnboardingInfo() 方法
+     * 内部会调用子类实现的 generateConversation() �?getOnboardingInfo() 方法
      */
     createConversation: () => Promise<void>;
     /**
@@ -323,38 +355,38 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      */
     loadConversation: (conversationId: string) => Promise<void>;
     /**
-     * 清除会话中的对话消息及会话 ID
+     * 清除会话中的对话消息及会�?ID
      */
     private clearConversation;
     /**
      * 发送消息的核心方法
      * 该方法是暴露给集成方进行调用的接口，内部会调用子类实现的 sendMessage() 方法
-     * @param text 用户输入的文本
-     * @param ctx 应用上下文
+     * @param text 用户输入的文�?
+     * @param ctx 应用上下�?
      * @param conversationID 发送的对话消息所属的会话 ID（可选）
      * @returns 返回发送的消息结构
      */
     send: (text: string, ctx?: ApplicationContext, conversationID?: string, regenerateMessageId?: string) => Promise<ChatMessage>;
     /**
      * 处理流式响应
-     * 在闭包中处理 EventStream,并在处理完成后丢弃闭包
+     * 在闭包中处理 EventStream,并在处理完成后丢弃闭�?
      * @param reader ReadableStreamDefaultReader
      * @param assistantMessageId 助手消息 ID
      */
     protected handleStreamResponse<T = any>(reader: ReadableStreamDefaultReader<Uint8Array>, assistantMessageId: string): Promise<T>;
     /**
-     * 执行 API 调用，并在需要时自动刷新 token 并重试一次
+     * 执行 API 调用，并在需要时自动刷新 token 并重试一�?
      * @param apiCall API 调用函数
      * @returns API 调用结果
      */
     protected executeWithTokenRefresh<T>(apiCall: () => Promise<T>): Promise<T>;
     /**
-     * 处理发送按钮点击
+     * 处理发送按钮点�?
      */
     protected handleSend: () => Promise<void>;
     /**
      * 处理停止流式响应
-     * 调用子类实现的 terminateConversation 方法终止当前会话
+     * 调用子类实现�?terminateConversation 方法终止当前会话
      */
     protected handleStop: () => Promise<void>;
     /**
@@ -368,7 +400,7 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
     /**
      * 渲染组件 (抽象方法，由子类实现)
      * 子类需要实现该方法以渲染不同的界面
-     * CopilotBase 和 AssistantBase 会分别实现各自的渲染逻辑
+     * CopilotBase �?AssistantBase 会分别实现各自的渲染逻辑
      */
     abstract render(): React.ReactNode;
 }

package/dist/components/base/assistant/HistoryChunkPlaceholder.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface HistoryChunkPlaceholderProps {
+    /** 此占位块包含的消息条数，用于展示提示文案 */
+    messageCount: number;
+    /** 点击展开该历史段 */
+    onExpand: () => void;
+}
+/**
+ * 历史段占位块
+ * - 用于折叠更早的历史记录，减少真实 DOM 数量
+ */
+declare const HistoryChunkPlaceholder: React.FC<HistoryChunkPlaceholderProps>;
+export default HistoryChunkPlaceholder;

package/dist/components/base/assistant/InputArea.d.ts

@@ -8,8 +8,8 @@ interface InputAreaProps {
     value: string;
     /** 输入框值变化的回调 */
     onChange: (value: string) => void;
-    /** 发送消息的回调 */
-    onSend: () => void;
+    /** 发送消息的回调（支持异步） */
+    onSend: () => void | Promise<void>;
     /** 当前的应用上下文 */
     context?: ApplicationContext;
     /** 移除上下文的回调 */

package/dist/components/base/assistant/MessageShell.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface MessageShellProps {
+    messageId: string;
+    onHeightChange?: (messageId: string, height: number) => void;
+    className?: string;
+    children: React.ReactNode;
+}
+/**
+ * MessageShell
+ * - 包裹单条消息，负责通过 ResizeObserver 上报真实高度
+ * - 不关心消息内容与交互本身
+ */
+declare const MessageShell: React.FC<MessageShellProps>;
+export default MessageShell;

package/dist/components/base/assistant/blocks/index.d.ts

@@ -8,5 +8,6 @@ export { default as WebSearchBlock } from './WebSearchBlock';
 export { default as ToolBlock } from './ToolBlock';
 export { default as ToolDrawer } from './ToolDrawer';
 export { default as Json2PlotBlock } from './Json2PlotBlock';
+export { default as WebProcessorBlock } from '../../shared/blocks/WebProcessorBlock';
 export { CodeViewTool } from './CodeViewTool';
 export type { CodeViewToolProps } from './CodeViewTool';

package/dist/components/base/assistant/hooks/useAnchoredMessageList.d.ts

@@ -0,0 +1,23 @@
+import type React from 'react';
+export interface ScrollAnchor {
+    messageId: string;
+    offset: number;
+}
+export interface UseAnchoredMessageListOptions {
+    /** 消息按从上到下的顺序排列，用于根据高度表计算偏移（仅包含当前真实渲染的消息 ID） */
+    getOrderedMessageIds: () => string[];
+    /** 是否启用锚点恢复（例如在不贴底时才启用） */
+    shouldUseAnchor?: () => boolean;
+}
+export interface UseAnchoredMessageListResult {
+    handleMessageHeightChange: (messageId: string, height: number) => void;
+    handleScroll: (e: React.UIEvent<HTMLDivElement>) => void;
+    registerScrollContainer: (el: HTMLDivElement | null) => void;
+    restoreScrollByAnchor: () => void;
+}
+/**
+ * 管理消息高度表与滚动锚点的 Hook
+ * - 使用 ResizeObserver 上报的高度增量，结合锚点信息，在高度变化或上方插入消息时做滚动修正
+ * - 内部使用 requestAnimationFrame 合并一帧内的多次高度变更，避免频繁 reflow
+ */
+export declare function useAnchoredMessageList(options: UseAnchoredMessageListOptions): UseAnchoredMessageListResult;

package/dist/components/base/copilot/blocks/index.d.ts

@@ -7,3 +7,4 @@ export { default as MarkdownBlock } from './MarkdownBlock';
 export { default as WebSearchBlock } from './WebSearchBlock';
 export { default as ToolBlock } from './ToolBlock';
 export { default as ToolDrawer } from './ToolDrawer';
+export { default as WebProcessorBlock } from '../../shared/blocks/WebProcessorBlock';

package/dist/components/base/shared/blocks/WebProcessorBlock/WebProcessorContentView.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { WebProcessorDataSchema } from '../../../../../types';
+export interface WebProcessorContentViewProps {
+    data: WebProcessorDataSchema;
+    onZoom: () => void;
+    onOpenNewWindow: () => void;
+}
+declare const WebProcessorContentView: React.FC<WebProcessorContentViewProps>;
+export default WebProcessorContentView;

package/dist/components/base/shared/blocks/WebProcessorBlock/WebProcessorIframe.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { WebProcessorDataSchema } from '../../../../../types';
+export interface WebProcessorIframeProps {
+    data: WebProcessorDataSchema;
+    mode?: 'chat' | 'modal';
+}
+declare const WebProcessorIframe: React.FC<WebProcessorIframeProps>;
+export default WebProcessorIframe;

package/dist/components/base/shared/blocks/WebProcessorBlock/WebProcessorModal.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { WebProcessorDataSchema } from '../../../../../types';
+export interface WebProcessorModalProps {
+    open: boolean;
+    data: WebProcessorDataSchema;
+    onClose: () => void;
+    onOpenNewWindow: () => void;
+}
+declare const WebProcessorModal: React.FC<WebProcessorModalProps>;
+export default WebProcessorModal;

package/dist/components/base/shared/blocks/WebProcessorBlock/index.d.ts

@@ -0,0 +1,9 @@
+export { default } from '../WebProcessorBlock';
+export type { WebProcessorBlockProps } from '../WebProcessorBlock';
+export { default as WebProcessorContentView } from './WebProcessorContentView';
+export type { WebProcessorContentViewProps } from './WebProcessorContentView';
+export { default as WebProcessorModal } from './WebProcessorModal';
+export type { WebProcessorModalProps } from './WebProcessorModal';
+export { default as WebProcessorIframe } from './WebProcessorIframe';
+export type { WebProcessorIframeProps } from './WebProcessorIframe';
+export { buildEmbedUrl, getSafeWebProcessorUrl } from './utils';

package/dist/components/base/shared/blocks/WebProcessorBlock/utils.d.ts

@@ -0,0 +1,6 @@
+import type { WebProcessorDataSchema } from '../../../../../types';
+export declare function getSafeWebProcessorUrl(url?: string): URL | null;
+export declare function buildEmbedUrl(url?: string): string | null;
+export declare function getWebProcessorTitle(data: WebProcessorDataSchema): string;
+export declare function getWebProcessorDisplayUrl(url?: string): string;
+export declare function getWebProcessorHeight(data: WebProcessorDataSchema, mode: 'chat' | 'modal'): string;

package/dist/components/base/shared/blocks/WebProcessorBlock.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { WebProcessorBlock as WebProcessorBlockType } from '../../../../types';
+export interface WebProcessorBlockProps {
+    block: WebProcessorBlockType;
+}
+declare const WebProcessorBlock: React.FC<WebProcessorBlockProps>;
+export default WebProcessorBlock;