@ai-group/chat-sdk 3.7.1-alpha8 → 3.7.2

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

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

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

@@ -0,0 +1,46 @@
+import React from "react";
+import { jsx as _jsx } from "react/jsx-runtime";
+export var XGROUP_WEB_REFERENCE_ATTRIBUTES = ["url", "title", "snippet"];
+export var parseXGroupWebReference = function parseXGroupWebReference(_ref) {
+  var _attributes$url, _attributes$title, _attributes$snippet;
+  var attributes = _ref.attributes,
+    text = _ref.text;
+  return {
+    url: ((_attributes$url = attributes.url) === null || _attributes$url === void 0 ? void 0 : _attributes$url.trim()) || "",
+    title: ((_attributes$title = attributes.title) === null || _attributes$title === void 0 ? void 0 : _attributes$title.trim()) || "",
+    snippet: ((_attributes$snippet = attributes.snippet) === null || _attributes$snippet === void 0 ? void 0 : _attributes$snippet.trim()) || "",
+    label: text.trim()
+  };
+};
+var renderStaticWebReference = function renderStaticWebReference(node) {
+  var reference = parseXGroupWebReference(node);
+  return /*#__PURE__*/_jsx("span", {
+    "aria-label": "\u5916\u90E8\u641C\u7D22\u5F15\u7528 ".concat(reference.label || "引"),
+    "data-xadk-web-reference": "true",
+    style: {
+      boxSizing: "border-box",
+      display: "inline-flex",
+      alignItems: "center",
+      justifyContent: "center",
+      minWidth: 18,
+      height: 18,
+      margin: "0 3px",
+      padding: "0 5px",
+      border: "1px solid #e4e6eb",
+      borderRadius: 9,
+      background: "#f1f2f4",
+      color: "#8a8f99",
+      fontSize: 12,
+      fontWeight: 500,
+      lineHeight: "18px",
+      verticalAlign: "1px"
+    },
+    children: reference.label || "引"
+  });
+};
+export var xGroupWebReferenceMarkdownExtension = {
+  tagName: "ai-web-ref",
+  allowedAttributes: XGROUP_WEB_REFERENCE_ATTRIBUTES,
+  render: renderStaticWebReference
+};
+//# sourceMappingURL=webReference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","jsx","_jsx","XGROUP_WEB_REFERENCE_ATTRIBUTES","parseXGroupWebReference","_ref","_attributes$url","_attributes$title","_attributes$snippet","attributes","text","url","trim","title","snippet","label","renderStaticWebReference","node","reference","concat","style","boxSizing","display","alignItems","justifyContent","minWidth","height","margin","padding","border","borderRadius","background","color","fontSize","fontWeight","lineHeight","verticalAlign","children","xGroupWebReferenceMarkdownExtension","tagName","allowedAttributes","render"],"sources":["../../../../src/presets/xgroup/webReference.tsx"],"sourcesContent":["import React from \"react\";\n\nimport type { MarkdownExtension, MarkdownExtensionNode } from \"@/types\";\n\nexport interface XGroupWebReference {\n  url: string;\n  title: string;\n  snippet: string;\n  label: string;\n}\n\nexport const XGROUP_WEB_REFERENCE_ATTRIBUTES = [\n  \"url\",\n  \"title\",\n  \"snippet\",\n] as const;\n\nexport const parseXGroupWebReference = ({\n  attributes,\n  text,\n}: Pick<MarkdownExtensionNode, \"attributes\" | \"text\">): XGroupWebReference => ({\n  url: attributes.url?.trim() || \"\",\n  title: attributes.title?.trim() || \"\",\n  snippet: attributes.snippet?.trim() || \"\",\n  label: text.trim(),\n});\n\nconst renderStaticWebReference = (node: MarkdownExtensionNode) => {\n  const reference = parseXGroupWebReference(node);\n  return (\n    <span\n      aria-label={`外部搜索引用 ${reference.label || \"引\"}`}\n      data-xadk-web-reference=\"true\"\n      style={{\n        boxSizing: \"border-box\",\n        display: \"inline-flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        minWidth: 18,\n        height: 18,\n        margin: \"0 3px\",\n        padding: \"0 5px\",\n        border: \"1px solid #e4e6eb\",\n        borderRadius: 9,\n        background: \"#f1f2f4\",\n        color: \"#8a8f99\",\n        fontSize: 12,\n        fontWeight: 500,\n        lineHeight: \"18px\",\n        verticalAlign: \"1px\",\n      }}\n    >\n      {reference.label || \"引\"}\n    </span>\n  );\n};\n\nexport const xGroupWebReferenceMarkdownExtension: MarkdownExtension = {\n  tagName: \"ai-web-ref\",\n  allowedAttributes: XGROUP_WEB_REFERENCE_ATTRIBUTES,\n  render: renderStaticWebReference,\n};\n"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAW1B,OAAO,IAAMC,+BAA+B,GAAG,CAC7C,KAAK,EACL,OAAO,EACP,SAAS,CACD;AAEV,OAAO,IAAMC,uBAAuB,GAAG,SAA1BA,uBAAuBA,CAAAC,IAAA;EAAA,IAAAC,eAAA,EAAAC,iBAAA,EAAAC,mBAAA;EAAA,IAClCC,UAAU,GAAAJ,IAAA,CAAVI,UAAU;IACVC,IAAI,GAAAL,IAAA,CAAJK,IAAI;EAAA,OACyE;IAC7EC,GAAG,EAAE,EAAAL,eAAA,GAAAG,UAAU,CAACE,GAAG,cAAAL,eAAA,uBAAdA,eAAA,CAAgBM,IAAI,CAAC,CAAC,KAAI,EAAE;IACjCC,KAAK,EAAE,EAAAN,iBAAA,GAAAE,UAAU,CAACI,KAAK,cAAAN,iBAAA,uBAAhBA,iBAAA,CAAkBK,IAAI,CAAC,CAAC,KAAI,EAAE;IACrCE,OAAO,EAAE,EAAAN,mBAAA,GAAAC,UAAU,CAACK,OAAO,cAAAN,mBAAA,uBAAlBA,mBAAA,CAAoBI,IAAI,CAAC,CAAC,KAAI,EAAE;IACzCG,KAAK,EAAEL,IAAI,CAACE,IAAI,CAAC;EACnB,CAAC;AAAA,CAAC;AAEF,IAAMI,wBAAwB,GAAG,SAA3BA,wBAAwBA,CAAIC,IAA2B,EAAK;EAChE,IAAMC,SAAS,GAAGd,uBAAuB,CAACa,IAAI,CAAC;EAC/C,oBACEf,IAAA;IACE,sDAAAiB,MAAA,CAAsBD,SAAS,CAACH,KAAK,IAAI,GAAG,CAAG;IAC/C,2BAAwB,MAAM;IAC9BK,KAAK,EAAE;MACLC,SAAS,EAAE,YAAY;MACvBC,OAAO,EAAE,aAAa;MACtBC,UAAU,EAAE,QAAQ;MACpBC,cAAc,EAAE,QAAQ;MACxBC,QAAQ,EAAE,EAAE;MACZC,MAAM,EAAE,EAAE;MACVC,MAAM,EAAE,OAAO;MACfC,OAAO,EAAE,OAAO;MAChBC,MAAM,EAAE,mBAAmB;MAC3BC,YAAY,EAAE,CAAC;MACfC,UAAU,EAAE,SAAS;MACrBC,KAAK,EAAE,SAAS;MAChBC,QAAQ,EAAE,EAAE;MACZC,UAAU,EAAE,GAAG;MACfC,UAAU,EAAE,MAAM;MAClBC,aAAa,EAAE;IACjB,CAAE;IAAAC,QAAA,EAEDnB,SAAS,CAACH,KAAK,IAAI;EAAG,CACnB,CAAC;AAEX,CAAC;AAED,OAAO,IAAMuB,mCAAsD,GAAG;EACpEC,OAAO,EAAE,YAAY;EACrBC,iBAAiB,EAAErC,+BAA+B;EAClDsC,MAAM,EAAEzB;AACV,CAAC"}

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

@@ -49,4 +49,6 @@ export interface ChatPreset {
         appNo?: string;
     }) => UploadRequestFn | undefined;
 }
-export type ChatPresetInput = "base" | "xgroup-adk" | ChatPreset;
+/** SDK 为兼容现有接入提供的内建预设名称。自定义预设建议直接传 ChatPreset 对象。 */
+export type BuiltinChatPresetName = "base" | "xgroup-adk";
+export type ChatPresetInput = BuiltinChatPresetName | ChatPreset;

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

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/ChatStrategies.ts"],"sourcesContent":["import type React from \"react\";\nimport type { ParseAgentMessageOptions, ParsedPart } from \"@/utils\";\nimport type {\n  IMessage,\n  FunctionCall,\n  FunctionResponse,\n  MarkdownExtension,\n} from \"./XAdkChatbot\";\nimport type { ToolRenderKind } from \"./FunctionCallRender\";\nimport type { UploadRequestFn } from \"./XAdkSender\";\n\nexport interface ToolKindResolveContext {\n  name?: string;\n  msg?: IMessage;\n}\n\nexport interface ChatStrategies {\n  /**\n   * 工具名/消息 -> 渲染类型解析策略。\n   */\n  resolveToolKind?: (ctx: ToolKindResolveContext) => ToolRenderKind;\n  /**\n   * 函数调用确认场景中，基于工具调用和用户选择生成 functionResponse。\n   */\n  createFunctionResponse?: (\n    fnCall: FunctionCall,\n    confirmed: boolean,\n  ) => FunctionResponse;\n  /**\n   * 将模型文本拆分为过程节点和最终答案。\n   */\n  parseProcessMessage?: (\n    text: string,\n    options?: ParseAgentMessageOptions,\n  ) => ParsedPart[];\n  /**\n   * Markdown 资源链接协议白名单，如 skill://、plugin://。\n   * 业务预设可在这里追加私有协议，例如 xgroup-adk 的 kb://。\n   */\n  markdownResourceLinkSchemes?: readonly string[];\n  /**\n   * 自定义 approval 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderApproval?: (\n    msg: IMessage,\n    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void,\n  ) => React.ReactNode | null;\n  /**\n   * 自定义 handoff 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderHandoff?: (msg: IMessage) => React.ReactNode | null;\n}\n\nexport interface ChatPreset {\n  name: string;\n  strategies?: ChatStrategies;\n  /** 当前协议预设提供的默认 Markdown/XML 标签扩展。 */\n  markdownExtensions?: readonly MarkdownExtension[];\n  /**\n   * 基于当前协议预设创建默认文件上传函数。\n   * 用户显式传入 config.uploadRequest 时优先使用用户配置。\n   */\n  createUploadRequest?: (context: {\n    url: string;\n    token?: string;\n    appNo?: string;\n  }) => UploadRequestFn | undefined;\n}\n\nexport type ChatPresetInput = \"base\" | \"xgroup-adk\" | ChatPreset;\n"],"mappings":""}
+{"version":3,"names":[],"sources":["../../../src/types/ChatStrategies.ts"],"sourcesContent":["import type React from \"react\";\nimport type { ParseAgentMessageOptions, ParsedPart } from \"@/utils\";\nimport type {\n  IMessage,\n  FunctionCall,\n  FunctionResponse,\n  MarkdownExtension,\n} from \"./XAdkChatbot\";\nimport type { ToolRenderKind } from \"./FunctionCallRender\";\nimport type { UploadRequestFn } from \"./XAdkSender\";\n\nexport interface ToolKindResolveContext {\n  name?: string;\n  msg?: IMessage;\n}\n\nexport interface ChatStrategies {\n  /**\n   * 工具名/消息 -> 渲染类型解析策略。\n   */\n  resolveToolKind?: (ctx: ToolKindResolveContext) => ToolRenderKind;\n  /**\n   * 函数调用确认场景中，基于工具调用和用户选择生成 functionResponse。\n   */\n  createFunctionResponse?: (\n    fnCall: FunctionCall,\n    confirmed: boolean,\n  ) => FunctionResponse;\n  /**\n   * 将模型文本拆分为过程节点和最终答案。\n   */\n  parseProcessMessage?: (\n    text: string,\n    options?: ParseAgentMessageOptions,\n  ) => ParsedPart[];\n  /**\n   * Markdown 资源链接协议白名单，如 skill://、plugin://。\n   * 业务预设可在这里追加私有协议，例如 xgroup-adk 的 kb://。\n   */\n  markdownResourceLinkSchemes?: readonly string[];\n  /**\n   * 自定义 approval 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderApproval?: (\n    msg: IMessage,\n    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void,\n  ) => React.ReactNode | null;\n  /**\n   * 自定义 handoff 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderHandoff?: (msg: IMessage) => React.ReactNode | null;\n}\n\nexport interface ChatPreset {\n  name: string;\n  strategies?: ChatStrategies;\n  /** 当前协议预设提供的默认 Markdown/XML 标签扩展。 */\n  markdownExtensions?: readonly MarkdownExtension[];\n  /**\n   * 基于当前协议预设创建默认文件上传函数。\n   * 用户显式传入 config.uploadRequest 时优先使用用户配置。\n   */\n  createUploadRequest?: (context: {\n    url: string;\n    token?: string;\n    appNo?: string;\n  }) => UploadRequestFn | undefined;\n}\n\n/** SDK 为兼容现有接入提供的内建预设名称。自定义预设建议直接传 ChatPreset 对象。 */\nexport type BuiltinChatPresetName = \"base\" | \"xgroup-adk\";\n\nexport type ChatPresetInput = BuiltinChatPresetName | ChatPreset;\n"],"mappings":""}

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

@@ -5,6 +5,10 @@ export interface QuickListOption {
     label: string;
     description?: string;
     icon?: React.ReactNode;
+    /** 选中后的行为。insert 会写入 Mention；command 仅执行回调。默认 insert。 */
+    action?: "insert" | "command";
+    /** 选中当前选项时执行，可用于 command 类型的业务动作。 */
+    onSelect?: (option: QuickListOption) => void;
     /** 分组名（用于聚合列表，子分组通过下划线分割） */
     group?: string;
     [key: string]: any;

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

@@ -1 +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  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  /**\n   * 是否启用 Sender 自身的拖拽上传。\n   * 拖拽产生的文件通过 onFileSelect 回调交给业务/外层处理；\n   * 默认 false，由外层（如 DefaultLayout）管理拖拽时无需开启。\n   */\n  draggable?: boolean;\n  /**\n   * 拖拽文件回调：当 draggable 为 true 且用户向输入区拖拽文件时触发。\n   * 业务/外层在此回调中决定如何处理文件（通常调用 senderRef.addFiles 注入）。\n   */\n  onFileSelect?: (files: File[]) => void;\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":""}
+{"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  /** 选中后的行为。insert 会写入 Mention；command 仅执行回调。默认 insert。 */\n  action?: \"insert\" | \"command\";\n  /** 选中当前选项时执行，可用于 command 类型的业务动作。 */\n  onSelect?: (option: QuickListOption) => void;\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  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  /**\n   * 是否启用 Sender 自身的拖拽上传。\n   * 拖拽产生的文件通过 onFileSelect 回调交给业务/外层处理；\n   * 默认 false，由外层（如 DefaultLayout）管理拖拽时无需开启。\n   */\n  draggable?: boolean;\n  /**\n   * 拖拽文件回调：当 draggable 为 true 且用户向输入区拖拽文件时触发。\n   * 业务/外层在此回调中决定如何处理文件（通常调用 senderRef.addFiles 注入）。\n   */\n  onFileSelect?: (files: File[]) => void;\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":""}