@ai-group/chat-sdk 3.5.5 → 3.5.6

package/dist/cjs/types/XAiChatbot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/XAiChatbot.ts"],
+  "sourcesContent": ["import React, { ReactNode, RefObject, MouseEvent, ReactElement } from 'react';\nimport type { PromptsItemType } from '@ant-design/x';\nimport type { MessageType } from '../client/base';\nimport type { UploadProps } from 'antd';\nimport type { Messages } from './XAiMessage';\nimport type { SendContent } from './XAiSender';\n\n// 类型定义\nexport interface User {\n    id: string;\n    name: string;\n    avatar?: string;\n  }\n\nexport interface MessageProps {\n    _id: string;\n    type: string;\n    content: Record<string, any>;\n    createdAt: number;\n    user: User;\n    position?: 'left' | 'right' | 'center' | 'pop';\n    hasTime?: boolean;\n    status?: 'pending' | 'sent' | 'fail';\n  }\n\nexport interface QuickReplyItemProps {\n    name: string;\n    code: string;\n    icon?: string;\n    img?: string;\n    isNew?: boolean;\n    isHighlight?: boolean;\n  }\n\nexport interface ComposerHandle {\n    setText: (text: string) => void;\n  }\n\nexport interface ScrollToEndOptions {\n    animated?: boolean;\n    force?: boolean;\n  }\n\nexport interface MessageContainerHandle {\n    scrollToEnd: (options?: ScrollToEndOptions) => void;\n  }\n\nexport interface NavbarProps {\n  title?: string;\n  subtitle?: string;\n  avatar?: string;\n}\n\nexport interface ToolbarItemProps {\n    id: string;\n    icon: string;\n    label: string;\n    disabled?: boolean;\n  }\n\nexport interface IconButtonProps {\n    icon: string;\n    onClick: () => void;\n    disabled?: boolean;\n  }\n\nexport interface RecorderProps {\n    onStart?: () => void;\n    onStop?: (audioBlob: Blob) => void;\n    onError?: (error: Error) => void;\n  }\n\nexport type InputType = 'text' | 'voice';\n\n// chatbot 会话字段\nexport interface ChatbotMessageFields {\n  messages?: MessageType[];\n  setMessages?: React.Dispatch<React.SetStateAction<MessageType[]>>;\n  /** 发送消息回调 */\n  onSend?: (content: SendContent) => void;\n  /** 清空消息回调 */\n  onClear?: () => void;\n  /** 停止生成回调 */\n  onStop?: () => void;\n}\n\nexport interface ActionItem {\n  key?: string;\n  icon?: React.ReactNode;\n  render?: (index: number, msg: any) => React.ReactNode;\n  tooltip?: string;\n}\n\n/**\n   * AI 聊天机器人组件\n   */\nexport interface XAiChatbotProps extends ChatbotMessageFields {\n    /** 宽屏断点 */\n    wideBreakpoint?: string;\n    /** 导航栏展示 */\n    navbarShow?: boolean;\n    /** 导航栏配置 */\n    navbar?: NavbarProps;\n    /** 导航栏渲染函数，会覆盖 navbar */\n    renderNavbar?: () => ReactNode;\n    /** 是否加载中 */\n    loading?: boolean;\n    /** 加载更多文案 */\n    loadMoreText?: string;\n    /** 在消息列表上面的渲染函数 */\n    renderBeforeMessageList?: () => ReactNode;\n    /** 消息列表 ref */\n    messagesRef?: RefObject<MessageContainerHandle>;\n    /** 下拉加载回调 */\n    onRefresh?: () => Promise<any>;\n    /** 滚动消息列表回调 */\n    onScroll?: (event: React.UIEvent<HTMLDivElement, UIEvent>) => void;\n    /** 消息内容渲染函数 */\n    renderMessageContent?: (message: MessageProps) => ReactNode;\n    /** 快捷短语列表 */\n    quickReplies?: QuickReplyItemProps[];\n    /** 快捷短语是否可见 */\n    quickRepliesVisible?: boolean;\n    // /** 点击快速回复回调 */\n    // onQuickReplyClick?: (item: QuickReplyItemProps, index: number) => void;\n    // /** 快捷短语的滚动回调 */\n    // onQuickReplyScroll?: () => void;\n    // /** 快捷短语渲染函数，会覆盖 quickReplies */\n    // renderQuickReplies?: () => ReactNode;\n    /** 输入框初始内容 */\n    text?: string;\n    /** 空状态渲染插槽 */\n    empty?: ReactElement;\n    /** 空状态图片 */\n    emptyStateImage?: string;\n    /** 空状态文案 */\n    emptyStateText?: string;\n    /** 输入框占位符 */\n    placeholder?: string;\n    /** 输入方式 */\n    inputType?: InputType;\n    // /** 输入方式切换回调 */\n    // onInputTypeChange?: (inputType: InputType) => void;\n    /** 语音输入配置 */\n    recorder?: RecorderProps;\n    /** 工具栏配置 */\n    toolbar?: ToolbarItemProps[];\n    /** AI头像 */\n    avatar?: ReactNode;\n    /** 用户头像 */\n    userAvatar?: ReactNode;\n    /** 发送按钮 */\n    sendBtn?: ReactNode;\n    /** 是否展示清空按钮 */\n    clearBtnShow? : boolean;\n    /** 工具栏点击回调 */\n    onToolbarClick?: (item: ToolbarItemProps, event: MouseEvent) => void;\n    /** 工具栏打开/关闭回调 */\n    onAccessoryToggle?: (isAccessoryOpen: boolean) => void;\n    /** 输入框右边图标按钮配置 */\n    rightAction?: IconButtonProps;\n    /** 底部文案 */\n    footerTips?: string;\n    /** 帮助消息点击回调 */\n    onSuggestMessageClick?: (item: PromptsItemType, id: string) => void;\n    /** 消息左下角展示字段  */\n    messageTooltip?: (msg: Messages) => React.ReactNode;\n    /** 消息右下角功能区  */\n    messageActions?: ActionItem[];\n    /** 消息右下角功能区点击回调 */\n    onMessagesActionsCallback?: (index: number, data: Messages) => void; // 点击回调\n    /** 输入组件 */\n    Composer?: React.ElementType;\n    /** 是否展示输入框 */\n    inputShow?: boolean;\n    /** 多个chatbot唯一键 */\n    providerId?: string;\n    /** 消息顶部 */\n    messageTop?: ReactNode;\n    enableUpload?: boolean;\n    uploadRequest?: UploadProps['customRequest'];\n  }\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/types/XAiConversations.d.ts

@@ -0,0 +1,22 @@
+import { type ConversationsProps, type ConversationItemType } from "@ant-design/x";
+import React from "react";
+type OmitItems = Omit<ConversationsProps, "items" | "style">;
+export interface SessionData extends ConversationItemType {
+    meta?: any;
+}
+export interface XAiConversationsProps extends OmitItems {
+    /** 配色 */
+    color?: string;
+    /** 侧边栏展示形式,若为 true 则为抽屉式展示 */
+    isNarrow?: boolean;
+    /** 会话列表，替换原来的 items 字段 */
+    sessionList?: SessionData[];
+    /** session总数，当设置该值时，会增加自动加载逻辑 */
+    sessionTotal?: number;
+    /** 加载更多函数 */
+    loadMoreSession?: () => void;
+    /** 点击生成新对话回调 */
+    onNewChat?: () => void;
+    style?: React.CSSProperties;
+}
+export {};

package/dist/cjs/types/XAiConversations.js

@@ -0,0 +1,18 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/XAiConversations.ts
+var XAiConversations_exports = {};
+module.exports = __toCommonJS(XAiConversations_exports);
+//# sourceMappingURL=XAiConversations.js.map

package/dist/cjs/types/XAiConversations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/XAiConversations.ts"],
+  "sourcesContent": ["import {\n  type ConversationsProps,\n  type ConversationItemType,\n} from \"@ant-design/x\";\nimport React from \"react\";\n\ntype OmitItems = Omit<ConversationsProps, \"items\" | \"style\">;\n\nexport interface SessionData extends ConversationItemType {\n  meta?: any;\n}\n\nexport interface XAiConversationsProps extends OmitItems {\n  /** 配色 */\n  color?: string;\n  /** 侧边栏展示形式,若为 true 则为抽屉式展示 */\n  isNarrow?: boolean;\n  /** 会话列表，替换原来的 items 字段 */\n  sessionList?: SessionData[];\n  /** session总数，当设置该值时，会增加自动加载逻辑 */\n  sessionTotal?: number;\n  /** 加载更多函数 */\n  loadMoreSession?: () => void;\n  /** 点击生成新对话回调 */\n  onNewChat?: () => void;\n  style?: React.CSSProperties;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/types/XAiMessage.d.ts

@@ -0,0 +1,126 @@
+import type { PromptsProps } from '@ant-design/x';
+export type MessageType = 'TextMessage' | 'ActionExecutionMessage' | 'ResultMessage' | 'AgentStateMessage' | 'SuggestionMessage';
+export declare enum MessageRole {
+    user = "user",// 用户
+    assistant = "assistant",// AI助手
+    suggestion = "suggestion",// 建议
+    system = "system"
+}
+export declare enum MessageStatus {
+    init = "init",
+    pending = "pending",// 生成中/接收中
+    done = "done",// 已完成
+    failed = "failed",// 失败
+    recalled = "recalled",// 已撤回
+    deleted = "deleted"
+}
+/**
+ * 阶段性回答内容
+ */
+export interface Steps {
+    id: string;
+    content: any;
+}
+/**
+* 所有消息的基础结构
+*/
+export interface BaseMessage {
+    id: string;
+    type: MessageType;
+    createdAt: Date;
+    status?: MessageStatus;
+    execute?: ActionExecutionMessage[];
+    stepContent?: Steps[];
+    thinks?: string;
+    extra?: any;
+    isLike?: 0 | 1 | -1;
+    raw?: any;
+}
+export interface FileMessage {
+    fileId?: string | number;
+    fileName?: string;
+    fileSize?: number | string;
+    fileType?: string;
+    fileUrl?: string;
+}
+/**
+* 文本消息
+*/
+export interface TextMessage extends BaseMessage {
+    type: 'TextMessage';
+    role: MessageRole;
+    content: {
+        text?: string;
+        files?: FileMessage[];
+    };
+    parentMessageId?: string;
+}
+/**
+* 工具/动作执行消息
+*/
+export interface ActionExecutionMessage extends BaseMessage {
+    type: 'ActionExecutionMessage';
+    name: string;
+    arguments?: Record<string, any>;
+    parentMessageId?: string;
+    extra?: any;
+}
+/**
+* 工具/动作执行结果消息
+*/
+export interface ResultMessage extends BaseMessage {
+    type: 'ResultMessage';
+    actionExecutionId: string;
+    actionName: string;
+    result: string;
+}
+/**
+* 智能体状态消息
+*/
+export interface AgentStateMessage extends BaseMessage {
+    type: 'AgentStateMessage';
+    threadId: string;
+    agentName: string;
+    nodeName: string;
+    runId: string;
+    active: boolean;
+    role: MessageRole;
+    state: any;
+    running: boolean;
+}
+/**
+ * 提示消息
+ */
+export interface SuggestionMessage extends BaseMessage {
+    type: 'SuggestionMessage';
+    content: PromptsProps['items'];
+    role: MessageRole;
+}
+/**
+* 消息输入类型（用于前端输入/组装）
+* 可选地包含不同类型的消息体
+*/
+export interface MessageInput extends BaseMessage {
+    textMessage?: Omit<TextMessage, 'id' | 'createdAt' | 'type'>;
+    actionExecutionMessage?: Omit<ActionExecutionMessage, 'id' | 'createdAt' | 'type'>;
+    resultMessage?: Omit<ResultMessage, 'id' | 'createdAt' | 'type'>;
+    agentStateMessage?: Omit<AgentStateMessage, 'id' | 'createdAt' | 'type'>;
+}
+/**
+* 消息列表中消息格式
+*/
+export type Messages = TextMessage | SuggestionMessage;
+export declare enum ActionAvailability {
+    disabled = "disabled",// 不可用
+    enabled = "enabled",// 可用
+    remote = "remote"
+}
+/**
+* 工具/动作定义
+*/
+export interface Action {
+    name: string;
+    description: string;
+    jsonSchema: string;
+    available?: ActionAvailability;
+}

package/dist/cjs/types/XAiMessage.js

@@ -0,0 +1,55 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/XAiMessage.ts
+var XAiMessage_exports = {};
+__export(XAiMessage_exports, {
+  ActionAvailability: () => ActionAvailability,
+  MessageRole: () => MessageRole,
+  MessageStatus: () => MessageStatus
+});
+module.exports = __toCommonJS(XAiMessage_exports);
+var MessageRole = /* @__PURE__ */ ((MessageRole2) => {
+  MessageRole2["user"] = "user";
+  MessageRole2["assistant"] = "assistant";
+  MessageRole2["suggestion"] = "suggestion";
+  MessageRole2["system"] = "system";
+  return MessageRole2;
+})(MessageRole || {});
+var MessageStatus = /* @__PURE__ */ ((MessageStatus2) => {
+  MessageStatus2["init"] = "init";
+  MessageStatus2["pending"] = "pending";
+  MessageStatus2["done"] = "done";
+  MessageStatus2["failed"] = "failed";
+  MessageStatus2["recalled"] = "recalled";
+  MessageStatus2["deleted"] = "deleted";
+  return MessageStatus2;
+})(MessageStatus || {});
+var ActionAvailability = /* @__PURE__ */ ((ActionAvailability2) => {
+  ActionAvailability2["disabled"] = "disabled";
+  ActionAvailability2["enabled"] = "enabled";
+  ActionAvailability2["remote"] = "remote";
+  return ActionAvailability2;
+})(ActionAvailability || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ActionAvailability,
+  MessageRole,
+  MessageStatus
+});
+//# sourceMappingURL=XAiMessage.js.map

package/dist/cjs/types/XAiMessage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/XAiMessage.ts"],
+  "sourcesContent": ["import type { PromptsProps } from '@ant-design/x';\n\nexport type MessageType =\n| 'TextMessage'\n| 'ActionExecutionMessage'\n| 'ResultMessage'\n| 'AgentStateMessage'\n| 'SuggestionMessage';\n\nexport enum MessageRole {\n  user = 'user',      // 用户\n  assistant = 'assistant', // AI助手\n  suggestion = 'suggestion',  // 建议\n  system = 'system',      // 工具\n}\n\nexport enum MessageStatus {\n  init = 'init',\n  pending = 'pending', // 生成中/接收中\n  done = 'done', // 已完成\n  failed = 'failed', // 失败\n  recalled = 'recalled', // 已撤回\n  deleted = 'deleted', // 已删除\n}\n\n/**\n * 阶段性回答内容\n */\nexport interface Steps {\n  id: string; // 阶段性回答ID\n  content: any; // 文本内容\n}\n\n/**\n* 所有消息的基础结构\n*/\nexport interface BaseMessage {\n  id: string; // 消息唯一ID\n  type: MessageType; // 消息类型\n  createdAt: Date;   // 创建时间\n  status?: MessageStatus; // 内容是否生成中\n  execute?: ActionExecutionMessage[]; // 智能体执行过程\n  stepContent?: Steps[]; // 阶段性回答内容\n  thinks?: string ; // 思考过程\n  extra?: any; // 额外消息\n  isLike?: 0 | 1 | -1; // 是否喜欢\n  raw?: any; // 原始消息\n}\n\nexport interface FileMessage {\n  fileId?: string | number; // 文件ID\n  fileName?: string; // 文件名\n  fileSize?: number | string; // 文件大小（字节）\n  fileType?: string; // 文件类型（MIME类型）\n  fileUrl?: string; // 文件URL（可选，用于展示/下载）\n}\n\n/**\n* 文本消息\n*/\nexport interface TextMessage extends BaseMessage {\n  type: 'TextMessage';\n  role: MessageRole; // 发送者角色\n  content: {\n    text?: string;  // 文本内容\n    files?: FileMessage[]; // 文件列表\n  };\n  parentMessageId?: string; // 父消息ID（可选）\n}\n\n/**\n* 工具/动作执行消息\n*/\nexport interface ActionExecutionMessage extends BaseMessage {\n  type: 'ActionExecutionMessage';\n  name: string; // 动作/工具名称\n  arguments?: Record<string, any>; // 执行参数\n  parentMessageId?: string;\n  extra?: any; // 额外信息\n}\n\n/**\n* 工具/动作执行结果消息\n*/\nexport interface ResultMessage extends BaseMessage {\n  type: 'ResultMessage';\n  actionExecutionId: string; // 执行ID\n  actionName: string; // 动作/工具名称\n  result: string; // 执行结果\n}\n\n/**\n* 智能体状态消息\n*/\nexport interface AgentStateMessage extends BaseMessage {\n  type: 'AgentStateMessage';\n  threadId: string; // 线程ID\n  agentName: string; // agent名称\n  nodeName: string; // 节点名称\n  runId: string; // 运行ID\n  active: boolean; // 是否激活\n  role: MessageRole; // 角色\n  state: any; // 状态内容\n  running: boolean; // 是否运行中\n}\n\n/**\n * 提示消息\n */\nexport interface SuggestionMessage extends BaseMessage {\n  type: 'SuggestionMessage';\n  content: PromptsProps['items'];\n  role: MessageRole;\n}\n\n/**\n* 消息输入类型（用于前端输入/组装）\n* 可选地包含不同类型的消息体\n*/\nexport interface MessageInput extends BaseMessage {\n  textMessage?: Omit<TextMessage, 'id' | 'createdAt' | 'type'>;\n  actionExecutionMessage?: Omit<ActionExecutionMessage, 'id' | 'createdAt' | 'type'>;\n  resultMessage?: Omit<ResultMessage, 'id' | 'createdAt' | 'type'>;\n  agentStateMessage?: Omit<AgentStateMessage, 'id' | 'createdAt' | 'type'>;\n}\n\n/**\n* 消息列表中消息格式\n*/\nexport type Messages = TextMessage | SuggestionMessage;\n\nexport enum ActionAvailability {\n  disabled = 'disabled', // 不可用\n  enabled = 'enabled',   // 可用\n  remote = 'remote',     // 远程可用\n}\n\n/**\n* 工具/动作定义\n*/\nexport interface Action {\n  name: string; // 名称\n  description: string; // 描述\n  jsonSchema: string; // 参数JSON Schema\n  available?: ActionAvailability; // 可用性\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAK,cAAL,kBAAKA,iBAAL;AACL,EAAAA,aAAA,UAAO;AACP,EAAAA,aAAA,eAAY;AACZ,EAAAA,aAAA,gBAAa;AACb,EAAAA,aAAA,YAAS;AAJC,SAAAA;AAAA,GAAA;AAOL,IAAK,gBAAL,kBAAKC,mBAAL;AACL,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,aAAU;AACV,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,YAAS;AACT,EAAAA,eAAA,cAAW;AACX,EAAAA,eAAA,aAAU;AANA,SAAAA;AAAA,GAAA;AAmHL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,cAAW;AACX,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,YAAS;AAHC,SAAAA;AAAA,GAAA;",
+  "names": ["MessageRole", "MessageStatus", "ActionAvailability"]
+}

package/dist/cjs/types/XAiProvider.d.ts

@@ -0,0 +1,315 @@
+import React, { ReactNode } from 'react';
+import { AiClient } from '../client/base';
+import type { ChatbotMessageFields } from './XAiChatbot';
+import type { Messages, SendContent, SessionData, ChatConfig, ThemeType } from "./";
+/**
+ * 错误码枚举（数字格式）
+ * @enum {string}
+ * @version 1.0.0
+ */
+export declare enum ErrorCodeNum {
+    /** 应用下架 */
+    APP_NOT_ENABLE = "client_50017",
+    /** 应用删除 */
+    APP_DELETED = "client_50017",
+    /** 无该应用 */
+    APP_NOT_FOUND = "client_59999",
+    /** 接口报错 */
+    API_ERROR = "client_50054"
+}
+/**
+ * 错误码枚举
+ * @enum {string}
+ * @version 1.0.0
+ */
+export declare enum ErrorCode {
+    /** 应用未启用 */
+    APP_NOT_ENABLE = "APP_NOT_ENABLE",
+    /** 应用已删除 */
+    APP_DELETED = "APP_DELETED",
+    /** 应用未找到 */
+    APP_NOT_FOUND = "APP_NOT_FOUND",
+    /** API 错误 */
+    API_ERROR = "API_ERROR"
+}
+/**
+ * 错误码映射表
+ * @type {Record<string, {code: ErrorCode, message: string}>}
+ * @version 1.0.0
+ */
+export declare const ErrorCodeMap: {
+    client_50017: {
+        code: ErrorCode;
+        message: string;
+    };
+    client_50054: {
+        code: ErrorCode;
+        message: string;
+    };
+};
+/**
+ * 成功状态码枚举
+ * @enum {string}
+ * @version 1.0.0
+ */
+export declare enum SuccessCode {
+    /** 应用配置初始化成功 */
+    APP_CONFIG_INIT_SUCCESS = "APP_CONFIG_INIT_SUCCESS",
+    /** 应用消息初始化成功 */
+    APP_MESSAGES_INIT_SUCCESS = "APP_MESSAGES_INIT_SUCCESS"
+}
+/**
+ * 错误信息接口
+ * @interface Error
+ * @version 1.0.0
+ */
+export interface Error {
+    /** 错误码 */
+    code: ErrorCode;
+    /** 错误信息 */
+    message: string;
+}
+/**
+ * 成功信息接口
+ * @interface Success
+ * @version 1.0.0
+ */
+export interface Success {
+    /** 成功状态码 */
+    code: SuccessCode;
+    /** 成功信息 */
+    message: string;
+    /** 成功数据 */
+    data?: any;
+}
+/**
+ * XAiProvider 操作句柄接口
+ * @interface XAiProviderHandle
+ * @version 1.0.0
+ */
+export interface XAiProviderHandle {
+    /**
+     * 发送聊天消息
+     * @param content - 消息内容
+     * @type {(content: string) => void}
+     * @version 1.0.0
+     */
+    chat: (content: SendContent) => void;
+    /**
+     * 停止聊天
+     * @type {() => void}
+     * @version 1.0.0
+     */
+    stopChat: () => void;
+    /**
+     * 重新发送聊天
+     * @type {() => void}
+     * @version 1.0.0
+     */
+    reChat: () => void;
+    /**
+     * 获取应用信息
+     * @returns {any} 应用信息对象
+     * @type {() => any}
+     * @version 1.0.0
+     */
+    getAppInfo: () => any;
+    /**
+     * 获取消息列表
+     * @returns {Messages[]} 消息数组
+     * @type {() => Messages[]}
+     * @version 1.0.0
+     */
+    getMessages: () => Messages[];
+    /**
+     * 获取会话列表
+     * @returns {}
+     */
+    getSessions: () => SessionData[];
+    /**
+     * 重新设置当前会话
+     * @param id - 会话ID
+     * @type {(id: string) => void}
+     * @version 1.0.0
+     */
+    setCurrentSession: (id: string) => void;
+}
+export interface sessionConfig {
+    /**
+     * 是否展示会话列表
+     * @type {boolean}
+     * @default false
+     */
+    showSessionList?: boolean;
+}
+/**
+ * XAiProvider 配置接口
+ * @interface XAiProviderConfig
+ * @version 1.0.0
+ */
+export interface XAiProviderConfig {
+    /**
+     * 应用唯一编号
+     * @type {string}
+     * @default undefined
+     * @version 1.0.0
+     */
+    appNo?: string;
+    /**
+     * 会话配置
+     * @type {sessionConfig}
+     */
+    session?: sessionConfig;
+    /**
+     * 对话框配置
+     * @type {ChatConfig}
+     */
+    chatProps?: ChatConfig;
+    /**
+     * 是否启用调试模式
+     * @type {boolean}
+     * @default false
+     * @version 1.0.0
+     */
+    debug?: boolean;
+}
+/**
+ * XAiProvider 组件属性接口
+ * @interface XAiProviderProps
+ * @version 1.0.0
+ */
+export interface XAiProviderProps {
+    /**
+     * AI 服务地址
+     * @type {string}
+     * @version 1.0.0
+     */
+    url: string;
+    /**
+     * 认证 token
+     * @type {string}
+     * @version 1.0.0
+     */
+    token: string;
+    /**
+     * 配置信息
+     * @type {XAiProviderConfig}
+     * @default undefined
+     * @version 1.0.0
+     */
+    config?: XAiProviderConfig;
+    /**
+     * Provider 唯一标识，用于区分多个 Provider 实例
+     * @type {string}
+     * @default undefined
+     * @version 1.0.0
+     */
+    providerId?: string;
+    /**
+     * Token 刷新回调
+     * @type {() => Promise<string>}
+     * @default undefined
+     * @version 1.0.0
+     */
+    onRefreshToken?: () => Promise<string>;
+    /**
+     * 应用无法正常渲染回调
+     * @type {(error: Error) => void}
+     * @default undefined
+     * @version 1.0.0
+     */
+    onError?: (error: Error) => void;
+    /**
+     * 应用正常渲染回调
+     * @type {(success: Success) => void}
+     * @default undefined
+     * @version 1.0.0
+     */
+    onSuccess?: (success: Success) => void;
+    /**
+     * 消息返回回调
+     * @type {(data: Messages) => void}
+     * @default undefined
+     * @version 1.0.0
+     */
+    onMessage?: (content: string, data: Messages) => void;
+    /**
+     * 子组件
+     * @type {ReactNode}
+     * @version 1.0.0
+     */
+    children: ReactNode;
+}
+/**
+ * XAiSDK 组件属性接口
+ * @interface XAiSDKProps
+ * @extends XAiProviderProps
+ * @version 1.0.0
+ */
+export interface XAiSDKProps extends XAiProviderProps {
+    /**
+     * 主题类型
+     * @type {ThemeType}
+     * @default 'default'
+     * @version 1.0.0
+     */
+    theme?: ThemeType;
+    /**
+     * 组件属性配置
+     * @type {object}
+     * @default undefined
+     * @version 1.0.0
+     */
+    componentProps?: {
+        /**
+         * 组件ID
+         * @type {string}
+         * @default undefined
+         * @version 1.0.0
+         */
+        id?: string;
+        /** 支持任意 CSS 属性 */
+        [key: string]: any;
+    };
+}
+/**
+ * XAi 上下文类型接口
+ * @interface XAiContextType
+ * @extends Required<ChatbotMessageFields>
+ * @version 1.0.0
+ */
+export interface XAiContextType extends Required<ChatbotMessageFields> {
+    /**
+     * AI 客户端实例
+     * @type {AiClient | null}
+     * @default null
+     * @version 1.0.0
+     */
+    client: AiClient | null;
+    /**
+     * 认证令牌
+     * @type {string}
+     * @version 1.0.0
+     */
+    token: string;
+    /**
+     * 加载状态
+     * @type {boolean}
+     * @default false
+     * @version 1.0.0
+     */
+    loading: boolean;
+    /**
+     * 错误信息
+     * @type {string | null}
+     * @default null
+     * @version 1.0.0
+     */
+    error: string | null;
+}
+/**
+ * XAi 上下文对象
+ * @type {React.Context<XAiContextType | null>}
+ * @version 1.0.0
+ */
+export declare const XAiContext: React.Context<XAiContextType | null>;

package/dist/cjs/types/XAiProvider.js

@@ -0,0 +1,78 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types/XAiProvider.ts
+var XAiProvider_exports = {};
+__export(XAiProvider_exports, {
+  ErrorCode: () => ErrorCode,
+  ErrorCodeMap: () => ErrorCodeMap,
+  ErrorCodeNum: () => ErrorCodeNum,
+  SuccessCode: () => SuccessCode,
+  XAiContext: () => XAiContext
+});
+module.exports = __toCommonJS(XAiProvider_exports);
+var import_react = __toESM(require("react"));
+var ErrorCodeNum = /* @__PURE__ */ ((ErrorCodeNum2) => {
+  ErrorCodeNum2["APP_NOT_ENABLE"] = "client_50017";
+  ErrorCodeNum2["APP_DELETED"] = "client_50017";
+  ErrorCodeNum2["APP_NOT_FOUND"] = "client_59999";
+  ErrorCodeNum2["API_ERROR"] = "client_50054";
+  return ErrorCodeNum2;
+})(ErrorCodeNum || {});
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["APP_NOT_ENABLE"] = "APP_NOT_ENABLE";
+  ErrorCode2["APP_DELETED"] = "APP_DELETED";
+  ErrorCode2["APP_NOT_FOUND"] = "APP_NOT_FOUND";
+  ErrorCode2["API_ERROR"] = "API_ERROR";
+  return ErrorCode2;
+})(ErrorCode || {});
+var ErrorCodeMap = {
+  client_50017: {
+    code: "APP_NOT_ENABLE" /* APP_NOT_ENABLE */,
+    message: "该应用已删除或已下架"
+  },
+  client_50054: {
+    code: "API_ERROR" /* API_ERROR */,
+    message: "应用服务端出错"
+  }
+};
+var SuccessCode = /* @__PURE__ */ ((SuccessCode2) => {
+  SuccessCode2["APP_CONFIG_INIT_SUCCESS"] = "APP_CONFIG_INIT_SUCCESS";
+  SuccessCode2["APP_MESSAGES_INIT_SUCCESS"] = "APP_MESSAGES_INIT_SUCCESS";
+  return SuccessCode2;
+})(SuccessCode || {});
+var XAiContext = import_react.default.createContext(null);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorCode,
+  ErrorCodeMap,
+  ErrorCodeNum,
+  SuccessCode,
+  XAiContext
+});
+//# sourceMappingURL=XAiProvider.js.map