@ai-group/chat-sdk 3.7.0 → 3.7.1-alpha10

package/dist/cjs/presets/xgroup/preset.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/presets/xgroup/preset.ts"],
-  "sourcesContent": ["import { parseAgentMessage } from \"@/utils\";\nimport type {\n  ChatPreset,\n  ChatPresetInput,\n  ChatStrategies,\n  UploadRequestFn,\n} from \"@/types\";\nimport {\n  baseChatStrategies,\n  xGroupToolKindResolver,\n} from \"./strategies\";\nimport { createXGroupUploadRequest } from \"./upload\";\n\n/** 众安信科 ADK 官方预设：聚合工具展示、消息解析、确认响应和默认上传等业务策略。 */\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\n/** 基础预设用于完全通用的 SDK 行为，不绑定众安信科后端协议。 */\nexport const basePreset: ChatPreset = {\n  name: \"base\",\n  strategies: baseChatStrategies,\n};\n\n/** 统一解析字符串预设和对象预设，默认保持历史行为使用 xgroup-adk。 */\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\n/** 将预设策略与局部覆盖合并，供组件和业务侧按需覆盖单个函数。 */\nexport const mergeChatStrategies = (\n  preset: ChatPresetInput | undefined,\n  overrides?: ChatStrategies,\n): ChatStrategies => ({\n  ...baseChatStrategies,\n  ...resolveChatPreset(preset).strategies,\n  ...overrides,\n});\n\n/** 从当前预设中解析上传实现，业务显式传入 uploadRequest 时仍然优先使用业务实现。 */\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,mBAAkC;AAOlC,wBAGO;AACP,oBAA0C;AAGnC,IAAM,kBAA8B;AAAA,EACzC,MAAM;AAAA,EACN,YAAY;AAAA,IACV,iBAAiB;AAAA,IACjB,wBAAwB,qCAAmB;AAAA,IAC3C,qBAAqB,CAAC,MAAM,gBAC1B,gCAAkB,MAAM,EAAE,MAAM,WAAW,GAAG,QAAQ,CAAC;AAAA,EAC3D;AAAA,EACA,qBAAqB;AACvB;AAGO,IAAM,aAAyB;AAAA,EACpC,MAAM;AAAA,EACN,YAAY;AACd;AAGO,IAAM,oBAAoB,CAC/B,WACe;AACf,MAAI,CAAC,UAAU,WAAW;AAAc,WAAO;AAC/C,MAAI,WAAW;AAAQ,WAAO;AAC9B,SAAO;AACT;AAGO,IAAM,sBAAsB,CACjC,QACA,eACoB;AAAA,EACpB,GAAG;AAAA,EACH,GAAG,kBAAkB,MAAM,EAAE;AAAA,EAC7B,GAAG;AACL;AAGO,IAAM,6BAA6B,CACxC,QACA,YAKgC;AA1DlC;AA2DE,UAAO,6BAAkB,MAAM,GAAE,wBAA1B,4BAAgD;AACzD;",
+  "sourcesContent": ["import { parseAgentMessage } from \"@/utils\";\nimport type { ChatPreset } from \"@/types\";\nimport { basePreset } from \"../base\";\nimport { composeChatPresets, defineChatPreset } from \"../define\";\nimport {\n  xGroupMarkdownResourceLinkSchemes,\n  xGroupToolKindResolver,\n} from \"./strategies\";\nimport { xGroupMarkdownExtensions } from \"./knowledgeReference\";\nimport { createXGroupUploadRequest } from \"./upload\";\n\n/** 众安信科 ADK 官方预设：聚合工具展示、消息解析、确认响应和默认上传等业务策略。 */\nexport const xGroupAdkPreset: ChatPreset = composeChatPresets(\n  basePreset,\n  defineChatPreset({\n    name: \"xgroup-adk\",\n    markdownExtensions: xGroupMarkdownExtensions,\n    strategies: {\n      resolveToolKind: xGroupToolKindResolver,\n      parseProcessMessage: (text, options) =>\n        parseAgentMessage(text, { mode: \"comment\", ...options }),\n      markdownResourceLinkSchemes: xGroupMarkdownResourceLinkSchemes,\n    },\n    createUploadRequest: createXGroupUploadRequest,\n  }),\n);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AAElC,kBAA2B;AAC3B,oBAAqD;AACrD,wBAGO;AACP,gCAAyC;AACzC,oBAA0C;AAGnC,IAAM,sBAA8B;AAAA,EACzC;AAAA,MACA,gCAAiB;AAAA,IACf,MAAM;AAAA,IACN,oBAAoB;AAAA,IACpB,YAAY;AAAA,MACV,iBAAiB;AAAA,MACjB,qBAAqB,CAAC,MAAM,gBAC1B,gCAAkB,MAAM,EAAE,MAAM,WAAW,GAAG,QAAQ,CAAC;AAAA,MACzD,6BAA6B;AAAA,IAC/B;AAAA,IACA,qBAAqB;AAAA,EACvB,CAAC;AACH;",
   "names": []
 }

package/dist/cjs/presets/xgroup/strategies.d.ts

@@ -1,8 +1,9 @@
-import type { ChatStrategies, ToolRenderKind } from "../../types";
-export declare const baseToolKindResolver: () => ToolRenderKind;
+import type { ToolRenderKind } from "../../types";
+export declare const xGroupMarkdownResourceLinkSchemes: readonly ["skill", "kb"];
+export declare const formatXGroupMarkdownResourceLinksAsText: (text: string, options?: {
+    stripTrigger?: boolean;
+}) => string;
 /** 众安信科预设的工具类型映射，集中处理当前后端约定的 tool name。 */
 export declare const xGroupToolKindResolver: ({ name, }: {
     name?: string | undefined;
 }) => ToolRenderKind;
-/** SDK 基础策略：不带业务协议偏好的最小行为集合。 */
-export declare const baseChatStrategies: Required<Pick<ChatStrategies, "resolveToolKind" | "createFunctionResponse" | "parseProcessMessage">>;

package/dist/cjs/presets/xgroup/strategies.js

@@ -19,13 +19,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/presets/xgroup/strategies.ts
 var strategies_exports = {};
 __export(strategies_exports, {
-  baseChatStrategies: () => baseChatStrategies,
-  baseToolKindResolver: () => baseToolKindResolver,
+  formatXGroupMarkdownResourceLinksAsText: () => formatXGroupMarkdownResourceLinksAsText,
+  xGroupMarkdownResourceLinkSchemes: () => xGroupMarkdownResourceLinkSchemes,
   xGroupToolKindResolver: () => xGroupToolKindResolver
 });
 module.exports = __toCommonJS(strategies_exports);
-var import_utils = require("../../utils");
-var baseToolKindResolver = () => "default";
+var import_markdownResource = require("../../utils/markdownResource");
+var import_markdownResource2 = require("../../utils/markdownResource");
+var xGroupMarkdownResourceLinkSchemes = import_markdownResource.MARKDOWN_RESOURCE_LINK_SCHEMES;
+var formatXGroupMarkdownResourceLinksAsText = (text, options) => (0, import_markdownResource2.formatMarkdownResourceLinksAsText)(text, {
+  ...options,
+  schemes: xGroupMarkdownResourceLinkSchemes
+});
 var xGroupToolKindResolver = ({
   name
 }) => {
@@ -35,19 +40,10 @@ var xGroupToolKindResolver = ({
     return "handoff";
   return "default";
 };
-var baseChatStrategies = {
-  resolveToolKind: () => "default",
-  createFunctionResponse: (fnCall, confirmed) => ({
-    id: fnCall.id,
-    name: fnCall.name,
-    response: { confirmed }
-  }),
-  parseProcessMessage: import_utils.parseAgentMessage
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  baseChatStrategies,
-  baseToolKindResolver,
+  formatXGroupMarkdownResourceLinksAsText,
+  xGroupMarkdownResourceLinkSchemes,
   xGroupToolKindResolver
 });
 //# sourceMappingURL=strategies.js.map

package/dist/cjs/presets/xgroup/strategies.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/presets/xgroup/strategies.ts"],
-  "sourcesContent": ["import { parseAgentMessage } from \"@/utils\";\nimport type {\n  ChatStrategies,\n  FunctionCall,\n  FunctionResponse,\n  ToolRenderKind,\n} from \"@/types\";\n\nexport const baseToolKindResolver = (): ToolRenderKind => \"default\";\n\n/** 众安信科预设的工具类型映射，集中处理当前后端约定的 tool name。 */\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\n/** SDK 基础策略：不带业务协议偏好的最小行为集合。 */\nexport const baseChatStrategies: Required<\n  Pick<\n    ChatStrategies,\n    \"resolveToolKind\" | \"createFunctionResponse\" | \"parseProcessMessage\"\n  >\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"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AAQ3B,IAAM,uBAAuB,MAAsB;AAGnD,IAAM,yBAAyB,CAAC;AAAA,EACrC;AACF,MAEsB;AACpB,MAAI,SAAS;AAA4B,WAAO;AAChD,MAAI,SAAS;AAAmB,WAAO;AACvC,SAAO;AACT;AAGO,IAAM,qBAKT;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;",
-  "names": []
+  "sourcesContent": ["import type { ToolRenderKind } from \"@/types\";\nimport { MARKDOWN_RESOURCE_LINK_SCHEMES } from \"@/utils/markdownResource\";\nimport { formatMarkdownResourceLinksAsText } from \"@/utils/markdownResource\";\n\nexport const xGroupMarkdownResourceLinkSchemes = MARKDOWN_RESOURCE_LINK_SCHEMES;\n\nexport const formatXGroupMarkdownResourceLinksAsText = (\n  text: string,\n  options?: { stripTrigger?: boolean },\n) =>\n  formatMarkdownResourceLinksAsText(text, {\n    ...options,\n    schemes: xGroupMarkdownResourceLinkSchemes,\n  });\n\n/** 众安信科预设的工具类型映射，集中处理当前后端约定的 tool name。 */\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"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,8BAA+C;AAC/C,IAAAA,2BAAkD;AAE3C,IAAM,oCAAoC;AAE1C,IAAM,0CAA0C,CACrD,MACA,gBAEA,4DAAkC,MAAM;AAAA,EACtC,GAAG;AAAA,EACH,SAAS;AACX,CAAC;AAGI,IAAM,yBAAyB,CAAC;AAAA,EACrC;AACF,MAEsB;AACpB,MAAI,SAAS;AAA4B,WAAO;AAChD,MAAI,SAAS;AAAmB,WAAO;AACvC,SAAO;AACT;",
+  "names": ["import_markdownResource"]
 }

package/dist/cjs/presets/xgroup/webReference.d.ts

@@ -0,0 +1,10 @@
+import type { MarkdownExtension, MarkdownExtensionNode } from "../../types";
+export interface XGroupWebReference {
+    url: string;
+    title: string;
+    snippet: string;
+    label: string;
+}
+export declare const XGROUP_WEB_REFERENCE_ATTRIBUTES: readonly ["url", "title", "snippet"];
+export declare const parseXGroupWebReference: ({ attributes, text, }: Pick<MarkdownExtensionNode, "attributes" | "text">) => XGroupWebReference;
+export declare const xGroupWebReferenceMarkdownExtension: MarkdownExtension;

package/dist/cjs/presets/xgroup/webReference.js

@@ -0,0 +1,85 @@
+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/xgroup/webReference.tsx
+var webReference_exports = {};
+__export(webReference_exports, {
+  XGROUP_WEB_REFERENCE_ATTRIBUTES: () => XGROUP_WEB_REFERENCE_ATTRIBUTES,
+  parseXGroupWebReference: () => parseXGroupWebReference,
+  xGroupWebReferenceMarkdownExtension: () => xGroupWebReferenceMarkdownExtension
+});
+module.exports = __toCommonJS(webReference_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+var XGROUP_WEB_REFERENCE_ATTRIBUTES = [
+  "url",
+  "title",
+  "snippet"
+];
+var parseXGroupWebReference = ({
+  attributes,
+  text
+}) => {
+  var _a, _b, _c;
+  return {
+    url: ((_a = attributes.url) == null ? void 0 : _a.trim()) || "",
+    title: ((_b = attributes.title) == null ? void 0 : _b.trim()) || "",
+    snippet: ((_c = attributes.snippet) == null ? void 0 : _c.trim()) || "",
+    label: text.trim()
+  };
+};
+var renderStaticWebReference = (node) => {
+  const reference = parseXGroupWebReference(node);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "span",
+    {
+      "aria-label": `外部搜索引用 ${reference.label || "引"}`,
+      "data-xadk-web-reference": "true",
+      style: {
+        boxSizing: "border-box",
+        display: "inline-flex",
+        alignItems: "center",
+        justifyContent: "center",
+        minWidth: 18,
+        height: 18,
+        margin: "0 3px",
+        padding: "0 5px",
+        border: "1px solid #e4e6eb",
+        borderRadius: 9,
+        background: "#f1f2f4",
+        color: "#8a8f99",
+        fontSize: 12,
+        fontWeight: 500,
+        lineHeight: "18px",
+        verticalAlign: "1px"
+      },
+      children: reference.label || "引"
+    }
+  );
+};
+var xGroupWebReferenceMarkdownExtension = {
+  tagName: "ai-web-ref",
+  allowedAttributes: XGROUP_WEB_REFERENCE_ATTRIBUTES,
+  render: renderStaticWebReference
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  XGROUP_WEB_REFERENCE_ATTRIBUTES,
+  parseXGroupWebReference,
+  xGroupWebReferenceMarkdownExtension
+});
+//# sourceMappingURL=webReference.js.map

package/dist/cjs/presets/xgroup/webReference.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/presets/xgroup/webReference.tsx"],
+  "sourcesContent": ["import React from \"react\";\n\nimport type { MarkdownExtension, MarkdownExtensionNode } from \"@/types\";\n\nexport interface XGroupWebReference {\n  url: string;\n  title: string;\n  snippet: string;\n  label: string;\n}\n\nexport const XGROUP_WEB_REFERENCE_ATTRIBUTES = [\n  \"url\",\n  \"title\",\n  \"snippet\",\n] as const;\n\nexport const parseXGroupWebReference = ({\n  attributes,\n  text,\n}: Pick<MarkdownExtensionNode, \"attributes\" | \"text\">): XGroupWebReference => ({\n  url: attributes.url?.trim() || \"\",\n  title: attributes.title?.trim() || \"\",\n  snippet: attributes.snippet?.trim() || \"\",\n  label: text.trim(),\n});\n\nconst renderStaticWebReference = (node: MarkdownExtensionNode) => {\n  const reference = parseXGroupWebReference(node);\n  return (\n    <span\n      aria-label={`外部搜索引用 ${reference.label || \"引\"}`}\n      data-xadk-web-reference=\"true\"\n      style={{\n        boxSizing: \"border-box\",\n        display: \"inline-flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        minWidth: 18,\n        height: 18,\n        margin: \"0 3px\",\n        padding: \"0 5px\",\n        border: \"1px solid #e4e6eb\",\n        borderRadius: 9,\n        background: \"#f1f2f4\",\n        color: \"#8a8f99\",\n        fontSize: 12,\n        fontWeight: 500,\n        lineHeight: \"18px\",\n        verticalAlign: \"1px\",\n      }}\n    >\n      {reference.label || \"引\"}\n    </span>\n  );\n};\n\nexport const xGroupWebReferenceMarkdownExtension: MarkdownExtension = {\n  tagName: \"ai-web-ref\",\n  allowedAttributes: XGROUP_WEB_REFERENCE_ATTRIBUTES,\n  render: renderStaticWebReference,\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BI;AAnBG,IAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,0BAA0B,CAAC;AAAA,EACtC;AAAA,EACA;AACF,MAA2E;AApB3E;AAoB+E;AAAA,IAC7E,OAAK,gBAAW,QAAX,mBAAgB,WAAU;AAAA,IAC/B,SAAO,gBAAW,UAAX,mBAAkB,WAAU;AAAA,IACnC,WAAS,gBAAW,YAAX,mBAAoB,WAAU;AAAA,IACvC,OAAO,KAAK,KAAK;AAAA,EACnB;AAAA;AAEA,IAAM,2BAA2B,CAAC,SAAgC;AAChE,QAAM,YAAY,wBAAwB,IAAI;AAC9C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,UAAU,UAAU,SAAS;AAAA,MACzC,2BAAwB;AAAA,MACxB,OAAO;AAAA,QACL,WAAW;AAAA,QACX,SAAS;AAAA,QACT,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,YAAY;AAAA,QACZ,OAAO;AAAA,QACP,UAAU;AAAA,QACV,YAAY;AAAA,QACZ,YAAY;AAAA,QACZ,eAAe;AAAA,MACjB;AAAA,MAEC,oBAAU,SAAS;AAAA;AAAA,EACtB;AAEJ;AAEO,IAAM,sCAAyD;AAAA,EACpE,SAAS;AAAA,EACT,mBAAmB;AAAA,EACnB,QAAQ;AACV;",
+  "names": []
+}

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

@@ -1,6 +1,6 @@
 import type React from "react";
 import type { ParseAgentMessageOptions, ParsedPart } from "../utils";
-import type { IMessage, FunctionCall, FunctionResponse } from "./XAdkChatbot";
+import type { IMessage, FunctionCall, FunctionResponse, MarkdownExtension } from "./XAdkChatbot";
 import type { ToolRenderKind } from "./FunctionCallRender";
 import type { UploadRequestFn } from "./XAdkSender";
 export interface ToolKindResolveContext {
@@ -20,6 +20,11 @@ export interface ChatStrategies {
      * 将模型文本拆分为过程节点和最终答案。
      */
     parseProcessMessage?: (text: string, options?: ParseAgentMessageOptions) => ParsedPart[];
+    /**
+     * Markdown 资源链接协议白名单，如 skill://、plugin://。
+     * 业务预设可在这里追加私有协议，例如 xgroup-adk 的 kb://。
+     */
+    markdownResourceLinkSchemes?: readonly string[];
     /**
      * 自定义 approval 场景渲染，返回 null 则使用默认渲染。
      */
@@ -32,6 +37,8 @@ export interface ChatStrategies {
 export interface ChatPreset {
     name: string;
     strategies?: ChatStrategies;
+    /** 当前协议预设提供的默认 Markdown/XML 标签扩展。 */
+    markdownExtensions?: readonly MarkdownExtension[];
     /**
      * 基于当前协议预设创建默认文件上传函数。
      * 用户显式传入 config.uploadRequest 时优先使用用户配置。
@@ -42,4 +49,6 @@ export interface ChatPreset {
         appNo?: string;
     }) => UploadRequestFn | undefined;
 }
-export type ChatPresetInput = "base" | "xgroup-adk" | ChatPreset;
+/** SDK 为兼容现有接入提供的内建预设名称。自定义预设建议直接传 ChatPreset 对象。 */
+export type BuiltinChatPresetName = "base" | "xgroup-adk";
+export type ChatPresetInput = BuiltinChatPresetName | ChatPreset;

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

@@ -1,7 +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"],
+  "sourcesContent": ["import type React from \"react\";\nimport type { ParseAgentMessageOptions, ParsedPart } from \"@/utils\";\nimport type {\n  IMessage,\n  FunctionCall,\n  FunctionResponse,\n  MarkdownExtension,\n} 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   * Markdown 资源链接协议白名单，如 skill://、plugin://。\n   * 业务预设可在这里追加私有协议，例如 xgroup-adk 的 kb://。\n   */\n  markdownResourceLinkSchemes?: readonly string[];\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  /** 当前协议预设提供的默认 Markdown/XML 标签扩展。 */\n  markdownExtensions?: readonly MarkdownExtension[];\n  /**\n   * 基于当前协议预设创建默认文件上传函数。\n   * 用户显式传入 config.uploadRequest 时优先使用用户配置。\n   */\n  createUploadRequest?: (context: {\n    url: string;\n    token?: string;\n    appNo?: string;\n  }) => UploadRequestFn | undefined;\n}\n\n/** SDK 为兼容现有接入提供的内建预设名称。自定义预设建议直接传 ChatPreset 对象。 */\nexport type BuiltinChatPresetName = \"base\" | \"xgroup-adk\";\n\nexport type ChatPresetInput = BuiltinChatPresetName | ChatPreset;\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -27,9 +27,12 @@ export type ImageDisplayMode = "thumbnail" | "preview" | "full";
 export type MediaDisplayMode = "inline" | "card";
 /** 文件卡片类型：不传则自动推断（图片/音频/视频用原生渲染），传 'file' 强制附件卡片展示 */
 export type FileCardType = "file" | "image" | "audio" | "video";
+/** 文件卡片尺寸：default 适合消息区，small 适合输入框上下文区 */
+export type FileGallerySize = "default" | "small";
 export interface FileGalleryProps {
     file: FileItem;
     align?: "left" | "right";
+    size?: FileGallerySize;
     removable?: boolean;
     onRemove?: (id: string) => void;
     className?: string;

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

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

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

@@ -0,0 +1,30 @@
+/// <reference types="react" />
+export type SemanticType = 'root' | 'title' | 'content';
+export interface SourcesItem {
+    key?: React.Key;
+    title: React.ReactNode;
+    url?: string;
+    icon?: React.ReactNode;
+    description?: React.ReactNode;
+}
+export interface SourcesProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'onClick'> {
+    prefixCls?: string;
+    style?: React.CSSProperties;
+    styles?: Partial<Record<SemanticType, React.CSSProperties>>;
+    className?: string;
+    classNames?: Partial<Record<SemanticType, string>>;
+    rootClassName?: string;
+    inline?: boolean;
+    items?: Array<SourcesItem>;
+    title?: React.ReactNode;
+    expandIconPosition?: 'start' | 'end';
+    onClick?: (item: SourcesItem) => void;
+    popoverOverlayWidth?: number | string;
+    activeKey?: React.Key;
+    expanded?: boolean;
+    onExpand?: (expand: boolean) => void;
+    defaultExpanded?: boolean;
+}
+export type SourcesRef = {
+    nativeElement: HTMLElement;
+};

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/types/Sources.ts"],
+  "sourcesContent": ["export type SemanticType = 'root' | 'title' | 'content';\n\nexport interface SourcesItem {\n  key?: React.Key;\n  title: React.ReactNode;\n  url?: string;\n  icon?: React.ReactNode;\n  description?: React.ReactNode;\n}\n\nexport interface SourcesProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'onClick'> {\n  prefixCls?: string;\n  style?: React.CSSProperties;\n  styles?: Partial<Record<SemanticType, React.CSSProperties>>;\n  className?: string;\n  classNames?: Partial<Record<SemanticType, string>>;\n  rootClassName?: string;\n  inline?: boolean;\n  items?: Array<SourcesItem>;\n  title?: React.ReactNode;\n  expandIconPosition?: 'start' | 'end';\n  onClick?: (item: SourcesItem) => void;\n  popoverOverlayWidth?: number | string;\n  activeKey?: React.Key;\n  expanded?: boolean;\n  onExpand?: (expand: boolean) => void;\n  defaultExpanded?: boolean;\n}\n\nexport type SourcesRef = {\n  nativeElement: HTMLElement;\n};"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

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

@@ -229,6 +229,17 @@ export type ActionExtraProps = (data: {
     message: ChatGroup;
     isLastBotMsg: boolean;
 }) => ReactNode;
+export interface MarkdownResourceLink {
+    /** 完整链接，如 skill://InnerSkill01 */
+    href: string;
+    /** Markdown 链接文字，如 @skill-creator */
+    label: string;
+    /** 协议类型，如 skill/plugin/knowledge */
+    type: string;
+    /** 协议值，如 InnerSkill01 */
+    value: string;
+}
+export type RenderMarkdownResourceLink = (link: MarkdownResourceLink) => ReactNode | null;
 /**
  * 自定义工具调用渲染函数
  * - 返回 ReactNode：使用自定义渲染
@@ -241,6 +252,22 @@ export type ActionExtraProps = (data: {
  * }}
  */
 export type RenderFunctionCall = (msg: IMessage) => ReactNode | null;
+/** Markdown 自定义标签经过安全过滤后的结构化节点。 */
+export interface MarkdownExtensionNode {
+    tagName: string;
+    attributes: Readonly<Record<string, string>>;
+    text: string;
+    children: ReactNode;
+}
+/**
+ * Markdown 自定义标签扩展。
+ * 标签及属性只有显式注册后才会交给渲染函数，业务协议无需进入 SDK 核心。
+ */
+export interface MarkdownExtension {
+    tagName: string;
+    allowedAttributes?: readonly string[];
+    render: (node: MarkdownExtensionNode) => ReactNode | null;
+}
 export interface XAdkChatbotProps extends Partial<XAdkSenderProps> {
     /**
      * 自定义工具调用渲染函数
@@ -349,6 +376,12 @@ export interface XAdkChatbotProps extends Partial<XAdkSenderProps> {
     stream?: boolean;
     /** 点击对话中附件卡片的回调（非图片、非音视频文件） */
     onFileClick?: (file: FileItem) => void;
+    /** 点击 Markdown 资源链接标签的回调，如 [@skill](skill://xxx) */
+    onResourceLinkClick?: (link: MarkdownResourceLink) => void;
+    /** 自定义 Markdown 资源链接渲染，返回 null 则降级使用默认标签样式 */
+    renderResourceLink?: RenderMarkdownResourceLink;
+    /** Markdown/XML 自定义标签扩展 */
+    markdownExtensions?: readonly MarkdownExtension[];
     /** 消息列表为空时展示的自定义空状态组件 */
     empty?: ReactNode | (() => ReactNode);
 }

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAdkChatbot.ts"],
-  "sourcesContent": ["import type { CSSProperties, JSX, ReactNode } 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 * XAdkChatbot 命令式 API\n */\nexport interface XAdkChatbotHandle {\n  /** 手动滚动到底部 */\n  scrollToBottom: (behavior?: ScrollBehavior) => void;\n}\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 UsageMetadata {\n  candidatesTokenCount?: number;\n  promptTokenCount?: number;\n  totalTokenCount?: number;\n  [key: string]: any;\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  modelCode?: string;\n  invocationId?: string;\n  actions?: EventActions;\n  longRunningToolIds?: string[];\n  branch?: string;\n  timestamp?: number;\n  finishReason?: string;\n  usageMetadata?: UsageMetadata;\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  /** 模型编码，通常来自 stream 事件或历史消息 */\n  modelCode?: string;\n  /** 事件级 token 使用量等模型调用元数据 */\n  usageMetadata?: UsageMetadata;\n  /** 结束原因，通常来自最后一条 stream 事件 */\n  finishReason?: string;\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 type ActionExtraProps = (data: {\n  message: ChatGroup;\n  isLastBotMsg: boolean;\n}) => ReactNode;\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) => 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?: CSSProperties;\n  // 加载状态\n  loading?: boolean;\n  /** 消息列表 */\n  messages: IMessage[];\n  /** 开场白 */\n  prologue?: string;\n  /** 建议回复 */\n  suggestions?: string[];\n  /** 欢迎页面 */\n  welcome?: ReactNode;\n  /** 显示函数调用详情 */\n  showFnCallDetail?: boolean;\n  /**\n   * 数据是否就绪，就绪后触发首次自动滚底。默认 true。\n   * 仅在需要等待异步加载历史消息的场景（如 XAdkProvider 内）才需设为 false，\n   * 待数据加载完成后再切换为 true；独立使用时无需关心此属性。\n   */\n  initialized?: boolean;\n  /**\n   * 当前会话 ID，切换时自动重置滚动状态并置底。\n   * 不传则退化为仅依赖 initialized 的单次置底行为。\n   */\n  sessionId?: string;\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  /** 追加在消息功能区之后的内容，适合展示 token 消耗等业务扩展信息 */\n  actionsExtra?: ActionExtraProps;\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  /** 消息列表为空时展示的自定义空状态组件 */\n  empty?: ReactNode | (() => ReactNode);\n}\n"],
+  "sourcesContent": ["import type { CSSProperties, JSX, ReactNode } 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 * XAdkChatbot 命令式 API\n */\nexport interface XAdkChatbotHandle {\n  /** 手动滚动到底部 */\n  scrollToBottom: (behavior?: ScrollBehavior) => void;\n}\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 UsageMetadata {\n  candidatesTokenCount?: number;\n  promptTokenCount?: number;\n  totalTokenCount?: number;\n  [key: string]: any;\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  modelCode?: string;\n  invocationId?: string;\n  actions?: EventActions;\n  longRunningToolIds?: string[];\n  branch?: string;\n  timestamp?: number;\n  finishReason?: string;\n  usageMetadata?: UsageMetadata;\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  /** 模型编码，通常来自 stream 事件或历史消息 */\n  modelCode?: string;\n  /** 事件级 token 使用量等模型调用元数据 */\n  usageMetadata?: UsageMetadata;\n  /** 结束原因，通常来自最后一条 stream 事件 */\n  finishReason?: string;\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 type ActionExtraProps = (data: {\n  message: ChatGroup;\n  isLastBotMsg: boolean;\n}) => ReactNode;\n\nexport interface MarkdownResourceLink {\n  /** 完整链接，如 skill://InnerSkill01 */\n  href: string;\n  /** Markdown 链接文字，如 @skill-creator */\n  label: string;\n  /** 协议类型，如 skill/plugin/knowledge */\n  type: string;\n  /** 协议值，如 InnerSkill01 */\n  value: string;\n}\n\nexport type RenderMarkdownResourceLink = (\n  link: MarkdownResourceLink,\n) => ReactNode | 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) => ReactNode | null;\n\n/** Markdown 自定义标签经过安全过滤后的结构化节点。 */\nexport interface MarkdownExtensionNode {\n  tagName: string;\n  attributes: Readonly<Record<string, string>>;\n  text: string;\n  children: ReactNode;\n}\n\n/**\n * Markdown 自定义标签扩展。\n * 标签及属性只有显式注册后才会交给渲染函数，业务协议无需进入 SDK 核心。\n */\nexport interface MarkdownExtension {\n  tagName: string;\n  allowedAttributes?: readonly string[];\n  render: (node: MarkdownExtensionNode) => ReactNode | null;\n}\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?: CSSProperties;\n  // 加载状态\n  loading?: boolean;\n  /** 消息列表 */\n  messages: IMessage[];\n  /** 开场白 */\n  prologue?: string;\n  /** 建议回复 */\n  suggestions?: string[];\n  /** 欢迎页面 */\n  welcome?: ReactNode;\n  /** 显示函数调用详情 */\n  showFnCallDetail?: boolean;\n  /**\n   * 数据是否就绪，就绪后触发首次自动滚底。默认 true。\n   * 仅在需要等待异步加载历史消息的场景（如 XAdkProvider 内）才需设为 false，\n   * 待数据加载完成后再切换为 true；独立使用时无需关心此属性。\n   */\n  initialized?: boolean;\n  /**\n   * 当前会话 ID，切换时自动重置滚动状态并置底。\n   * 不传则退化为仅依赖 initialized 的单次置底行为。\n   */\n  sessionId?: string;\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  /** 追加在消息功能区之后的内容，适合展示 token 消耗等业务扩展信息 */\n  actionsExtra?: ActionExtraProps;\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  /** 点击 Markdown 资源链接标签的回调，如 [@skill](skill://xxx) */\n  onResourceLinkClick?: (link: MarkdownResourceLink) => void;\n\n  /** 自定义 Markdown 资源链接渲染，返回 null 则降级使用默认标签样式 */\n  renderResourceLink?: RenderMarkdownResourceLink;\n\n  /** Markdown/XML 自定义标签扩展 */\n  markdownExtensions?: readonly MarkdownExtension[];\n\n  /** 消息列表为空时展示的自定义空状态组件 */\n  empty?: ReactNode | (() => ReactNode);\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }