@ai-group/chat-sdk 3.7.1-alpha3 → 3.7.1-alpha5

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\";\nimport {\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  createXGroupUploadRequest,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n} from \"./presets/xgroup\";\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// Sources 来源引用组件\nimport Sources from \"./components/Sources\";\nexport { Sources };\nexport type { SourcesProps, SourcesItem, SourcesRef } from \"./types/Sources\";\n\n// FolderTree 文件树组件\nimport FolderTree from \"./components/FolderTree\";\nexport { FolderTree };\nexport type {\n  FolderTreeProps,\n  FolderTreeData,\n  FileContentService,\n  FolderTreeRef,\n} from \"./components/FolderTree\";\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  ThoughtChainStatus,\n} from \"./types/XAdkThoughtChain\";\n\n// 设计令牌导出 - 供引用方覆盖样式\nexport { tokens, tokenDefaults, token, cssVarStyle } from \"./styles/tokens\";\n\n// Headless ADK data-flow APIs\nexport * from \"./core\";\nexport { default as useAdkConversation } from \"./react/useAdkConversation\";\nexport type { UseAdkConversationResult } from \"./react/useAdkConversation\";\nexport { createXGroupOpenApiTransport } from \"./presets/xgroup\";\nexport type { XGroupOpenApiTransportOptions } from \"./presets/xgroup\";\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wCAAAA;AAAA,EAAA,oCAAAC;AAAA,EAAA;AAAA;AAAA,gCAAAC;AAAA,EAAA;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;AAAA;AAAA,gCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sCAAAC;AAAA,EAAA;AAAA;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,oBAUO;AAGP,qBAIO;AAEP,wBAAc,oBApCd;AAyEA,qBAAoB;AAKpB,wBAAuB;AAUvB,4BAA0C;AAC1C,gCAA8C;AAC9C,yBAAuC;AAYvC,oBAA0D;AAG1D,wBAAc,mBAzGd;AA0GA,gCAA8C;AAE9C,IAAAC,iBAA6C;",
+  "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\";\nimport {\n  formatMarkdownResourceLinksAsText,\n  parseMarkdownResourceHref,\n  replaceMarkdownResourceLinks,\n} from \"./utils/markdownResource\";\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/xgroup\";\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  formatMarkdownResourceLinksAsText,\n  parseMarkdownResourceHref,\n  replaceMarkdownResourceLinks,\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  createXGroupUploadRequest,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n};\n\n// Sources 来源引用组件\nimport Sources from \"./components/Sources\";\nexport { Sources };\nexport type { SourcesProps, SourcesItem, SourcesRef } from \"./types/Sources\";\n\n// FolderTree 文件树组件\nimport FolderTree from \"./components/FolderTree\";\nexport { FolderTree };\nexport type {\n  FolderTreeProps,\n  FolderTreeData,\n  FileContentService,\n  FolderTreeRef,\n} from \"./components/FolderTree\";\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  ThoughtChainStatus,\n} from \"./types/XAdkThoughtChain\";\n\n// 设计令牌导出 - 供引用方覆盖样式\nexport { tokens, tokenDefaults, token, cssVarStyle } from \"./styles/tokens\";\n\n// Headless ADK data-flow APIs\nexport * from \"./core\";\nexport { default as useAdkConversation } from \"./react/useAdkConversation\";\nexport type { UseAdkConversationResult } from \"./react/useAdkConversation\";\nexport { createXGroupOpenApiTransport } from \"./presets/xgroup\";\nexport type { XGroupOpenApiTransportOptions } from \"./presets/xgroup\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wCAAAA;AAAA,EAAA,oCAAAC;AAAA,EAAA;AAAA;AAAA,gCAAAC;AAAA,EAAA;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;AAAA;AAAA;AAAA;AAAA;AAAA,gCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sCAAAC;AAAA,EAAA;AAAA;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;AACpB,8BAIO;AAGP,0BAAyB;AACzB,yBAAwB;AACxB,wBAAuB;AACvB,wBAAuB;AACvB,oBAUO;AAGP,qBAIO;AAEP,wBAAc,oBAzCd;AAiFA,qBAAoB;AAKpB,wBAAuB;AAUvB,4BAA0C;AAC1C,gCAA8C;AAC9C,yBAAuC;AAYvC,oBAA0D;AAG1D,wBAAc,mBAjHd;AAkHA,gCAA8C;AAE9C,IAAAC,iBAA6C;",
   "names": ["FileGallery", "FolderTree", "Sources", "XAdkChatbot", "XAdkProvider", "XAdkSender", "XAdkThoughtChain", "XAiChatbot", "XAiConversations", "XAiProvider", "XAiSDK", "XAiSender", "request", "useADKChat", "useXAiSDK", "import_xgroup"]
 }

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

@@ -34,7 +34,8 @@ var xGroupAdkPreset = {
   strategies: {
     resolveToolKind: import_strategies.xGroupToolKindResolver,
     createFunctionResponse: import_strategies.baseChatStrategies.createFunctionResponse,
-    parseProcessMessage: (text, options) => (0, import_utils.parseAgentMessage)(text, { mode: "comment", ...options })
+    parseProcessMessage: (text, options) => (0, import_utils.parseAgentMessage)(text, { mode: "comment", ...options }),
+    markdownResourceLinkSchemes: import_strategies.xGroupMarkdownResourceLinkSchemes
   },
   createUploadRequest: import_upload.createXGroupUploadRequest
 };

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 {\n  ChatPreset,\n  ChatPresetInput,\n  ChatStrategies,\n  UploadRequestFn,\n} from \"@/types\";\nimport {\n  baseChatStrategies,\n  xGroupMarkdownResourceLinkSchemes,\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    markdownResourceLinkSchemes: xGroupMarkdownResourceLinkSchemes,\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,wBAIO;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,IACzD,6BAA6B;AAAA,EAC/B;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;AA5DlC;AA6DE,UAAO,6BAAkB,MAAM,GAAE,wBAA1B,4BAAgD;AACzD;",
   "names": []
 }

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

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

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

@@ -21,10 +21,22 @@ 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 import_markdownResource = require("../../utils/markdownResource");
+var import_markdownResource2 = require("../../utils/markdownResource");
+var xGroupMarkdownResourceLinkSchemes = [
+  ...import_markdownResource.MARKDOWN_RESOURCE_LINK_SCHEMES,
+  "kb"
+];
+var formatXGroupMarkdownResourceLinksAsText = (text, options) => (0, import_markdownResource2.formatMarkdownResourceLinksAsText)(text, {
+  ...options,
+  schemes: xGroupMarkdownResourceLinkSchemes
+});
 var baseToolKindResolver = () => "default";
 var xGroupToolKindResolver = ({
   name
@@ -42,12 +54,15 @@ var baseChatStrategies = {
     name: fnCall.name,
     response: { confirmed }
   }),
-  parseProcessMessage: import_utils.parseAgentMessage
+  parseProcessMessage: import_utils.parseAgentMessage,
+  markdownResourceLinkSchemes: import_markdownResource.MARKDOWN_RESOURCE_LINK_SCHEMES
 };
 // 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 { parseAgentMessage } from \"@/utils\";\nimport type {\n  ChatStrategies,\n  FunctionCall,\n  FunctionResponse,\n  ToolRenderKind,\n} from \"@/types\";\nimport { MARKDOWN_RESOURCE_LINK_SCHEMES } from \"@/utils/markdownResource\";\nimport { formatMarkdownResourceLinksAsText } from \"@/utils/markdownResource\";\n\nexport const xGroupMarkdownResourceLinkSchemes = [\n  ...MARKDOWN_RESOURCE_LINK_SCHEMES,\n  \"kb\",\n] as const;\n\nexport const formatXGroupMarkdownResourceLinksAsText = (\n  text: string,\n  options?: { stripTrigger?: boolean },\n) =>\n  formatMarkdownResourceLinksAsText(text, {\n    ...options,\n    schemes: xGroupMarkdownResourceLinkSchemes,\n  });\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\"\n    | \"createFunctionResponse\"\n    | \"parseProcessMessage\"\n    | \"markdownResourceLinkSchemes\"\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  markdownResourceLinkSchemes: MARKDOWN_RESOURCE_LINK_SCHEMES,\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AAOlC,8BAA+C;AAC/C,IAAAA,2BAAkD;AAE3C,IAAM,oCAAoC;AAAA,EAC/C,GAAG;AAAA,EACH;AACF;AAEO,IAAM,0CAA0C,CACrD,MACA,gBAEA,4DAAkC,MAAM;AAAA,EACtC,GAAG;AAAA,EACH,SAAS;AACX,CAAC;AAEI,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,qBAQT;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;AAAA,EACrB,6BAA6B;AAC/B;",
+  "names": ["import_markdownResource"]
 }

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

@@ -20,6 +20,11 @@ export interface ChatStrategies {
      * 将模型文本拆分为过程节点和最终答案。
      */
     parseProcessMessage?: (text: string, options?: ParseAgentMessageOptions) => ParsedPart[];
+    /**
+     * Markdown 资源链接协议白名单，如 skill://、plugin://。
+     * 业务预设可在这里追加私有协议，例如 xgroup-adk 的 kb://。
+     */
+    markdownResourceLinkSchemes?: readonly string[];
     /**
      * 自定义 approval 场景渲染，返回 null 则使用默认渲染。
      */

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 { 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   * 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  /**\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/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：使用自定义渲染
@@ -349,6 +360,10 @@ export interface XAdkChatbotProps extends Partial<XAdkSenderProps> {
     stream?: boolean;
     /** 点击对话中附件卡片的回调（非图片、非音视频文件） */
     onFileClick?: (file: FileItem) => void;
+    /** 点击 Markdown 资源链接标签的回调，如 [@skill](skill://xxx) */
+    onResourceLinkClick?: (link: MarkdownResourceLink) => void;
+    /** 自定义 Markdown 资源链接渲染，返回 null 则降级使用默认标签样式 */
+    renderResourceLink?: RenderMarkdownResourceLink;
     /** 消息列表为空时展示的自定义空状态组件 */
     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\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  /** 消息列表为空时展示的自定义空状态组件 */\n  empty?: ReactNode | (() => ReactNode);\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -13,7 +13,9 @@ export interface QuickListOption {
 export interface QuickKeyConfig {
     /** 触发字符，如 '@', '#', '$' */
     key: string;
-    /** 选中后写入 InputTag.type 的语义类型，不传时回退为 key 以兼容旧行为 */
+    /** 选中后写入 MentionTag.type 的语义类型，不传时回退为 key */
+    mentionType?: string;
+    /** @deprecated 请使用 mentionType。 */
     tagType?: string;
     /** 列表标题 */
     title?: string;
@@ -24,21 +26,31 @@ export interface QuickKeyConfig {
     /** 选中回调 */
     onSelect?: (option: QuickListOption) => void;
 }
-/** 输入框内标签 */
-export interface InputTag {
+/** 输入框内的资源引用。SDK 只理解通用 Mention，业务语义可放入 data 或可选语义字段。 */
+export interface MentionTag {
     id: string;
     label: string;
-    /** 标签类型，如 'aggregation', 'skill', 'app' */
+    /** Mention 类型，如 'knowledge', 'skill', 'plugin', 'agent' */
     type: string;
-    /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 label */
+    /** 资源 URI，如 skill://skillNo、kb://kb/knNo/dir/docs/2024 */
+    uri?: string;
+    /** 业务资源 ID，如 skillNo、knowledgeNo */
+    targetId?: string;
+    /** 展示名；不传时回退 label */
+    displayName?: string;
+    /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 uri/targetId/label */
     value?: string;
     /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */
     trigger?: string;
     color?: string;
     icon?: React.ReactNode;
+    /** 业务扩展上下文，例如知识库目录 scope */
+    scope?: any;
     /** 原始数据 */
     data?: any;
 }
+/** @deprecated 请使用 MentionTag。 */
+export type InputTag = MentionTag;
 export interface InlineTagRenderInfo {
     onRemove: () => void;
 }
@@ -47,13 +59,22 @@ export type XAdkSenderSubmitPart = {
     type: "text";
     text: string;
 } | {
+    type: "mention";
+    mention: MentionTag;
+};
+/** @deprecated 旧 tag part，仅用于兼容 defaultInputParts 历史传入。 */
+export type XAdkSenderLegacyTagPart = {
     type: "tag";
-    tag: InputTag;
+    tag: MentionTag;
 };
-export interface XAdkSenderFormatTagContext {
+/** 输入框文本/Mention 有序片段，表示用户正在编辑的输入内容 */
+export type XAdkSenderInputPart = XAdkSenderSubmitPart | XAdkSenderLegacyTagPart;
+export interface XAdkSenderFormatMentionContext {
     format: Exclude<XAdkSenderSubmitFormat, "structured">;
     index: number;
 }
+/** @deprecated 请使用 XAdkSenderFormatMentionContext。 */
+export type XAdkSenderFormatTagContext = XAdkSenderFormatMentionContext;
 export interface XAdkSenderSubmitData<TPayload = unknown> {
     /** 根据 submitFormat 生成的最终内容，默认是纯文本 */
     text: string;
@@ -61,10 +82,13 @@ export interface XAdkSenderSubmitData<TPayload = unknown> {
     rawText: string;
     /** 当前提交格式 */
     format: XAdkSenderSubmitFormat;
-    /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */
+    /** 文本与 Mention 的有序片段，inlineTags 模式下可还原资源引用在输入框中的位置 */
     parts: XAdkSenderSubmitPart[];
     files: ServerFile[];
-    tags?: InputTag[];
+    /** 当前 Mention 列表 */
+    mentions?: MentionTag[];
+    /** @deprecated 请使用 mentions。 */
+    tags?: MentionTag[];
     /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */
     payload?: TPayload;
 }
@@ -175,27 +199,39 @@ export interface SenderUIProps {
     footerLeft?: React.ReactNode | false | SlotRenderFunction;
     /** 快捷键配置列表 */
     quickKeys?: QuickKeyConfig[];
-    /** 是否把标签以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */
+    /** 是否把 Mention 以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */
     inlineTags?: boolean;
-    /** 自定义内联标签渲染 */
-    renderTag?: (tag: InputTag, info: InlineTagRenderInfo) => React.ReactNode;
-    /** 受控：标签列表 */
-    tags?: InputTag[];
-    /** 非受控：默认标签列表 */
-    defaultTags?: InputTag[];
-    /** 标签变化回调 */
-    onTagsChange?: (tags: InputTag[]) => void;
+    /** 自定义内联 Mention 渲染 */
+    renderMention?: (mention: MentionTag, info: InlineTagRenderInfo) => React.ReactNode;
+    /** @deprecated 请使用 renderMention。 */
+    renderTag?: (mention: MentionTag, info: InlineTagRenderInfo) => React.ReactNode;
+    /** 受控：Mention 列表 */
+    mentions?: MentionTag[];
+    /** @deprecated 请使用 mentions。 */
+    tags?: MentionTag[];
+    /** 非受控：默认 Mention 列表 */
+    defaultMentions?: MentionTag[];
+    /** @deprecated 请使用 defaultMentions。 */
+    defaultTags?: MentionTag[];
+    /** 非受控：默认输入内容片段，用于初始化内联 Mention 输入区 */
+    defaultInputParts?: XAdkSenderInputPart[];
+    /** Mention 变化回调 */
+    onMentionsChange?: (mentions: MentionTag[]) => void;
+    /** @deprecated 请使用 onMentionsChange。 */
+    onTagsChange?: (mentions: MentionTag[]) => void;
     /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */
     onQuickKeyTrigger?: (key: string, keyword: string) => void;
     /**
      * 提交内容格式：
-     * - text: 默认，输出文字 + 标签文本（如 /生图技能）
-     * - structured: 保留 parts/tags/files 结构化数据，text 为 rawText
+     * - text: 默认，输出文字 + Mention 文本（如 @生图技能）
+     * - structured: 保留 parts/mentions/files 结构化数据，text 为 rawText
      * - markdown/xml: 输出对应标记文本
      */
     submitFormat?: XAdkSenderSubmitFormat;
-    /** 自定义标签在 text/markdown/xml 格式中的序列化结果 */
-    formatTag?: (tag: InputTag, context: XAdkSenderFormatTagContext) => string;
+    /** 自定义 Mention 在 text/markdown/xml 格式中的序列化结果 */
+    formatMention?: (mention: MentionTag, context: XAdkSenderFormatMentionContext) => string;
+    /** @deprecated 请使用 formatMention。 */
+    formatTag?: (mention: MentionTag, context: XAdkSenderFormatMentionContext) => string;
     /**
      * 基于 SDK 标准提交结构派生业务 payload。
      * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。
@@ -205,8 +241,10 @@ export interface SenderUIProps {
 export type XAdkSenderProps = SenderUIProps & UploaderCoreProps;
 export interface XAdkSenderHandle {
     addFiles: (files: File[]) => void;
-    /** 向当前光标位置插入一个内联标签；未启用 inlineTags 时会退化为追加标签。 */
-    insertTag: (tag: InputTag) => void;
+    /** 向当前光标位置插入一个内联 Mention；未启用 inlineTags 时会退化为追加 Mention。 */
+    insertMention: (mention: MentionTag) => void;
+    /** @deprecated 请使用 insertMention。 */
+    insertTag: (mention: MentionTag) => void;
     /** 聚焦输入区 */
     focus: () => void;
 }

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\n// ===================== 快捷键/标签相关类型 =====================\n\n/** 快捷键触发的列表项 */\nexport interface QuickListOption {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: React.ReactNode;\n  /** 分组名（用于聚合列表，子分组通过下划线分割） */\n  group?: string;\n  [key: string]: any;\n}\n\n/** 快捷键配置 */\nexport interface QuickKeyConfig {\n  /** 触发字符，如 '@', '#', '$' */\n  key: string;\n  /** 选中后写入 InputTag.type 的语义类型，不传时回退为 key 以兼容旧行为 */\n  tagType?: string;\n  /** 列表标题 */\n  title?: string;\n  /** 列表数据 */\n  options: QuickListOption[];\n  /** 自定义列表项渲染 */\n  renderItem?: (option: QuickListOption) => React.ReactNode;\n  /** 选中回调 */\n  onSelect?: (option: QuickListOption) => void;\n}\n\n/** 输入框内标签 */\nexport interface InputTag {\n  id: string;\n  label: string;\n  /** 标签类型，如 'aggregation', 'skill', 'app' */\n  type: string;\n  /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 label */\n  value?: string;\n  /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */\n  trigger?: string;\n  color?: string;\n  icon?: React.ReactNode;\n  /** 原始数据 */\n  data?: any;\n}\n\nexport interface InlineTagRenderInfo {\n  onRemove: () => void;\n}\n\nexport type XAdkSenderSubmitFormat = \"text\" | \"structured\" | \"markdown\" | \"xml\";\n\nexport type XAdkSenderSubmitPart =\n  | { type: \"text\"; text: string }\n  | { type: \"tag\"; tag: InputTag };\n\nexport interface XAdkSenderFormatTagContext {\n  format: Exclude<XAdkSenderSubmitFormat, \"structured\">;\n  index: number;\n}\n\nexport interface XAdkSenderSubmitData<TPayload = unknown> {\n  /** 根据 submitFormat 生成的最终内容，默认是纯文本 */\n  text: string;\n  /** 去掉标签后的用户原始输入文本 */\n  rawText: string;\n  /** 当前提交格式 */\n  format: XAdkSenderSubmitFormat;\n  /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */\n  parts: XAdkSenderSubmitPart[];\n  files: ServerFile[];\n  tags?: InputTag[];\n  /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */\n  payload?: TPayload;\n}\n\n// ===================== 上传相关类型 =====================\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  UploadButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */\n  draggable?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  placeholder?: string;\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: XAdkSenderSubmitData) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 输入主体内部的头部内容 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部左侧拓展区域，不传时 footer 保持原有居中布局 */\n  footerLeft?: React.ReactNode | false | SlotRenderFunction;\n\n  // 快捷键/标签功能\n  /** 快捷键配置列表 */\n  quickKeys?: QuickKeyConfig[];\n  /** 是否把标签以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */\n  inlineTags?: boolean;\n  /** 自定义内联标签渲染 */\n  renderTag?: (\n    tag: InputTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** 受控：标签列表 */\n  tags?: InputTag[];\n  /** 非受控：默认标签列表 */\n  defaultTags?: InputTag[];\n  /** 标签变化回调 */\n  onTagsChange?: (tags: InputTag[]) => void;\n  /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */\n  onQuickKeyTrigger?: (key: string, keyword: string) => void;\n  /**\n   * 提交内容格式：\n   * - text: 默认，输出文字 + 标签文本（如 /生图技能）\n   * - structured: 保留 parts/tags/files 结构化数据，text 为 rawText\n   * - markdown/xml: 输出对应标记文本\n   */\n  submitFormat?: XAdkSenderSubmitFormat;\n  /** 自定义标签在 text/markdown/xml 格式中的序列化结果 */\n  formatTag?: (\n    tag: InputTag,\n    context: XAdkSenderFormatTagContext,\n  ) => string;\n  /**\n   * 基于 SDK 标准提交结构派生业务 payload。\n   * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。\n   */\n  transformSubmitData?: (\n    data: Omit<XAdkSenderSubmitData, \"payload\">,\n  ) => unknown;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n  /** 向当前光标位置插入一个内联标签；未启用 inlineTags 时会退化为追加标签。 */\n  insertTag: (tag: InputTag) => void;\n  /** 聚焦输入区 */\n  focus: () => void;\n}\n"],
+  "sourcesContent": ["// types/XAdkSender.ts\nimport React from \"react\";\n\n// ===================== 快捷键/Mention 相关类型 =====================\n\n/** 快捷键触发的列表项 */\nexport interface QuickListOption {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: React.ReactNode;\n  /** 分组名（用于聚合列表，子分组通过下划线分割） */\n  group?: string;\n  [key: string]: any;\n}\n\n/** 快捷键配置 */\nexport interface QuickKeyConfig {\n  /** 触发字符，如 '@', '#', '$' */\n  key: string;\n  /** 选中后写入 MentionTag.type 的语义类型，不传时回退为 key */\n  mentionType?: string;\n  /** @deprecated 请使用 mentionType。 */\n  tagType?: string;\n  /** 列表标题 */\n  title?: string;\n  /** 列表数据 */\n  options: QuickListOption[];\n  /** 自定义列表项渲染 */\n  renderItem?: (option: QuickListOption) => React.ReactNode;\n  /** 选中回调 */\n  onSelect?: (option: QuickListOption) => void;\n}\n\n/** 输入框内的资源引用。SDK 只理解通用 Mention，业务语义可放入 data 或可选语义字段。 */\nexport interface MentionTag {\n  id: string;\n  label: string;\n  /** Mention 类型，如 'knowledge', 'skill', 'plugin', 'agent' */\n  type: string;\n  /** 资源 URI，如 skill://skillNo、kb://kb/knNo/dir/docs/2024 */\n  uri?: string;\n  /** 业务资源 ID，如 skillNo、knowledgeNo */\n  targetId?: string;\n  /** 展示名；不传时回退 label */\n  displayName?: string;\n  /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 uri/targetId/label */\n  value?: string;\n  /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */\n  trigger?: string;\n  color?: string;\n  icon?: React.ReactNode;\n  /** 业务扩展上下文，例如知识库目录 scope */\n  scope?: any;\n  /** 原始数据 */\n  data?: any;\n}\n\n/** @deprecated 请使用 MentionTag。 */\nexport type InputTag = MentionTag;\n\nexport interface InlineTagRenderInfo {\n  onRemove: () => void;\n}\n\nexport type XAdkSenderSubmitFormat = \"text\" | \"structured\" | \"markdown\" | \"xml\";\n\nexport type XAdkSenderSubmitPart =\n  | { type: \"text\"; text: string }\n  | { type: \"mention\"; mention: MentionTag };\n\n/** @deprecated 旧 tag part，仅用于兼容 defaultInputParts 历史传入。 */\nexport type XAdkSenderLegacyTagPart = { type: \"tag\"; tag: MentionTag };\n\n/** 输入框文本/Mention 有序片段，表示用户正在编辑的输入内容 */\nexport type XAdkSenderInputPart =\n  | XAdkSenderSubmitPart\n  | XAdkSenderLegacyTagPart;\n\nexport interface XAdkSenderFormatMentionContext {\n  format: Exclude<XAdkSenderSubmitFormat, \"structured\">;\n  index: number;\n}\n\n/** @deprecated 请使用 XAdkSenderFormatMentionContext。 */\nexport type XAdkSenderFormatTagContext = XAdkSenderFormatMentionContext;\n\nexport interface XAdkSenderSubmitData<TPayload = unknown> {\n  /** 根据 submitFormat 生成的最终内容，默认是纯文本 */\n  text: string;\n  /** 去掉标签后的用户原始输入文本 */\n  rawText: string;\n  /** 当前提交格式 */\n  format: XAdkSenderSubmitFormat;\n  /** 文本与 Mention 的有序片段，inlineTags 模式下可还原资源引用在输入框中的位置 */\n  parts: XAdkSenderSubmitPart[];\n  files: ServerFile[];\n  /** 当前 Mention 列表 */\n  mentions?: MentionTag[];\n  /** @deprecated 请使用 mentions。 */\n  tags?: MentionTag[];\n  /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */\n  payload?: TPayload;\n}\n\n// ===================== 上传相关类型 =====================\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  UploadButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */\n  draggable?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  placeholder?: string;\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: XAdkSenderSubmitData) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 输入主体内部的头部内容 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部左侧拓展区域，不传时 footer 保持原有居中布局 */\n  footerLeft?: React.ReactNode | false | SlotRenderFunction;\n\n  // 快捷键/Mention 功能\n  /** 快捷键配置列表 */\n  quickKeys?: QuickKeyConfig[];\n  /** 是否把 Mention 以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */\n  inlineTags?: boolean;\n  /** 自定义内联 Mention 渲染 */\n  renderMention?: (\n    mention: MentionTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** @deprecated 请使用 renderMention。 */\n  renderTag?: (\n    mention: MentionTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** 受控：Mention 列表 */\n  mentions?: MentionTag[];\n  /** @deprecated 请使用 mentions。 */\n  tags?: MentionTag[];\n  /** 非受控：默认 Mention 列表 */\n  defaultMentions?: MentionTag[];\n  /** @deprecated 请使用 defaultMentions。 */\n  defaultTags?: MentionTag[];\n  /** 非受控：默认输入内容片段，用于初始化内联 Mention 输入区 */\n  defaultInputParts?: XAdkSenderInputPart[];\n  /** Mention 变化回调 */\n  onMentionsChange?: (mentions: MentionTag[]) => void;\n  /** @deprecated 请使用 onMentionsChange。 */\n  onTagsChange?: (mentions: MentionTag[]) => void;\n  /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */\n  onQuickKeyTrigger?: (key: string, keyword: string) => void;\n  /**\n   * 提交内容格式：\n   * - text: 默认，输出文字 + Mention 文本（如 @生图技能）\n   * - structured: 保留 parts/mentions/files 结构化数据，text 为 rawText\n   * - markdown/xml: 输出对应标记文本\n   */\n  submitFormat?: XAdkSenderSubmitFormat;\n  /** 自定义 Mention 在 text/markdown/xml 格式中的序列化结果 */\n  formatMention?: (\n    mention: MentionTag,\n    context: XAdkSenderFormatMentionContext,\n  ) => string;\n  /** @deprecated 请使用 formatMention。 */\n  formatTag?: (\n    mention: MentionTag,\n    context: XAdkSenderFormatMentionContext,\n  ) => string;\n  /**\n   * 基于 SDK 标准提交结构派生业务 payload。\n   * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。\n   */\n  transformSubmitData?: (\n    data: Omit<XAdkSenderSubmitData, \"payload\">,\n  ) => unknown;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n  /** 向当前光标位置插入一个内联 Mention；未启用 inlineTags 时会退化为追加 Mention。 */\n  insertMention: (mention: MentionTag) => void;\n  /** @deprecated 请使用 insertMention。 */\n  insertTag: (mention: MentionTag) => void;\n  /** 聚焦输入区 */\n  focus: () => void;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

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

package/dist/cjs/utils/index.js

@@ -26,6 +26,7 @@ __export(utils_exports, {
 });
 module.exports = __toCommonJS(utils_exports);
 __reExport(utils_exports, require("./parseAgentMessage"), module.exports);
+__reExport(utils_exports, require("./markdownResource"), module.exports);
 var safeJsonParse = (str, defaultValue = {}) => {
   if (!str)
     return defaultValue;
@@ -54,6 +55,7 @@ function cleanProcessText(text) {
   cleanProcessText,
   safeJsonParse,
   safeJsonStringify,
-  ...require("./parseAgentMessage")
+  ...require("./parseAgentMessage"),
+  ...require("./markdownResource")
 });
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/utils/index.ts"],
-  "sourcesContent": ["export const safeJsonParse = <T = any>(\n  str?: string,\n  defaultValue: any = {},\n): T => {\n  if (!str) return defaultValue as T;\n  try {\n    return JSON.parse(str) || defaultValue;\n  } catch (error) {\n    return defaultValue as T;\n  }\n};\n\nexport const safeJsonStringify = <T = any>(\n  obj?: T,\n  defaultValue: any = {},\n): string => {\n  if (!obj) return defaultValue as string;\n  try {\n    return JSON.stringify(obj) || defaultValue;\n  } catch (error) {\n    return defaultValue as string;\n  }\n};\n\nexport function cleanProcessText(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/\\/\\*(PLANNING|REPLANNING|REASONING|ACTION|FINAL_ANSWER)\\*\\//g, \"\")\n    .trim();\n}\n\n// 导出新的解析工具\nexport * from './parseAgentMessage';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,0BAAc,gCAhCd;AAAO,IAAM,gBAAgB,CAC3B,KACA,eAAoB,CAAC,MACf;AACN,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,MAAM,GAAG,KAAK;AAAA,EAC5B,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,IAAM,oBAAoB,CAC/B,KACA,eAAoB,CAAC,MACV;AACX,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,UAAU,GAAG,KAAK;AAAA,EAChC,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,CAAC;AAAM,WAAO;AAClB,SAAO,KACJ,QAAQ,gEAAgE,EAAE,EAC1E,KAAK;AACV;",
+  "sourcesContent": ["export const safeJsonParse = <T = any>(\n  str?: string,\n  defaultValue: any = {},\n): T => {\n  if (!str) return defaultValue as T;\n  try {\n    return JSON.parse(str) || defaultValue;\n  } catch (error) {\n    return defaultValue as T;\n  }\n};\n\nexport const safeJsonStringify = <T = any>(\n  obj?: T,\n  defaultValue: any = {},\n): string => {\n  if (!obj) return defaultValue as string;\n  try {\n    return JSON.stringify(obj) || defaultValue;\n  } catch (error) {\n    return defaultValue as string;\n  }\n};\n\nexport function cleanProcessText(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/\\/\\*(PLANNING|REPLANNING|REASONING|ACTION|FINAL_ANSWER)\\*\\//g, \"\")\n    .trim();\n}\n\n// 导出新的解析工具\nexport * from './parseAgentMessage';\nexport * from './markdownResource';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,0BAAc,gCAhCd;AAiCA,0BAAc,+BAjCd;AAAO,IAAM,gBAAgB,CAC3B,KACA,eAAoB,CAAC,MACf;AACN,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,MAAM,GAAG,KAAK;AAAA,EAC5B,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,IAAM,oBAAoB,CAC/B,KACA,eAAoB,CAAC,MACV;AACX,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,UAAU,GAAG,KAAK;AAAA,EAChC,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,CAAC;AAAM,WAAO;AAClB,SAAO,KACJ,QAAQ,gEAAgE,EAAE,EAC1E,KAAK;AACV;",
   "names": []
 }

package/dist/cjs/utils/markdownResource.d.ts

@@ -0,0 +1,11 @@
+import type { MarkdownResourceLink } from "../types";
+export declare const MARKDOWN_RESOURCE_LINK_SCHEMES: readonly ["skill", "plugin", "tool", "knowledge", "agent", "model"];
+export type MarkdownResourceLinkScheme = (typeof MARKDOWN_RESOURCE_LINK_SCHEMES)[number] | (string & {});
+export interface MarkdownResourceLinkOptions {
+    schemes?: readonly MarkdownResourceLinkScheme[];
+}
+export declare const parseMarkdownResourceHref: (href: string, label?: string, options?: MarkdownResourceLinkOptions) => MarkdownResourceLink | null;
+export declare const replaceMarkdownResourceLinks: (text: string, replacer: (link: MarkdownResourceLink) => string, options?: MarkdownResourceLinkOptions) => string;
+export declare const formatMarkdownResourceLinksAsText: (text: string, options?: MarkdownResourceLinkOptions & {
+    stripTrigger?: boolean;
+}) => string;

package/dist/cjs/utils/markdownResource.js

@@ -0,0 +1,79 @@
+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/utils/markdownResource.ts
+var markdownResource_exports = {};
+__export(markdownResource_exports, {
+  MARKDOWN_RESOURCE_LINK_SCHEMES: () => MARKDOWN_RESOURCE_LINK_SCHEMES,
+  formatMarkdownResourceLinksAsText: () => formatMarkdownResourceLinksAsText,
+  parseMarkdownResourceHref: () => parseMarkdownResourceHref,
+  replaceMarkdownResourceLinks: () => replaceMarkdownResourceLinks
+});
+module.exports = __toCommonJS(markdownResource_exports);
+var MARKDOWN_RESOURCE_LINK_SCHEMES = [
+  "skill",
+  "plugin",
+  "tool",
+  "knowledge",
+  "agent",
+  "model"
+];
+var getResourceLinkSchemeSet = (options) => new Set((options == null ? void 0 : options.schemes) || MARKDOWN_RESOURCE_LINK_SCHEMES);
+var RESOURCE_LINK_REGEX = /\[([^\]\n]+)\]\(([a-z][a-z0-9+.-]*:\/{2,3}[^)\s]+)\)/gi;
+var stripTriggerPrefix = (label) => label.replace(/^[@/#$]+/, "");
+var parseMarkdownResourceHref = (href, label = "", options) => {
+  const match = href.match(/^([a-z][a-z0-9+.-]*):\/{2,3}(.+)$/i);
+  if (!match)
+    return null;
+  const type = match[1].toLowerCase();
+  if (!getResourceLinkSchemeSet(options).has(type))
+    return null;
+  return {
+    href,
+    label: label || href,
+    type,
+    value: decodeURIComponent(match[2])
+  };
+};
+var replaceMarkdownResourceLinks = (text, replacer, options) => {
+  if (!text)
+    return "";
+  return text.replace(
+    RESOURCE_LINK_REGEX,
+    (source, label, href) => {
+      const link = parseMarkdownResourceHref(href, label, options);
+      return link ? replacer(link) : source;
+    }
+  );
+};
+var formatMarkdownResourceLinksAsText = (text, options) => replaceMarkdownResourceLinks(
+  text,
+  (link) => {
+    const label = link.label || link.value;
+    return (options == null ? void 0 : options.stripTrigger) === false ? label : stripTriggerPrefix(label);
+  },
+  options
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MARKDOWN_RESOURCE_LINK_SCHEMES,
+  formatMarkdownResourceLinksAsText,
+  parseMarkdownResourceHref,
+  replaceMarkdownResourceLinks
+});
+//# sourceMappingURL=markdownResource.js.map

package/dist/cjs/utils/markdownResource.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/markdownResource.ts"],
+  "sourcesContent": ["import type { MarkdownResourceLink } from \"@/types\";\n\nexport const MARKDOWN_RESOURCE_LINK_SCHEMES = [\n  \"skill\",\n  \"plugin\",\n  \"tool\",\n  \"knowledge\",\n  \"agent\",\n  \"model\",\n] as const;\n\nexport type MarkdownResourceLinkScheme =\n  | (typeof MARKDOWN_RESOURCE_LINK_SCHEMES)[number]\n  | (string & {});\n\nexport interface MarkdownResourceLinkOptions {\n  schemes?: readonly MarkdownResourceLinkScheme[];\n}\n\nconst getResourceLinkSchemeSet = (options?: MarkdownResourceLinkOptions) =>\n  new Set<string>(options?.schemes || MARKDOWN_RESOURCE_LINK_SCHEMES);\n\nconst RESOURCE_LINK_REGEX =\n  /\\[([^\\]\\n]+)\\]\\(([a-z][a-z0-9+.-]*:\\/{2,3}[^)\\s]+)\\)/gi;\n\nconst stripTriggerPrefix = (label: string) => label.replace(/^[@/#$]+/, \"\");\n\nexport const parseMarkdownResourceHref = (\n  href: string,\n  label = \"\",\n  options?: MarkdownResourceLinkOptions,\n): MarkdownResourceLink | null => {\n  const match = href.match(/^([a-z][a-z0-9+.-]*):\\/{2,3}(.+)$/i);\n  if (!match) return null;\n\n  const type = match[1].toLowerCase();\n  if (!getResourceLinkSchemeSet(options).has(type)) return null;\n\n  return {\n    href,\n    label: label || href,\n    type,\n    value: decodeURIComponent(match[2]),\n  };\n};\n\nexport const replaceMarkdownResourceLinks = (\n  text: string,\n  replacer: (link: MarkdownResourceLink) => string,\n  options?: MarkdownResourceLinkOptions,\n) => {\n  if (!text) return \"\";\n  return text.replace(\n    RESOURCE_LINK_REGEX,\n    (source, label: string, href: string) => {\n      const link = parseMarkdownResourceHref(href, label, options);\n      return link ? replacer(link) : source;\n    },\n  );\n};\n\nexport const formatMarkdownResourceLinksAsText = (\n  text: string,\n  options?: MarkdownResourceLinkOptions & { stripTrigger?: boolean },\n) =>\n  replaceMarkdownResourceLinks(\n    text,\n    (link) => {\n      const label = link.label || link.value;\n      return options?.stripTrigger === false\n        ? label\n        : stripTriggerPrefix(label);\n    },\n    options,\n  );\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,IAAM,iCAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUA,IAAM,2BAA2B,CAAC,YAChC,IAAI,KAAY,mCAAS,YAAW,8BAA8B;AAEpE,IAAM,sBACJ;AAEF,IAAM,qBAAqB,CAAC,UAAkB,MAAM,QAAQ,YAAY,EAAE;AAEnE,IAAM,4BAA4B,CACvC,MACA,QAAQ,IACR,YACgC;AAChC,QAAM,QAAQ,KAAK,MAAM,oCAAoC;AAC7D,MAAI,CAAC;AAAO,WAAO;AAEnB,QAAM,OAAO,MAAM,CAAC,EAAE,YAAY;AAClC,MAAI,CAAC,yBAAyB,OAAO,EAAE,IAAI,IAAI;AAAG,WAAO;AAEzD,SAAO;AAAA,IACL;AAAA,IACA,OAAO,SAAS;AAAA,IAChB;AAAA,IACA,OAAO,mBAAmB,MAAM,CAAC,CAAC;AAAA,EACpC;AACF;AAEO,IAAM,+BAA+B,CAC1C,MACA,UACA,YACG;AACH,MAAI,CAAC;AAAM,WAAO;AAClB,SAAO,KAAK;AAAA,IACV;AAAA,IACA,CAAC,QAAQ,OAAe,SAAiB;AACvC,YAAM,OAAO,0BAA0B,MAAM,OAAO,OAAO;AAC3D,aAAO,OAAO,SAAS,IAAI,IAAI;AAAA,IACjC;AAAA,EACF;AACF;AAEO,IAAM,oCAAoC,CAC/C,MACA,YAEA;AAAA,EACE;AAAA,EACA,CAAC,SAAS;AACR,UAAM,QAAQ,KAAK,SAAS,KAAK;AACjC,YAAO,mCAAS,kBAAiB,QAC7B,QACA,mBAAmB,KAAK;AAAA,EAC9B;AAAA,EACA;AACF;",
+  "names": []
+}