@zero-library/chat-copilot 1.0.2 → 1.0.4

package/dist/index.d.ts

@@ -1,9 +1,8 @@
 import * as react from 'react';
-import react__default from 'react';
+import react__default, { ReactNode } from 'react';
+import { BubbleProps } from '@ant-design/x-v2';
 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 {
@@ -135,7 +134,7 @@ interface SenderProps {
     /** 文件上传配置 */
     fileUpload?: FileUpload;
 }
-declare const _default$3: react.ForwardRefExoticComponent<SenderProps & react.RefAttributes<ChatSenderHandle>>;
+declare const _default$2: react.ForwardRefExoticComponent<SenderProps & react.RefAttributes<ChatSenderHandle>>;
 
 interface UserInputType {
     inputs: Variable[];
@@ -349,11 +348,48 @@ interface InputFile {
  * 定义通过URL访问的文件信息
  */
 interface FileUrlType {
+    /** 文件后缀名 */
+    suffix: string;
+    /** 文件访问URL */
+    fileUrl: string;
+    /** 文件名 */
+    fileName: string;
+}
+interface FirstMessageRenderCtx {
+    index: number;
+    member: 1 | 2;
+}
+interface FirstMessage extends Omit<BubbleProps, 'content' | 'contentRender' | 'role' | 'placement'> {
+    /** 会话成员类型 */
+    member?: 1 | 2;
+    /** 直接传入要展示的节点 */
+    content?: ReactNode;
+    /** 动态生成要展示的节点 */
+    contentRender?: (ctx: FirstMessageRenderCtx) => ReactNode;
+}
+/**
+ * 文件文本类型接口
+ * 定义包含文本内容的文件信息
+ */
+interface FileTextType {
+    /** 文件内容 */
+    content: string;
+    /** 文件后缀名 */
+    suffix: string;
+    /** 文件名 */
+    fileName: string;
+}
+/**
+ * 文件文本类型接口
+ * 定义包含文本内容的文件信息
+ */
+interface FileTextType {
+    /** 文件内容 */
+    content: string;
+    /** 文件后缀名 */
+    suffix: string;
     /** 文件名 */
     fileName: string;
-    path: string;
-    fileUrl?: string;
-    ext?: string;
 }
 /**
  * 消息引用类型
@@ -364,8 +400,6 @@ interface MessageQuoteMsg {
     id?: string;
     /** 被引用的消息内容 */
     msgContent?: string;
-    /** 被引用消息的附件文件列表 */
-    msgFiles?: InputFile[];
 }
 /**
  * 引用内容接口
@@ -634,6 +668,21 @@ interface ChatHandle {
      * chatRef.current?.switchConversation(item)
      */
     switchConversation: (id: ConversationType['id']) => Promise<void>;
+    /**
+   * 切换智能体会话
+   * 切换到指定的智能体并创建或获取会话
+   *
+   * @param agentId - 目标智能体ID
+   * @param strategy - 会话策略，1-使用最近会话，2-创建新会话
+   *
+   * @example
+   * // 切换到指定智能体并创建新会话
+   * chatRef.current?.switchAgentConversation('agent-001')
+   *
+   * @example
+   * // 切换到指定智能体并使用最近会话
+   * chatRef.current?.switchAgentConversation('agent-001', 1)
+   */
     /**
      * 基于当前接收者创建新的会话
      *
@@ -665,6 +714,7 @@ interface ChatHandle {
      * // 清除引用
      * chatRef.current?.setReferences()
      */
+    setReferences: (references?: ReferencesType) => void;
     /**
      * 直接设置输入框中的文本内容
      *
@@ -1155,14 +1205,14 @@ interface ChatHooks {
      * @param file - 被预览的文件对象, 如果不存在则表示正在关闭预览
      * @param isBuiltIn - 是否为内嵌布局
      */
-    onBeforeFilePreview?: (file?: FileUrlType, isBuiltIn?: boolean) => boolean | Promise<boolean> | void;
+    onBeforeFilePreview?: (file?: FileUrlType | FileTextType, isBuiltIn?: boolean) => boolean | Promise<boolean> | void;
     /**
      * 文件预览后的回调函数
      * 在文件预览打开或关闭之后执行，可以用于控制布局等
      * @param file - 预览的文件对象, 如果不存在则表示已经关闭预览
      * @param isBuiltIn - 是否为内嵌布局
      */
-    onAfterFilePreview?: (file?: FileUrlType, isBuiltIn?: boolean) => void;
+    onAfterFilePreview?: (file?: FileUrlType | FileTextType, isBuiltIn?: boolean) => void;
     /**
      * 设置引用消息前回调
      * 在设置引用消息前调用，返回false可阻止设置
@@ -1326,7 +1376,7 @@ interface ChatLayoutWelcomeMessage {
  */
 interface ChatLayoutMessageList {
     /** 首条消息配置 */
-    firstMessages?: ConversationMessage[];
+    firstMessages?: FirstMessage[];
     /** 头像显示控制：可以是全局布尔值或按成员类型分别控制 */
     avatar?: boolean | Partial<Record<ConversationMemberEnum, boolean>>;
     /** 智能体消息操作区渲染控制 */
@@ -1438,7 +1488,7 @@ interface AttachmentsProps {
  * 附件上传组件
  * 支持多文件上传、文件类型验证、文件大小限制等功能
  */
-declare const _default$2: react.ForwardRefExoticComponent<AttachmentsProps & react.RefAttributes<unknown>>;
+declare const _default$1: react.ForwardRefExoticComponent<AttachmentsProps & react.RefAttributes<unknown>>;
 
 interface RoleContent {
     role: number;
@@ -1457,8 +1507,7 @@ interface MessageRenderProps {
     /** message自定义标记渲染组件 */
     customComponents?: ChatLayoutMessageList['customComponents'];
 }
-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$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 };
+export { type AgentConfig, type AgentInfo, type AgentSpec, _default$1 as Attachments, type AttachmentsProps, type ChatConfig, _default as ChatCopilot, type ChatHandle, type ChatHooks, type ChatLayout, type ChatParams, type ChatProps, _default$2 as ChatSender, type ChatServices, type ConversationMessage, type ConversationStrategy, type FileUploadConfig, type InputFile, type MessageRenderProps, type ReferencesType, type RequestInstance, type SenderProps };