@kweaver-ai/chatkit 0.1.1 → 0.1.3

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;

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -5,3 +5,13 @@ export { CloseIcon } from './CloseIcon';
 export { StopIcon } from './StopIcon';
 export { SendIcon } from './SendIcon';
 export { ClockIcon } from './ClockIcon';
+export { PieIcon } from './PieIcon';
+export { LineIcon } from './LineIcon';
+export { ColumnIcon } from './ColumnIcon';
+export { TableIcon } from './TableIcon';
+export { JsonPlotIcon } from './JsonPlotIcon';
+export { Text2SqlIcon } from './Text2SqlIcon';
+export { AssistantIcon } from './AssistantIcon';
+export { MoreIcon } from './MoreIcon';
+export { NewIcon } from './NewIcon';
+export { ExpandIcon } from './ExpandIcon';

package/dist/types/index.d.ts

@@ -32,7 +32,11 @@ export declare enum BlockType {
     /** Web 搜索类型 */
     WEB_SEARCH = "WebSearch",
     /** 工具调用类型 */
-    TOOL = "Tool"
+    TOOL = "Tool",
+    /** JSON2Plot 图表类型 */
+    JSON2PLOT = "Json2Plot",
+    /** Text2SQL 类型 */
+    Text2Sql = "Text2Sql"
 }
 /**
  * 角色接口
@@ -79,6 +83,11 @@ export interface WebSearchBlock extends ContentBlock<BlockType.WEB_SEARCH, WebSe
  */
 export interface ToolBlock extends ContentBlock<BlockType.TOOL, ToolCallData> {
 }
+/**
+ * JSON2Plot 图表类型的消息块
+ */
+export interface Json2PlotBlock extends ContentBlock<BlockType.JSON2PLOT, ChartDataSchema> {
+}
 /**
  * 消息接口
  * 展示在消息区消息列表中的一条消息
@@ -91,7 +100,7 @@ export interface ChatMessage {
     /** 该条消息的类型（已废弃，保留用于向后兼容） */
     type?: ChatMessageType;
     /** 该条消息的内容。一条消息可以由许多不同类型的消息块组成 */
-    content: Array<TextBlock | MarkdownBlock | WebSearchBlock | ToolBlock>;
+    content: Array<TextBlock | MarkdownBlock | WebSearchBlock | ToolBlock | Json2PlotBlock>;
     /** 与该消息关联的应用上下文（可选），仅用户消息可能包含此字段 */
     applicationContext?: ApplicationContext;
 }
@@ -161,6 +170,19 @@ export interface ExecuteCodeResult {
     /** 代码执行后转为自然语言的输出结果，以 Markdown 格式显示 */
     output: string;
 }
+/**
+ * Text2SQL 结果接口
+ * Text2SQL 工具的输入和输出信息
+ * 根据 OpenAPI 规范，answer 包含 result 和 full_result
+ * - result: Text2SqlResultData（包含 data_desc，但可能只有数据样本）
+ * - full_result: Text2SqlFullResultData（包含完整数据，但没有 data_desc）
+ */
+export interface Text2SqlResult {
+    /** 输入的查询文本 */
+    title: string;
+    data: Array<Record<string, any>>;
+    sql: string;
+}
 /**
  * 工具调用数据接口
  * 工具调用的输入和输出信息
@@ -213,9 +235,10 @@ export interface ChatKitInterface {
      * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口
      * 成功返回会话 ID
      * 注意：该方法是一个无状态无副作用的函数，不允许修改 state
+     * @param title 会话标题，通常是用户发送的第一条消息内容
      * @returns 返回新创建的会话 ID
      */
-    generateConversation(): Promise<string>;
+    generateConversation(title?: string): Promise<string>;
     /**
      * 向后端发送消息
      * 该方法需要由开发者实现，以适配扣子、Dify等 LLMOps 平台的接口
@@ -283,3 +306,63 @@ export interface ChatKitInterface {
      */
     deleteConversation(conversationID: string): Promise<void>;
 }
+/**
+ * 图表类型枚举
+ * 支持的图表类型
+ */
+export type ChartType = 'Line' | 'Column' | 'Pie' | 'Circle';
+/**
+ * 数据行
+ */
+export type DataRow = Record<string, any>;
+/**
+ * 维度接口
+ */
+export interface Dimension {
+    /** 字段名 */
+    name: string;
+    /** 显示名称 */
+    displayName: string;
+    /** 数据类型 */
+    dataType: 'string' | 'number' | 'date' | 'boolean';
+}
+/**
+ * 度量接口
+ */
+export interface Measure {
+    /** 字段名 */
+    name: string;
+    /** 显示名称 */
+    displayName: string;
+    /** 数据类型 */
+    dataType: 'number' | 'string';
+    /** 聚合方式 */
+    aggregation?: 'sum' | 'avg' | 'count' | 'max' | 'min';
+}
+/**
+ * 图表数据 Schema
+ */
+export interface ChartDataSchema {
+    /** 图表类型 */
+    chartType: ChartType;
+    /** 图表名称/标题（可选） */
+    title?: string;
+    /** 维度列表 */
+    dimensions: Dimension[];
+    /** 度量列表 */
+    measures: Measure[];
+    /** 数据行列表 */
+    rows: DataRow[];
+}
+/**
+ * 日期范围枚举
+ */
+export declare enum DateRange {
+    Minute = "minute",
+    Hour = "hour",
+    ToDay = "toDay",
+    Yesterday = "yesterday",
+    SixDay = "sixDay",
+    Month = "month",
+    Year = "year"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/chatkit",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "publishConfig": {
     "access": "public"
   },
@@ -24,7 +24,8 @@
     "build": "npm run build:lib && npm run build:types",
     "build:lib": "vite build --config vite.config.lib.ts",
     "build:types": "tsc --project tsconfig.lib.json",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "prepare": "npm run build"
   },
   "keywords": [
     "chat",