@ai-group/chat-sdk 3.2.0 → 3.3.0

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["// index.ts\nimport { useXAi } from \"./context/AiProviderContext\";\nimport XAiProvider from \"./components/XAiProvider\";\nimport XAiChatbot from \"./components/XAiChatbot\";\nimport XAiSDK from \"./components/XAiSDK\";\nimport XAiSender from \"./components/XAiSender\";\nimport FileGallery from \"./components/FileGallery\";\nimport XAiConversations from \"./components/XAiConversations\";\nimport XAdkThoughtChain from \"./components/XAdkThoughtChain\";\nimport useXAiSDK from \"./hooks/useXAiSDK\";\nimport request from \"./utils/request\";\n\n// 新的 Compound Components 架构\nimport XAdkProvider from \"./components/XAdkProvider\";\nimport XAdkChatbot from \"./components/XAdkChatbot\";\nimport XAdkSender from \"./components/XAdkSender\";\nimport useADKChat from \"./hooks/useADKChat\";\n\n// 导出新的 Context Hooks\nexport {\n  useChatState,\n  useChatActions,\n  useSession,\n} from \"./components/XAdkProvider/context\";\n\nexport * from \"./types\";\n\n// 导出自定义 Hook 相关类型\nexport type { ChatHookResult, ChatHookFactory } from \"./types/ChatHook\";\n\n// 旧 API - 保持向后兼容\nexport {\n  useXAi,\n  XAiProvider,\n  XAiChatbot,\n  XAiSDK,\n  XAiSender,\n  XAiConversations,\n  useXAiSDK,\n  request,\n};\n\n// 新 API - 推荐使用\nexport {\n  XAdkProvider,\n  XAdkChatbot,\n  XAdkSender,\n  FileGallery,\n  XAdkThoughtChain,\n  useADKChat,\n};\n\n// 基础组件导出 - 供高级用户和业务侧使用\nexport { default as MarkdownRender } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport { default as FunctionCallRender } from \"./components/XAdkChatbot/components/FunctionCallRender\";\nexport { default as ThinkRender } from \"./components/XAdkChatbot/components/ThinkRender\";\n\n// 基础组件类型导出\nexport type { MarkdownRenderProps } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport type { FunctionCallRenderProps } from \"./components/XAdkChatbot/components/FunctionCallRender\";\nexport type {\n  XAdkThoughtChainProps,\n  ThoughtChainItemType,\n} from \"./types/XAdkThoughtChain\";\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wCAAAA;AAAA,EAAA;AAAA;AAAA;AAAA,wCAAAC;AAAA,EAAA,wCAAAC;AAAA,EAAA,oCAAAC;AAAA,EAAA,gDAAAC;AAAA,EAAA,oCAAAC;AAAA,EAAA,gDAAAC;AAAA,EAAA,sCAAAC;AAAA,EAAA,4BAAAC;AAAA,EAAA,kCAAAC;AAAA,EAAA,8BAAAC;AAAA,EAAA,oCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,oCAAAC;AAAA;AAAA;AACA,+BAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,oBAAmB;AACnB,uBAAsB;AACtB,yBAAwB;AACxB,8BAA6B;AAC7B,8BAA6B;AAC7B,uBAAsB;AACtB,qBAAoB;AAGpB,0BAAyB;AACzB,yBAAwB;AACxB,wBAAuB;AACvB,wBAAuB;AAGvB,qBAIO;AAEP,wBAAc,oBAzBd;AAqDA,4BAA0C;AAC1C,gCAA8C;AAC9C,yBAAuC;",
+  "sourcesContent": ["// index.ts\nimport { useXAi } from \"./context/AiProviderContext\";\nimport XAiProvider from \"./components/XAiProvider\";\nimport XAiChatbot from \"./components/XAiChatbot\";\nimport XAiSDK from \"./components/XAiSDK\";\nimport XAiSender from \"./components/XAiSender\";\nimport FileGallery from \"./components/FileGallery\";\nimport XAiConversations from \"./components/XAiConversations\";\nimport XAdkThoughtChain from \"./components/XAdkThoughtChain\";\nimport useXAiSDK from \"./hooks/useXAiSDK\";\nimport request from \"./utils/request\";\n\n// 新的 Compound Components 架构\nimport XAdkProvider from \"./components/XAdkProvider\";\nimport XAdkChatbot from \"./components/XAdkChatbot\";\nimport XAdkSender from \"./components/XAdkSender\";\nimport useADKChat from \"./hooks/useADKChat\";\nimport {\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  createXGroupUploadRequest,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n} from \"./presets/xGroupAdk\";\n\n// 导出新的 Context Hooks\nexport {\n  useChatState,\n  useChatActions,\n  useSession,\n} from \"./components/XAdkProvider/context\";\n\nexport * from \"./types\";\n\n// 导出自定义 Hook 相关类型\nexport type { ChatHookResult, ChatHookFactory } from \"./types/ChatHook\";\n\n// 旧 API - 保持向后兼容\nexport {\n  useXAi,\n  XAiProvider,\n  XAiChatbot,\n  XAiSDK,\n  XAiSender,\n  XAiConversations,\n  useXAiSDK,\n  request,\n};\n\n// 新 API - 推荐使用\nexport {\n  XAdkProvider,\n  XAdkChatbot,\n  XAdkSender,\n  FileGallery,\n  XAdkThoughtChain,\n  useADKChat,\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  createXGroupUploadRequest,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n};\n\n// 基础组件导出 - 供高级用户和业务侧使用\nexport { default as MarkdownRender } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport { default as FunctionCallRender } from \"./components/XAdkChatbot/components/FunctionCallRender\";\nexport { default as ThinkRender } from \"./components/XAdkChatbot/components/ThinkRender\";\n\n// 基础组件类型导出\nexport type { MarkdownRenderProps } from \"./components/XAdkChatbot/components/MarkdownRender\";\nexport type { FunctionCallRenderProps } from \"./types/FunctionCallRender\";\nexport type {\n  XAdkThoughtChainProps,\n  ThoughtChainItemType,\n} from \"./types/XAdkThoughtChain\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wCAAAA;AAAA,EAAA;AAAA;AAAA;AAAA,wCAAAC;AAAA,EAAA,wCAAAC;AAAA,EAAA,oCAAAC;AAAA,EAAA,gDAAAC;AAAA,EAAA,oCAAAC;AAAA,EAAA,gDAAAC;AAAA,EAAA,sCAAAC;AAAA,EAAA,4BAAAC;AAAA,EAAA,kCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAAAC;AAAA,EAAA;AAAA;AAAA,sCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,oCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AACA,+BAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,oBAAmB;AACnB,uBAAsB;AACtB,yBAAwB;AACxB,8BAA6B;AAC7B,8BAA6B;AAC7B,uBAAsB;AACtB,qBAAoB;AAGpB,0BAAyB;AACzB,yBAAwB;AACxB,wBAAuB;AACvB,wBAAuB;AACvB,uBAUO;AAGP,qBAIO;AAEP,wBAAc,oBApCd;AAyEA,4BAA0C;AAC1C,gCAA8C;AAC9C,yBAAuC;",
   "names": ["FileGallery", "XAdkChatbot", "XAdkProvider", "XAdkSender", "XAdkThoughtChain", "XAiChatbot", "XAiConversations", "XAiProvider", "XAiSDK", "XAiSender", "request", "useADKChat", "useXAiSDK"]
 }

package/dist/cjs/presets/xGroupAdk.d.ts

@@ -0,0 +1,20 @@
+import type { ChatPreset, ChatPresetInput, ChatStrategies, ToolRenderKind, UploadRequestFn } from "../types";
+export declare const baseToolKindResolver: () => ToolRenderKind;
+export declare const xGroupToolKindResolver: ({ name, }: {
+    name?: string | undefined;
+}) => ToolRenderKind;
+export declare const baseChatStrategies: Required<Pick<ChatStrategies, "resolveToolKind" | "createFunctionResponse" | "parseProcessMessage">>;
+export declare const createXGroupUploadRequest: ({ url, token, appNo, }: {
+    url: string;
+    token?: string | undefined;
+    appNo?: string | undefined;
+}) => UploadRequestFn | undefined;
+export declare const xGroupAdkPreset: ChatPreset;
+export declare const basePreset: ChatPreset;
+export declare const resolveChatPreset: (preset: ChatPresetInput | undefined) => ChatPreset;
+export declare const mergeChatStrategies: (preset: ChatPresetInput | undefined, overrides?: ChatStrategies) => ChatStrategies;
+export declare const resolvePresetUploadRequest: (preset: ChatPresetInput | undefined, context: {
+    url: string;
+    token?: string;
+    appNo?: string;
+}) => UploadRequestFn | undefined;

package/dist/cjs/presets/xGroupAdk.js

@@ -0,0 +1,130 @@
+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/presets/xGroupAdk.ts
+var xGroupAdk_exports = {};
+__export(xGroupAdk_exports, {
+  baseChatStrategies: () => baseChatStrategies,
+  basePreset: () => basePreset,
+  baseToolKindResolver: () => baseToolKindResolver,
+  createXGroupUploadRequest: () => createXGroupUploadRequest,
+  mergeChatStrategies: () => mergeChatStrategies,
+  resolveChatPreset: () => resolveChatPreset,
+  resolvePresetUploadRequest: () => resolvePresetUploadRequest,
+  xGroupAdkPreset: () => xGroupAdkPreset,
+  xGroupToolKindResolver: () => xGroupToolKindResolver
+});
+module.exports = __toCommonJS(xGroupAdk_exports);
+var import_utils = require("../utils");
+var baseToolKindResolver = () => "default";
+var xGroupToolKindResolver = ({
+  name
+}) => {
+  if (name === "adk_request_confirmation")
+    return "approval";
+  if (name === "transferToAgent")
+    return "handoff";
+  return "default";
+};
+var baseChatStrategies = {
+  resolveToolKind: () => "default",
+  createFunctionResponse: (fnCall, confirmed) => ({
+    id: fnCall.id,
+    name: fnCall.name,
+    response: { confirmed }
+  }),
+  parseProcessMessage: import_utils.parseAgentMessage
+};
+var createXGroupUploadRequest = ({
+  url,
+  token,
+  appNo
+}) => {
+  if (!appNo || !token)
+    return void 0;
+  return async ({ file, onProgress, onSuccess, onError }) => {
+    try {
+      onProgress == null ? void 0 : onProgress({ percent: 0 });
+      const formData = new FormData();
+      formData.append("file", file);
+      const response = await fetch(
+        `${url}/api/gateway-web/openApi/v1/aizt/app/${appNo}/uploadMultiFile`,
+        {
+          method: "POST",
+          body: formData,
+          credentials: "include",
+          headers: {
+            Accept: "application/json, text/plain, */*",
+            Authorization: `Bearer ${token}`,
+            "Cache-Control": "no-cache"
+          }
+        }
+      );
+      const result = await response.json().catch(() => ({}));
+      if (!response.ok) {
+        throw new Error((result == null ? void 0 : result.message) || `文件上传失败 (${response.status})`);
+      }
+      onProgress == null ? void 0 : onProgress({ percent: 100 });
+      onSuccess == null ? void 0 : onSuccess((result == null ? void 0 : result.data) ?? result);
+    } catch (error) {
+      onError == null ? void 0 : onError(error instanceof Error ? error : new Error("文件上传失败"));
+    }
+  };
+};
+var xGroupAdkPreset = {
+  name: "xgroup-adk",
+  strategies: {
+    resolveToolKind: xGroupToolKindResolver,
+    createFunctionResponse: baseChatStrategies.createFunctionResponse,
+    parseProcessMessage: (text, options) => (0, import_utils.parseAgentMessage)(text, { mode: "comment", ...options })
+  },
+  createUploadRequest: createXGroupUploadRequest
+};
+var basePreset = {
+  name: "base",
+  strategies: baseChatStrategies
+};
+var resolveChatPreset = (preset) => {
+  if (!preset || preset === "xgroup-adk")
+    return xGroupAdkPreset;
+  if (preset === "base")
+    return basePreset;
+  return preset;
+};
+var mergeChatStrategies = (preset, overrides) => ({
+  ...baseChatStrategies,
+  ...resolveChatPreset(preset).strategies,
+  ...overrides
+});
+var resolvePresetUploadRequest = (preset, context) => {
+  var _a, _b;
+  return (_b = (_a = resolveChatPreset(preset)).createUploadRequest) == null ? void 0 : _b.call(_a, context);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  baseChatStrategies,
+  basePreset,
+  baseToolKindResolver,
+  createXGroupUploadRequest,
+  mergeChatStrategies,
+  resolveChatPreset,
+  resolvePresetUploadRequest,
+  xGroupAdkPreset,
+  xGroupToolKindResolver
+});
+//# sourceMappingURL=xGroupAdk.js.map

package/dist/cjs/presets/xGroupAdk.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/presets/xGroupAdk.ts"],
+  "sourcesContent": ["import { parseAgentMessage } from \"@/utils\";\nimport type {\n  ChatPreset,\n  ChatPresetInput,\n  ChatStrategies,\n  FunctionCall,\n  FunctionResponse,\n  ToolRenderKind,\n  UploadRequestFn,\n} from \"@/types\";\n\nexport const baseToolKindResolver = (): ToolRenderKind => \"default\";\n\nexport const xGroupToolKindResolver = ({\n  name,\n}: {\n  name?: string;\n}): ToolRenderKind => {\n  if (name === \"adk_request_confirmation\") return \"approval\";\n  if (name === \"transferToAgent\") return \"handoff\";\n  return \"default\";\n};\n\nexport const baseChatStrategies: Required<\n  Pick<ChatStrategies, \"resolveToolKind\" | \"createFunctionResponse\" | \"parseProcessMessage\">\n> = {\n  resolveToolKind: () => \"default\",\n  createFunctionResponse: (\n    fnCall: FunctionCall,\n    confirmed: boolean,\n  ): FunctionResponse => ({\n    id: fnCall.id,\n    name: fnCall.name,\n    response: { confirmed },\n  }),\n  parseProcessMessage: parseAgentMessage,\n};\n\nexport const createXGroupUploadRequest = ({\n  url,\n  token,\n  appNo,\n}: {\n  url: string;\n  token?: string;\n  appNo?: string;\n}): UploadRequestFn | undefined => {\n  if (!appNo || !token) return undefined;\n\n  return async ({ file, onProgress, onSuccess, onError }) => {\n    try {\n      onProgress?.({ percent: 0 });\n\n      const formData = new FormData();\n      formData.append(\"file\", file);\n\n      const response = await fetch(\n        `${url}/api/gateway-web/openApi/v1/aizt/app/${appNo}/uploadMultiFile`,\n        {\n          method: \"POST\",\n          body: formData,\n          credentials: \"include\",\n          headers: {\n            Accept: \"application/json, text/plain, */*\",\n            Authorization: `Bearer ${token}`,\n            \"Cache-Control\": \"no-cache\",\n          },\n        },\n      );\n\n      const result = await response.json().catch(() => ({}));\n\n      if (!response.ok) {\n        throw new Error(result?.message || `文件上传失败 (${response.status})`);\n      }\n\n      onProgress?.({ percent: 100 });\n      onSuccess?.(result?.data ?? result);\n    } catch (error) {\n      onError?.(error instanceof Error ? error : new Error(\"文件上传失败\"));\n    }\n  };\n};\n\nexport const xGroupAdkPreset: ChatPreset = {\n  name: \"xgroup-adk\",\n  strategies: {\n    resolveToolKind: xGroupToolKindResolver,\n    createFunctionResponse: baseChatStrategies.createFunctionResponse,\n    parseProcessMessage: (text, options) =>\n      parseAgentMessage(text, { mode: \"comment\", ...options }),\n  },\n  createUploadRequest: createXGroupUploadRequest,\n};\n\nexport const basePreset: ChatPreset = {\n  name: \"base\",\n  strategies: baseChatStrategies,\n};\n\nexport const resolveChatPreset = (\n  preset: ChatPresetInput | undefined,\n): ChatPreset => {\n  if (!preset || preset === \"xgroup-adk\") return xGroupAdkPreset;\n  if (preset === \"base\") return basePreset;\n  return preset;\n};\n\nexport const mergeChatStrategies = (\n  preset: ChatPresetInput | undefined,\n  overrides?: ChatStrategies,\n): ChatStrategies => ({\n  ...baseChatStrategies,\n  ...resolveChatPreset(preset).strategies,\n  ...overrides,\n});\n\nexport const resolvePresetUploadRequest = (\n  preset: ChatPresetInput | undefined,\n  context: {\n    url: string;\n    token?: string;\n    appNo?: string;\n  },\n): UploadRequestFn | undefined => {\n  return resolveChatPreset(preset).createUploadRequest?.(context);\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AAW3B,IAAM,uBAAuB,MAAsB;AAEnD,IAAM,yBAAyB,CAAC;AAAA,EACrC;AACF,MAEsB;AACpB,MAAI,SAAS;AAA4B,WAAO;AAChD,MAAI,SAAS;AAAmB,WAAO;AACvC,SAAO;AACT;AAEO,IAAM,qBAET;AAAA,EACF,iBAAiB,MAAM;AAAA,EACvB,wBAAwB,CACtB,QACA,eACsB;AAAA,IACtB,IAAI,OAAO;AAAA,IACX,MAAM,OAAO;AAAA,IACb,UAAU,EAAE,UAAU;AAAA,EACxB;AAAA,EACA,qBAAqB;AACvB;AAEO,IAAM,4BAA4B,CAAC;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,MAImC;AACjC,MAAI,CAAC,SAAS,CAAC;AAAO,WAAO;AAE7B,SAAO,OAAO,EAAE,MAAM,YAAY,WAAW,QAAQ,MAAM;AACzD,QAAI;AACF,+CAAa,EAAE,SAAS,EAAE;AAE1B,YAAM,WAAW,IAAI,SAAS;AAC9B,eAAS,OAAO,QAAQ,IAAI;AAE5B,YAAM,WAAW,MAAM;AAAA,QACrB,GAAG,2CAA2C;AAAA,QAC9C;AAAA,UACE,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,aAAa;AAAA,UACb,SAAS;AAAA,YACP,QAAQ;AAAA,YACR,eAAe,UAAU;AAAA,YACzB,iBAAiB;AAAA,UACnB;AAAA,QACF;AAAA,MACF;AAEA,YAAM,SAAS,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAErD,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI,OAAM,iCAAQ,YAAW,WAAW,SAAS,SAAS;AAAA,MAClE;AAEA,+CAAa,EAAE,SAAS,IAAI;AAC5B,8CAAY,iCAAQ,SAAQ;AAAA,IAC9B,SAAS,OAAP;AACA,yCAAU,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,QAAQ;AAAA,IAC/D;AAAA,EACF;AACF;AAEO,IAAM,kBAA8B;AAAA,EACzC,MAAM;AAAA,EACN,YAAY;AAAA,IACV,iBAAiB;AAAA,IACjB,wBAAwB,mBAAmB;AAAA,IAC3C,qBAAqB,CAAC,MAAM,gBAC1B,gCAAkB,MAAM,EAAE,MAAM,WAAW,GAAG,QAAQ,CAAC;AAAA,EAC3D;AAAA,EACA,qBAAqB;AACvB;AAEO,IAAM,aAAyB;AAAA,EACpC,MAAM;AAAA,EACN,YAAY;AACd;AAEO,IAAM,oBAAoB,CAC/B,WACe;AACf,MAAI,CAAC,UAAU,WAAW;AAAc,WAAO;AAC/C,MAAI,WAAW;AAAQ,WAAO;AAC9B,SAAO;AACT;AAEO,IAAM,sBAAsB,CACjC,QACA,eACoB;AAAA,EACpB,GAAG;AAAA,EACH,GAAG,kBAAkB,MAAM,EAAE;AAAA,EAC7B,GAAG;AACL;AAEO,IAAM,6BAA6B,CACxC,QACA,YAKgC;AA5HlC;AA6HE,UAAO,6BAAkB,MAAM,GAAE,wBAA1B,4BAAgD;AACzD;",
+  "names": []
+}

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

@@ -0,0 +1,45 @@
+import type React from "react";
+import type { ParseAgentMessageOptions, ParsedPart } from "../utils";
+import type { IMessage, FunctionCall, FunctionResponse } from "./XAdkChatbot";
+import type { ToolRenderKind } from "./FunctionCallRender";
+import type { UploadRequestFn } from "./XAdkSender";
+export interface ToolKindResolveContext {
+    name?: string;
+    msg?: IMessage;
+}
+export interface ChatStrategies {
+    /**
+     * 工具名/消息 -> 渲染类型解析策略。
+     */
+    resolveToolKind?: (ctx: ToolKindResolveContext) => ToolRenderKind;
+    /**
+     * 函数调用确认场景中，基于工具调用和用户选择生成 functionResponse。
+     */
+    createFunctionResponse?: (fnCall: FunctionCall, confirmed: boolean) => FunctionResponse;
+    /**
+     * 将模型文本拆分为过程节点和最终答案。
+     */
+    parseProcessMessage?: (text: string, options?: ParseAgentMessageOptions) => ParsedPart[];
+    /**
+     * 自定义 approval 场景渲染，返回 null 则使用默认渲染。
+     */
+    renderApproval?: (msg: IMessage, onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void) => React.ReactNode | null;
+    /**
+     * 自定义 handoff 场景渲染，返回 null 则使用默认渲染。
+     */
+    renderHandoff?: (msg: IMessage) => React.ReactNode | null;
+}
+export interface ChatPreset {
+    name: string;
+    strategies?: ChatStrategies;
+    /**
+     * 基于当前协议预设创建默认文件上传函数。
+     * 用户显式传入 config.uploadRequest 时优先使用用户配置。
+     */
+    createUploadRequest?: (context: {
+        url: string;
+        token?: string;
+        appNo?: string;
+    }) => UploadRequestFn | undefined;
+}
+export type ChatPresetInput = "base" | "xgroup-adk" | ChatPreset;

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/ChatStrategies.ts"],
+  "sourcesContent": ["import type React from \"react\";\nimport type { ParseAgentMessageOptions, ParsedPart } from \"@/utils\";\nimport type { IMessage, FunctionCall, FunctionResponse } from \"./XAdkChatbot\";\nimport type { ToolRenderKind } from \"./FunctionCallRender\";\nimport type { UploadRequestFn } from \"./XAdkSender\";\n\nexport interface ToolKindResolveContext {\n  name?: string;\n  msg?: IMessage;\n}\n\nexport interface ChatStrategies {\n  /**\n   * 工具名/消息 -> 渲染类型解析策略。\n   */\n  resolveToolKind?: (ctx: ToolKindResolveContext) => ToolRenderKind;\n  /**\n   * 函数调用确认场景中，基于工具调用和用户选择生成 functionResponse。\n   */\n  createFunctionResponse?: (\n    fnCall: FunctionCall,\n    confirmed: boolean,\n  ) => FunctionResponse;\n  /**\n   * 将模型文本拆分为过程节点和最终答案。\n   */\n  parseProcessMessage?: (\n    text: string,\n    options?: ParseAgentMessageOptions,\n  ) => ParsedPart[];\n  /**\n   * 自定义 approval 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderApproval?: (\n    msg: IMessage,\n    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void,\n  ) => React.ReactNode | null;\n  /**\n   * 自定义 handoff 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderHandoff?: (msg: IMessage) => React.ReactNode | null;\n}\n\nexport interface ChatPreset {\n  name: string;\n  strategies?: ChatStrategies;\n  /**\n   * 基于当前协议预设创建默认文件上传函数。\n   * 用户显式传入 config.uploadRequest 时优先使用用户配置。\n   */\n  createUploadRequest?: (context: {\n    url: string;\n    token?: string;\n    appNo?: string;\n  }) => UploadRequestFn | undefined;\n}\n\nexport type ChatPresetInput = \"base\" | \"xgroup-adk\" | ChatPreset;\n"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

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

@@ -0,0 +1,35 @@
+/// <reference types="react" />
+import type { IMessage, FunctionCall } from "./";
+/**
+ * 工具调用渲染类型
+ * - approval: 需要用户确认的调用（如危险操作确认）
+ * - handoff: 任务转交给其他 Agent
+ * - default: 普通工具调用
+ */
+export type ToolRenderKind = "approval" | "handoff" | "default";
+/**
+ * 默认的工具名 → 渲染类型推导策略
+ */
+export declare const defaultToolKindResolver: (_name: string | undefined) => ToolRenderKind;
+export interface FunctionCallRenderProps {
+    msg: IMessage;
+    showDetail?: boolean;
+    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;
+    /**
+     * 工具渲染类型，不传则使用 toolKindResolver 自动推导
+     */
+    kind?: ToolRenderKind;
+    /**
+     * 工具名 → 渲染类型的解析策略，默认使用中立的 defaultToolKindResolver。
+     * 业务协议可通过 XAdkProvider preset/strategies 自动下发，或局部传入覆盖。
+     */
+    toolKindResolver?: (name: string | undefined) => ToolRenderKind;
+    /**
+     * 自定义 approval 场景渲染，返回 null 则使用默认渲染
+     */
+    renderApproval?: (msg: IMessage, onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void) => React.ReactNode | null;
+    /**
+     * 自定义 handoff 场景渲染，返回 null 则使用默认渲染
+     */
+    renderHandoff?: (msg: IMessage) => React.ReactNode | null;
+}

package/dist/cjs/types/FunctionCallRender.js

@@ -0,0 +1,32 @@
+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/FunctionCallRender.ts
+var FunctionCallRender_exports = {};
+__export(FunctionCallRender_exports, {
+  defaultToolKindResolver: () => defaultToolKindResolver
+});
+module.exports = __toCommonJS(FunctionCallRender_exports);
+var defaultToolKindResolver = (_name) => {
+  return "default";
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultToolKindResolver
+});
+//# sourceMappingURL=FunctionCallRender.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/FunctionCallRender.ts"],
+  "sourcesContent": ["import type { IMessage, FunctionCall } from \"@/types\";\n\n/**\n * 工具调用渲染类型\n * - approval: 需要用户确认的调用（如危险操作确认）\n * - handoff: 任务转交给其他 Agent\n * - default: 普通工具调用\n */\nexport type ToolRenderKind = \"approval\" | \"handoff\" | \"default\";\n\n/**\n * 默认的工具名 → 渲染类型推导策略\n */\nexport const defaultToolKindResolver = (\n  _name: string | undefined,\n): ToolRenderKind => {\n  return \"default\";\n};\n\nexport interface FunctionCallRenderProps {\n  msg: IMessage;\n  showDetail?: boolean;\n  onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;\n  /**\n   * 工具渲染类型，不传则使用 toolKindResolver 自动推导\n   */\n  kind?: ToolRenderKind;\n  /**\n   * 工具名 → 渲染类型的解析策略，默认使用中立的 defaultToolKindResolver。\n   * 业务协议可通过 XAdkProvider preset/strategies 自动下发，或局部传入覆盖。\n   */\n  toolKindResolver?: (name: string | undefined) => ToolRenderKind;\n  /**\n   * 自定义 approval 场景渲染，返回 null 则使用默认渲染\n   */\n  renderApproval?: (\n    msg: IMessage,\n    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void,\n  ) => React.ReactNode | null;\n  /**\n   * 自定义 handoff 场景渲染，返回 null 则使用默认渲染\n   */\n  renderHandoff?: (msg: IMessage) => React.ReactNode | null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,IAAM,0BAA0B,CACrC,UACmB;AACnB,SAAO;AACT;",
+  "names": []
+}

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

@@ -2,6 +2,8 @@ import { JSX } from "react";
 import { type XAdkSenderProps } from "./XAdkSender";
 import { type SendContent } from "./XAiSender";
 import { type FileItem } from "./FileGallery";
+import { type ToolRenderKind } from "./FunctionCallRender";
+import { type ChatPresetInput, type ChatStrategies } from "./ChatStrategies";
 /**
  * 消息分组接口
  */
@@ -201,7 +203,37 @@ export type ActionProps = (data: {
     message: ChatGroup;
     isLastBotMsg: boolean;
 }) => JSX.Element | null;
+/**
+ * 自定义工具调用渲染函数
+ * - 返回 ReactNode：使用自定义渲染
+ * - 返回 null：降级使用默认渲染
+ *
+ * @example
+ * renderFunctionCall={(msg) => {
+ *   if (msg.functionCall?.name === 'my_tool') return <MyToolRender msg={msg} />;
+ *   return null; // 其他工具使用默认渲染
+ * }}
+ */
+export type RenderFunctionCall = (msg: IMessage) => React.ReactNode | null;
 export interface XAdkChatbotProps extends Partial<XAdkSenderProps> {
+    /**
+     * 自定义工具调用渲染函数
+     * 返回 null 则降级使用默认渲染
+     */
+    renderFunctionCall?: RenderFunctionCall;
+    /**
+     * 工具名 → 渲染类型的解析策略，默认使用 defaultToolKindResolver
+     */
+    toolKindResolver?: (name: string | undefined) => ToolRenderKind;
+    /**
+     * 聊天策略，可由 Provider preset 自动下发，也可在组件局部覆盖。
+     */
+    strategies?: ChatStrategies;
+    /**
+     * 组件直用时的协议预设。默认沿用 xgroup-adk 以兼容既有业务接入；
+     * 需要中立行为时可传入 base。
+     */
+    preset?: ChatPresetInput;
     className?: string;
     style?: React.CSSProperties;
     loading?: boolean;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAdkChatbot.ts"],
-  "sourcesContent": ["import { JSX } from \"react\";\nimport { type XAdkSenderProps } from \"./XAdkSender\";\nimport { type SendContent } from \"./XAiSender\";\nimport { type FileItem } from \"./FileGallery\";\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  /** 点击对话中附件卡片的回调（非图片、非音视频文件） */\n  onFileClick?: (file: FileItem) => void;\n}\n"],
+  "sourcesContent": ["import { JSX } from \"react\";\nimport { type XAdkSenderProps } from \"./XAdkSender\";\nimport { type SendContent } from \"./XAiSender\";\nimport { type FileItem } from \"./FileGallery\";\nimport { type ToolRenderKind } from \"./FunctionCallRender\";\nimport { type ChatPresetInput, type ChatStrategies } from \"./ChatStrategies\";\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\n/**\n * 自定义工具调用渲染函数\n * - 返回 ReactNode：使用自定义渲染\n * - 返回 null：降级使用默认渲染\n *\n * @example\n * renderFunctionCall={(msg) => {\n *   if (msg.functionCall?.name === 'my_tool') return <MyToolRender msg={msg} />;\n *   return null; // 其他工具使用默认渲染\n * }}\n */\nexport type RenderFunctionCall = (msg: IMessage) => React.ReactNode | null;\n\nexport interface XAdkChatbotProps extends Partial<XAdkSenderProps> {\n  /**\n   * 自定义工具调用渲染函数\n   * 返回 null 则降级使用默认渲染\n   */\n  renderFunctionCall?: RenderFunctionCall;\n  /**\n   * 工具名 → 渲染类型的解析策略，默认使用 defaultToolKindResolver\n   */\n  toolKindResolver?: (name: string | undefined) => ToolRenderKind;\n  /**\n   * 聊天策略，可由 Provider preset 自动下发，也可在组件局部覆盖。\n   */\n  strategies?: ChatStrategies;\n  /**\n   * 组件直用时的协议预设。默认沿用 xgroup-adk 以兼容既有业务接入；\n   * 需要中立行为时可传入 base。\n   */\n  preset?: ChatPresetInput;\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  /** 点击对话中附件卡片的回调（非图片、非音视频文件） */\n  onFileClick?: (file: FileItem) => void;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -1,5 +1,6 @@
 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;
@@ -12,6 +13,7 @@ export interface DebugOptions {
      * @default true
      */
     enabled?: boolean;
+    strategies?: ChatStrategies;
     onError?: (error: Error) => void;
     onSuccess?: (data: Success) => void;
     onStream?: (data: Event) => void;
@@ -125,6 +127,15 @@ export interface XAdkProviderConfig {
      * 自定义文件上传函数
      */
     uploadRequest?: UploadRequestFn;
+    /**
+     * 预设策略。默认 xgroup-adk，用于兼容众安信科现有 ADK 协议。
+     * 传入 base 可获得更中立的组件默认行为。
+     */
+    preset?: ChatPresetInput;
+    /**
+     * 覆盖或补充当前 preset 的局部策略。
+     */
+    strategies?: ChatStrategies;
 }
 /**
  * XAdkProvider Props
@@ -142,6 +153,14 @@ export interface XAdkProviderProps {
      * 组件功能配置
      */
     config?: XAdkProviderConfig;
+    /**
+     * Provider 级预设策略，优先级高于 config.preset。
+     */
+    preset?: ChatPresetInput;
+    /**
+     * Provider 级策略覆盖，优先级高于 config.strategies。
+     */
+    strategies?: ChatStrategies;
     /**
      * Provider 唯一标识
      */

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\";\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  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  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\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": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCO,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,oBAAiB;AAEjB,EAAAA,WAAA,oBAAiB;AAJP,SAAAA;AAAA,GAAA;",
+  "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  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

@@ -1,22 +1,38 @@
 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;
+    [key: string]: any;
+}
 interface uploadRequestProps {
     (options: {
         file: File;
         onProgress?: (e: {
             percent: number;
         }) => void;
-        onSuccess?: (response: any) => void;
+        onSuccess?: (response: UploadFileResult | UploadSuccessResponse) => void;
         onError?: (error: Error) => void;
     }): Promise<void> | void;
 }
 export type UploadRequestFn = uploadRequestProps;
 export interface ServerFile {
     fileName: string;
-    fileId: number;
+    fileId: string | number;
     tempUrl: string;
     type: string;
-    size: number;
+    size?: number;
     mimeType: string;
+    raw?: UploadFileResult;
 }
 export interface LocalFile {
     id: string;
@@ -27,7 +43,7 @@ export interface LocalFile {
     type: string;
     progress: number;
     status: "pending" | "uploading" | "success" | "error";
-    fileId?: number;
+    fileId?: string | number;
     tempUrl?: string;
     response?: any;
     errorMessage?: string;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "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 type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: number;\n  tempUrl: string;\n  type: string;\n  size: number;\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 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  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: { text: string; files: ServerFile[] }) => void;\n  onStop?: () => void;\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"],
+  "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;\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (response: UploadFileResult | UploadSuccessResponse) => 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  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: { text: string; files: ServerFile[] }) => void;\n  onStop?: () => void;\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"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -1,5 +1,5 @@
 import React, { type ReactNode } from "react";
-import { IMessage } from "./XAdkChatbot";
+import { IMessage, RenderFunctionCall, ToolRenderKind, ChatStrategies } from "./";
 export interface XAdkThoughtChainProps {
     defaultOpen?: boolean;
     loading?: boolean;
@@ -8,6 +8,14 @@ export interface XAdkThoughtChainProps {
     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;
@@ -21,7 +29,7 @@ export interface ThoughtChainItemType {
     type: "tool" | "text";
     key: string;
     content: string;
-    title?: React.ReactNode;
+    title?: ReactNode;
     collapsible?: boolean;
     msg?: IMessage;
 }