@ai-group/chat-sdk 2.1.13 → 3.0.1-alpha.2

package/dist/esm/types/XAdkChatbot.d.ts

@@ -1,6 +1,18 @@
-/// <reference types="react" />
-import { type XAdkSenderProps } from './XAdkSender';
-import { type SendContent } from './XAiSender';
+import { JSX } from "react";
+import { type XAdkSenderProps } from "./XAdkSender";
+import { type SendContent } from "./XAiSender";
+/**
+ * 消息分组接口
+ */
+export interface ChatGroup {
+    id: string;
+    role: "user" | "bot";
+    msgs: IMessage[];
+    invocationId?: string;
+    allFiles: any[];
+    /** 点赞状态: 1=赞, -1=踩, 0=未反馈 */
+    isLike?: number;
+}
 export interface IInvocation {
     id: string;
     name: string;
@@ -69,11 +81,11 @@ export interface FileData {
     fileUri: string;
 }
 export interface ExecutableCode {
-    language: 'UNKNOWN' | 'PYTHON';
+    language: "UNKNOWN" | "PYTHON";
     code: string;
 }
 export interface CodeExecutionResult {
-    outcome: 'UNKNOWN' | 'OK' | 'FAILED' | 'DEADLINE_EXCEEDED';
+    outcome: "UNKNOWN" | "OK" | "FAILED" | "DEADLINE_EXCEEDED";
     output: string;
 }
 export interface Part {
@@ -153,7 +165,7 @@ export interface IMessage {
     eventId?: string;
     /** 消息发起人：智能体名称、user */
     author?: string;
-    role: 'bot' | 'user';
+    role: "bot" | "user";
     /** 时间戳 */
     timestamp?: number;
     isLoading?: boolean;
@@ -181,8 +193,16 @@ export interface IMessage {
     invocationIndex?: any;
     finalResponsePartIndex?: any;
     toolUseIndex?: any;
+    /** 是否赞/踩 */
+    isLike?: number;
 }
-export interface XAdkChatbotProps extends XAdkSenderProps {
+export type ActionProps = (data: {
+    message: ChatGroup;
+    isLastBotMsg: boolean;
+}) => JSX.Element | null;
+export interface XAdkChatbotProps extends Partial<XAdkSenderProps> {
+    className?: string;
+    style?: React.CSSProperties;
     loading?: boolean;
     /** 消息列表 */
     messages: IMessage[];
@@ -190,18 +210,12 @@ export interface XAdkChatbotProps extends XAdkSenderProps {
     prologue?: string;
     /** 建议回复 */
     suggestions?: string[];
+    /** 欢迎页面 */
+    welcome?: React.ReactNode;
     /** 显示函数调用详情 */
     showFnCallDetail?: boolean;
-    /** 是否显示清除聊天记录按钮 */
-    clearBtnShow?: boolean;
     /** 是否初始化 */
     initialized?: boolean;
-    /** 底部插槽 */
-    footer?: (props: {
-        message: IMessage;
-        isLastBotMsg: boolean;
-        isLastMsg: boolean;
-    }) => React.ReactNode;
     /** 提交回调 */
     onSubmit?: ({ text, files }: SendContent) => void;
     /** 函数调用确认回调 */
@@ -212,4 +226,55 @@ export interface XAdkChatbotProps extends XAdkSenderProps {
     onClear?: () => void;
     /** 建议回复回调 */
     onSuggest?: (text: string) => void;
+    /** Agent 名称 (欢迎页面) */
+    agentName?: string;
+    /** Agent 图标 (欢迎页面) */
+    agentIcon?: string;
+    /** Agent 描述 (欢迎页面) */
+    description?: string;
+    /** 是否显示重试按钮 */
+    showRetry?: boolean;
+    /** 是否显示复制按钮 */
+    showCopy?: boolean;
+    /** 是否显示日志按钮 */
+    showLog?: boolean;
+    /** 重试回调 */
+    onRetry?: () => void;
+    /** 复制回调 */
+    onCopy?: (text: string) => void;
+    /** 查看日志回调 */
+    onShowLog?: (invocationId: string, timestamp?: number) => void;
+    /** 是否启用消息分组 (默认 true) */
+    enableGrouping?: boolean;
+    /** 是否自动解析 process 内容并展示思维链 (默认 true) */
+    enableProcessParsing?: boolean;
+    /** 消息功能区 */
+    actions?: ActionProps;
+    /**
+     * Process 解析选项
+     * @example
+     * // 业务项目格式 (注释模式)
+     * parseOptions={{ mode: 'comment' }}
+     *
+     * @example
+     * // 自定义格式
+     * parseOptions={{
+     *   mode: 'custom',
+     *   customPatterns: [
+     *     { regex: /\[REASONING\]([\s\S]*?)\[\/REASONING\]/g, type: 'reasoning' }
+     *   ]
+     * }}
+     */
+    parseOptions?: {
+        mode?: "xml" | "comment" | "custom";
+        customPatterns?: Array<{
+            regex: RegExp;
+            type: string;
+        }>;
+        finalMarker?: string;
+    };
+    /** 是否禁用输入 */
+    disabled?: boolean;
+    /** 是否流式响应 */
+    stream?: boolean;
 }

package/dist/esm/types/XAdkChatbot.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/XAdkChatbot.ts"],"sourcesContent":["import { type XAdkSenderProps } from './XAdkSender';\nimport { type SendContent } from './XAiSender';\n\nexport interface IInvocation {\n  id: string;\n  name: string;\n  spanId: string;\n  traceId: string;\n  parentSpanId: string;\n  startTime: number;\n  endTime: number;\n  sessionId: string;\n  invocationId: string;\n  duration: number;\n  attributes: Record<string, string>;\n  botName: string;\n  workspaceNo: string;\n  status: number;\n  agentName: string;\n  agentNo: string;\n  agentVersionNo: string;\n  userId: string;\n}\n\nexport interface AgentRunRequest {\n  stream?: boolean;\n  sessionId: string | undefined;\n  content: {\n    parts: Array<{\n      text?: string;\n      functionResponse?: {\n        id?: string;\n        name?: string;\n        response?: any;\n      };\n    }>;\n    role: string;\n  };\n  files?: Array<{\n    fileName: string;\n    fileId?: string;\n    tempUrl: string;\n    type?: string;\n    mimeType: string;\n  }>\n  stateDelta?: any;\n}\nexport interface Blob {\n  displayName?: string;\n  mimeType?: string;\n  data: string;\n}\n\nexport interface FunctionCall {\n  id?: string;\n  name: string;\n  args: {[key: string]: any};\n}\n\nexport interface FunctionResponse {\n  id?: string;\n  name: string;\n  response: {[key: string]: any};\n}\n\nexport interface FileData {\n  displayName: string;\n  mimeType: string;\n  fileUri: string;\n}\n\nexport interface ExecutableCode {\n  language: 'UNKNOWN'|'PYTHON';\n  code: string;\n}\n\nexport interface CodeExecutionResult {\n  outcome: 'UNKNOWN'|'OK'|'FAILED'|'DEADLINE_EXCEEDED';\n  output: string;\n}\n\nexport interface Part {\n  text?: string;\n  inlineData?: Blob;\n  functionCall?: FunctionCall;\n  functionResponse?: FunctionResponse;\n  thought?: boolean;\n  fileData?: FileData;\n  executableCode?: ExecutableCode;\n  codeExecutionResult?: CodeExecutionResult;\n  errorMessage?: string;\n}\n\nexport interface GenAiContent {\n  role: string;\n  parts: Part[];\n}\n\nexport interface LlmRequest {\n  contents: GenAiContent[];\n}\n\nexport interface LlmResponse {\n  partial?: boolean;\n  content: GenAiContent;\n  error?: string;\n  errorMessage?: string;\n  errorCode?: string;\n  longRunningToolIds?: string[];\n}\n\nexport interface EventActions {\n  message?: string;\n  artifactDelta?: any;\n  functionCall?: FunctionCall;\n  functionResponse?: FunctionResponse;\n  finishReason?: string;\n}\n\nexport interface Event extends LlmResponse {\n  id?: string;\n  author?: string;\n  invocationId?: string;\n  actions?: EventActions;\n  longRunningToolIds?: string[];\n  branch?: string;\n  timestamp?: number;\n  evalStatus?: any;\n  failedMetric?: any;\n  evalScore?: any;\n  evalThreshold?: any;\n  groundingMetadata?: {\n    searchEntryPoint?: {\n      renderedContent?: any;\n    };\n  };\n  isLike?: number;\n  sessionId?: string;\n}\n\nexport interface SessionState {\n  [key: string]: unknown;\n}\n\nexport interface Session {\n  id?: string;\n  appName?: string;\n  userId?: string;\n  state?: SessionState;\n  events?: Event[];\n  lastUpdateTime?: number;\n}\n\nexport interface TimeTick {\n  position: number;\n  label: string;\n}\n\nexport interface IMessage {\n  /** 前端生成的唯一标识 */\n  id: string;\n  /** 单次请求的唯一标识 */\n  invocationId?: string;\n  /** 单个Event的唯一标识，一个event里有可能有多个parts的消息 */\n  eventId?: string;\n  /** 消息发起人：智能体名称、user */\n  author?: string;\n  role: 'bot' | 'user';\n  /** 时间戳 */\n  timestamp?: number;\n  isLoading?: boolean;\n  /** 函数调用 */\n  functionCall?: FunctionCall;\n  /** 函数调用结果 */\n  functionResponse?: FunctionResponse;\n  /** 文件上传 */\n  inlineData?: Blob;\n  /** 文本消息 */\n  text?: string;\n  /** 文件信息 */\n  fileData?: FileData[];\n  /** 思考 */\n  thought?: boolean;\n  executableCode?: ExecutableCode;\n  codeExecutionResult?: CodeExecutionResult;\n  renderedContent?: any;\n  /** 原始数据 */\n  raw?: any;\n  // 下面暂时没有用到\n  evalStatus?: any;\n  failedMetric?: any;\n  evalScore?: any;\n  evalThreshold?: any;\n  invocationIndex?: any;\n  finalResponsePartIndex?: any;\n  toolUseIndex?: any;\n}\n\nexport interface XAdkChatbotProps extends XAdkSenderProps {\n  // 加载状态\n  loading?: boolean;\n  /** 消息列表 */\n  messages: IMessage[];\n  /** 开场白 */\n  prologue?: string;\n  /** 建议回复 */\n  suggestions?: string[];\n  /** 显示函数调用详情 */\n  showFnCallDetail?: boolean;\n  /** 是否显示清除聊天记录按钮 */\n  clearBtnShow?: boolean;\n  /** 是否初始化 */\n  initialized?: boolean;\n  /** 底部插槽 */\n  footer?: (props: { message: IMessage; isLastBotMsg: boolean; isLastMsg: boolean; }) => React.ReactNode;\n  /** 提交回调 */\n  onSubmit?: ({ text, files }: SendContent) => void;\n  /** 函数调用确认回调 */\n  onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;\n  /** 停止回调 */\n  onStop?: () => void;\n  /** 清除回调 */\n  onClear?: () => void;\n  /** 建议回复回调 */\n  onSuggest?: (text: string) => void;\n}"],"mappings":""}
+{"version":3,"names":[],"sources":["../../../src/types/XAdkChatbot.ts"],"sourcesContent":["import { JSX, ReactNode } from \"react\";\nimport { type XAdkSenderProps } from \"./XAdkSender\";\nimport { type SendContent } from \"./XAiSender\";\n\n/**\n * 消息分组接口\n */\nexport interface ChatGroup {\n  id: string;\n  role: \"user\" | \"bot\";\n  msgs: IMessage[];\n  invocationId?: string;\n  allFiles: any[];\n  /** 点赞状态: 1=赞, -1=踩, 0=未反馈 */\n  isLike?: number;\n}\n\nexport interface IInvocation {\n  id: string;\n  name: string;\n  spanId: string;\n  traceId: string;\n  parentSpanId: string;\n  startTime: number;\n  endTime: number;\n  sessionId: string;\n  invocationId: string;\n  duration: number;\n  attributes: Record<string, string>;\n  botName: string;\n  workspaceNo: string;\n  status: number;\n  agentName: string;\n  agentNo: string;\n  agentVersionNo: string;\n  userId: string;\n}\n\nexport interface AgentRunRequest {\n  stream?: boolean;\n  sessionId: string | undefined;\n  content: {\n    parts: Array<{\n      text?: string;\n      functionResponse?: {\n        id?: string;\n        name?: string;\n        response?: any;\n      };\n    }>;\n    role: string;\n  };\n  files?: Array<{\n    fileName: string;\n    fileId?: string;\n    tempUrl: string;\n    type?: string;\n    mimeType: string;\n  }>;\n  stateDelta?: any;\n}\nexport interface Blob {\n  displayName?: string;\n  mimeType?: string;\n  data: string;\n}\n\nexport interface FunctionCall {\n  id?: string;\n  name: string;\n  args: { [key: string]: any };\n}\n\nexport interface FunctionResponse {\n  id?: string;\n  name: string;\n  response: { [key: string]: any };\n}\n\nexport interface FileData {\n  displayName: string;\n  mimeType: string;\n  fileUri: string;\n}\n\nexport interface ExecutableCode {\n  language: \"UNKNOWN\" | \"PYTHON\";\n  code: string;\n}\n\nexport interface CodeExecutionResult {\n  outcome: \"UNKNOWN\" | \"OK\" | \"FAILED\" | \"DEADLINE_EXCEEDED\";\n  output: string;\n}\n\nexport interface Part {\n  text?: string;\n  inlineData?: Blob;\n  functionCall?: FunctionCall;\n  functionResponse?: FunctionResponse;\n  thought?: boolean;\n  fileData?: FileData;\n  executableCode?: ExecutableCode;\n  codeExecutionResult?: CodeExecutionResult;\n  errorMessage?: string;\n}\n\nexport interface GenAiContent {\n  role: string;\n  parts: Part[];\n}\n\nexport interface LlmRequest {\n  contents: GenAiContent[];\n}\n\nexport interface LlmResponse {\n  partial?: boolean;\n  content: GenAiContent;\n  error?: string;\n  errorMessage?: string;\n  errorCode?: string;\n  longRunningToolIds?: string[];\n}\n\nexport interface EventActions {\n  message?: string;\n  artifactDelta?: any;\n  functionCall?: FunctionCall;\n  functionResponse?: FunctionResponse;\n  finishReason?: string;\n}\n\nexport interface Event extends LlmResponse {\n  id?: string;\n  author?: string;\n  invocationId?: string;\n  actions?: EventActions;\n  longRunningToolIds?: string[];\n  branch?: string;\n  timestamp?: number;\n  evalStatus?: any;\n  failedMetric?: any;\n  evalScore?: any;\n  evalThreshold?: any;\n  groundingMetadata?: {\n    searchEntryPoint?: {\n      renderedContent?: any;\n    };\n  };\n  isLike?: number;\n  sessionId?: string;\n}\n\nexport interface SessionState {\n  [key: string]: unknown;\n}\n\nexport interface Session {\n  id?: string;\n  appName?: string;\n  userId?: string;\n  state?: SessionState;\n  events?: Event[];\n  lastUpdateTime?: number;\n}\n\nexport interface TimeTick {\n  position: number;\n  label: string;\n}\n\nexport interface IMessage {\n  /** 前端生成的唯一标识 */\n  id: string;\n  /** 单次请求的唯一标识 */\n  invocationId?: string;\n  /** 单个Event的唯一标识，一个event里有可能有多个parts的消息 */\n  eventId?: string;\n  /** 消息发起人：智能体名称、user */\n  author?: string;\n  role: \"bot\" | \"user\";\n  /** 时间戳 */\n  timestamp?: number;\n  isLoading?: boolean;\n  /** 函数调用 */\n  functionCall?: FunctionCall;\n  /** 函数调用结果 */\n  functionResponse?: FunctionResponse;\n  /** 文件上传 */\n  inlineData?: Blob;\n  /** 文本消息 */\n  text?: string;\n  /** 文件信息 */\n  fileData?: FileData[];\n  /** 思考 */\n  thought?: boolean;\n  executableCode?: ExecutableCode;\n  codeExecutionResult?: CodeExecutionResult;\n  renderedContent?: any;\n  /** 原始数据 */\n  raw?: any;\n  // 下面暂时没有用到\n  evalStatus?: any;\n  failedMetric?: any;\n  evalScore?: any;\n  evalThreshold?: any;\n  invocationIndex?: any;\n  finalResponsePartIndex?: any;\n  toolUseIndex?: any;\n  /** 是否赞/踩 */\n  isLike?: number;\n}\n\nexport type ActionProps = (data: {\n  message: ChatGroup;\n  isLastBotMsg: boolean;\n}) => JSX.Element | null;\n\nexport interface XAdkChatbotProps extends Partial<XAdkSenderProps> {\n  className?: string;\n  style?: React.CSSProperties;\n  // 加载状态\n  loading?: boolean;\n  /** 消息列表 */\n  messages: IMessage[];\n  /** 开场白 */\n  prologue?: string;\n  /** 建议回复 */\n  suggestions?: string[];\n  /** 欢迎页面 */\n  welcome?: React.ReactNode;\n  /** 显示函数调用详情 */\n  showFnCallDetail?: boolean;\n  /** 是否初始化 */\n  initialized?: boolean;\n  /** 提交回调 */\n  onSubmit?: ({ text, files }: SendContent) => void;\n  /** 函数调用确认回调 */\n  onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;\n  /** 停止回调 */\n  onStop?: () => void;\n  /** 清除回调 */\n  onClear?: () => void;\n  /** 建议回复回调 */\n  onSuggest?: (text: string) => void;\n\n  // ========== 新增功能 ==========\n\n  /** Agent 名称 (欢迎页面) */\n  agentName?: string;\n  /** Agent 图标 (欢迎页面) */\n  agentIcon?: string;\n  /** Agent 描述 (欢迎页面) */\n  description?: string;\n\n  /** 是否显示重试按钮 */\n  showRetry?: boolean;\n  /** 是否显示复制按钮 */\n  showCopy?: boolean;\n  /** 是否显示日志按钮 */\n  showLog?: boolean;\n\n  /** 重试回调 */\n  onRetry?: () => void;\n  /** 复制回调 */\n  onCopy?: (text: string) => void;\n  /** 查看日志回调 */\n  onShowLog?: (invocationId: string, timestamp?: number) => void;\n\n  /** 是否启用消息分组 (默认 true) */\n  enableGrouping?: boolean;\n\n  /** 是否自动解析 process 内容并展示思维链 (默认 true) */\n  enableProcessParsing?: boolean;\n\n  /** 消息功能区 */\n  actions?: ActionProps;\n\n  /**\n   * Process 解析选项\n   * @example\n   * // 业务项目格式 (注释模式)\n   * parseOptions={{ mode: 'comment' }}\n   *\n   * @example\n   * // 自定义格式\n   * parseOptions={{\n   *   mode: 'custom',\n   *   customPatterns: [\n   *     { regex: /\\[REASONING\\]([\\s\\S]*?)\\[\\/REASONING\\]/g, type: 'reasoning' }\n   *   ]\n   * }}\n   */\n  parseOptions?: {\n    mode?: \"xml\" | \"comment\" | \"custom\";\n    customPatterns?: Array<{ regex: RegExp; type: string }>;\n    finalMarker?: string;\n  };\n\n  /** 是否禁用输入 */\n  disabled?: boolean;\n\n  /** 是否流式响应 */\n  stream?: boolean;\n}\n"],"mappings":""}

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

@@ -1,11 +1,17 @@
-import { ReactNode } from 'react';
+import { ReactNode } from "react";
 import { IMessage, Success, Event, Error, SendContent, ThemeType } from "./";
 export interface DebugOptions {
     url: string;
     sessionId?: string;
     config: any;
     token: string;
-    type?: 'agentDebug' | 'appDebug';
+    type?: "agentDebug" | "appDebug";
+    /**
+     * 是否启用 Hook
+     * 当使用自定义 chatData 时,应设置为 false 以避免内部 Hook 初始化
+     * @default true
+     */
+    enabled?: boolean;
     onError?: (error: Error) => void;
     onSuccess?: (data: Success) => void;
     onStream?: (data: Event) => void;
@@ -99,7 +105,7 @@ export interface XAdkProviderProps {
     /**
      * AI 服务基础地址
      */
-    url?: string;
+    url: string;
     /**
      * 认证 token
      */
@@ -112,25 +118,6 @@ export interface XAdkProviderProps {
      * Provider 唯一标识
      */
     providerId?: string;
-    /**
-     * 获取应用信息
-     * @type {() => any}
-     * @version 1.0.0
-     */
-    getData: () => any;
-    /**
-     * 发送聊天消息
-     * @param content - 消息内容
-     * @type {(content: string) => void}
-     * @version 1.0.0
-     */
-    chat: (content: SendContent) => void;
-    /**
-     * 停止聊天
-     * @type {() => void}
-     * @version 1.0.0
-     */
-    stop: () => void;
     /**
      * 消息成功回调
      */
@@ -152,11 +139,7 @@ export interface XAdkProviderProps {
      */
     onEvent?: (event: handleEvent) => void;
     /**
-     * 自定义插槽渲染函数
-     */
-    footer?: (args: FooterRenderArgs) => ReactNode;
-    /**
-     * React 子元素
+     * React 子元素 - 支持 Compound Components
      */
     children?: ReactNode;
 }

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

@@ -1 +1 @@
-{"version":3,"names":["EventCode"],"sources":["../../../src/types/XAdkProvider.ts"],"sourcesContent":["import { ReactNode } from 'react';\nimport { IMessage, Success, Event, Error, SendContent, ThemeType } from '@/types';\n\n\nexport interface DebugOptions {\n  url: string\n  sessionId?: string;\n  config: any;\n  token: string;\n  type?: 'agentDebug' | 'appDebug';\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\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  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  setCurrentSessionDetail: (id: string) => 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  appNo?: string;\n  chatProps?: ChatConfig;\n  debug?: boolean;\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 唯一标识\n   */\n  providerId?: string;\n  /**\n   * 获取应用信息\n   * @type {() => any}\n   * @version 1.0.0\n   */\n  getData: () => any;\n\n  /**\n   * 发送聊天消息\n   * @param content - 消息内容\n   * @type {(content: string) => void}\n   * @version 1.0.0\n   */\n  chat: (content: SendContent) => void;\n  /**\n   * 停止聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  stop: () => void;\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   * 自定义插槽渲染函数\n   */\n  footer?: (args: FooterRenderArgs) => ReactNode;\n  /**\n   * React 子元素\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}"],"mappings":"AAgBA;AACA;AACA;AACA;AACA;AACA,WAAaA,SAAS,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAAA,OAATA,SAAS;AAAA;;AAatB;AACA;AACA;;AAOA;AACA;AACA;;AAcA;AACA;AACA;;AAuBA;AACA;AACA;;AAiBA;AACA;AACA;;AAoEA"}
+{"version":3,"names":["EventCode"],"sources":["../../../src/types/XAdkProvider.ts"],"sourcesContent":["import { ReactNode } from \"react\";\nimport {\n  IMessage,\n  Success,\n  Event,\n  Error,\n  SendContent,\n  ThemeType,\n} from \"@/types\";\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  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  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  setCurrentSessionDetail: (id: string) => 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  appNo?: string;\n  chatProps?: ChatConfig;\n  debug?: boolean;\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 唯一标识\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":"AA4BA;AACA;AACA;AACA;AACA;AACA,WAAYA,SAAS,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAAA,OAATA,SAAS;AAAA;;AAYrB;AACA;AACA;;AAOA;AACA;AACA;;AAcA;AACA;AACA;;AAuBA;AACA;AACA;;AAiBA;AACA;AACA;;AA4CA"}

package/dist/esm/types/XAdkSender.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 interface uploadRequestProps {
     (options: {
         file: File;
@@ -29,10 +30,19 @@ export interface LocalFile {
     response?: any;
     errorMessage?: string;
 }
+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 XAdkSenderProps {
     clearBtnShow?: boolean;
     allowUpload?: boolean;
     loading?: boolean;
+    disabled?: boolean;
     onClear?: () => void;
     onChange?: (value: string) => void;
     onSubmit?: (data: {
@@ -45,5 +55,13 @@ export interface XAdkSenderProps {
     allowedFileTypes?: string[];
     maxFiles?: number;
     onFilesChange?: (files: ServerFile[]) => void;
+    /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */
+    suffix?: React.ReactNode | false | SlotRenderFunction;
+    /** 头部面板 */
+    header?: React.ReactNode | false | SlotRenderFunction;
+    /** 前缀内容 */
+    prefix?: React.ReactNode | false | SlotRenderFunction;
+    /** 底部内容 */
+    footer?: React.ReactNode | false | SlotRenderFunction;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"sourcesContent":["// types/XAdkSender.ts\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (response: any) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: number;\n  tempUrl: string;\n  type: string;\n  mimeType: string; \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?: number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport interface XAdkSenderProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  loading?: boolean;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: {\n    text: string;\n    files: ServerFile[];\n  }) => void;\n  onStop?: () => void;\n  \n  // 上传相关配置\n  uploadRequest?: uploadRequestProps;\n  maxFileSize?: number;  // 最大文件大小（MB）\n  allowedFileTypes?: string[];  // 允许的文件类型\n  maxFiles?: number;  // 最大文件数量\n  \n  // 文件状态回调\n  onFilesChange?: (files: ServerFile[]) => void;\n}"],"mappings":""}
+{"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"sourcesContent":["// types/XAdkSender.ts\nimport React from 'react';\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (response: any) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: number;\n  tempUrl: string;\n  type: string;\n  mimeType: string;\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?: number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\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\nexport interface XAdkSenderProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: {\n    text: string;\n    files: ServerFile[];\n  }) => void;\n  onStop?: () => void;\n\n  // 上传相关配置\n  uploadRequest?: uploadRequestProps;\n  maxFileSize?: number;  // 最大文件大小（MB）\n  allowedFileTypes?: string[];  // 允许的文件类型\n  maxFiles?: number;  // 最大文件数量\n\n  // 文件状态回调\n  onFilesChange?: (files: ServerFile[]) => void;\n\n  // 插槽功能\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}"],"mappings":""}

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

@@ -1,5 +1,6 @@
-import { type ConversationsProps, type ConversationItemType } from '@ant-design/x';
-type OmitItems = Omit<ConversationsProps, 'items'>;
+import { type ConversationsProps, type ConversationItemType } from "@ant-design/x";
+import React from "react";
+type OmitItems = Omit<ConversationsProps, "items">;
 export interface SessionData extends ConversationItemType {
     meta?: any;
 }
@@ -16,5 +17,6 @@ export interface XAiConversationsProps extends OmitItems {
     loadMoreSession?: () => void;
     /** 点击生成新对话回调 */
     onNewChat?: () => void;
+    style?: React.CSSProperties;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/XAiConversations.ts"],"sourcesContent":["import { type ConversationsProps, type ConversationItemType } from '@ant-design/x';\n\ntype OmitItems = Omit<ConversationsProps, 'items'>;\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}\n"],"mappings":""}
+{"version":3,"names":[],"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\">;\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":""}

package/dist/esm/types/XAiThoughtChain.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+import { IMessage } from "./XAdkChatbot";
+export interface XAiThoughtChainProps {
+    defaultOpen?: boolean;
+    loading?: boolean;
+    title?: string;
+    items: ThoughtChainItemType[];
+    showFnCallDetail?: boolean;
+    onConfirm?: (fnCall: any, confirmed: boolean) => void;
+}
+export interface TimelineItemProps {
+    icon: React.ReactNode;
+    title: React.ReactNode;
+    children: React.ReactNode;
+    collapsible?: boolean;
+    defaultOpen?: boolean;
+}
+export interface ThoughtChainItemType {
+    type: "tool" | "text";
+    key: string;
+    content: string;
+    title?: React.ReactNode;
+    collapsible?: boolean;
+    msg?: IMessage;
+}

package/dist/esm/types/XAiThoughtChain.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=XAiThoughtChain.js.map

package/dist/esm/types/XAiThoughtChain.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/XAiThoughtChain.ts"],"sourcesContent":["import React from \"react\";\nimport { IMessage } from \"./XAdkChatbot\";\n\nexport interface XAiThoughtChainProps {\n  defaultOpen?: boolean;\n  loading?: boolean;\n  title?: string;\n  items: ThoughtChainItemType[];\n  showFnCallDetail?: boolean; // 是否可查看调用方法入参\n  onConfirm?: (fnCall: any, confirmed: boolean) => void;\n}\n\nexport interface TimelineItemProps {\n  icon: React.ReactNode;\n  title: React.ReactNode;\n  children: React.ReactNode;\n  collapsible?: boolean; // 是否可展示\n  defaultOpen?: boolean; // 是否默认展开\n}\n\nexport interface ThoughtChainItemType {\n  type: \"tool\" | \"text\"; // 思维节点类型，目前仅支持 tool | text\n  key: string; // 思维节点唯一标识符\n  content: string; // 思维节点内容\n  title?: React.ReactNode; // 思维节点标题\n  collapsible?: boolean; // 思维节点是否可折叠\n  msg?: IMessage; // 思维节点信息，tool 类型必传\n}\n"],"mappings":""}

package/dist/esm/types/index.d.ts

@@ -1,8 +1,9 @@
-export * from './XAiChatbot';
-export * from './XAiMessage';
-export * from './XAiProvider';
-export * from './XAiSender';
-export * from './XAiConversations';
-export * from './XAdkProvider';
-export * from './XAdkChatbot';
-export * from './common';
+export * from "./XAiChatbot";
+export * from "./XAiMessage";
+export * from "./XAiProvider";
+export * from "./XAiSender";
+export * from "./XAiConversations";
+export * from "./XAdkProvider";
+export * from "./XAdkChatbot";
+export * from "./XAiThoughtChain";
+export * from "./common";

package/dist/esm/types/index.js

@@ -5,5 +5,6 @@ export * from "./XAiSender";
 export * from "./XAiConversations";
 export * from "./XAdkProvider";
 export * from "./XAdkChatbot";
+export * from "./XAiThoughtChain";
 export * from "./common";
 //# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from './XAiChatbot';\nexport * from './XAiMessage';\nexport * from './XAiProvider';\nexport * from './XAiSender';\nexport * from './XAiConversations';\nexport * from './XAdkProvider';\nexport * from './XAdkChatbot';\nexport * from './common';"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}
+{"version":3,"names":[],"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from \"./XAiChatbot\";\nexport * from \"./XAiMessage\";\nexport * from \"./XAiProvider\";\nexport * from \"./XAiSender\";\nexport * from \"./XAiConversations\";\nexport * from \"./XAdkProvider\";\nexport * from \"./XAdkChatbot\";\nexport * from \"./XAiThoughtChain\";\nexport * from \"./common\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA"}

package/dist/esm/utils/index.d.ts

@@ -1,2 +1,4 @@
 export declare const safeJsonParse: <T = any>(str?: string, defaultValue?: any) => T;
 export declare const safeJsonStringify: <T = any>(obj?: T, defaultValue?: any) => string;
+export declare function cleanProcessText(text: string): string;
+export * from './parseAgentMessage';

package/dist/esm/utils/index.js

@@ -16,4 +16,11 @@ export var safeJsonStringify = function safeJsonStringify(obj) {
     return defaultValue;
   }
 };
+export function cleanProcessText(text) {
+  if (!text) return "";
+  return text.replace(/\/\*(PLANNING|REPLANNING|REASONING|ACTION|FINAL_ANSWER)\*\//g, "").trim();
+}
+
+// 导出新的解析工具
+export * from "./parseAgentMessage";
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["safeJsonParse","str","defaultValue","arguments","length","undefined","JSON","parse","error","safeJsonStringify","obj","stringify"],"sources":["../../../src/utils/index.ts"],"sourcesContent":["export const safeJsonParse = <T = any>(str?: string, defaultValue: any = {}): T => {\n  if (!str) return defaultValue as T;\n  try {\n    return JSON.parse(str) || defaultValue;\n  } catch (error) {\n    return defaultValue as T;\n  }\n};\n\nexport const safeJsonStringify = <T = any>(obj?: T, defaultValue: any = {}): string => {\n  if (!obj) return defaultValue as string;\n  try {\n    return JSON.stringify(obj) || defaultValue;\n  } catch (error) {\n    return defaultValue as string;\n  }\n};\n"],"mappings":"AAAA,OAAO,IAAMA,aAAa,GAAG,SAAhBA,aAAaA,CAAaC,GAAY,EAAgC;EAAA,IAA9BC,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EACzE,IAAI,CAACF,GAAG,EAAE,OAAOC,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACC,KAAK,CAACN,GAAG,CAAC,IAAIC,YAAY;EACxC,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,IAAMO,iBAAiB,GAAG,SAApBA,iBAAiBA,CAAaC,GAAO,EAAqC;EAAA,IAAnCR,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EACxE,IAAI,CAACO,GAAG,EAAE,OAAOR,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACK,SAAS,CAACD,GAAG,CAAC,IAAIR,YAAY;EAC5C,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC"}
+{"version":3,"names":["safeJsonParse","str","defaultValue","arguments","length","undefined","JSON","parse","error","safeJsonStringify","obj","stringify","cleanProcessText","text","replace","trim"],"sources":["../../../src/utils/index.ts"],"sourcesContent":["export const safeJsonParse = <T = any>(\n  str?: string,\n  defaultValue: any = {},\n): T => {\n  if (!str) return defaultValue as T;\n  try {\n    return JSON.parse(str) || defaultValue;\n  } catch (error) {\n    return defaultValue as T;\n  }\n};\n\nexport const safeJsonStringify = <T = any>(\n  obj?: T,\n  defaultValue: any = {},\n): string => {\n  if (!obj) return defaultValue as string;\n  try {\n    return JSON.stringify(obj) || defaultValue;\n  } catch (error) {\n    return defaultValue as string;\n  }\n};\n\nexport function cleanProcessText(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/\\/\\*(PLANNING|REPLANNING|REASONING|ACTION|FINAL_ANSWER)\\*\\//g, \"\")\n    .trim();\n}\n\n// 导出新的解析工具\nexport * from './parseAgentMessage';\n"],"mappings":"AAAA,OAAO,IAAMA,aAAa,GAAG,SAAhBA,aAAaA,CACxBC,GAAY,EAEN;EAAA,IADNC,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEtB,IAAI,CAACF,GAAG,EAAE,OAAOC,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACC,KAAK,CAACN,GAAG,CAAC,IAAIC,YAAY;EACxC,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,IAAMO,iBAAiB,GAAG,SAApBA,iBAAiBA,CAC5BC,GAAO,EAEI;EAAA,IADXR,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEtB,IAAI,CAACO,GAAG,EAAE,OAAOR,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACK,SAAS,CAACD,GAAG,CAAC,IAAIR,YAAY;EAC5C,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,SAASU,gBAAgBA,CAACC,IAAY,EAAU;EACrD,IAAI,CAACA,IAAI,EAAE,OAAO,EAAE;EACpB,OAAOA,IAAI,CACRC,OAAO,CAAC,8DAA8D,EAAE,EAAE,CAAC,CAC3EC,IAAI,CAAC,CAAC;AACX;;AAEA;AACA"}

package/dist/esm/utils/parseAgentMessage.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 解析后的消息片段类型
+ */
+export interface ParsedPart {
+    type: 'text' | 'planning' | 'replanning' | 'reasoning' | 'action_log' | 'final_result' | 'process_text';
+    content: string;
+}
+/**
+ * 解析规则配置
+ */
+export interface ParseAgentMessageOptions {
+    /**
+     * 解析模式
+     * - 'xml': XML 标签模式 <reasoning>...</reasoning>
+     * - 'comment': 注释标签模式 /*REASONING*\/
+     * - 'custom': 自定义正则模式
+     */
+    mode?: 'xml' | 'comment' | 'custom';
+    /**
+     * 自定义正则规则 (mode='custom' 时使用)
+     * @example
+     * [
+     *   { regex: /\[REASONING\]([\s\S]*?)\[\/REASONING\]/g, type: 'reasoning' },
+     *   { regex: /\[PLANNING\]([\s\S]*?)\[\/PLANNING\]/g, type: 'planning' }
+     * ]
+     */
+    customPatterns?: Array<{
+        regex: RegExp;
+        type: ParsedPart['type'];
+    }>;
+    /**
+     * 最终答案标记 (comment 模式使用)
+     * @default '/*FINAL_ANSWER*\/'
+     */
+    finalMarker?: string;
+}
+/**
+ * 清理 process 文本
+ * - 移除多余的换行
+ * - 移除 JSON 代码块标记
+ */
+export declare function cleanProcessText(text: string): string;
+/**
+ * 解析 Agent 消息 (支持多种格式)
+ *
+ * @param text 原始消息文本
+ * @param options 解析选项
+ * @returns 解析后的消息片段数组
+ *
+ * @example
+ * // XML 模式 (默认)
+ * const parts1 = parseAgentMessage(`
+ *   <reasoning>分析用户需求...</reasoning>
+ *   最终回复内容
+ * `);
+ *
+ * @example
+ * // 注释模式 (业务项目格式)
+ * const parts2 = parseAgentMessage(`
+ *   /*REASONING*\/分析用户需求...
+ *   /*FINAL_ANSWER*\/最终回复内容
+ * `, { mode: 'comment' });
+ *
+ * @example
+ * // 自定义模式
+ * const parts3 = parseAgentMessage(text, {
+ *   mode: 'custom',
+ *   customPatterns: [
+ *     { regex: /\[REASONING\]([\s\S]*?)\[\/REASONING\]/g, type: 'reasoning' }
+ *   ]
+ * });
+ */
+export declare function parseAgentMessage(text: string, options?: ParseAgentMessageOptions): ParsedPart[];
+/**
+ * 检查是否包含 process 内容
+ */
+export declare function hasProcessContent(parts: ParsedPart[]): boolean;
+/**
+ * 获取纯文本内容(不包含 process 标签)
+ */
+export declare function getPlainText(parts: ParsedPart[]): string;