@zero-library/chat-copilot 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import react__default from 'react';
 import { ButtonProps, ThemeConfig } from 'antd';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { createRequest, RequestConfig, RenderControl } from '@zero-library/common';
+import { BubbleProps } from '@ant-design/x-v2';
 
 type ConversationMemberEnum = 'user' | 'agent';
 declare enum AgentTypeEnum {
@@ -66,10 +67,10 @@ interface AgentConfig {
 }
 interface AgentInfo {
     id: string;
-    name: string;
-    description: string;
-    iconUrl: string;
-    agentType: AgentTypeEnum;
+    name?: string;
+    description?: string;
+    iconUrl?: string;
+    agentType?: AgentTypeEnum;
     updatedAt?: string;
     tagIds?: string[];
     spec?: AgentSpec;
@@ -77,6 +78,65 @@ interface AgentInfo {
     userInput?: Variable[];
 }
 
+/**
+ * ChatSender 组件暴露的方法接口
+ */
+interface ChatSenderHandle {
+    /** 聚焦输入框 */
+    focus: (options?: {
+        cursor?: 'start' | 'end';
+    }) => void;
+}
+/**
+ * 文件上传配置接口
+ */
+interface FileUpload {
+    /** 上传时的额外参数 */
+    params?: ObjectType<any>;
+    /** 文件上传配置列表 */
+    config: FileUploadConfig;
+    /** 文件上传请求函数 */
+    request: AttachmentsProps['fileUpload'];
+}
+/**
+ * ChatSender 组件属性接口
+ */
+interface SenderProps {
+    /** 输入框占位符 */
+    placeholder?: string;
+    /** 输入框内容 */
+    content?: string;
+    /** 文件列表 */
+    fileList?: InputFile[];
+    /** 是否打开文件选择头部 */
+    headerOpen?: boolean;
+    /** 是否正在发送消息 */
+    loading?: boolean;
+    /** 内容变化回调 */
+    onContentChange: (value: string) => void;
+    /** 文件列表变化回调 */
+    onFileListChange: (files: InputFile[]) => void;
+    /** 头部打开状态变化回调 */
+    onHeaderOpenChange: (open: boolean) => void;
+    /** 发送消息回调 */
+    onSend: () => void;
+    /** 取消发送回调 */
+    onCancel?: () => void;
+    /** 输入框聚焦回调 */
+    onFocus?: () => void;
+    /** 头部额外内容 */
+    extraHeader?: React.ReactNode;
+    /** 底部额外内容 */
+    extraFooter?: React.ReactNode;
+    /** 底部下方额外内容 */
+    extraFooterBelow?: React.ReactNode;
+    /** 发送按钮属性 */
+    sendBtnProps?: ButtonProps;
+    /** 文件上传配置 */
+    fileUpload?: FileUpload;
+}
+declare const _default$3: react.ForwardRefExoticComponent<SenderProps & react.RefAttributes<ChatSenderHandle>>;
+
 interface UserInputType {
     inputs: Variable[];
     outputs: Variable[];
@@ -87,6 +147,7 @@ interface UserInputType {
  * @returns 聊天服务对象
  */
 declare const createChatService: (request: ReturnType<typeof createRequest>, config?: RequestConfig) => {
+    fetchModelList: () => Promise<R<ProviderModel[]>>;
     fetchAgentInfo: (agentId: string) => Promise<R<AgentInfo>>;
     createConversationId: (params: ConversationCreate) => Promise<R<string>>;
     fetchConversations: (params: ConversationsQuery) => Promise<R<ConversationType[]>>;
@@ -237,9 +298,13 @@ interface ConvMeta {
      * 1 正常 2 debug
      */
     mode?: number;
+    /** 项目或知识库ID */
     libraryId?: string;
+    /** 会话来源 */
     source?: number;
+    /** 项目或知识库类型 */
     libraryType?: LibraryTypeEnum;
+    /** 技能会话ID */
     skillConversationId?: string;
 }
 
@@ -482,11 +547,17 @@ type MessageEvent = RunStartedEvent | TextEvent | FilesEvent | StepStartedEvent
  * 定义智能体和用户之间的消息结构
  */
 interface ConversationMessage {
+    /** 消息ID */
     messageId: string;
+    /** 会话ID */
     conversationId: string;
+    /** 执行ID */
     executionId: string;
+    /** 角色：1-智能体 2-用户 */
     role: number;
+    /** 消息内容 */
     content: MessageEvent[];
+    /** 上传文件内容 */
     files?: InputFile[];
     /** 消息反馈：1-赞 2-踩 */
     feedback?: number;
@@ -494,6 +565,7 @@ interface ConversationMessage {
     params?: string;
     /** 引用的消息信息 */
     quoteMsg?: MessageQuoteMsg;
+    /** 创建时间 */
     createdAt: string;
     /** 是否被打断标志 */
     stopFlag?: boolean;
@@ -1077,6 +1149,12 @@ interface ChatHooks {
      * }
      */
     onAppRightVerify?: (appKey: string) => boolean | Promise<boolean> | void;
+    /**
+     * 文件预览前回调函数
+     * 在文件预览打开前调用，返回false可阻止预览
+     * @param file - 被预览的文件对象, 如果不存在则表示正在关闭预览
+     * @param isBuiltIn - 是否为内嵌布局
+     */
     onBeforeFilePreview?: (file?: FileUrlType, isBuiltIn?: boolean) => boolean | Promise<boolean> | void;
     /**
      * 文件预览后的回调函数
@@ -1323,6 +1401,23 @@ interface ChatProps {
     layout?: ChatLayout;
     services?: ChatServices;
 }
+interface Model {
+    modelName: string;
+    modelLabel: string;
+    desc: string | null;
+    tags: readonly string[] | null;
+    providerId: string;
+    providerName: string;
+    providerLabel?: string;
+    icon: string;
+}
+interface ProviderModel {
+    providerName: string;
+    providerLabel: string;
+    iconUrl: string;
+    icon?: string;
+    models: Model[];
+}
 
 /**
  * 附件组件属性接口
@@ -1339,67 +1434,21 @@ interface AttachmentsProps {
     /** 文件列表变化回调函数 */
     onChange: (fileList: InputFile[]) => void;
 }
-
 /**
- * ChatSender 组件暴露的方法接口
+ * 附件上传组件
+ * 支持多文件上传、文件类型验证、文件大小限制等功能
  */
-interface ChatSenderHandle {
-    /** 聚焦输入框 */
-    focus: (options?: {
-        cursor?: 'start' | 'end';
-    }) => void;
-}
-/**
- * 文件上传配置接口
- */
-interface FileUpload {
-    /** 上传时的额外参数 */
-    params?: ObjectType<any>;
-    /** 文件上传配置列表 */
-    config: FileUploadConfig;
-    /** 文件上传请求函数 */
-    request: AttachmentsProps['fileUpload'];
-}
-/**
- * ChatSender 组件属性接口
- */
-interface SenderProps {
-    /** 输入框占位符 */
-    placeholder?: string;
-    /** 输入框内容 */
-    content?: string;
-    /** 文件列表 */
-    fileList?: InputFile[];
-    /** 是否打开文件选择头部 */
-    headerOpen?: boolean;
-    /** 是否正在发送消息 */
-    loading?: boolean;
-    /** 内容变化回调 */
-    onContentChange: (value: string) => void;
-    /** 文件列表变化回调 */
-    onFileListChange: (files: InputFile[]) => void;
-    /** 头部打开状态变化回调 */
-    onHeaderOpenChange: (open: boolean) => void;
-    /** 发送消息回调 */
-    onSend: () => void;
-    /** 取消发送回调 */
-    onCancel?: () => void;
-    /** 输入框聚焦回调 */
-    onFocus?: () => void;
-    /** 头部额外内容 */
-    extraHeader?: React.ReactNode;
-    /** 底部额外内容 */
-    extraFooter?: React.ReactNode;
-    /** 底部下方额外内容 */
-    extraFooterBelow?: React.ReactNode;
-    /** 发送按钮属性 */
-    sendBtnProps?: ButtonProps;
-    /** 文件上传配置 */
-    fileUpload?: FileUpload;
+declare const _default$2: react.ForwardRefExoticComponent<AttachmentsProps & react.RefAttributes<unknown>>;
+
+interface RoleContent {
+    role: number;
+    user: ConversationMemberEnum;
+    placement: BubbleProps['placement'];
+    avatar?: any;
 }
-declare const _default$3: react.ForwardRefExoticComponent<SenderProps & react.RefAttributes<ChatSenderHandle>>;
 
 interface MessageRenderProps {
+    role: RoleContent;
     message: ConversationMessage;
     messageIndex?: number;
     loading?: boolean;
@@ -1408,10 +1457,8 @@ interface MessageRenderProps {
     /** message自定义标记渲染组件 */
     customComponents?: ChatLayoutMessageList['customComponents'];
 }
-declare const _default$2: react__default.MemoExoticComponent<({ message, messageIndex, loading, containerRef, customComponents }: MessageRenderProps) => react_jsx_runtime.JSX.Element>;
-
-declare const _default$1: ({ firstMessages, welcomeMessage, avatar, agentActions, customComponents }: ChatLayoutMessageList) => react_jsx_runtime.JSX.Element;
+declare const _default$1: react__default.MemoExoticComponent<({ role, message, messageIndex, loading, containerRef, customComponents }: MessageRenderProps) => react_jsx_runtime.JSX.Element>;
 
 declare const _default: react.ForwardRefExoticComponent<ChatProps & react.RefAttributes<ChatHandle>>;
 
-export { type AgentConfig, type AgentInfo, type AgentSpec, _default$1 as BubbleListItems, type ChatConfig, _default as ChatCopilot, type ChatHandle, type ChatProps, _default$3 as ChatSender, type ConversationMessage, type FileUploadConfig, type InputFile, _default$2 as MessageRender };
+export { type AgentConfig, type AgentInfo, type AgentSpec, _default$2 as Attachments, type AttachmentsProps, type ChatConfig, _default as ChatCopilot, type ChatHandle, type ChatHooks, type ChatLayout, type ChatParams, type ChatProps, _default$3 as ChatSender, type ChatServices, type ConversationMessage, type ConversationStrategy, type FileUploadConfig, type InputFile, _default$1 as MessageRender, type MessageRenderProps, type ReferencesType, type RequestInstance, type SenderProps };