@kweaver-ai/chatkit 0.1.16 → 0.1.17

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

@@ -258,6 +258,14 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @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;
     /**
      * 添加 AfSailor 工具类型的消息块
      * 该方法由子类调用，用于在消息中添加 AfSailor 查询结果
@@ -274,6 +282,14 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @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 处理方式一致
@@ -282,6 +298,14 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @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;
     /**
      * 添加默认工具类型的消息块
      * 用于那些没有单独渲染逻辑的通用工具

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

@@ -189,6 +189,14 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         getWhitelistEntry(action: string, jsonPath: string): {
             postProcess?: (assistantMessage: AssistantMessage, content: any, messageId: string) => void;
         } | null;
+        /**
+         * 在流式结束后，将完整的 AssistantMessage 结构一次性应用到指定 ChatMessage：
+         * - 遍历 middle_answer.progress，按顺序调用 appendSkillOrLLMContentToMessage 组装所有工具和 LLM 内容块
+         * - 基于 message.ext 同步 messageContext（相关问题、耗时、Token 等），与历史会话逻辑保持一致
+         *
+         * 作为受保护方法暴露，便于子类在特殊场景下自定义流式结果的应用逻辑。
+         */
+        applyAssistantMessageFromStream(assistantMessage: AssistantMessage, messageId: string): void;
         /**
          * 从 Progress 对象中提取 Web 搜索查询
          * 根据 OpenAPI 规范，搜索数据在 answer.choices[0].message.tool_calls 中

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/chatkit",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "publishConfig": {
     "access": "public"
   },