@kweaver-ai/chatkit 0.1.1 → 0.1.3

package/dist/components/Avatar/Avatar-1.d.ts

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

package/dist/components/Avatar/Avatar-10.d.ts

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

package/dist/components/Avatar/Avatar-2.d.ts

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

package/dist/components/Avatar/Avatar-3.d.ts

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

package/dist/components/Avatar/Avatar-4.d.ts

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

package/dist/components/Avatar/Avatar-5.d.ts

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

package/dist/components/Avatar/Avatar-6.d.ts

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

package/dist/components/Avatar/Avatar-7.d.ts

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

package/dist/components/Avatar/Avatar-8.d.ts

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

package/dist/components/Avatar/Avatar-9.d.ts

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

package/dist/components/Avatar/index.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import { Avatar1 } from './Avatar-1';
+import { Avatar2 } from './Avatar-2';
+import { Avatar3 } from './Avatar-3';
+import { Avatar4 } from './Avatar-4';
+import { Avatar5 } from './Avatar-5';
+import { Avatar6 } from './Avatar-6';
+import { Avatar7 } from './Avatar-7';
+import { Avatar8 } from './Avatar-8';
+import { Avatar9 } from './Avatar-9';
+import { Avatar10 } from './Avatar-10';
+/**
+ * Avatar 组件属性接口
+ */
+export interface AvatarProps extends React.SVGProps<SVGSVGElement> {
+    /** SVG 名称，支持 '1' 到 '10' */
+    name: string;
+}
+/**
+ * Avatar 组件
+ * 根据传入的 name 参数渲染对应的 Avatar 图标
+ *
+ * @example
+ * ```tsx
+ * <Avatar name="1" width={48} height={48} />
+ * <Avatar name="10" className="avatar-icon" />
+ * ```
+ */
+export declare const Avatar: React.FC<AvatarProps>;
+/**
+ * 根据名称获取 Avatar 组件
+ *
+ * @param name - SVG 名称，支持 '1' 到 '10'
+ * @returns 对应的 Avatar 组件，如果不存在则返回 null
+ */
+export declare const getAvatarByName: (name: string) => React.FC<React.SVGProps<SVGSVGElement>> | null;
+export { Avatar1, Avatar2, Avatar3, Avatar4, Avatar5, Avatar6, Avatar7, Avatar8, Avatar9, Avatar10 };
+export default Avatar;

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 名称) */
+    agentInfo?: any;
+}
+/**
+ * 历史会话列表组件
+ * 右侧滑出面板，展示用户的历史会话记录，支持加载和删除操作
+ * 设计参考：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,10 @@ import { ChatMessage } from '../../../types';
 interface MessageItemProps {
     /** 消息对象 */
     message: ChatMessage;
+    /** 是否正在流式更新 */
+    isStreaming?: boolean;
+    /** 助手信息 */
+    agentAvatar?: string;
 }
 /**
  * MessageItem 组件

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

@@ -6,6 +6,10 @@ import { ChatMessage } from '../../../types';
 interface MessageListProps {
     /** 消息列表 */
     messages: ChatMessage[];
+    /** 当前正在流式更新的消息 ID */
+    streamingMessageId?: string | null;
+    /** 助手信息 */
+    agentAvatar?: string;
 }
 /**
  * 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 组件