@ai-group/chat-sdk 3.7.1-alpha7 → 3.7.1-alpha9

package/dist/cjs/index.js

@@ -30,6 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  BUILTIN_CHAT_PRESETS: () => import_presets.BUILTIN_CHAT_PRESETS,
+  DEFAULT_CHAT_PRESET_NAME: () => import_presets.DEFAULT_CHAT_PRESET_NAME,
   FileGallery: () => import_FileGallery.default,
   FolderTree: () => import_FolderTree.default,
   FunctionCallRender: () => import_FunctionCallRender.default,
@@ -45,21 +47,26 @@ __export(src_exports, {
   XAiProvider: () => import_XAiProvider.default,
   XAiSDK: () => import_XAiSDK.default,
   XAiSender: () => import_XAiSender.default,
-  baseChatStrategies: () => import_xgroup.baseChatStrategies,
-  basePreset: () => import_xgroup.basePreset,
-  baseToolKindResolver: () => import_xgroup.baseToolKindResolver,
+  baseChatStrategies: () => import_presets.baseChatStrategies,
+  basePreset: () => import_presets.basePreset,
+  baseToolKindResolver: () => import_presets.baseToolKindResolver,
+  composeChatPresets: () => import_presets.composeChatPresets,
   createXGroupOpenApiTransport: () => import_xgroup2.createXGroupOpenApiTransport,
   createXGroupUploadRequest: () => import_xgroup.createXGroupUploadRequest,
   cssVarStyle: () => import_tokens.cssVarStyle,
+  defineChatPreset: () => import_presets.defineChatPreset,
+  extractXGroupKnowledgeReferences: () => import_xgroup.extractXGroupKnowledgeReferences,
   formatMarkdownResourceLinksAsText: () => import_markdownResource.formatMarkdownResourceLinksAsText,
   getMarkdownResourceDisplayLabel: () => import_markdownResource.getMarkdownResourceDisplayLabel,
-  mergeChatStrategies: () => import_xgroup.mergeChatStrategies,
+  mergeChatStrategies: () => import_presets.mergeChatStrategies,
   parseMarkdownResourceHref: () => import_markdownResource.parseMarkdownResourceHref,
   parseMarkdownResourceLinksAsParts: () => import_markdownResource.parseMarkdownResourceLinksAsParts,
+  parseXGroupKnowledgeReference: () => import_xgroup.parseXGroupKnowledgeReference,
   replaceMarkdownResourceLinks: () => import_markdownResource.replaceMarkdownResourceLinks,
   request: () => import_request.default,
-  resolveChatPreset: () => import_xgroup.resolveChatPreset,
-  resolvePresetUploadRequest: () => import_xgroup.resolvePresetUploadRequest,
+  resolveChatPreset: () => import_presets.resolveChatPreset,
+  resolvePresetMarkdownExtensions: () => import_presets.resolvePresetMarkdownExtensions,
+  resolvePresetUploadRequest: () => import_presets.resolvePresetUploadRequest,
   token: () => import_tokens.token,
   tokenDefaults: () => import_tokens.tokenDefaults,
   tokens: () => import_tokens.tokens,
@@ -71,6 +78,8 @@ __export(src_exports, {
   useXAi: () => import_AiProviderContext.useXAi,
   useXAiSDK: () => import_useXAiSDK.default,
   xGroupAdkPreset: () => import_xgroup.xGroupAdkPreset,
+  xGroupKnowledgeReferenceMarkdownExtension: () => import_xgroup.xGroupKnowledgeReferenceMarkdownExtension,
+  xGroupMarkdownExtensions: () => import_xgroup.xGroupMarkdownExtensions,
   xGroupToolKindResolver: () => import_xgroup.xGroupToolKindResolver
 });
 module.exports = __toCommonJS(src_exports);
@@ -89,6 +98,7 @@ var import_XAdkProvider = __toESM(require("./components/XAdkProvider"));
 var import_XAdkChatbot = __toESM(require("./components/XAdkChatbot"));
 var import_XAdkSender = __toESM(require("./components/XAdkSender"));
 var import_useADKChat = __toESM(require("./hooks/useADKChat"));
+var import_presets = require("./presets");
 var import_xgroup = require("./presets/xgroup");
 var import_context = require("./components/XAdkProvider/context");
 __reExport(src_exports, require("./types"), module.exports);
@@ -103,6 +113,8 @@ var import_useAdkConversation = __toESM(require("./react/useAdkConversation"));
 var import_xgroup2 = require("./presets/xgroup");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUILTIN_CHAT_PRESETS,
+  DEFAULT_CHAT_PRESET_NAME,
   FileGallery,
   FolderTree,
   FunctionCallRender,
@@ -121,17 +133,22 @@ var import_xgroup2 = require("./presets/xgroup");
   baseChatStrategies,
   basePreset,
   baseToolKindResolver,
+  composeChatPresets,
   createXGroupOpenApiTransport,
   createXGroupUploadRequest,
   cssVarStyle,
+  defineChatPreset,
+  extractXGroupKnowledgeReferences,
   formatMarkdownResourceLinksAsText,
   getMarkdownResourceDisplayLabel,
   mergeChatStrategies,
   parseMarkdownResourceHref,
   parseMarkdownResourceLinksAsParts,
+  parseXGroupKnowledgeReference,
   replaceMarkdownResourceLinks,
   request,
   resolveChatPreset,
+  resolvePresetMarkdownExtensions,
   resolvePresetUploadRequest,
   token,
   tokenDefaults,
@@ -144,6 +161,8 @@ var import_xgroup2 = require("./presets/xgroup");
   useXAi,
   useXAiSDK,
   xGroupAdkPreset,
+  xGroupKnowledgeReferenceMarkdownExtension,
+  xGroupMarkdownExtensions,
   xGroupToolKindResolver,
   ...require("./types"),
   ...require("./core")

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\";\nimport {\n  formatMarkdownResourceLinksAsText,\n  getMarkdownResourceDisplayLabel,\n  parseMarkdownResourceLinksAsParts,\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  getMarkdownResourceDisplayLabel,\n  parseMarkdownResourceLinksAsParts,\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;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,8BAMO;AAGP,0BAAyB;AACzB,yBAAwB;AACxB,wBAAuB;AACvB,wBAAuB;AACvB,oBAUO;AAGP,qBAIO;AAEP,wBAAc,oBA3Cd;AAqFA,qBAAoB;AAKpB,wBAAuB;AAUvB,4BAA0C;AAC1C,gCAA8C;AAC9C,yBAAuC;AAYvC,oBAA0D;AAG1D,wBAAc,mBArHd;AAsHA,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  getMarkdownResourceDisplayLabel,\n  parseMarkdownResourceLinksAsParts,\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  BUILTIN_CHAT_PRESETS,\n  composeChatPresets,\n  DEFAULT_CHAT_PRESET_NAME,\n  defineChatPreset,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  resolvePresetMarkdownExtensions,\n} from \"./presets\";\nimport {\n  extractXGroupKnowledgeReferences,\n  parseXGroupKnowledgeReference,\n  xGroupKnowledgeReferenceMarkdownExtension,\n  xGroupMarkdownExtensions,\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  getMarkdownResourceDisplayLabel,\n  parseMarkdownResourceLinksAsParts,\n  parseMarkdownResourceHref,\n  replaceMarkdownResourceLinks,\n  baseChatStrategies,\n  basePreset,\n  baseToolKindResolver,\n  BUILTIN_CHAT_PRESETS,\n  composeChatPresets,\n  DEFAULT_CHAT_PRESET_NAME,\n  defineChatPreset,\n  createXGroupUploadRequest,\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n  resolveChatPreset,\n  resolvePresetMarkdownExtensions,\n  extractXGroupKnowledgeReferences,\n  parseXGroupKnowledgeReference,\n  xGroupKnowledgeReferenceMarkdownExtension,\n  xGroupMarkdownExtensions,\n  xGroupAdkPreset,\n  xGroupToolKindResolver,\n};\nexport type { XGroupKnowledgeReference } from \"./presets/xgroup\";\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;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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oCAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,+BAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,oBAAmB;AACnB,uBAAsB;AACtB,yBAAwB;AACxB,8BAA6B;AAC7B,8BAA6B;AAC7B,uBAAsB;AACtB,qBAAoB;AACpB,8BAMO;AAGP,0BAAyB;AACzB,yBAAwB;AACxB,wBAAuB;AACvB,wBAAuB;AACvB,qBAYO;AACP,oBAQO;AAGP,qBAIO;AAEP,wBAAc,oBAtDd;AA0GA,qBAAoB;AAKpB,wBAAuB;AAUvB,4BAA0C;AAC1C,gCAA8C;AAC9C,yBAAuC;AAYvC,oBAA0D;AAG1D,wBAAc,mBA1Id;AA2IA,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/base.d.ts

@@ -0,0 +1,6 @@
+import type { ChatPreset, ChatStrategies, ToolRenderKind } from "../types";
+export declare const baseToolKindResolver: () => ToolRenderKind;
+/** SDK 基础策略：不带任何企业协议偏好的最小行为集合。 */
+export declare const baseChatStrategies: Required<Pick<ChatStrategies, "resolveToolKind" | "createFunctionResponse" | "parseProcessMessage" | "markdownResourceLinkSchemes">>;
+/** 不绑定企业后端协议的中立预设。 */
+export declare const basePreset: ChatPreset;

package/dist/cjs/presets/base.js

@@ -0,0 +1,50 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/presets/base.ts
+var base_exports = {};
+__export(base_exports, {
+  baseChatStrategies: () => baseChatStrategies,
+  basePreset: () => basePreset,
+  baseToolKindResolver: () => baseToolKindResolver
+});
+module.exports = __toCommonJS(base_exports);
+var import_utils = require("../utils");
+var BASE_MARKDOWN_RESOURCE_LINK_SCHEMES = [];
+var baseToolKindResolver = () => "default";
+var baseChatStrategies = {
+  resolveToolKind: baseToolKindResolver,
+  createFunctionResponse: (fnCall, confirmed) => ({
+    id: fnCall.id,
+    name: fnCall.name,
+    response: { confirmed }
+  }),
+  parseProcessMessage: import_utils.parseAgentMessage,
+  markdownResourceLinkSchemes: BASE_MARKDOWN_RESOURCE_LINK_SCHEMES
+};
+var basePreset = {
+  name: "base",
+  strategies: baseChatStrategies
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  baseChatStrategies,
+  basePreset,
+  baseToolKindResolver
+});
+//# sourceMappingURL=base.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/presets/base.ts"],
+  "sourcesContent": ["import { parseAgentMessage } from \"@/utils\";\nimport type {\n  ChatPreset,\n  ChatStrategies,\n  FunctionCall,\n  FunctionResponse,\n  ToolRenderKind,\n} from \"@/types\";\n\nconst BASE_MARKDOWN_RESOURCE_LINK_SCHEMES: readonly string[] = [];\n\nexport const baseToolKindResolver = (): ToolRenderKind => \"default\";\n\n/** SDK 基础策略：不带任何企业协议偏好的最小行为集合。 */\nexport const baseChatStrategies: Required<\n  Pick<\n    ChatStrategies,\n    | \"resolveToolKind\"\n    | \"createFunctionResponse\"\n    | \"parseProcessMessage\"\n    | \"markdownResourceLinkSchemes\"\n  >\n> = {\n  resolveToolKind: baseToolKindResolver,\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: BASE_MARKDOWN_RESOURCE_LINK_SCHEMES,\n};\n\n/** 不绑定企业后端协议的中立预设。 */\nexport const basePreset: ChatPreset = {\n  name: \"base\",\n  strategies: baseChatStrategies,\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkC;AASlC,IAAM,sCAAyD,CAAC;AAEzD,IAAM,uBAAuB,MAAsB;AAGnD,IAAM,qBAQT;AAAA,EACF,iBAAiB;AAAA,EACjB,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;AAGO,IAAM,aAAyB;AAAA,EACpC,MAAM;AAAA,EACN,YAAY;AACd;",
+  "names": []
+}

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

@@ -0,0 +1,11 @@
+import type { ChatPreset } from "../types";
+/**
+ * 为企业预设提供类型安全的声明入口。
+ * 使用函数而非可变的全局注册器，避免 SSR/多实例之间共享注册状态。
+ */
+export declare const defineChatPreset: <TPreset extends ChatPreset>(preset: TPreset) => TPreset;
+/**
+ * 组合基础预设、可复用能力包和企业差异。后传入的预设优先，策略按字段浅合并，
+ * Markdown 扩展按 tagName 去重并由后者覆盖。
+ */
+export declare const composeChatPresets: (base: ChatPreset, ...overrides: ChatPreset[]) => ChatPreset;

package/dist/cjs/presets/define.js

@@ -0,0 +1,58 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/presets/define.ts
+var define_exports = {};
+__export(define_exports, {
+  composeChatPresets: () => composeChatPresets,
+  defineChatPreset: () => defineChatPreset
+});
+module.exports = __toCommonJS(define_exports);
+var defineChatPreset = (preset) => preset;
+var mergeChatPreset = (base, override) => {
+  const overrideTags = new Set(
+    (override.markdownExtensions || []).map(
+      (item) => item.tagName.toLowerCase()
+    )
+  );
+  return {
+    ...base,
+    ...override,
+    strategies: {
+      ...base.strategies,
+      ...override.strategies
+    },
+    markdownExtensions: [
+      ...(base.markdownExtensions || []).filter(
+        (item) => !overrideTags.has(item.tagName.toLowerCase())
+      ),
+      ...override.markdownExtensions || []
+    ],
+    createUploadRequest: Object.prototype.hasOwnProperty.call(
+      override,
+      "createUploadRequest"
+    ) ? override.createUploadRequest : base.createUploadRequest
+  };
+};
+var composeChatPresets = (base, ...overrides) => overrides.reduce(mergeChatPreset, base);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  composeChatPresets,
+  defineChatPreset
+});
+//# sourceMappingURL=define.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/presets/define.ts"],
+  "sourcesContent": ["import type { ChatPreset } from \"@/types\";\n\n/**\n * 为企业预设提供类型安全的声明入口。\n * 使用函数而非可变的全局注册器，避免 SSR/多实例之间共享注册状态。\n */\nexport const defineChatPreset = <TPreset extends ChatPreset>(\n  preset: TPreset,\n): TPreset => preset;\n\nconst mergeChatPreset = (\n  base: ChatPreset,\n  override: ChatPreset,\n): ChatPreset => {\n  const overrideTags = new Set(\n    (override.markdownExtensions || []).map((item) =>\n      item.tagName.toLowerCase(),\n    ),\n  );\n\n  return {\n    ...base,\n    ...override,\n    strategies: {\n      ...base.strategies,\n      ...override.strategies,\n    },\n    markdownExtensions: [\n      ...(base.markdownExtensions || []).filter(\n        (item) => !overrideTags.has(item.tagName.toLowerCase()),\n      ),\n      ...(override.markdownExtensions || []),\n    ],\n    createUploadRequest: Object.prototype.hasOwnProperty.call(\n      override,\n      \"createUploadRequest\",\n    )\n      ? override.createUploadRequest\n      : base.createUploadRequest,\n  };\n};\n\n/**\n * 组合基础预设、可复用能力包和企业差异。后传入的预设优先，策略按字段浅合并，\n * Markdown 扩展按 tagName 去重并由后者覆盖。\n */\nexport const composeChatPresets = (\n  base: ChatPreset,\n  ...overrides: ChatPreset[]\n): ChatPreset =>\n  overrides.reduce(mergeChatPreset, base);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,IAAM,mBAAmB,CAC9B,WACY;AAEd,IAAM,kBAAkB,CACtB,MACA,aACe;AACf,QAAM,eAAe,IAAI;AAAA,KACtB,SAAS,sBAAsB,CAAC,GAAG;AAAA,MAAI,CAAC,SACvC,KAAK,QAAQ,YAAY;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH,YAAY;AAAA,MACV,GAAG,KAAK;AAAA,MACR,GAAG,SAAS;AAAA,IACd;AAAA,IACA,oBAAoB;AAAA,MAClB,IAAI,KAAK,sBAAsB,CAAC,GAAG;AAAA,QACjC,CAAC,SAAS,CAAC,aAAa,IAAI,KAAK,QAAQ,YAAY,CAAC;AAAA,MACxD;AAAA,MACA,GAAI,SAAS,sBAAsB,CAAC;AAAA,IACtC;AAAA,IACA,qBAAqB,OAAO,UAAU,eAAe;AAAA,MACnD;AAAA,MACA;AAAA,IACF,IACI,SAAS,sBACT,KAAK;AAAA,EACX;AACF;AAMO,IAAM,qBAAqB,CAChC,SACG,cAEH,UAAU,OAAO,iBAAiB,IAAI;",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+export * from "./base";
+export * from "./define";
+export * from "./runtime";

package/dist/cjs/presets/index.js

@@ -0,0 +1,28 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/presets/index.ts
+var presets_exports = {};
+module.exports = __toCommonJS(presets_exports);
+__reExport(presets_exports, require("./base"), module.exports);
+__reExport(presets_exports, require("./define"), module.exports);
+__reExport(presets_exports, require("./runtime"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./base"),
+  ...require("./define"),
+  ...require("./runtime")
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/presets/index.ts"],
+  "sourcesContent": ["export * from \"./base\";\nexport * from \"./define\";\nexport * from \"./runtime\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,4BAAc,mBAAd;AACA,4BAAc,qBADd;AAEA,4BAAc,sBAFd;",
+  "names": []
+}

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

@@ -0,0 +1,22 @@
+import type { ChatPreset, ChatPresetInput, ChatStrategies, MarkdownExtension, UploadRequestFn } from "../types";
+export declare const DEFAULT_CHAT_PRESET_NAME: "xgroup-adk";
+/** SDK 内建预设注册表。外部预设应优先直接传入 ChatPreset 对象。 */
+export declare const BUILTIN_CHAT_PRESETS: Readonly<{
+    base: ChatPreset;
+    "xgroup-adk": ChatPreset;
+}>;
+/**
+ * 统一解析内建名称和自定义预设对象。
+ * 未传时继续使用 xgroup-adk，保持既有接入行为。
+ */
+export declare const resolveChatPreset: (preset: ChatPresetInput | undefined) => ChatPreset;
+/** 将基础策略、预设策略和接入方局部覆盖按优先级合并。 */
+export declare const mergeChatStrategies: (preset: ChatPresetInput | undefined, overrides?: ChatStrategies) => ChatStrategies;
+/** 合并预设与接入方 Markdown 扩展；同名标签始终由接入方覆盖。 */
+export declare const resolvePresetMarkdownExtensions: (preset: ChatPresetInput | undefined, overrides?: readonly MarkdownExtension[]) => MarkdownExtension[];
+/** 解析当前预设提供的默认上传实现，显式 uploadRequest 仍由调用方优先。 */
+export declare const resolvePresetUploadRequest: (preset: ChatPresetInput | undefined, context: {
+    url: string;
+    token?: string;
+    appNo?: string;
+}) => UploadRequestFn | undefined;

package/dist/cjs/presets/runtime.js

@@ -0,0 +1,75 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/presets/runtime.ts
+var runtime_exports = {};
+__export(runtime_exports, {
+  BUILTIN_CHAT_PRESETS: () => BUILTIN_CHAT_PRESETS,
+  DEFAULT_CHAT_PRESET_NAME: () => DEFAULT_CHAT_PRESET_NAME,
+  mergeChatStrategies: () => mergeChatStrategies,
+  resolveChatPreset: () => resolveChatPreset,
+  resolvePresetMarkdownExtensions: () => resolvePresetMarkdownExtensions,
+  resolvePresetUploadRequest: () => resolvePresetUploadRequest
+});
+module.exports = __toCommonJS(runtime_exports);
+var import_base = require("./base");
+var import_preset = require("./xgroup/preset");
+var DEFAULT_CHAT_PRESET_NAME = "xgroup-adk";
+var BUILTIN_CHAT_PRESETS = Object.freeze({
+  base: import_base.basePreset,
+  "xgroup-adk": import_preset.xGroupAdkPreset
+});
+var resolveChatPreset = (preset) => {
+  if (!preset)
+    return BUILTIN_CHAT_PRESETS[DEFAULT_CHAT_PRESET_NAME];
+  if (typeof preset !== "string")
+    return preset;
+  return BUILTIN_CHAT_PRESETS[preset];
+};
+var mergeChatStrategies = (preset, overrides) => ({
+  ...import_base.baseChatStrategies,
+  ...resolveChatPreset(preset).strategies,
+  ...overrides
+});
+var resolvePresetMarkdownExtensions = (preset, overrides = []) => {
+  const registeredTags = /* @__PURE__ */ new Set();
+  return [
+    ...overrides,
+    ...resolveChatPreset(preset).markdownExtensions || []
+  ].filter((extension) => {
+    const tagName = extension.tagName.toLowerCase();
+    if (registeredTags.has(tagName))
+      return false;
+    registeredTags.add(tagName);
+    return true;
+  });
+};
+var resolvePresetUploadRequest = (preset, context) => {
+  var _a, _b;
+  return (_b = (_a = resolveChatPreset(preset)).createUploadRequest) == null ? void 0 : _b.call(_a, context);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BUILTIN_CHAT_PRESETS,
+  DEFAULT_CHAT_PRESET_NAME,
+  mergeChatStrategies,
+  resolveChatPreset,
+  resolvePresetMarkdownExtensions,
+  resolvePresetUploadRequest
+});
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/presets/runtime.ts"],
+  "sourcesContent": ["import type {\n  ChatPreset,\n  ChatPresetInput,\n  ChatStrategies,\n  BuiltinChatPresetName,\n  MarkdownExtension,\n  UploadRequestFn,\n} from \"@/types\";\nimport { baseChatStrategies, basePreset } from \"./base\";\nimport { xGroupAdkPreset } from \"./xgroup/preset\";\n\nexport const DEFAULT_CHAT_PRESET_NAME = \"xgroup-adk\" as const;\n\n/** SDK 内建预设注册表。外部预设应优先直接传入 ChatPreset 对象。 */\nexport const BUILTIN_CHAT_PRESETS = Object.freeze({\n  base: basePreset,\n  \"xgroup-adk\": xGroupAdkPreset,\n}) satisfies Readonly<Record<BuiltinChatPresetName, ChatPreset>>;\n\n/**\n * 统一解析内建名称和自定义预设对象。\n * 未传时继续使用 xgroup-adk，保持既有接入行为。\n */\nexport const resolveChatPreset = (\n  preset: ChatPresetInput | undefined,\n): ChatPreset => {\n  if (!preset) return BUILTIN_CHAT_PRESETS[DEFAULT_CHAT_PRESET_NAME];\n  if (typeof preset !== \"string\") return preset;\n  return BUILTIN_CHAT_PRESETS[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/** 合并预设与接入方 Markdown 扩展；同名标签始终由接入方覆盖。 */\nexport const resolvePresetMarkdownExtensions = (\n  preset: ChatPresetInput | undefined,\n  overrides: readonly MarkdownExtension[] = [],\n) => {\n  const registeredTags = new Set<string>();\n  return [\n    ...overrides,\n    ...(resolveChatPreset(preset).markdownExtensions || []),\n  ].filter((extension) => {\n    const tagName = extension.tagName.toLowerCase();\n    if (registeredTags.has(tagName)) return false;\n    registeredTags.add(tagName);\n    return true;\n  });\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  resolveChatPreset(preset).createUploadRequest?.(context);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,kBAA+C;AAC/C,oBAAgC;AAEzB,IAAM,2BAA2B;AAGjC,IAAM,uBAAuB,OAAO,OAAO;AAAA,EAChD,MAAM;AAAA,EACN,cAAc;AAChB,CAAC;AAMM,IAAM,oBAAoB,CAC/B,WACe;AACf,MAAI,CAAC;AAAQ,WAAO,qBAAqB,wBAAwB;AACjE,MAAI,OAAO,WAAW;AAAU,WAAO;AACvC,SAAO,qBAAqB,MAAM;AACpC;AAGO,IAAM,sBAAsB,CACjC,QACA,eACoB;AAAA,EACpB,GAAG;AAAA,EACH,GAAG,kBAAkB,MAAM,EAAE;AAAA,EAC7B,GAAG;AACL;AAGO,IAAM,kCAAkC,CAC7C,QACA,YAA0C,CAAC,MACxC;AACH,QAAM,iBAAiB,oBAAI,IAAY;AACvC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAI,kBAAkB,MAAM,EAAE,sBAAsB,CAAC;AAAA,EACvD,EAAE,OAAO,CAAC,cAAc;AACtB,UAAM,UAAU,UAAU,QAAQ,YAAY;AAC9C,QAAI,eAAe,IAAI,OAAO;AAAG,aAAO;AACxC,mBAAe,IAAI,OAAO;AAC1B,WAAO;AAAA,EACT,CAAC;AACH;AAGO,IAAM,6BAA6B,CACxC,QACA,YAK6B;AAlE/B;AAmEE,uCAAkB,MAAM,GAAE,wBAA1B,4BAAgD;AAAA;",
+  "names": []
+}

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

@@ -1,4 +1,8 @@
+export * from "../base";
+export * from "../define";
+export * from "../runtime";
 export * from "./preset";
+export * from "./knowledgeReference";
 export * from "./strategies";
 export * from "./transport";
 export * from "./upload";

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

@@ -16,13 +16,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/presets/xgroup/index.ts
 var xgroup_exports = {};
 module.exports = __toCommonJS(xgroup_exports);
+__reExport(xgroup_exports, require("../base"), module.exports);
+__reExport(xgroup_exports, require("../define"), module.exports);
+__reExport(xgroup_exports, require("../runtime"), module.exports);
 __reExport(xgroup_exports, require("./preset"), module.exports);
+__reExport(xgroup_exports, require("./knowledgeReference"), module.exports);
 __reExport(xgroup_exports, require("./strategies"), module.exports);
 __reExport(xgroup_exports, require("./transport"), module.exports);
 __reExport(xgroup_exports, require("./upload"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ...require("../base"),
+  ...require("../define"),
+  ...require("../runtime"),
   ...require("./preset"),
+  ...require("./knowledgeReference"),
   ...require("./strategies"),
   ...require("./transport"),
   ...require("./upload")

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/presets/xgroup/index.ts"],
-  "sourcesContent": ["export * from \"./preset\";\nexport * from \"./strategies\";\nexport * from \"./transport\";\nexport * from \"./upload\";\n"],
-  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,2BAAc,qBAAd;AACA,2BAAc,yBADd;AAEA,2BAAc,wBAFd;AAGA,2BAAc,qBAHd;",
+  "sourcesContent": ["// 兼容历史从 presets/xgroup 导入的基础预设工具；新代码建议从 presets 导入。\nexport * from \"../base\";\nexport * from \"../define\";\nexport * from \"../runtime\";\nexport * from \"./preset\";\nexport * from \"./knowledgeReference\";\nexport * from \"./strategies\";\nexport * from \"./transport\";\nexport * from \"./upload\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AACA,2BAAc,oBADd;AAEA,2BAAc,sBAFd;AAGA,2BAAc,uBAHd;AAIA,2BAAc,qBAJd;AAKA,2BAAc,iCALd;AAMA,2BAAc,yBANd;AAOA,2BAAc,wBAPd;AAQA,2BAAc,qBARd;",
   "names": []
 }

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

@@ -0,0 +1,17 @@
+import type { MarkdownExtension, MarkdownExtensionNode } from "../../types";
+export interface XGroupKnowledgeReference {
+    knowledgeNo: string;
+    documentNo: string;
+    shardingNos: string[];
+    label: string;
+    version?: string;
+}
+export declare const XGROUP_KNOWLEDGE_NO_ATTRIBUTES: readonly ["knowledge-no", "knowledge-base-no", "workspace-no", "knowledgeno", "knowledgebaseno", "workspaceno"];
+export declare const XGROUP_DOCUMENT_NO_ATTRIBUTES: readonly ["document-no", "document-id", "documentno", "documentid"];
+export declare const XGROUP_VERSION_ATTRIBUTES: readonly ["version", "document-version", "documentversion"];
+export declare const XGROUP_SHARDING_NO_ATTRIBUTES: readonly ["sharding-nos", "sharding-no", "shardingnos", "shardingno"];
+export declare const parseXGroupKnowledgeReference: ({ attributes, text, }: Pick<MarkdownExtensionNode, "attributes" | "text">) => XGroupKnowledgeReference;
+/** 从已完成的 Agent 文本中提取知识库引用，不在流式渲染期间产生副作用。 */
+export declare const extractXGroupKnowledgeReferences: (text: string) => XGroupKnowledgeReference[];
+export declare const xGroupKnowledgeReferenceMarkdownExtension: MarkdownExtension;
+export declare const xGroupMarkdownExtensions: readonly MarkdownExtension[];