npm - @ai-group/chat-sdk - Versions diffs - 3.7.1-alpha2 → 3.7.1-alpha4 - Mend

@ai-group/chat-sdk 3.7.1-alpha2 → 3.7.1-alpha4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (84) hide show

package/dist/esm/index.js CHANGED Viewed

@@ -9,6 +9,7 @@ import XAiConversations from "./components/XAiConversations";
 import XAdkThoughtChain from "./components/XAdkThoughtChain";
 import useXAiSDK from "./hooks/useXAiSDK";
 import request from "./utils/request";
+import { formatMarkdownResourceLinksAsText, parseMarkdownResourceHref, replaceMarkdownResourceLinks } from "./utils/markdownResource";
 // 新的 Compound Components 架构
 import XAdkProvider from "./components/XAdkProvider";
@@ -27,7 +28,7 @@ export * from "./types";
 export { useXAi, XAiProvider, XAiChatbot, XAiSDK, XAiSender, XAiConversations, useXAiSDK, request };
 // 新 API - 推荐使用
-export { XAdkProvider, XAdkChatbot, XAdkSender, FileGallery, XAdkThoughtChain, useADKChat, baseChatStrategies, basePreset, baseToolKindResolver, createXGroupUploadRequest, mergeChatStrategies, resolvePresetUploadRequest, resolveChatPreset, xGroupAdkPreset, xGroupToolKindResolver };
+export { XAdkProvider, XAdkChatbot, XAdkSender, FileGallery, XAdkThoughtChain, useADKChat, formatMarkdownResourceLinksAsText, parseMarkdownResourceHref, replaceMarkdownResourceLinks, baseChatStrategies, basePreset, baseToolKindResolver, createXGroupUploadRequest, mergeChatStrategies, resolvePresetUploadRequest, resolveChatPreset, xGroupAdkPreset, xGroupToolKindResolver };
 // Sources 来源引用组件
 import Sources from "./components/Sources";

package/dist/esm/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"names":["useXAi","XAiProvider","XAiChatbot","XAiSDK","XAiSender","FileGallery","XAiConversations","XAdkThoughtChain","useXAiSDK","request","XAdkProvider","XAdkChatbot","XAdkSender","useADKChat","baseChatStrategies","basePreset","baseToolKindResolver","mergeChatStrategies","resolvePresetUploadRequest","resolveChatPreset","createXGroupUploadRequest","xGroupAdkPreset","xGroupToolKindResolver","useChatState","useChatActions","useSession","Sources","FolderTree","default","MarkdownRender","FunctionCallRender","ThinkRender","tokens","tokenDefaults","token","cssVarStyle","useAdkConversation","createXGroupOpenApiTransport"],"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;AACA,SAASA,MAAM;AACf,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,MAAM;AACb,OAAOC,SAAS;AAChB,OAAOC,WAAW;AAClB,OAAOC,gBAAgB;AACvB,OAAOC,gBAAgB;AACvB,OAAOC,SAAS;AAChB,OAAOC,OAAO;;~~AAEd~~;AACA,OAAOC,YAAY;AACnB,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,UAAU;AACjB,SACEC,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBC,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBC,yBAAyB,EACzBC,eAAe,EACfC,sBAAsB;;AAGxB;AACA,SACEC,YAAY,EACZC,cAAc,EACdC,UAAU;AAGZ;;AAEA;;AAGA;AACA,~~SACEzB~~,MAAM,EACNC,WAAW,EACXC,UAAU,EACVC,MAAM,EACNC,SAAS,EACTE,gBAAgB,EAChBE,SAAS,EACTC,OAAO;;AAGT;AACA,~~SACEC~~,YAAY,EACZC,WAAW,EACXC,UAAU,~~EACVP~~,WAAW,EACXE,gBAAgB,~~EAChBM~~,UAAU,~~EACVC~~,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBI,yBAAyB,EACzBH,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBE,eAAe,EACfC,sBAAsB;;AAGxB;AACA,OAAOI,OAAO;AACd,SAASA,OAAO;AAGhB;AACA,OAAOC,UAAU;AACjB,SAASA,UAAU;AAQnB;AACA,SAASC,OAAO,IAAIC,cAAc;AAClC,SAASD,OAAO,IAAIE,kBAAkB;AACtC,SAASF,OAAO,IAAIG,WAAW;;AAE/B;;AASA;AACA,SAASC,MAAM,EAAEC,aAAa,EAAEC,KAAK,EAAEC,WAAW;;AAElD;AACA;AACA,SAASP,OAAO,IAAIQ,kBAAkB;AAEtC,SAASC,4BAA4B"}
1	+ {"version":3,"names":["useXAi","XAiProvider","XAiChatbot","XAiSDK","XAiSender","FileGallery","XAiConversations","XAdkThoughtChain","useXAiSDK","request","formatMarkdownResourceLinksAsText","parseMarkdownResourceHref","replaceMarkdownResourceLinks","XAdkProvider","XAdkChatbot","XAdkSender","useADKChat","baseChatStrategies","basePreset","baseToolKindResolver","mergeChatStrategies","resolvePresetUploadRequest","resolveChatPreset","createXGroupUploadRequest","xGroupAdkPreset","xGroupToolKindResolver","useChatState","useChatActions","useSession","Sources","FolderTree","default","MarkdownRender","FunctionCallRender","ThinkRender","tokens","tokenDefaults","token","cssVarStyle","useAdkConversation","createXGroupOpenApiTransport"],"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\";\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;AACA,SAASA,MAAM;AACf,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,MAAM;AACb,OAAOC,SAAS;AAChB,OAAOC,WAAW;AAClB,OAAOC,gBAAgB;AACvB,OAAOC,gBAAgB;AACvB,OAAOC,SAAS;AAChB,OAAOC,OAAO;AACd,SACEC,iCAAiC,EACjCC,yBAAyB,EACzBC,4BAA4B;;AAG9B;AACA,OAAOC,YAAY;AACnB,OAAOC,WAAW;AAClB,OAAOC,UAAU;AACjB,OAAOC,UAAU;AACjB,SACEC,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBC,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBC,yBAAyB,EACzBC,eAAe,EACfC,sBAAsB;;AAGxB;AACA,SACEC,YAAY,EACZC,cAAc,EACdC,UAAU;AAGZ;;AAEA;;AAGA;AACA,SACE5B,MAAM,EACNC,WAAW,EACXC,UAAU,EACVC,MAAM,EACNC,SAAS,EACTE,gBAAgB,EAChBE,SAAS,EACTC,OAAO;;AAGT;AACA,SACEI,YAAY,EACZC,WAAW,EACXC,UAAU,EACVV,WAAW,EACXE,gBAAgB,EAChBS,UAAU,EACVN,iCAAiC,EACjCC,yBAAyB,EACzBC,4BAA4B,EAC5BK,kBAAkB,EAClBC,UAAU,EACVC,oBAAoB,EACpBI,yBAAyB,EACzBH,mBAAmB,EACnBC,0BAA0B,EAC1BC,iBAAiB,EACjBE,eAAe,EACfC,sBAAsB;;AAGxB;AACA,OAAOI,OAAO;AACd,SAASA,OAAO;AAGhB;AACA,OAAOC,UAAU;AACjB,SAASA,UAAU;AAQnB;AACA,SAASC,OAAO,IAAIC,cAAc;AAClC,SAASD,OAAO,IAAIE,kBAAkB;AACtC,SAASF,OAAO,IAAIG,WAAW;;AAE/B;;AASA;AACA,SAASC,MAAM,EAAEC,aAAa,EAAEC,KAAK,EAAEC,WAAW;;AAElD;AACA;AACA,SAASP,OAAO,IAAIQ,kBAAkB;AAEtC,SAASC,4BAA4B"}

package/dist/esm/types/FileGallery.d.ts CHANGED Viewed

@@ -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/esm/types/FileGallery.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"names":[],"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"],"mappings":""}
1	+ {"version":3,"names":[],"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\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":""}

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

@@ -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/esm/types/XAdkChatbot.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"names":[],"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"],"mappings":""}
1	+ {"version":3,"names":[],"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\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":""}

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

@@ -13,6 +13,10 @@ export interface QuickListOption {
 export interface QuickKeyConfig {
     /** 触发字符，如 '@', '#', '$' */
     key: string;
+    /** 选中后写入 MentionTag.type 的语义类型，不传时回退为 key */
+    mentionType?: string;
+    /** @deprecated 请使用 mentionType。 */
+    tagType?: string;
     /** 列表标题 */
     title?: string;
     /** 列表数据 */
@@ -22,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;
 }
@@ -45,24 +59,38 @@ 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;
 }
-export interface XAdkSenderSubmitData {
+/** @deprecated 请使用 XAdkSenderFormatMentionContext。 */
+export type XAdkSenderFormatTagContext = XAdkSenderFormatMentionContext;
+export interface XAdkSenderSubmitData<TPayload = unknown> {
     /** 根据 submitFormat 生成的最终内容，默认是纯文本 */
     text: string;
     /** 去掉标签后的用户原始输入文本 */
     rawText: string;
     /** 当前提交格式 */
     format: XAdkSenderSubmitFormat;
-    /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */
+    /** 文本与 Mention 的有序片段，inlineTags 模式下可还原资源引用在输入框中的位置 */
     parts: XAdkSenderSubmitPart[];
     files: ServerFile[];
-    tags?: InputTag[];
+    /** 当前 Mention 列表 */
+    mentions?: MentionTag[];
+    /** @deprecated 请使用 mentions。 */
+    tags?: MentionTag[];
+    /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */
+    payload?: TPayload;
 }
 export interface UploadFileResult {
     fileName?: string;
@@ -161,7 +189,7 @@ export interface SenderUIProps {
     }) => React.ReactNode;
     /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */
     suffix?: React.ReactNode | false | SlotRenderFunction;
-    /** 头部面板 */
+    /** 输入主体内部的头部内容 */
     header?: React.ReactNode | false | SlotRenderFunction;
     /** 前缀内容 */
     prefix?: React.ReactNode | false | SlotRenderFunction;
@@ -171,30 +199,53 @@ 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 数据中。
+     */
+    transformSubmitData?: (data: Omit<XAdkSenderSubmitData, "payload">) => unknown;
 }
 export type XAdkSenderProps = SenderUIProps & UploaderCoreProps;
 export interface XAdkSenderHandle {
     addFiles: (files: File[]) => void;
+    /** 向当前光标位置插入一个内联 Mention；未启用 inlineTags 时会退化为追加 Mention。 */
+    insertMention: (mention: MentionTag) => void;
+    /** @deprecated 请使用 insertMention。 */
+    insertTag: (mention: MentionTag) => void;
+    /** 聚焦输入区 */
+    focus: () => void;
 }
 export {};

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

	@@ -1 +1 @@
1	- {"version":3,"names":[],"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 /* 列表标题 /\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 {\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}\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\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n addFiles: (files: File[]) => void;\n}\n"],"mappings":""}
1	+ {"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"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":""}

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

@@ -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/esm/utils/index.js CHANGED Viewed

@@ -23,4 +23,5 @@ export function cleanProcessText(text) {
 // 导出新的解析工具
 export * from "./parseAgentMessage";
+export * from "./markdownResource";
 //# sourceMappingURL=index.js.map

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

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

package/dist/esm/utils/markdownResource.d.ts ADDED Viewed

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

package/dist/esm/utils/markdownResource.js ADDED Viewed

@@ -0,0 +1,33 @@
+export var MARKDOWN_RESOURCE_LINK_SCHEMES = ["skill", "plugin", "tool", "knowledge", "kb", "agent", "model"];
+var RESOURCE_LINK_SCHEME_SET = new Set(MARKDOWN_RESOURCE_LINK_SCHEMES);
+var RESOURCE_LINK_REGEX = /\[([^\]\n]+)\]\(((?:skill|plugin|tool|knowledge|kb|agent|model):\/{2,3}[^)\s]+)\)/gi;
+var stripTriggerPrefix = function stripTriggerPrefix(label) {
+  return label.replace(/^[@/#$]+/, "");
+};
+export var parseMarkdownResourceHref = function parseMarkdownResourceHref(href) {
+  var label = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "";
+  var match = href.match(/^([a-z][a-z0-9+.-]*):\/{2,3}(.+)$/i);
+  if (!match) return null;
+  var type = match[1].toLowerCase();
+  if (!RESOURCE_LINK_SCHEME_SET.has(type)) return null;
+  return {
+    href: href,
+    label: label || href,
+    type: type,
+    value: decodeURIComponent(match[2])
+  };
+};
+export var replaceMarkdownResourceLinks = function replaceMarkdownResourceLinks(text, replacer) {
+  if (!text) return "";
+  return text.replace(RESOURCE_LINK_REGEX, function (source, label, href) {
+    var link = parseMarkdownResourceHref(href, label);
+    return link ? replacer(link) : source;
+  });
+};
+export var formatMarkdownResourceLinksAsText = function formatMarkdownResourceLinksAsText(text, options) {
+  return replaceMarkdownResourceLinks(text, function (link) {
+    var label = link.label || link.value;
+    return (options === null || options === void 0 ? void 0 : options.stripTrigger) === false ? label : stripTriggerPrefix(label);
+  });
+};
+//# sourceMappingURL=markdownResource.js.map

package/dist/esm/utils/markdownResource.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"names":["MARKDOWN_RESOURCE_LINK_SCHEMES","RESOURCE_LINK_SCHEME_SET","Set","RESOURCE_LINK_REGEX","stripTriggerPrefix","label","replace","parseMarkdownResourceHref","href","arguments","length","undefined","match","type","toLowerCase","has","value","decodeURIComponent","replaceMarkdownResourceLinks","text","replacer","source","link","formatMarkdownResourceLinksAsText","options","stripTrigger"],"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 \"kb\",\n \"agent\",\n \"model\",\n] as const;\n\nconst RESOURCE_LINK_SCHEME_SET = new Set<string>(MARKDOWN_RESOURCE_LINK_SCHEMES);\nconst RESOURCE_LINK_REGEX =\n /\\[([^\\]\\n]+)\\]\$((?:skill|plugin|tool|knowledge|kb|agent|model):\\/{2,3}[^)\\s]+)\$/gi;\n\nconst stripTriggerPrefix = (label: string) => label.replace(/^[@/#$]+/, \"\");\n\nexport const parseMarkdownResourceHref = (\n href: string,\n label = \"\",\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 (!RESOURCE_LINK_SCHEME_SET.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) => {\n if (!text) return \"\";\n return text.replace(RESOURCE_LINK_REGEX, (source, label: string, href: string) => {\n const link = parseMarkdownResourceHref(href, label);\n return link ? replacer(link) : source;\n });\n};\n\nexport const formatMarkdownResourceLinksAsText = (\n text: string,\n options?: { stripTrigger?: boolean },\n) =>\n replaceMarkdownResourceLinks(text, (link) => {\n const label = link.label || link.value;\n return options?.stripTrigger === false ? label : stripTriggerPrefix(label);\n });\n"],"mappings":"AAEA,OAAO,IAAMA,8BAA8B,GAAG,CAC5C,OAAO,EACP,QAAQ,EACR,MAAM,EACN,WAAW,EACX,IAAI,EACJ,OAAO,EACP,OAAO,CACC;AAEV,IAAMC,wBAAwB,GAAG,IAAIC,GAAG,CAASF,8BAA8B,CAAC;AAChF,IAAMG,mBAAmB,GACvB,qFAAqF;AAEvF,IAAMC,kBAAkB,GAAG,SAArBA,kBAAkBA,CAAIC,KAAa;EAAA,OAAKA,KAAK,CAACC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;AAAA;AAE3E,OAAO,IAAMC,yBAAyB,GAAG,SAA5BA,yBAAyBA,CACpCC,IAAY,EAEoB;EAAA,IADhCH,KAAK,GAAAI,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,EAAE;EAEV,IAAMG,KAAK,GAAGJ,IAAI,CAACI,KAAK,CAAC,oCAAoC,CAAC;EAC9D,IAAI,CAACA,KAAK,EAAE,OAAO,IAAI;EAEvB,IAAMC,IAAI,GAAGD,KAAK,CAAC,CAAC,CAAC,CAACE,WAAW,CAAC,CAAC;EACnC,IAAI,CAACb,wBAAwB,CAACc,GAAG,CAACF,IAAI,CAAC,EAAE,OAAO,IAAI;EAEpD,OAAO;IACLL,IAAI,EAAJA,IAAI;IACJH,KAAK,EAAEA,KAAK,IAAIG,IAAI;IACpBK,IAAI,EAAJA,IAAI;IACJG,KAAK,EAAEC,kBAAkB,CAACL,KAAK,CAAC,CAAC,CAAC;EACpC,CAAC;AACH,CAAC;AAED,OAAO,IAAMM,4BAA4B,GAAG,SAA/BA,4BAA4BA,CACvCC,IAAY,EACZC,QAAgD,EAC7C;EACH,IAAI,CAACD,IAAI,EAAE,OAAO,EAAE;EACpB,OAAOA,IAAI,CAACb,OAAO,CAACH,mBAAmB,EAAE,UAACkB,MAAM,EAAEhB,KAAa,EAAEG,IAAY,EAAK;IAChF,IAAMc,IAAI,GAAGf,yBAAyB,CAACC,IAAI,EAAEH,KAAK,CAAC;IACnD,OAAOiB,IAAI,GAAGF,QAAQ,CAACE,IAAI,CAAC,GAAGD,MAAM;EACvC,CAAC,CAAC;AACJ,CAAC;AAED,OAAO,IAAME,iCAAiC,GAAG,SAApCA,iCAAiCA,CAC5CJ,IAAY,EACZK,OAAoC;EAAA,OAEpCN,4BAA4B,CAACC,IAAI,EAAE,UAACG,IAAI,EAAK;IAC3C,IAAMjB,KAAK,GAAGiB,IAAI,CAACjB,KAAK,IAAIiB,IAAI,CAACN,KAAK;IACtC,OAAO,CAAAQ,OAAO,aAAPA,OAAO,uBAAPA,OAAO,CAAEC,YAAY,MAAK,KAAK,GAAGpB,KAAK,GAAGD,kBAAkB,CAACC,KAAK,CAAC;EAC5E,CAAC,CAAC;AAAA"}