@ai-group/chat-sdk 3.6.2 → 3.6.4

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

@@ -19,6 +19,14 @@ export interface FileItem {
     tempUrl?: string;
     response?: any;
 }
+/** 文件图标类型 */
+export type FileIconType = "pdf" | "word" | "excel" | "ppt" | "audio" | "video" | "zip" | "markdown" | "image" | "default";
+/** 图片展示模式 */
+export type ImageDisplayMode = "thumbnail" | "preview" | "full";
+/** 音视频展示模式 */
+export type MediaDisplayMode = "inline" | "card";
+/** 文件卡片类型：不传则自动推断（图片/音频/视频用原生渲染），传 'file' 强制附件卡片展示 */
+export type FileCardType = "file" | "image" | "audio" | "video";
 export interface FileGalleryProps {
     file: FileItem;
     align?: "left" | "right";
@@ -28,6 +36,39 @@ export interface FileGalleryProps {
     style?: React.CSSProperties;
     /** 点击文件卡片回调（非图片、非音视频文件） */
     onClick?: (file: FileItem) => void;
+    /**
+     * 文件卡片类型
+     * - 不传：自动根据文件扩展名/MIME推断，图片/音频/视频使用原生渲染
+     * - 'file'：强制以附件卡片展示（音视频不可播放）
+     * - 'image' / 'audio' / 'video'：强制指定类型
+     */
+    type?: FileCardType;
+    /** 图片展示模式: thumbnail(缩略图) | preview(中等预览) | full(全宽) */
+    imageDisplayMode?: ImageDisplayMode;
+    /** 图片自定义宽度 */
+    imageWidth?: number | string;
+    /** 图片自定义高度 */
+    imageHeight?: number | string;
+    /** 图片加载策略 */
+    imageLoading?: "lazy" | "eager";
+    /** 图片 alt 文本 */
+    imageAlt?: string;
+    /** 自动播放(仅音频) */
+    mediaAutoPlay?: boolean;
+    /** 循环播放 */
+    mediaLoop?: boolean;
+    /** 静音 */
+    mediaMuted?: boolean;
+    /** 视频封面图 URL */
+    mediaPoster?: string;
+    /** 透传给原生 video 标签的属性 */
+    videoProps?: Partial<React.JSX.IntrinsicElements["video"]>;
+    /** 透传给原生 audio 标签的属性 */
+    audioProps?: Partial<React.JSX.IntrinsicElements["audio"]>;
+    /** 按文件类型自定义图标映射 */
+    iconMap?: Partial<Record<FileIconType, React.ReactNode>>;
+    /** 完全自定义图标（优先级最高，覆盖所有类型） */
+    customIcon?: React.ReactNode;
 }
 export interface FileItemComponentProps {
     file: FileItem;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/FileGallery.ts"],
-  "sourcesContent": ["/**\n * 统一的文件数据接口\n * 兼容 LocalFile (XAdkSender) 和 FileData (XadkChatbot)\n */\nexport interface FileItem {\n  // 基础字段\n  id?: string;\n  uid?: string;\n  name?: string;\n  displayName?: string;\n  size?: number;\n  type?: string;\n  mimeType?: string;\n\n  // 本地文件对象 (XAdkSender)\n  file?: File;\n\n  // 上传状态 (XAdkSender)\n  status?: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  progress?: number;\n  errorMessage?: string;\n\n  // URL 字段\n  fileUri?: string; // XadkChatbot\n  tempUrl?: string; // XAdkSender\n  response?: any;\n}\n\nexport interface FileGalleryProps {\n  file: FileItem;\n  align?: \"left\" | \"right\"; // 卡片内部布局：图标在左(默认)或右\n  removable?: boolean;\n  onRemove?: (id: string) => void;\n  className?: string;\n  style?: React.CSSProperties;\n  /** 点击文件卡片回调（非图片、非音视频文件） */\n  onClick?: (file: FileItem) => void;\n}\n\nexport interface FileItemComponentProps {\n  file: FileItem;\n  removable: boolean;\n  onRemove: (id: string) => void;\n}\n"],
+  "sourcesContent": ["/**\n * 统一的文件数据接口\n * 兼容 LocalFile (XAdkSender) 和 FileData (XadkChatbot)\n */\nexport interface FileItem {\n  // 基础字段\n  id?: string;\n  uid?: string;\n  name?: string;\n  displayName?: string;\n  size?: number;\n  type?: string;\n  mimeType?: string;\n\n  // 本地文件对象 (XAdkSender)\n  file?: File;\n\n  // 上传状态 (XAdkSender)\n  status?: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  progress?: number;\n  errorMessage?: string;\n\n  // URL 字段\n  fileUri?: string; // XadkChatbot\n  tempUrl?: string; // XAdkSender\n  response?: any;\n}\n\n/** 文件图标类型 */\nexport type FileIconType =\n  | \"pdf\"\n  | \"word\"\n  | \"excel\"\n  | \"ppt\"\n  | \"audio\"\n  | \"video\"\n  | \"zip\"\n  | \"markdown\"\n  | \"image\"\n  | \"default\";\n\n/** 图片展示模式 */\nexport type ImageDisplayMode = \"thumbnail\" | \"preview\" | \"full\";\n\n/** 音视频展示模式 */\nexport type MediaDisplayMode = \"inline\" | \"card\";\n\n/** 文件卡片类型：不传则自动推断（图片/音频/视频用原生渲染），传 'file' 强制附件卡片展示 */\nexport type FileCardType = \"file\" | \"image\" | \"audio\" | \"video\";\n\nexport interface FileGalleryProps {\n  file: FileItem;\n  align?: \"left\" | \"right\"; // 卡片内部布局：图标在左(默认)或右\n  removable?: boolean;\n  onRemove?: (id: string) => void;\n  className?: string;\n  style?: React.CSSProperties;\n  /** 点击文件卡片回调（非图片、非音视频文件） */\n  onClick?: (file: FileItem) => void;\n\n  /**\n   * 文件卡片类型\n   * - 不传：自动根据文件扩展名/MIME推断，图片/音频/视频使用原生渲染\n   * - 'file'：强制以附件卡片展示（音视频不可播放）\n   * - 'image' / 'audio' / 'video'：强制指定类型\n   */\n  type?: FileCardType;\n\n  // ========== 图片相关 ==========\n  /** 图片展示模式: thumbnail(缩略图) | preview(中等预览) | full(全宽) */\n  imageDisplayMode?: ImageDisplayMode;\n  /** 图片自定义宽度 */\n  imageWidth?: number | string;\n  /** 图片自定义高度 */\n  imageHeight?: number | string;\n  /** 图片加载策略 */\n  imageLoading?: \"lazy\" | \"eager\";\n  /** 图片 alt 文本 */\n  imageAlt?: string;\n\n  // ========== 音视频相关 ==========\n  /** 自动播放(仅音频) */\n  mediaAutoPlay?: boolean;\n  /** 循环播放 */\n  mediaLoop?: boolean;\n  /** 静音 */\n  mediaMuted?: boolean;\n  /** 视频封面图 URL */\n  mediaPoster?: string;\n  /** 透传给原生 video 标签的属性 */\n  videoProps?: Partial<React.JSX.IntrinsicElements[\"video\"]>;\n  /** 透传给原生 audio 标签的属性 */\n  audioProps?: Partial<React.JSX.IntrinsicElements[\"audio\"]>;\n\n  // ========== 自定义图标 ==========\n  /** 按文件类型自定义图标映射 */\n  iconMap?: Partial<Record<FileIconType, React.ReactNode>>;\n  /** 完全自定义图标（优先级最高，覆盖所有类型） */\n  customIcon?: React.ReactNode;\n}\n\nexport interface FileItemComponentProps {\n  file: FileItem;\n  removable: boolean;\n  onRemove: (id: string) => void;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -103,6 +103,10 @@ export interface ChatConfig {
 export interface XAdkProviderConfig {
     session?: {
         showSessionList?: boolean;
+        /** 是否轮询会话详情并主动补入异步任务消息，默认 true */
+        pollSessionEvents?: boolean;
+        /** 会话详情轮询间隔，单位毫秒，默认 10000，最小 1000 */
+        sessionEventsPollingInterval?: number;
     };
     /**
      * 初始化后是否默认展示第一条会话内容

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAdkProvider.ts"],
-  "sourcesContent": ["import { ReactNode } from \"react\";\nimport {\n  IMessage,\n  Success,\n  Event,\n  Error,\n  SendContent,\n  ThemeType,\n  FileItem,\n  UploadRequestFn,\n} from \"@/types\";\nimport type { ChatPresetInput, ChatStrategies } from \"./ChatStrategies\";\n\nexport interface DebugOptions {\n  url: string;\n  sessionId?: string;\n  config: any;\n  token: string;\n  type?: \"agentDebug\" | \"appDebug\";\n  /**\n   * 是否启用 Hook\n   * 当使用自定义 chatData 时,应设置为 false 以避免内部 Hook 初始化\n   * @default true\n   */\n  enabled?: boolean;\n  strategies?: ChatStrategies;\n  onError?: (error: Error) => void;\n  onSuccess?: (data: Success) => void;\n  onStream?: (data: Event) => void;\n  onMessage?: (content: string, data: IMessage) => void;\n}\n\n/**\n * 事件状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum EventCode {\n  /** 切换会话 */\n  SESSION_SWITCH = \"SESSION_SWITCH\",\n  /** 开启新会话 */\n  SESSION_CREATE = \"SESSION_CREATE\",\n}\n\nexport type handleEvent = {\n  code: EventCode;\n  message: string;\n  data?: any;\n};\n/**\n * renderFooter insert 参数说明\n */\nexport interface FooterRenderArgs {\n  message: IMessage;\n  isLastBotMsg: boolean;\n  isLastMsg: boolean;\n}\n\n/**\n * Provider 可通过 ref 暴露的方法句柄\n */\nexport interface XAdkProviderHandle {\n  startChat: (content: SendContent) => void;\n  stopChat: () => void;\n  reChat: () => void;\n  clearChat: () => void;\n  deleteSession: (id: string) => void;\n  updateSession: (id: string, title: string) => void;\n  getAppInfo: () => any;\n  getMessages: () => IMessage[];\n  getSessions: () => any[];\n  setMessages: (msgs: IMessage[]) => void;\n  setCurrentSession: (id: string) => void;\n  /**\n   * 设置自定义业务参数 (stateDelta)\n   * 设置后每次发送消息时会自动携带该参数至后端\n   * 传入 undefined 可清除已设置的参数\n   *\n   * @example\n   * providerRef.current.setStateDelta({ userId: '123', bizType: 'order' });\n   * // 之后发送消息，请求体会携带 stateDelta: { userId: '123', bizType: 'order' }\n   *\n   * @example\n   * // 清除自定义参数\n   * providerRef.current.setStateDelta(undefined);\n   */\n  setStateDelta: (delta: Record<string, any> | undefined) => void;\n}\n\n/**\n * config.chatProps 中的配置\n */\nexport interface ChatConfig {\n  /**\n   * 是否展示清空按钮\n   * @type {boolean}\n   * @default false\n   */\n  clearBtnShow?: boolean;\n  /**\n   * 是否展示输入框\n   * @type {boolean}\n   * @default true\n   */\n  inputShow?: boolean;\n  /**\n   * 打字机效果速度（单位：毫秒）\n   * @type {number}\n   * @default 60\n   * @version 1.0.0\n   */\n  textSpeed?: number;\n}\n\n/**\n * Provider config 整体配置结构\n */\nexport interface XAdkProviderConfig {\n  session?: {\n    showSessionList?: boolean;\n  };\n  /**\n   * 初始化后是否默认展示第一条会话内容\n   * @type {boolean}\n   * @default false\n   */\n  showFirstSession?: boolean;\n  allowUpload?: boolean;\n  /**\n   * 是否启用拖拽上传（需 allowUpload 为 true 时生效）\n   * 拖拽区域为整个聊天区域（不含侧边栏）\n   * @default true\n   */\n  draggable?: boolean;\n  appNo?: string;\n  chatProps?: ChatConfig;\n  debug?: boolean;\n  /**\n   * 是否展示点赞/点踩按钮\n   * @default true\n   */\n  showFeedback?: boolean;\n  /**\n   * 点击对话中附件卡片的回调（非图片、非音视频文件）\n   */\n  onFileClick?: (file: FileItem) => void;\n  /**\n   * 自定义文件上传函数\n   */\n  uploadRequest?: UploadRequestFn;\n  /**\n   * 预设策略。默认 xgroup-adk，用于兼容众安信科现有 ADK 协议。\n   * 传入 base 可获得更中立的组件默认行为。\n   */\n  preset?: ChatPresetInput;\n  /**\n   * 覆盖或补充当前 preset 的局部策略。\n   */\n  strategies?: ChatStrategies;\n}\n\n/**\n * XAdkProvider Props\n */\nexport interface XAdkProviderProps {\n  /**\n   * AI 服务基础地址\n   */\n  url?: string;\n  /**\n   * 认证 token\n   */\n  token: string;\n  /**\n   * 组件功能配置\n   */\n  config?: XAdkProviderConfig;\n  /**\n   * Provider 级预设策略，优先级高于 config.preset。\n   */\n  preset?: ChatPresetInput;\n  /**\n   * Provider 级策略覆盖，优先级高于 config.strategies。\n   */\n  strategies?: ChatStrategies;\n  /**\n   * Provider 唯一标识\n   */\n  providerId?: string;\n  /**\n   * 消息成功回调\n   */\n  onSuccess?: (success: any) => void;\n  /**\n   * 流式消息回调\n   */\n  onStream?: (data: Event) => void;\n  /**\n   * 错误回调\n   */\n  onError?: (err: any) => void;\n  /**\n   * 每条消息回调\n   */\n  onMessage?: (content: string, data: IMessage) => void;\n  /**\n   * 事件回调\n   */\n  onEvent?: (event: handleEvent) => void;\n  /**\n   * React 子元素 - 支持 Compound Components\n   */\n  children?: ReactNode;\n}\n\n// XAiSDKProps 继承 XAdkProviderProps\nexport interface XAdkSDKProps extends XAdkProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n"],
+  "sourcesContent": ["import { ReactNode } from \"react\";\nimport {\n  IMessage,\n  Success,\n  Event,\n  Error,\n  SendContent,\n  ThemeType,\n  FileItem,\n  UploadRequestFn,\n} from \"@/types\";\nimport type { ChatPresetInput, ChatStrategies } from \"./ChatStrategies\";\n\nexport interface DebugOptions {\n  url: string;\n  sessionId?: string;\n  config: any;\n  token: string;\n  type?: \"agentDebug\" | \"appDebug\";\n  /**\n   * 是否启用 Hook\n   * 当使用自定义 chatData 时,应设置为 false 以避免内部 Hook 初始化\n   * @default true\n   */\n  enabled?: boolean;\n  strategies?: ChatStrategies;\n  onError?: (error: Error) => void;\n  onSuccess?: (data: Success) => void;\n  onStream?: (data: Event) => void;\n  onMessage?: (content: string, data: IMessage) => void;\n}\n\n/**\n * 事件状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum EventCode {\n  /** 切换会话 */\n  SESSION_SWITCH = \"SESSION_SWITCH\",\n  /** 开启新会话 */\n  SESSION_CREATE = \"SESSION_CREATE\",\n}\n\nexport type handleEvent = {\n  code: EventCode;\n  message: string;\n  data?: any;\n};\n/**\n * renderFooter insert 参数说明\n */\nexport interface FooterRenderArgs {\n  message: IMessage;\n  isLastBotMsg: boolean;\n  isLastMsg: boolean;\n}\n\n/**\n * Provider 可通过 ref 暴露的方法句柄\n */\nexport interface XAdkProviderHandle {\n  startChat: (content: SendContent) => void;\n  stopChat: () => void;\n  reChat: () => void;\n  clearChat: () => void;\n  deleteSession: (id: string) => void;\n  updateSession: (id: string, title: string) => void;\n  getAppInfo: () => any;\n  getMessages: () => IMessage[];\n  getSessions: () => any[];\n  setMessages: (msgs: IMessage[]) => void;\n  setCurrentSession: (id: string) => void;\n  /**\n   * 设置自定义业务参数 (stateDelta)\n   * 设置后每次发送消息时会自动携带该参数至后端\n   * 传入 undefined 可清除已设置的参数\n   *\n   * @example\n   * providerRef.current.setStateDelta({ userId: '123', bizType: 'order' });\n   * // 之后发送消息，请求体会携带 stateDelta: { userId: '123', bizType: 'order' }\n   *\n   * @example\n   * // 清除自定义参数\n   * providerRef.current.setStateDelta(undefined);\n   */\n  setStateDelta: (delta: Record<string, any> | undefined) => void;\n}\n\n/**\n * config.chatProps 中的配置\n */\nexport interface ChatConfig {\n  /**\n   * 是否展示清空按钮\n   * @type {boolean}\n   * @default false\n   */\n  clearBtnShow?: boolean;\n  /**\n   * 是否展示输入框\n   * @type {boolean}\n   * @default true\n   */\n  inputShow?: boolean;\n  /**\n   * 打字机效果速度（单位：毫秒）\n   * @type {number}\n   * @default 60\n   * @version 1.0.0\n   */\n  textSpeed?: number;\n}\n\n/**\n * Provider config 整体配置结构\n */\nexport interface XAdkProviderConfig {\n  session?: {\n    showSessionList?: boolean;\n    /** 是否轮询会话详情并主动补入异步任务消息，默认 true */\n    pollSessionEvents?: boolean;\n    /** 会话详情轮询间隔，单位毫秒，默认 10000，最小 1000 */\n    sessionEventsPollingInterval?: number;\n  };\n  /**\n   * 初始化后是否默认展示第一条会话内容\n   * @type {boolean}\n   * @default false\n   */\n  showFirstSession?: boolean;\n  allowUpload?: boolean;\n  /**\n   * 是否启用拖拽上传（需 allowUpload 为 true 时生效）\n   * 拖拽区域为整个聊天区域（不含侧边栏）\n   * @default true\n   */\n  draggable?: boolean;\n  appNo?: string;\n  chatProps?: ChatConfig;\n  debug?: boolean;\n  /**\n   * 是否展示点赞/点踩按钮\n   * @default true\n   */\n  showFeedback?: boolean;\n  /**\n   * 点击对话中附件卡片的回调（非图片、非音视频文件）\n   */\n  onFileClick?: (file: FileItem) => void;\n  /**\n   * 自定义文件上传函数\n   */\n  uploadRequest?: UploadRequestFn;\n  /**\n   * 预设策略。默认 xgroup-adk，用于兼容众安信科现有 ADK 协议。\n   * 传入 base 可获得更中立的组件默认行为。\n   */\n  preset?: ChatPresetInput;\n  /**\n   * 覆盖或补充当前 preset 的局部策略。\n   */\n  strategies?: ChatStrategies;\n}\n\n/**\n * XAdkProvider Props\n */\nexport interface XAdkProviderProps {\n  /**\n   * AI 服务基础地址\n   */\n  url?: string;\n  /**\n   * 认证 token\n   */\n  token: string;\n  /**\n   * 组件功能配置\n   */\n  config?: XAdkProviderConfig;\n  /**\n   * Provider 级预设策略，优先级高于 config.preset。\n   */\n  preset?: ChatPresetInput;\n  /**\n   * Provider 级策略覆盖，优先级高于 config.strategies。\n   */\n  strategies?: ChatStrategies;\n  /**\n   * Provider 唯一标识\n   */\n  providerId?: string;\n  /**\n   * 消息成功回调\n   */\n  onSuccess?: (success: any) => void;\n  /**\n   * 流式消息回调\n   */\n  onStream?: (data: Event) => void;\n  /**\n   * 错误回调\n   */\n  onError?: (err: any) => void;\n  /**\n   * 每条消息回调\n   */\n  onMessage?: (content: string, data: IMessage) => void;\n  /**\n   * 事件回调\n   */\n  onEvent?: (event: handleEvent) => void;\n  /**\n   * React 子元素 - 支持 Compound Components\n   */\n  children?: ReactNode;\n}\n\n// XAiSDKProps 继承 XAdkProviderProps\nexport interface XAdkSDKProps extends XAdkProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqCO,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,oBAAiB;AAEjB,EAAAA,WAAA,oBAAiB;AAJP,SAAAA;AAAA,GAAA;",
   "names": ["EventCode"]
 }

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

@@ -3,54 +3,19 @@ import { AiClient } from '../client/base';
 import type { ChatbotMessageFields } from './XAiChatbot';
 import type { Messages, SendContent, SessionData, ChatConfig, ThemeType } from "./";
 /**
- * 错误码枚举（数字格式）
+ * SDK 内部错误码（仅用于 SDK 自身可确定的错误场景）
+ * 服务端返回的业务错误码会原样透传，接入方在 onError 中自行判断
  * @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"
+    /** 网络异常 / HTTP 错误 / 超时等 */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** HTTP 401/403 认证失败 */
+    AUTH_ERROR = "AUTH_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;
-    };
-};
-/**
- * 成功状态码枚举
+ * 成功状态码枚举（SDK 内部生命周期事件）
  * @enum {string}
- * @version 1.0.0
  */
 export declare enum SuccessCode {
     /** 应用配置初始化成功 */
@@ -60,14 +25,16 @@ export declare enum SuccessCode {
 }
 /**
  * 错误信息接口
- * @interface Error
- * @version 1.0.0
+ * - SDK 自身错误：code 为 ErrorCode 枚举值
+ * - 服务端业务错误：code 为服务端原始 code（如 "XS010016"），由接入方自行解读
  */
 export interface Error {
-    /** 错误码 */
-    code: ErrorCode;
+    /** 错误码：SDK 内部 ErrorCode 或服务端原始 code */
+    code: string;
     /** 错误信息 */
     message: string;
+    /** 服务端原始响应（仅服务端业务错误时携带） */
+    raw?: Record<string, any>;
 }
 /**
  * 成功信息接口

package/dist/cjs/types/XAiProvider.js

@@ -30,37 +30,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 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";
+  ErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  ErrorCode2["AUTH_ERROR"] = "AUTH_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";
@@ -70,8 +49,6 @@ 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
 });

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAiProvider.ts"],
-  "sourcesContent": ["// context/ProviderContext.ts\nimport React, { ReactNode } from 'react';\nimport { AiClient } from '../client/base';\nimport type { ChatbotMessageFields } from './XAiChatbot';\nimport type { Messages, SendContent, SessionData, ChatConfig, ThemeType } from '@/types';\n\n/**\n * 错误码枚举（数字格式）\n * @enum {string}\n * @version 1.0.0\n */\nexport enum ErrorCodeNum {\n  /** 应用下架 */\n  APP_NOT_ENABLE = 'client_50017',\n  /** 应用删除 */\n  APP_DELETED = 'client_50017',\n  /** 无该应用 */\n  APP_NOT_FOUND = 'client_59999',\n  /** 接口报错 */\n  API_ERROR = 'client_50054',\n}\n\n/**\n * 错误码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum ErrorCode {\n  /** 应用未启用 */\n  APP_NOT_ENABLE = 'APP_NOT_ENABLE',\n  /** 应用已删除 */\n  APP_DELETED = 'APP_DELETED',\n  /** 应用未找到 */\n  APP_NOT_FOUND = 'APP_NOT_FOUND',\n  /** API 错误 */\n  API_ERROR = 'API_ERROR',\n}\n\n/**\n * 错误码映射表\n * @type {Record<string, {code: ErrorCode, message: string}>}\n * @version 1.0.0\n */\nexport const ErrorCodeMap = {\n  client_50017: {\n    code: ErrorCode.APP_NOT_ENABLE,\n    message: '该应用已删除或已下架',\n  },\n  client_50054: {\n    code: ErrorCode.API_ERROR,\n    message: '应用服务端出错',\n  },\n};\n\n/**\n * 成功状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum SuccessCode {\n  /** 应用配置初始化成功 */\n  APP_CONFIG_INIT_SUCCESS = 'APP_CONFIG_INIT_SUCCESS',\n  /** 应用消息初始化成功 */\n  APP_MESSAGES_INIT_SUCCESS = 'APP_MESSAGES_INIT_SUCCESS',\n}\n\n/**\n * 错误信息接口\n * @interface Error\n * @version 1.0.0\n */\nexport interface Error {\n  /** 错误码 */\n  code: ErrorCode;\n  /** 错误信息 */\n  message: string;\n}\n\n/**\n * 成功信息接口\n * @interface Success\n * @version 1.0.0\n */\nexport interface Success {\n  /** 成功状态码 */\n  code: SuccessCode;\n  /** 成功信息 */\n  message: string;\n  /** 成功数据 */\n  data?: any;\n}\n\n/**\n * XAiProvider 操作句柄接口\n * @interface XAiProviderHandle\n * @version 1.0.0\n */\nexport interface XAiProviderHandle {\n  /**\n   * 发送聊天消息\n   * @param content - 消息内容\n   * @type {(content: string) => void}\n   * @version 1.0.0\n   */\n  chat: (content: SendContent) => void;\n\n  /**\n   * 停止聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  stopChat: () => void;\n\n  /**\n   * 重新发送聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  reChat: () => void;\n\n  /**\n   * 获取应用信息\n   * @returns {any} 应用信息对象\n   * @type {() => any}\n   * @version 1.0.0\n   */\n  getAppInfo: () => any;\n\n  /**\n   * 获取消息列表\n   * @returns {Messages[]} 消息数组\n   * @type {() => Messages[]}\n   * @version 1.0.0\n   */\n  getMessages: () => Messages[];\n\n  /**\n   * 获取会话列表\n   * @returns {}\n   */\n  getSessions: () => SessionData[];\n\n  /**\n   * 重新设置当前会话\n   * @param id - 会话ID\n   * @type {(id: string) => void}\n   * @version 1.0.0\n   */\n  setCurrentSession: (id: string) => void;\n}\n\nexport interface sessionConfig {\n  /**\n   * 是否展示会话列表\n   * @type {boolean}\n   * @default false\n   */\n  showSessionList?: boolean;\n}\n\n\n/**\n * XAiProvider 配置接口\n * @interface XAiProviderConfig\n * @version 1.0.0\n */\nexport interface XAiProviderConfig {\n  /**\n   * 应用唯一编号\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  appNo?: string;\n\n  /**\n   * 会话配置\n   * @type {sessionConfig}\n   */\n  session?: sessionConfig;\n\n  /**\n   * 对话框配置\n   * @type {ChatConfig}\n   */\n  chatProps?: ChatConfig;\n\n  /**\n   * 是否启用调试模式\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  debug?: boolean;\n}\n\n/**\n * XAiProvider 组件属性接口\n * @interface XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiProviderProps {\n  /**\n   * AI 服务地址\n   * @type {string}\n   * @version 1.0.0\n   */\n  url: string;\n\n  /**\n   * 认证 token\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 配置信息\n   * @type {XAiProviderConfig}\n   * @default undefined\n   * @version 1.0.0\n   */\n  config?: XAiProviderConfig;\n\n  /**\n   * Provider 唯一标识，用于区分多个 Provider 实例\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  providerId?: string;\n\n  /**\n   * Token 刷新回调\n   * @type {() => Promise<string>}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onRefreshToken?: () => Promise<string>;\n\n  /**\n   * 应用无法正常渲染回调\n   * @type {(error: Error) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * 应用正常渲染回调\n   * @type {(success: Success) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onSuccess?: (success: Success) => void;\n\n  /**\n   * 消息返回回调\n   * @type {(data: Messages) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onMessage?: (content: string, data: Messages) => void;\n\n  /**\n   * 子组件\n   * @type {ReactNode}\n   * @version 1.0.0\n   */\n  children: ReactNode;\n}\n\n/**\n * XAiSDK 组件属性接口\n * @interface XAiSDKProps\n * @extends XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiSDKProps extends XAiProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n\n/**\n * XAi 上下文类型接口\n * @interface XAiContextType\n * @extends Required<ChatbotMessageFields>\n * @version 1.0.0\n */\nexport interface XAiContextType extends Required<ChatbotMessageFields> {\n  /**\n   * AI 客户端实例\n   * @type {AiClient | null}\n   * @default null\n   * @version 1.0.0\n   */\n  client: AiClient | null;\n\n  /**\n   * 认证令牌\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 加载状态\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  loading: boolean;\n\n  /**\n   * 错误信息\n   * @type {string | null}\n   * @default null\n   * @version 1.0.0\n   */\n  error: string | null;\n}\n\n/**\n * XAi 上下文对象\n * @type {React.Context<XAiContextType | null>}\n * @version 1.0.0\n */\nexport const XAiContext = React.createContext<XAiContextType | null>(null);\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAiC;AAU1B,IAAK,eAAL,kBAAKA,kBAAL;AAEL,EAAAA,cAAA,oBAAiB;AAEjB,EAAAA,cAAA,iBAAc;AAEd,EAAAA,cAAA,mBAAgB;AAEhB,EAAAA,cAAA,eAAY;AARF,SAAAA;AAAA,GAAA;AAgBL,IAAK,YAAL,kBAAKC,eAAL;AAEL,EAAAA,WAAA,oBAAiB;AAEjB,EAAAA,WAAA,iBAAc;AAEd,EAAAA,WAAA,mBAAgB;AAEhB,EAAAA,WAAA,eAAY;AARF,SAAAA;AAAA,GAAA;AAgBL,IAAM,eAAe;AAAA,EAC1B,cAAc;AAAA,IACZ,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AAAA,EACA,cAAc;AAAA,IACZ,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AACF;AAOO,IAAK,cAAL,kBAAKC,iBAAL;AAEL,EAAAA,aAAA,6BAA0B;AAE1B,EAAAA,aAAA,+BAA4B;AAJlB,SAAAA;AAAA,GAAA;AAmSL,IAAM,aAAa,aAAAC,QAAM,cAAqC,IAAI;",
-  "names": ["ErrorCodeNum", "ErrorCode", "SuccessCode", "React"]
+  "sourcesContent": ["// context/ProviderContext.ts\nimport React, { ReactNode } from 'react';\nimport { AiClient } from '../client/base';\nimport type { ChatbotMessageFields } from './XAiChatbot';\nimport type { Messages, SendContent, SessionData, ChatConfig, ThemeType } from '@/types';\n\n/**\n * SDK 内部错误码（仅用于 SDK 自身可确定的错误场景）\n * 服务端返回的业务错误码会原样透传，接入方在 onError 中自行判断\n * @enum {string}\n */\nexport enum ErrorCode {\n  /** 网络异常 / HTTP 错误 / 超时等 */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  /** HTTP 401/403 认证失败 */\n  AUTH_ERROR = 'AUTH_ERROR',\n}\n\n/**\n * 成功状态码枚举（SDK 内部生命周期事件）\n * @enum {string}\n */\nexport enum SuccessCode {\n  /** 应用配置初始化成功 */\n  APP_CONFIG_INIT_SUCCESS = 'APP_CONFIG_INIT_SUCCESS',\n  /** 应用消息初始化成功 */\n  APP_MESSAGES_INIT_SUCCESS = 'APP_MESSAGES_INIT_SUCCESS',\n}\n\n/**\n * 错误信息接口\n * - SDK 自身错误：code 为 ErrorCode 枚举值\n * - 服务端业务错误：code 为服务端原始 code（如 \"XS010016\"），由接入方自行解读\n */\nexport interface Error {\n  /** 错误码：SDK 内部 ErrorCode 或服务端原始 code */\n  code: string;\n  /** 错误信息 */\n  message: string;\n  /** 服务端原始响应（仅服务端业务错误时携带） */\n  raw?: Record<string, any>;\n}\n\n/**\n * 成功信息接口\n * @interface Success\n * @version 1.0.0\n */\nexport interface Success {\n  /** 成功状态码 */\n  code: SuccessCode;\n  /** 成功信息 */\n  message: string;\n  /** 成功数据 */\n  data?: any;\n}\n\n/**\n * XAiProvider 操作句柄接口\n * @interface XAiProviderHandle\n * @version 1.0.0\n */\nexport interface XAiProviderHandle {\n  /**\n   * 发送聊天消息\n   * @param content - 消息内容\n   * @type {(content: string) => void}\n   * @version 1.0.0\n   */\n  chat: (content: SendContent) => void;\n\n  /**\n   * 停止聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  stopChat: () => void;\n\n  /**\n   * 重新发送聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  reChat: () => void;\n\n  /**\n   * 获取应用信息\n   * @returns {any} 应用信息对象\n   * @type {() => any}\n   * @version 1.0.0\n   */\n  getAppInfo: () => any;\n\n  /**\n   * 获取消息列表\n   * @returns {Messages[]} 消息数组\n   * @type {() => Messages[]}\n   * @version 1.0.0\n   */\n  getMessages: () => Messages[];\n\n  /**\n   * 获取会话列表\n   * @returns {}\n   */\n  getSessions: () => SessionData[];\n\n  /**\n   * 重新设置当前会话\n   * @param id - 会话ID\n   * @type {(id: string) => void}\n   * @version 1.0.0\n   */\n  setCurrentSession: (id: string) => void;\n}\n\nexport interface sessionConfig {\n  /**\n   * 是否展示会话列表\n   * @type {boolean}\n   * @default false\n   */\n  showSessionList?: boolean;\n}\n\n\n/**\n * XAiProvider 配置接口\n * @interface XAiProviderConfig\n * @version 1.0.0\n */\nexport interface XAiProviderConfig {\n  /**\n   * 应用唯一编号\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  appNo?: string;\n\n  /**\n   * 会话配置\n   * @type {sessionConfig}\n   */\n  session?: sessionConfig;\n\n  /**\n   * 对话框配置\n   * @type {ChatConfig}\n   */\n  chatProps?: ChatConfig;\n\n  /**\n   * 是否启用调试模式\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  debug?: boolean;\n}\n\n/**\n * XAiProvider 组件属性接口\n * @interface XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiProviderProps {\n  /**\n   * AI 服务地址\n   * @type {string}\n   * @version 1.0.0\n   */\n  url: string;\n\n  /**\n   * 认证 token\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 配置信息\n   * @type {XAiProviderConfig}\n   * @default undefined\n   * @version 1.0.0\n   */\n  config?: XAiProviderConfig;\n\n  /**\n   * Provider 唯一标识，用于区分多个 Provider 实例\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  providerId?: string;\n\n  /**\n   * Token 刷新回调\n   * @type {() => Promise<string>}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onRefreshToken?: () => Promise<string>;\n\n  /**\n   * 应用无法正常渲染回调\n   * @type {(error: Error) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * 应用正常渲染回调\n   * @type {(success: Success) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onSuccess?: (success: Success) => void;\n\n  /**\n   * 消息返回回调\n   * @type {(data: Messages) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onMessage?: (content: string, data: Messages) => void;\n\n  /**\n   * 子组件\n   * @type {ReactNode}\n   * @version 1.0.0\n   */\n  children: ReactNode;\n}\n\n/**\n * XAiSDK 组件属性接口\n * @interface XAiSDKProps\n * @extends XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiSDKProps extends XAiProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n\n/**\n * XAi 上下文类型接口\n * @interface XAiContextType\n * @extends Required<ChatbotMessageFields>\n * @version 1.0.0\n */\nexport interface XAiContextType extends Required<ChatbotMessageFields> {\n  /**\n   * AI 客户端实例\n   * @type {AiClient | null}\n   * @default null\n   * @version 1.0.0\n   */\n  client: AiClient | null;\n\n  /**\n   * 认证令牌\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 加载状态\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  loading: boolean;\n\n  /**\n   * 错误信息\n   * @type {string | null}\n   * @default null\n   * @version 1.0.0\n   */\n  error: string | null;\n}\n\n/**\n * XAi 上下文对象\n * @type {React.Context<XAiContextType | null>}\n * @version 1.0.0\n */\nexport const XAiContext = React.createContext<XAiContextType | null>(null);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAiC;AAU1B,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,mBAAgB;AAEhB,EAAAA,WAAA,gBAAa;AAJH,SAAAA;AAAA,GAAA;AAWL,IAAK,cAAL,kBAAKC,iBAAL;AAEL,EAAAA,aAAA,6BAA0B;AAE1B,EAAAA,aAAA,+BAA4B;AAJlB,SAAAA;AAAA,GAAA;AAqSL,IAAM,aAAa,aAAAC,QAAM,cAAqC,IAAI;",
+  "names": ["ErrorCode", "SuccessCode", "React"]
 }

package/dist/esm/components/FileGallery/index.d.ts

@@ -1,34 +1,4 @@
 import React from "react";
 import { FileGalleryProps } from "../../types";
-/**
- * FileGallery - 单文件展示组件
- *
- * 功能特性:
- * - 📁 支持多种文件类型展示 (图片、音频、视频、文档等)
- * - 🖼️ 图片支持预览和缩略图
- * - 🎵 音频文件支持内联播放
- * - 🎬 视频文件支持内联播放
- * - 📊 显示文件大小、类型图标
- * - 🗑️ 支持删除操作
- * - 📤 支持上传进度显示
- * - 🎨 支持卡片内部布局控制（align：图标和信息的排列方式）
- *
- * @example
- * // XAdkSender 场景 - 可删除的本地文件
- * {files.map(file => (
- *   <FileGallery
- *     key={file.id}
- *     file={file}
- *     removable
- *     onRemove={handleRemove}
- *   />
- * ))}
- *
- * @example
- * // XadkChatbot 场景 - 只读的远程文件
- * {files.map(file => (
- *   <FileGallery key={file.id} file={file} />
- * ))}
- */
 declare const FileGallery: React.FC<FileGalleryProps>;
 export default FileGallery;