@kweaver-ai/chatkit 0.1.1 → 0.1.2

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

@@ -1,5 +1,5 @@
 import { Component } from 'react';
-import { ChatMessage, ApplicationContext, ChatKitInterface, OnboardingInfo, WebSearchQuery, ExecuteCodeResult } from '../../types';
+import { ChatMessage, ApplicationContext, ChatKitInterface, OnboardingInfo, WebSearchQuery, ExecuteCodeResult, Text2SqlResult, ChartDataSchema } from '../../types';
 /**
  * ChatKitBase 组件的属性接口
  */
@@ -93,9 +93,10 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * 该方法需要由开发者实现，以适配扣子、Dify 等 LLMOps 平台的接口
      * 成功返回会话 ID
      * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
+     * @param title 会话标题，通常是用户发送的第一条消息内容
      * @returns 返回新创建的会话 ID
      */
-    abstract generateConversation(): Promise<string>;
+    abstract generateConversation(title?: string): Promise<string>;
     /**
      * 向后端发送消息 (抽象方法，由子类实现)
      * 该方法需要由开发者实现，以适配扣子、Dify等 LLMOps 平台的接口
@@ -197,6 +198,20 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * @param result 代码执行的输入和输出结果
      */
     protected appendExecuteCodeBlock(messageId: string, result: ExecuteCodeResult): void;
+    /**
+     * 添加 Text2SQL 工具类型的消息块
+     * 该方法由子类调用，用于在消息中添加 Text2SQL 查询结果
+     * @param messageId 消息 ID
+     * @param result Text2SQL 的输入和输出结果
+     */
+    protected appendText2SqlBlock(messageId: string, result: Text2SqlResult): void;
+    /**
+    * 添加 JSON2Plot 图表类型的消息块
+    * 该方法由子类调用，用于在消息中添加 JSON2Plot 图表数据
+    * @param messageId 消息 ID
+    * @param chartData 图表数据 Schema
+    */
+    protected appendJson2PlotBlock(messageId: string, chartData: ChartDataSchema): void;
     /**
      * 创建新的会话
      * 内部会调用子类实现的 generateConversation() 和 getOnboardingInfo() 方法

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

@@ -1,13 +1,56 @@
-import { ChatKitBase, ChatKitBaseProps } from '../ChatKitBase';
+import { ChatKitBase, ChatKitBaseProps, ChatKitBaseState } from '../ChatKitBase';
+/**
+ * AssistantBase 组件的属性接口
+ * 扩展 ChatKitBaseProps，添加历史对话相关配置
+ */
+export interface AssistantBaseProps extends ChatKitBaseProps {
+    /** 是否启用历史对话功能，默认为 true */
+    enableHistory?: boolean;
+}
+/**
+ * AssistantBase 组件的状态接口
+ * 扩展 ChatKitBaseState，添加历史对话显示状态
+ */
+export interface AssistantBaseState extends ChatKitBaseState {
+    showHistory: boolean;
+}
 /**
  * AssistantBase 基础组件
  * 作为主交互入口，是应用的主体
  *
  * 该类继承自 ChatKitBase，实现了 Assistant 模式的交互界面和交互逻辑
- * 区别于 CopilotBase，AssistantBase 是全屏主对话界面，不包含 Header
- * Header（历史对话、新对话等按钮）应由外部应用的侧边栏提供
+ * 区别于 CopilotBase，AssistantBase 是全屏主对话界面，包含 Header 和历史对话功能
  */
-export declare abstract class AssistantBase<P extends ChatKitBaseProps = ChatKitBaseProps> extends ChatKitBase<P> {
+export declare abstract class AssistantBase<P extends AssistantBaseProps = AssistantBaseProps> extends ChatKitBase<P> {
+    /**
+     * 组件状态，包含历史对话显示状态
+     */
+    state: AssistantBaseState;
+    constructor(props: P);
+    /**
+     * 处理查看历史对话
+     */
+    handleHistory: () => void;
+    /**
+     * 处理关闭历史对话列表
+     */
+    handleCloseHistory: () => void;
+    /**
+     * 处理新建对话
+     */
+    handleNewChat: () => void;
+    /**
+     * 处理加载指定会话
+     */
+    handleLoadConversation: (conversationId: string) => Promise<void>;
+    /**
+     * 处理删除指定会话
+     */
+    handleDeleteConversation: (conversationId: string) => Promise<void>;
+    /**
+     * 处理获取历史会话列表
+     */
+    handleGetConversations: (page?: number, size?: number) => Promise<import("../../..").ConversationHistory[]>;
     /**
      * 实现 React.Component.render() 方法
      * 渲染 Assistant 模式的界面

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

@@ -0,0 +1,26 @@
+import React from 'react';
+import { ConversationHistory as ConversationHistoryType } from '../../../types';
+/**
+ * 历史会话列表组件的属性接口
+ */
+interface ConversationHistoryProps {
+    /** 是否显示历史会话列表 */
+    visible: boolean;
+    /** 关闭历史会话列表的回调函数 */
+    onClose: () => void;
+    /** 获取历史会话列表的函数 */
+    onGetConversations: (page?: number, size?: number) => Promise<ConversationHistoryType[]>;
+    /** 加载指定会话的回调函数 */
+    onLoadConversation: (conversationId: string) => void;
+    /** 删除指定会话的回调函数 */
+    onDeleteConversation: (conversationId: string) => Promise<void>;
+    /** Agent Name (agent 名称) */
+    agentName?: string;
+}
+/**
+ * 历史会话列表组件
+ * 右侧滑出面板，展示用户的历史会话记录，支持加载和删除操作
+ * 设计参考：https://www.figma.com/design/AnGlsx50RkpJgY9irtMtwr/chatkit-max?node-id=14-1901
+ */
+export declare const ConversationHistory: React.FC<ConversationHistoryProps>;
+export default ConversationHistory;

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

@@ -6,6 +6,8 @@ import { ChatMessage } from '../../../types';
 interface MessageItemProps {
     /** 消息对象 */
     message: ChatMessage;
+    /** 是否正在流式更新 */
+    isStreaming?: boolean;
 }
 /**
  * MessageItem 组件

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

@@ -6,6 +6,8 @@ import { ChatMessage } from '../../../types';
 interface MessageListProps {
     /** 消息列表 */
     messages: ChatMessage[];
+    /** 当前正在流式更新的消息 ID */
+    streamingMessageId?: string | null;
 }
 /**
  * MessageList 组件

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

@@ -3,6 +3,8 @@ import React from 'react';
  * Prologue 组件的属性接口
  */
 interface PrologueProps {
+    /** Agent 信息 */
+    agentInfo?: any;
     /** 点击推荐问题时的回调函数 */
     onQuestionClick?: (question: string) => void;
     /** 开场白文案 */

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

@@ -0,0 +1,22 @@
+import React from 'react';
+/**
+ * CodeViewTool 组件的属性接口
+ */
+export interface CodeViewToolProps {
+    /** 代码内容 */
+    code: string;
+    /** 代码语言类型（python、sql、javascript等） */
+    language?: string;
+    /** 编辑器宽度 */
+    width?: string | number;
+    /** 编辑器高度 */
+    height?: string | number;
+    /** 自定义样式类名 */
+    className?: string;
+}
+/**
+ * CodeViewTool 组件
+ * 用于在 ToolDrawer 中展示代码（Python、SQL等）的代码查看组件
+ */
+declare const CodeViewTool: React.FC<CodeViewToolProps>;
+export default CodeViewTool;

package/dist/components/base/assistant/blocks/CodeViewTool/SqlFormatter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SQL 格式化选项
+ */
+export interface SqlFormatOptions {
+    /** 缩进字符，默认为2个空格 */
+    indent?: string;
+    /** 是否大写关键字，默认为true */
+    uppercase?: boolean;
+    /** SQL 语言类型，默认为 'sql' */
+    language?: string;
+}
+/**
+ * 格式化 SQL 代码
+ *
+ * @param sql - 需要格式化的 SQL 代码
+ * @param options - 格式化选项
+ * @returns 格式化后的 SQL 代码，格式化失败时返回原始代码
+ *
+ * @example
+ * ```typescript
+ * const formatted = formatSql('SELECT * FROM users WHERE id=1');
+ * ```
+ */
+export declare const formatSql: (sql: string, options?: SqlFormatOptions) => string;

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

@@ -0,0 +1,4 @@
+export { default as CodeViewTool } from './CodeViewTool';
+export type { CodeViewToolProps } from './CodeViewTool';
+export { formatSql } from './SqlFormatter';
+export type { SqlFormatOptions } from './SqlFormatter';

package/dist/components/base/assistant/blocks/Json2PlotBlock/EChartsView.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ChartDataSchema, ChartType } from '../../../../../types';
+/**
+ * EChartsView 组件的属性接口
+ */
+export interface EChartsViewProps {
+    /** 图表数据 Schema */
+    data: ChartDataSchema;
+    /** 图表类型 */
+    chartType: ChartType;
+    /** 图表宽度 */
+    width?: string | number;
+    /** 图表高度 */
+    height?: string | number;
+    /** 是否可点击（用于打开弹窗） */
+    clickable?: boolean;
+    /** 点击回调 */
+    onClick?: () => void;
+}
+/**
+ * EChartsView 组件
+ * 纯图表渲染组件，负责使用 ECharts 渲染图表
+ */
+declare const EChartsView: React.FC<EChartsViewProps>;
+export default EChartsView;

package/dist/components/base/assistant/blocks/Json2PlotBlock/Json2PlotContentView.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { ChartDataSchema } from '../../../../../types';
+/**
+ * Json2PlotContentView 组件的属性接口
+ */
+export interface Json2PlotContentViewProps {
+    /** 图表数据 Schema */
+    data: ChartDataSchema;
+    /** 图表宽度 */
+    width?: string | number;
+    /** 图表高度 */
+    height?: string | number;
+    /** 点击图表回调（用于打开弹窗） */
+    onChartClick?: () => void;
+}
+/**
+ * Json2PlotContentView 组件
+ * 包含标题栏和内容区域，整合 EChartsView 和 TableView
+ */
+declare const Json2PlotContentView: React.FC<Json2PlotContentViewProps>;
+export default Json2PlotContentView;

package/dist/components/base/assistant/blocks/Json2PlotBlock/Json2PlotModal.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { ChartDataSchema, ChartType } from '../../../../../types';
+/**
+ * Json2PlotModal 组件的属性接口
+ */
+export interface Json2PlotModalProps {
+    /** 是否显示弹窗 */
+    open: boolean;
+    /** 关闭弹窗回调 */
+    onClose: () => void;
+    /** 图表数据 Schema */
+    data: ChartDataSchema;
+    /** 初始视图类型：'table' 或图表类型 */
+    initialViewType?: 'table' | ChartType;
+}
+/**
+ * Json2PlotModal 组件
+ * 弹窗组件，包含菜单栏和内容区域，整合 EChartsView 和 TableView
+ */
+declare const Json2PlotModal: React.FC<Json2PlotModalProps>;
+export default Json2PlotModal;

package/dist/components/base/assistant/blocks/Json2PlotBlock/TableView.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { ChartDataSchema } from '../../../../../types';
+/**
+ * TableView 组件的属性接口
+ */
+export interface TableViewProps {
+    /** 图表数据 Schema */
+    data: ChartDataSchema;
+    /** 表格最大高度 */
+    maxHeight?: string | number;
+    /** 是否启用分页，默认 false */
+    pagination?: boolean;
+    /** 每页显示条数，默认 10 */
+    pageSize?: number;
+}
+/**
+ * TableView 组件
+ * 纯表格渲染组件，负责渲染数据表格
+ */
+declare const TableView: React.FC<TableViewProps>;
+export default TableView;

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

@@ -0,0 +1,9 @@
+/**
+ * Json2PlotBlock 组件导出文件
+ */
+export { default as EChartsView } from './EChartsView';
+export { default as TableView } from './TableView';
+export { default as Json2PlotModal } from './Json2PlotModal';
+export type { EChartsViewProps } from './EChartsView';
+export type { TableViewProps } from './TableView';
+export type { Json2PlotModalProps } from './Json2PlotModal';

package/dist/components/base/assistant/blocks/Json2PlotBlock/utils.d.ts

@@ -0,0 +1,14 @@
+import type { EChartsOption } from 'echarts';
+import { ChartDataSchema, ChartType } from '../../../../../types';
+/**
+ * 格式化日期
+ */
+export declare function formatDate(value: any): string;
+/**
+ * 验证数据是否可以转换为指定图表类型
+ */
+export declare function validateChartType(data: ChartDataSchema, targetType: ChartType): string | null;
+/**
+ * 转换 ChartDataSchema 到 ECharts Option
+ */
+export declare function convertToEChartsOption(data: ChartDataSchema, chartType: ChartType): EChartsOption | null;

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import { Json2PlotBlock as Json2PlotBlockType } from '../../../../types';
+/**
+ * Json2PlotBlock 组件的属性接口
+ */
+export interface Json2PlotBlockProps {
+    /** JSON2Plot 图表块数据 */
+    block: Json2PlotBlockType;
+    /** 图表宽度 */
+    width?: string | number;
+    /** 图表高度 */
+    height?: string | number;
+}
+/**
+ * Json2PlotBlock 组件
+ * 主组件，包含标题栏和菜单栏，整合 EChartsView 和 TableView
+ */
+declare const Json2PlotBlock: React.FC<Json2PlotBlockProps>;
+export default Json2PlotBlock;
+export { Json2PlotBlock };

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

@@ -6,6 +6,10 @@ import { MarkdownBlock as MarkdownBlockType } from '../../../../types';
 export interface MarkdownBlockProps {
     /** Markdown 块数据 */
     block: MarkdownBlockType;
+    /** 基础字号，单位 px，默认为 14 */
+    fontSize?: number;
+    /** 基础字体颜色，默认为 rgba(0, 0, 0, 0.85) */
+    fontColor?: string;
 }
 /**
  * MarkdownBlock 组件

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

@@ -7,3 +7,6 @@ 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 Json2PlotBlock } from './Json2PlotBlock';
+export { CodeViewTool } from './CodeViewTool';
+export type { CodeViewToolProps } from './CodeViewTool';

package/dist/components/base/copilot/MessageItem.d.ts

@@ -6,6 +6,8 @@ import { ChatMessage } from '../../../types';
 interface MessageItemProps {
     /** 消息对象 */
     message: ChatMessage;
+    /** 是否正在流式更新 */
+    isStreaming?: boolean;
 }
 /**
  * MessageItem 组件

package/dist/components/base/copilot/MessageList.d.ts

@@ -6,6 +6,8 @@ import { ChatMessage } from '../../../types';
 interface MessageListProps {
     /** 消息列表 */
     messages: ChatMessage[];
+    /** 当前正在流式更新的消息 ID */
+    streamingMessageId?: string | null;
 }
 /**
  * MessageList 组件

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

@@ -6,6 +6,10 @@ import { MarkdownBlock as MarkdownBlockType } from '../../../../types';
 export interface MarkdownBlockProps {
     /** Markdown 块数据 */
     block: MarkdownBlockType;
+    /** 基础字号，单位 px，默认为 14 */
+    fontSize?: number;
+    /** 基础字体颜色，默认为 rgba(0, 0, 0, 0.85) */
+    fontColor?: string;
 }
 /**
  * MarkdownBlock 组件

package/dist/components/dip/DIPBase.d.ts

@@ -1,4 +1,4 @@
-import { ApplicationContext, ChatMessage, OnboardingInfo, WebSearchQuery, ConversationHistory } from '../../types';
+import { ApplicationContext, ChatMessage, OnboardingInfo, WebSearchQuery, ChartDataSchema, ConversationHistory } from '../../types';
 import { Constructor } from '../../utils/mixins';
 /**
  * DIP 的 AssistantMessage 接口
@@ -10,13 +10,6 @@ interface AssistantMessage {
         conversation_id?: string;
         role?: string;
         content?: {
-            final_answer?: {
-                thinking?: string;
-                answer?: {
-                    text?: string;
-                };
-                answer_type_other?: OtherTypeAnswer;
-            };
             middle_answer?: {
                 progress?: Progress[];
             };
@@ -71,8 +64,8 @@ interface EventMessage {
  * DIPBase 的 props 接口
  */
 export interface DIPBaseProps {
-    /** AISHU DIP 的 Agent ID,用作路径参数 */
-    agentId: string;
+    /** AISHU DIP 的 Agent Key,用作路径参数 */
+    agentKey: string;
     /** 访问令牌,需要包含 Bearer 前缀 (已废弃，请使用 token 属性) */
     bearerToken?: string;
     /** 服务端基础地址,应包含 /api/agent-app/v1 前缀 */
@@ -106,8 +99,10 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
         /** 服务端基础地址 */
         dipBaseUrl: string;
-        /** Agent ID */
-        dipId: string;
+        /** Agent Key (agent 标识) */
+        dipKey: string;
+        /** Agent 信息 */
+        agentInfo: any;
         /** agent 版本 */
         dipVersion: string;
         /** 智能体执行引擎版本 */
@@ -121,7 +116,7 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         /**
          * 获取开场白和预置问题
          * 调用 AISHU DIP 的 agent-factory API 获取智能体配置信息，提取开场白和预置问题
-         * API 端点: GET /api/agent-factory/v3/agent-market/agent/{agent_id}/version/v0
+         * API 端点: GET /api/agent-factory/v3/agent-market/agent/{agent_key}/version/v0
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @returns 返回开场白信息，包含开场白文案和预置问题
          */
@@ -129,11 +124,12 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         /**
          * 创建新的会话
          * 调用 DIP API 创建新的会话，返回会话 ID
-         * API 端点: POST /app/{agent_id}/conversation
+         * API 端点: POST /app/{agent_key}/conversation
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
+         * @param title 会话标题，通常是用户发送的第一条消息内容
          * @returns 返回新创建的会话 ID
          */
-        generateConversation(): Promise<string>;
+        generateConversation(title?: string): Promise<string>;
         /**
          * 调用 DIP API 发送消息(流式)
          * 该方法实现了完整的消息发送逻辑,子类无需覆盖
@@ -158,8 +154,8 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         parseEventMessage(raw: any): EventMessage;
         /**
          * 将 key 数组转换为 JSONPath 字符串
-         * 例如: ["message", "content", "final_answer", "answer", "text"]
-         * => "message.content.final_answer.answer.text"
+         * 例如: ["message", "content", "middle_answer", "progress", 0]
+         * => "message.content.middle_answer.progress[0]"
          */
         keyToJSONPath(key: Array<string | number>): string;
         /**
@@ -178,6 +174,19 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
          * tool_calls[0] 是 SearchIntent（输入），tool_calls[1] 是 SearchResult（输出）
          */
         extractWebSearchQuery(progress: any): WebSearchQuery | null;
+        /**
+         * 从 Progress 对象中提取 Json2Plot 图表数据
+         * 根据 OpenAPI 规范，Json2Plot 数据在 answer.choices[0].message.tool_calls 中
+         * tool_calls 中包含 Json2PlotAnswer，格式为 { result: Json2PlotResult, full_result: Json2PlotFullResult }
+         * Json2PlotResult 包含: data_sample, chart_config, title, text
+         * Json2PlotFullResult 包含: data, chart_config, title, text
+         * ChartConfig 包含: xField, yField, seriesField, chart_type, groupField, isStack, isGroup
+         */
+        extractJson2PlotData(progress: any): ChartDataSchema | null;
+        /**
+         * 推断数据类型
+         */
+        inferDataType(value: any): "string" | "number" | "date" | "boolean";
         /**
          * 处理技能调用的统一方法
          * 根据设计文档 3.2 Event Message 白名单中的后处理逻辑
@@ -186,13 +195,6 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
          * @param messageId 消息 ID
          */
         processSkillExecution(skillInfo: SkillInfo | undefined, answer: any, messageId: string): void;
-        /**
-         * 处理 final_answer.answer_type_other
-         * 根据设计文档 3.2 Event Message 白名单中的后处理逻辑
-         * @param content OtherTypeAnswer 对象
-         * @param messageId 消息 ID
-         */
-        processFinalAnswerTypeOther(content: OtherTypeAnswer, messageId: string): void;
         /**
          * 处理 middle_answer.progress 中的一个元素
          * 根据设计文档 3.2 Event Message 白名单中的后处理逻辑
@@ -202,18 +204,21 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         processMiddleAnswerProgress(content: Progress, messageId: string): void;
         /**
          * 从 answer.choices 中提取 Web 搜索查询
-         * 用于处理 final_answer.answer_type_other 和 middle_answer.progress 中的搜索结果
+         * 用于处理 middle_answer.progress 中的搜索结果
          */
         extractWebSearchQueryFromAnswer(answer: any): WebSearchQuery | null;
         /**
-         * 从 skill_info.args 中提取图表数据
+         * 从 skill_info.args 和 answer 中提取图表数据并转换为 ChartDataSchema
          * 用于处理 json2plot 工具的输出
+         * @param args 技能参数数组（保留用于 API 一致性，实际数据从 answer 中提取）
+         * @param answer 技能执行的 answer 字段，包含 result 或 full_result
+         * @returns ChartDataSchema 对象，如果解析失败则返回 null
          */
-        extractChartDataFromArgs(args: Array<{
+        extractChartDataFromArgs(_args: Array<{
             name?: string;
             type?: string;
             value?: string;
-        }> | undefined): any;
+        }> | undefined, answer: any): ChartDataSchema | null;
         /**
          * 从 skill_info.args 和 answer 中提取代码执行结果
          * 用于处理 execute_code 工具的输入和输出
@@ -229,6 +234,39 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
             input: string;
             output: string;
         } | null;
+        /**
+         * 从 skill_info.args 和 answer 中提取 Text2SQL 结果
+         * 用于处理 text2sql 工具的输入和输出
+         * 根据 OpenAPI 规范，Text2SqlResult 包含 result 和 full_result
+         * - result: Text2SqlResultData（包含 data_desc，但可能只有数据样本）
+         * - full_result: Text2SqlFullResultData（包含完整数据，但没有 data_desc）
+         * 优先使用 full_result，如果没有则使用 result
+         * @param args skill_info.args 数组，包含查询文本
+         * @param answer 技能执行的 answer 字段，包含 SQL 执行结果
+         * @returns Text2SqlResult 对象，包含 input、sql、data 等信息
+         */
+        extractText2SqlResult(args: Array<{
+            name?: string;
+            type?: string;
+            value?: string;
+        }> | undefined, answer: any): {
+            input: string;
+            sql: string;
+            data?: Array<Record<string, any>>;
+            cites?: Array<{
+                id: string;
+                name: string;
+                type: string;
+                description?: string;
+            }>;
+            title?: string;
+            message?: string;
+            dataDesc?: {
+                return_records_num?: number;
+                real_records_num?: number;
+            };
+            explanation?: any;
+        } | null;
         /**
          * 将技能调用或 LLM 回答的内容追加到消息中
          * 用于历史消息解析，根据 stage 和 skill_info 将内容添加到 ChatMessage.content 数组
@@ -265,7 +303,7 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         shouldRefreshToken(status: number, _error: any): boolean;
         /**
          * 终止会话
-         * 调用 DIP 的 /app/{agent_id}/chat/termination 接口终止指定会话
+         * 调用 DIP 的 /app/{agent_key}/chat/termination 接口终止指定会话
          * @param conversationId 要终止的会话 ID
          * @returns 返回 Promise，成功时 resolve，失败时 reject
          */
@@ -278,8 +316,8 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         executeDataAgentWithTokenRefresh<T>(apiCall: () => Promise<T>): Promise<T>;
         /**
          * 获取历史会话列表
-         * 调用 DIP 的 GET /app/{agent_id}/conversation 接口获取会话列表
-         * API 端点: GET /app/{agent_id}/conversation?page={page}&size={size}
+         * 调用 DIP 的 GET /app/{agent_key}/conversation 接口获取会话列表
+         * API 端点: GET /app/{agent_key}/conversation?page={page}&size={size}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param page 分页页码，默认为 1
          * @param size 每页返回条数，默认为 10
@@ -288,9 +326,9 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         getConversations(page?: number, size?: number): Promise<ConversationHistory[]>;
         /**
          * 获取指定会话 ID 的对话消息列表
-         * 调用 DIP 的 GET /app/{agent_id}/conversation/{conversation_id} 接口获取会话详情
+         * 调用 DIP 的 GET /app/{agent_key}/conversation/{conversation_id} 接口获取会话详情
          * 如果对话消息是 AI 助手消息，则需要调用 reduceAssistantMessage() 解析消息
-         * API 端点: GET /app/{agent_id}/conversation/{conversation_id}
+         * API 端点: GET /app/{agent_key}/conversation/{conversation_id}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param conversationId 会话 ID
          * @returns 返回对话消息列表
@@ -298,8 +336,8 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         getConversationMessages(conversationId: string): Promise<ChatMessage[]>;
         /**
          * 删除指定 ID 的会话
-         * 调用 DIP 的 DELETE /app/{agent_id}/conversation/{conversation_id} 接口删除会话
-         * API 端点: DELETE /app/{agent_id}/conversation/{conversation_id}
+         * 调用 DIP 的 DELETE /app/{agent_key}/conversation/{conversation_id} 接口删除会话
+         * API 端点: DELETE /app/{agent_key}/conversation/{conversation_id}
          * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
          * @param conversationID 会话 ID
          * @returns 返回 Promise，成功时 resolve，失败时 reject

package/dist/components/icons/AssistantIcon.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/**
+ * Assistant 图标组件
+ */
+export declare const AssistantIcon: React.FC<React.SVGProps<SVGSVGElement>>;
+export default AssistantIcon;

package/dist/components/icons/ColumnIcon.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/**
+ * 柱状图图标组件
+ */
+export declare const ColumnIcon: React.FC<React.SVGProps<SVGSVGElement>>;
+export default ColumnIcon;

package/dist/components/icons/ExpandIcon.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/**
+ * 展开图标组件
+ */
+export declare const ExpandIcon: React.FC<React.SVGProps<SVGSVGElement>>;
+export default ExpandIcon;

package/dist/components/icons/JsonPlotIcon.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/**
+ * JSON Plot 图标组件
+ */
+export declare const JsonPlotIcon: React.FC<React.SVGProps<SVGSVGElement>>;
+export default JsonPlotIcon;