@ai-group/chat-sdk 3.5.5 → 3.5.7

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

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

package/dist/cjs/types/XAdkProvider.js

@@ -0,0 +1,34 @@
+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/XAdkProvider.ts
+var XAdkProvider_exports = {};
+__export(XAdkProvider_exports, {
+  EventCode: () => EventCode
+});
+module.exports = __toCommonJS(XAdkProvider_exports);
+var EventCode = /* @__PURE__ */ ((EventCode2) => {
+  EventCode2["SESSION_SWITCH"] = "SESSION_SWITCH";
+  EventCode2["SESSION_CREATE"] = "SESSION_CREATE";
+  return EventCode2;
+})(EventCode || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EventCode
+});
+//# sourceMappingURL=XAdkProvider.js.map

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

@@ -0,0 +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"],
+  "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/XAdkSender.d.ts

@@ -0,0 +1,114 @@
+import React from "react";
+export interface UploadFileResult {
+    fileName?: string;
+    fileId?: string | number;
+    tempUrl?: string;
+    url?: string;
+    fileUrl?: string;
+    fileType?: string;
+    fileSize?: number;
+    mimeType?: string;
+    [key: string]: any;
+}
+export interface UploadSuccessResponse {
+    data?: UploadFileResult | UploadFileResult[];
+    [key: string]: any;
+}
+interface uploadRequestProps {
+    (options: {
+        file: File;
+        onProgress?: (e: {
+            percent: number;
+        }) => void;
+        onSuccess?: (response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse) => void;
+        onError?: (error: Error) => void;
+    }): Promise<void> | void;
+}
+export type UploadRequestFn = uploadRequestProps;
+export interface ServerFile {
+    fileName: string;
+    fileId: string | number;
+    tempUrl: string;
+    type: string;
+    size?: number;
+    mimeType: string;
+    raw?: UploadFileResult;
+}
+export interface LocalFile {
+    id: string;
+    uid: string;
+    name: string;
+    file: File;
+    size: number;
+    type: string;
+    progress: number;
+    status: "pending" | "uploading" | "success" | "error";
+    fileId?: string | number;
+    tempUrl?: string;
+    response?: any;
+    errorMessage?: string;
+}
+export type FileValidator = (file: File, context: {
+    files: LocalFile[];
+}) => string | null;
+export interface ActionsComponents {
+    SendButton: React.ComponentType<any>;
+    UploadButton: React.ComponentType<any>;
+    ClearButton: React.ComponentType<any>;
+}
+export type SlotRenderFunction = (oriNode: React.ReactNode, info: {
+    components: ActionsComponents;
+}) => React.ReactNode | false;
+export interface UploaderCoreProps {
+    uploadRequest?: uploadRequestProps;
+    maxFileSize?: number;
+    allowedFileTypes?: string[];
+    maxFiles?: number;
+    validators?: FileValidator[];
+    onFilesChange?: (files: LocalFile[]) => void;
+    onUploadSuccess?: (file: LocalFile) => void;
+    onUploadError?: (file: LocalFile, error: Error) => void;
+}
+export interface SenderUIProps {
+    clearBtnShow?: boolean;
+    allowUpload?: boolean;
+    /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */
+    draggable?: boolean;
+    /** 是否显示输入框顶部渐变遮罩（通过 ::before 伪元素实现），默认开启 */
+    showMask?: boolean;
+    loading?: boolean;
+    disabled?: boolean;
+    /** 受控：输入框的值 */
+    value?: string;
+    /** 非受控：输入框默认值 */
+    defaultValue?: string;
+    onClear?: () => void;
+    onChange?: (value: string) => void;
+    onSubmit?: (data: {
+        text: string;
+        files: ServerFile[];
+    }) => void;
+    onStop?: () => void;
+    /** 自定义发送按钮渲染 */
+    sendButtonRender?: (info: {
+        loading: boolean;
+        disabled: boolean;
+        /** 当前是否可以发送（文本非空或有已上传的文件） */
+        canSend: boolean;
+        onSend: () => void;
+        onStop?: () => void;
+    }) => React.ReactNode;
+    /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */
+    suffix?: React.ReactNode | false | SlotRenderFunction;
+    /** 头部面板 */
+    header?: React.ReactNode | false | SlotRenderFunction;
+    /** 前缀内容 */
+    prefix?: React.ReactNode | false | SlotRenderFunction;
+    /** 底部内容 */
+    footer?: React.ReactNode | false | SlotRenderFunction;
+}
+export type XAdkSenderProps = SenderUIProps & UploaderCoreProps;
+export interface XAdkSenderHandle {
+    addFiles: (files: File[]) => void;
+}
+export {};

package/dist/cjs/types/XAdkSender.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/XAdkSender.ts
+var XAdkSender_exports = {};
+module.exports = __toCommonJS(XAdkSender_exports);
+//# sourceMappingURL=XAdkSender.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/XAdkSender.ts"],
+  "sourcesContent": ["// types/XAdkSender.ts\nimport React from \"react\";\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  UploadButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */\n  draggable?: boolean;\n  /** 是否显示输入框顶部渐变遮罩（通过 ::before 伪元素实现），默认开启 */\n  showMask?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: { text: string; files: ServerFile[] }) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 头部面板 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

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

@@ -0,0 +1,35 @@
+import React, { type ReactNode } from "react";
+import { IMessage, RenderFunctionCall, ToolRenderKind, ChatStrategies } from "./";
+export interface XAdkThoughtChainProps {
+    defaultOpen?: boolean;
+    loading?: boolean;
+    title?: ReactNode;
+    items: ThoughtChainItemType[];
+    showFnCallDetail?: boolean;
+    onConfirm?: (fnCall: any, confirmed: boolean) => void;
+    blink?: boolean;
+    /** 自定义工具调用渲染函数，返回 null 则使用默认渲染 */
+    renderFunctionCall?: RenderFunctionCall;
+    /**
+     * 工具名 → 渲染类型的解析策略，默认使用 defaultToolKindResolver
+     */
+    toolKindResolver?: (name: string | undefined) => ToolRenderKind;
+    /** 聊天策略，可由 Provider preset 自动下发，也可在组件局部覆盖。 */
+    strategies?: ChatStrategies;
+}
+export interface TimelineItemProps {
+    icon: React.ReactNode;
+    title: React.ReactNode;
+    children: React.ReactNode;
+    collapsible?: boolean;
+    defaultOpen?: boolean;
+    blink?: boolean;
+}
+export interface ThoughtChainItemType {
+    type: "tool" | "text";
+    key: string;
+    content: string;
+    title?: ReactNode;
+    collapsible?: boolean;
+    msg?: IMessage;
+}

package/dist/cjs/types/XAdkThoughtChain.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/XAdkThoughtChain.ts
+var XAdkThoughtChain_exports = {};
+module.exports = __toCommonJS(XAdkThoughtChain_exports);
+//# sourceMappingURL=XAdkThoughtChain.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/XAdkThoughtChain.ts"],
+  "sourcesContent": ["import React, { type ReactNode } from \"react\";\nimport {\n  IMessage,\n  RenderFunctionCall,\n  ToolRenderKind,\n  ChatStrategies,\n} from \"@/types\";\n\nexport interface XAdkThoughtChainProps {\n  defaultOpen?: boolean;\n  loading?: boolean;\n  title?: ReactNode;\n  items: ThoughtChainItemType[];\n  showFnCallDetail?: boolean;\n  onConfirm?: (fnCall: any, confirmed: boolean) => void;\n  blink?: boolean;\n  /** 自定义工具调用渲染函数，返回 null 则使用默认渲染 */\n  renderFunctionCall?: RenderFunctionCall;\n  /**\n   * 工具名 → 渲染类型的解析策略，默认使用 defaultToolKindResolver\n   */\n  toolKindResolver?: (name: string | undefined) => ToolRenderKind;\n  /** 聊天策略，可由 Provider preset 自动下发，也可在组件局部覆盖。 */\n  strategies?: ChatStrategies;\n}\n\nexport interface TimelineItemProps {\n  icon: React.ReactNode;\n  title: React.ReactNode;\n  children: React.ReactNode;\n  collapsible?: boolean;\n  defaultOpen?: boolean;\n  blink?: boolean;\n}\n\nexport interface ThoughtChainItemType {\n  type: \"tool\" | \"text\";\n  key: string;\n  content: string;\n  title?: ReactNode;\n  collapsible?: boolean;\n  msg?: IMessage;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

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

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

package/dist/cjs/types/XAiChatbot.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/XAiChatbot.ts
+var XAiChatbot_exports = {};
+module.exports = __toCommonJS(XAiChatbot_exports);
+//# sourceMappingURL=XAiChatbot.js.map