@ai-group/chat-sdk 3.5.5 → 3.5.7

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

@@ -0,0 +1,45 @@
+import type React from "react";
+import type { ParseAgentMessageOptions, ParsedPart } from "../utils";
+import type { IMessage, FunctionCall, FunctionResponse } from "./XAdkChatbot";
+import type { ToolRenderKind } from "./FunctionCallRender";
+import type { UploadRequestFn } from "./XAdkSender";
+export interface ToolKindResolveContext {
+    name?: string;
+    msg?: IMessage;
+}
+export interface ChatStrategies {
+    /**
+     * 工具名/消息 -> 渲染类型解析策略。
+     */
+    resolveToolKind?: (ctx: ToolKindResolveContext) => ToolRenderKind;
+    /**
+     * 函数调用确认场景中，基于工具调用和用户选择生成 functionResponse。
+     */
+    createFunctionResponse?: (fnCall: FunctionCall, confirmed: boolean) => FunctionResponse;
+    /**
+     * 将模型文本拆分为过程节点和最终答案。
+     */
+    parseProcessMessage?: (text: string, options?: ParseAgentMessageOptions) => ParsedPart[];
+    /**
+     * 自定义 approval 场景渲染，返回 null 则使用默认渲染。
+     */
+    renderApproval?: (msg: IMessage, onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void) => React.ReactNode | null;
+    /**
+     * 自定义 handoff 场景渲染，返回 null 则使用默认渲染。
+     */
+    renderHandoff?: (msg: IMessage) => React.ReactNode | null;
+}
+export interface ChatPreset {
+    name: string;
+    strategies?: ChatStrategies;
+    /**
+     * 基于当前协议预设创建默认文件上传函数。
+     * 用户显式传入 config.uploadRequest 时优先使用用户配置。
+     */
+    createUploadRequest?: (context: {
+        url: string;
+        token?: string;
+        appNo?: string;
+    }) => UploadRequestFn | undefined;
+}
+export type ChatPresetInput = "base" | "xgroup-adk" | ChatPreset;

package/dist/esm/types/ChatStrategies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChatStrategies.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/ChatStrategies.ts"],"sourcesContent":["import type React from \"react\";\nimport type { ParseAgentMessageOptions, ParsedPart } from \"@/utils\";\nimport type { IMessage, FunctionCall, FunctionResponse } from \"./XAdkChatbot\";\nimport type { ToolRenderKind } from \"./FunctionCallRender\";\nimport type { UploadRequestFn } from \"./XAdkSender\";\n\nexport interface ToolKindResolveContext {\n  name?: string;\n  msg?: IMessage;\n}\n\nexport interface ChatStrategies {\n  /**\n   * 工具名/消息 -> 渲染类型解析策略。\n   */\n  resolveToolKind?: (ctx: ToolKindResolveContext) => ToolRenderKind;\n  /**\n   * 函数调用确认场景中，基于工具调用和用户选择生成 functionResponse。\n   */\n  createFunctionResponse?: (\n    fnCall: FunctionCall,\n    confirmed: boolean,\n  ) => FunctionResponse;\n  /**\n   * 将模型文本拆分为过程节点和最终答案。\n   */\n  parseProcessMessage?: (\n    text: string,\n    options?: ParseAgentMessageOptions,\n  ) => ParsedPart[];\n  /**\n   * 自定义 approval 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderApproval?: (\n    msg: IMessage,\n    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void,\n  ) => React.ReactNode | null;\n  /**\n   * 自定义 handoff 场景渲染，返回 null 则使用默认渲染。\n   */\n  renderHandoff?: (msg: IMessage) => React.ReactNode | null;\n}\n\nexport interface ChatPreset {\n  name: string;\n  strategies?: ChatStrategies;\n  /**\n   * 基于当前协议预设创建默认文件上传函数。\n   * 用户显式传入 config.uploadRequest 时优先使用用户配置。\n   */\n  createUploadRequest?: (context: {\n    url: string;\n    token?: string;\n    appNo?: string;\n  }) => UploadRequestFn | undefined;\n}\n\nexport type ChatPresetInput = \"base\" | \"xgroup-adk\" | ChatPreset;\n"],"mappings":""}

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

@@ -0,0 +1,36 @@
+/// <reference types="react" />
+/**
+ * 统一的文件数据接口
+ * 兼容 LocalFile (XAdkSender) 和 FileData (XadkChatbot)
+ */
+export interface FileItem {
+    id?: string;
+    uid?: string;
+    name?: string;
+    displayName?: string;
+    size?: number;
+    type?: string;
+    mimeType?: string;
+    file?: File;
+    status?: "pending" | "uploading" | "success" | "error";
+    progress?: number;
+    errorMessage?: string;
+    fileUri?: string;
+    tempUrl?: string;
+    response?: any;
+}
+export interface FileGalleryProps {
+    file: FileItem;
+    align?: "left" | "right";
+    removable?: boolean;
+    onRemove?: (id: string) => void;
+    className?: string;
+    style?: React.CSSProperties;
+    /** 点击文件卡片回调（非图片、非音视频文件） */
+    onClick?: (file: FileItem) => void;
+}
+export interface FileItemComponentProps {
+    file: FileItem;
+    removable: boolean;
+    onRemove: (id: string) => void;
+}

package/dist/esm/types/FileGallery.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FileGallery.js.map

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

@@ -0,0 +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\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\nexport interface FileItemComponentProps {\n  file: FileItem;\n  removable: boolean;\n  onRemove: (id: string) => void;\n}\n"],"mappings":""}

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

@@ -0,0 +1,35 @@
+/// <reference types="react" />
+import type { IMessage, FunctionCall } from "./";
+/**
+ * 工具调用渲染类型
+ * - approval: 需要用户确认的调用（如危险操作确认）
+ * - handoff: 任务转交给其他 Agent
+ * - default: 普通工具调用
+ */
+export type ToolRenderKind = "approval" | "handoff" | "default";
+/**
+ * 默认的工具名 → 渲染类型推导策略
+ */
+export declare const defaultToolKindResolver: (_name: string | undefined) => ToolRenderKind;
+export interface FunctionCallRenderProps {
+    msg: IMessage;
+    showDetail?: boolean;
+    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;
+    /**
+     * 工具渲染类型，不传则使用 toolKindResolver 自动推导
+     */
+    kind?: ToolRenderKind;
+    /**
+     * 工具名 → 渲染类型的解析策略，默认使用中立的 defaultToolKindResolver。
+     * 业务协议可通过 XAdkProvider preset/strategies 自动下发，或局部传入覆盖。
+     */
+    toolKindResolver?: (name: string | undefined) => ToolRenderKind;
+    /**
+     * 自定义 approval 场景渲染，返回 null 则使用默认渲染
+     */
+    renderApproval?: (msg: IMessage, onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void) => React.ReactNode | null;
+    /**
+     * 自定义 handoff 场景渲染，返回 null 则使用默认渲染
+     */
+    renderHandoff?: (msg: IMessage) => React.ReactNode | null;
+}

package/dist/esm/types/FunctionCallRender.js

@@ -0,0 +1,14 @@
+/**
+ * 工具调用渲染类型
+ * - approval: 需要用户确认的调用（如危险操作确认）
+ * - handoff: 任务转交给其他 Agent
+ * - default: 普通工具调用
+ */
+
+/**
+ * 默认的工具名 → 渲染类型推导策略
+ */
+export var defaultToolKindResolver = function defaultToolKindResolver(_name) {
+  return "default";
+};
+//# sourceMappingURL=FunctionCallRender.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["defaultToolKindResolver","_name"],"sources":["../../../src/types/FunctionCallRender.ts"],"sourcesContent":["import type { IMessage, FunctionCall } from \"@/types\";\n\n/**\n * 工具调用渲染类型\n * - approval: 需要用户确认的调用（如危险操作确认）\n * - handoff: 任务转交给其他 Agent\n * - default: 普通工具调用\n */\nexport type ToolRenderKind = \"approval\" | \"handoff\" | \"default\";\n\n/**\n * 默认的工具名 → 渲染类型推导策略\n */\nexport const defaultToolKindResolver = (\n  _name: string | undefined,\n): ToolRenderKind => {\n  return \"default\";\n};\n\nexport interface FunctionCallRenderProps {\n  msg: IMessage;\n  showDetail?: boolean;\n  onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;\n  /**\n   * 工具渲染类型，不传则使用 toolKindResolver 自动推导\n   */\n  kind?: ToolRenderKind;\n  /**\n   * 工具名 → 渲染类型的解析策略，默认使用中立的 defaultToolKindResolver。\n   * 业务协议可通过 XAdkProvider preset/strategies 自动下发，或局部传入覆盖。\n   */\n  toolKindResolver?: (name: string | undefined) => ToolRenderKind;\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"],"mappings":"AAEA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA,OAAO,IAAMA,uBAAuB,GAAG,SAA1BA,uBAAuBA,CAClCC,KAAyB,EACN;EACnB,OAAO,SAAS;AAClB,CAAC"}

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

@@ -0,0 +1,348 @@
+import type { CSSProperties, JSX, ReactNode } from "react";
+import { type XAdkSenderProps } from "./XAdkSender";
+import { type SendContent } from "./XAiSender";
+import { type FileItem } from "./FileGallery";
+import { type ToolRenderKind } from "./FunctionCallRender";
+import { type ChatPresetInput, type ChatStrategies } from "./ChatStrategies";
+/**
+ * XAdkChatbot 命令式 API
+ */
+export interface XAdkChatbotHandle {
+    /** 手动滚动到底部 */
+    scrollToBottom: (behavior?: ScrollBehavior) => void;
+}
+/**
+ * 消息分组接口
+ */
+export interface ChatGroup {
+    id: string;
+    role: "user" | "bot";
+    msgs: IMessage[];
+    invocationId?: string;
+    allFiles: any[];
+    /** 点赞状态: 1=赞, -1=踩, 0=未反馈 */
+    isLike?: number;
+}
+export interface IInvocation {
+    id: string;
+    name: string;
+    spanId: string;
+    traceId: string;
+    parentSpanId: string;
+    startTime: number;
+    endTime: number;
+    sessionId: string;
+    invocationId: string;
+    duration: number;
+    attributes: Record<string, string>;
+    botName: string;
+    workspaceNo: string;
+    status: number;
+    agentName: string;
+    agentNo: string;
+    agentVersionNo: string;
+    userId: string;
+}
+export interface AgentRunRequest {
+    stream?: boolean;
+    sessionId: string | undefined;
+    content: {
+        parts: Array<{
+            text?: string;
+            functionResponse?: {
+                id?: string;
+                name?: string;
+                response?: any;
+            };
+        }>;
+        role: string;
+    };
+    files?: Array<{
+        fileName: string;
+        fileId?: string;
+        tempUrl: string;
+        type?: string;
+        mimeType: string;
+    }>;
+    stateDelta?: any;
+}
+export interface Blob {
+    displayName?: string;
+    mimeType?: string;
+    data: string;
+}
+export interface FunctionCall {
+    id?: string;
+    name: string;
+    args: {
+        [key: string]: any;
+    };
+}
+export interface FunctionResponse {
+    id?: string;
+    name: string;
+    response: {
+        [key: string]: any;
+    };
+}
+export interface FileData {
+    displayName: string;
+    mimeType: string;
+    fileUri: string;
+}
+export interface ExecutableCode {
+    language: "UNKNOWN" | "PYTHON";
+    code: string;
+}
+export interface CodeExecutionResult {
+    outcome: "UNKNOWN" | "OK" | "FAILED" | "DEADLINE_EXCEEDED";
+    output: string;
+}
+export interface Part {
+    text?: string;
+    inlineData?: Blob;
+    functionCall?: FunctionCall;
+    functionResponse?: FunctionResponse;
+    thought?: boolean;
+    fileData?: FileData;
+    executableCode?: ExecutableCode;
+    codeExecutionResult?: CodeExecutionResult;
+    errorMessage?: string;
+}
+export interface GenAiContent {
+    role: string;
+    parts: Part[];
+}
+export interface LlmRequest {
+    contents: GenAiContent[];
+}
+export interface LlmResponse {
+    partial?: boolean;
+    content: GenAiContent;
+    error?: string;
+    errorMessage?: string;
+    errorCode?: string;
+    longRunningToolIds?: string[];
+}
+export interface UsageMetadata {
+    candidatesTokenCount?: number;
+    promptTokenCount?: number;
+    totalTokenCount?: number;
+    [key: string]: any;
+}
+export interface EventActions {
+    message?: string;
+    artifactDelta?: any;
+    functionCall?: FunctionCall;
+    functionResponse?: FunctionResponse;
+    finishReason?: string;
+}
+export interface Event extends LlmResponse {
+    id?: string;
+    author?: string;
+    modelCode?: string;
+    invocationId?: string;
+    actions?: EventActions;
+    longRunningToolIds?: string[];
+    branch?: string;
+    timestamp?: number;
+    finishReason?: string;
+    usageMetadata?: UsageMetadata;
+    evalStatus?: any;
+    failedMetric?: any;
+    evalScore?: any;
+    evalThreshold?: any;
+    groundingMetadata?: {
+        searchEntryPoint?: {
+            renderedContent?: any;
+        };
+    };
+    isLike?: number;
+    sessionId?: string;
+}
+export interface SessionState {
+    [key: string]: unknown;
+}
+export interface Session {
+    id?: string;
+    appName?: string;
+    userId?: string;
+    state?: SessionState;
+    events?: Event[];
+    lastUpdateTime?: number;
+}
+export interface TimeTick {
+    position: number;
+    label: string;
+}
+export interface IMessage {
+    /** 前端生成的唯一标识 */
+    id: string;
+    /** 单次请求的唯一标识 */
+    invocationId?: string;
+    /** 单个Event的唯一标识，一个event里有可能有多个parts的消息 */
+    eventId?: string;
+    /** 消息发起人：智能体名称、user */
+    author?: string;
+    role: "bot" | "user";
+    /** 时间戳 */
+    timestamp?: number;
+    isLoading?: boolean;
+    /** 函数调用 */
+    functionCall?: FunctionCall;
+    /** 函数调用结果 */
+    functionResponse?: FunctionResponse;
+    /** 文件上传 */
+    inlineData?: Blob;
+    /** 文本消息 */
+    text?: string;
+    /** 文件信息 */
+    fileData?: FileData[];
+    /** 思考 */
+    thought?: boolean;
+    executableCode?: ExecutableCode;
+    codeExecutionResult?: CodeExecutionResult;
+    renderedContent?: any;
+    /** 原始数据 */
+    raw?: any;
+    /** 模型编码，通常来自 stream 事件或历史消息 */
+    modelCode?: string;
+    /** 事件级 token 使用量等模型调用元数据 */
+    usageMetadata?: UsageMetadata;
+    /** 结束原因，通常来自最后一条 stream 事件 */
+    finishReason?: string;
+    evalStatus?: any;
+    failedMetric?: any;
+    evalScore?: any;
+    evalThreshold?: any;
+    invocationIndex?: any;
+    finalResponsePartIndex?: any;
+    toolUseIndex?: any;
+    /** 是否赞/踩 */
+    isLike?: number;
+}
+export type ActionProps = (data: {
+    message: ChatGroup;
+    isLastBotMsg: boolean;
+}) => JSX.Element | null;
+export type ActionExtraProps = (data: {
+    message: ChatGroup;
+    isLastBotMsg: boolean;
+}) => ReactNode;
+/**
+ * 自定义工具调用渲染函数
+ * - 返回 ReactNode：使用自定义渲染
+ * - 返回 null：降级使用默认渲染
+ *
+ * @example
+ * renderFunctionCall={(msg) => {
+ *   if (msg.functionCall?.name === 'my_tool') return <MyToolRender msg={msg} />;
+ *   return null; // 其他工具使用默认渲染
+ * }}
+ */
+export type RenderFunctionCall = (msg: IMessage) => ReactNode | null;
+export interface XAdkChatbotProps extends Partial<XAdkSenderProps> {
+    /**
+     * 自定义工具调用渲染函数
+     * 返回 null 则降级使用默认渲染
+     */
+    renderFunctionCall?: RenderFunctionCall;
+    /**
+     * 工具名 → 渲染类型的解析策略，默认使用 defaultToolKindResolver
+     */
+    toolKindResolver?: (name: string | undefined) => ToolRenderKind;
+    /**
+     * 聊天策略，可由 Provider preset 自动下发，也可在组件局部覆盖。
+     */
+    strategies?: ChatStrategies;
+    /**
+     * 组件直用时的协议预设。默认沿用 xgroup-adk 以兼容既有业务接入；
+     * 需要中立行为时可传入 base。
+     */
+    preset?: ChatPresetInput;
+    className?: string;
+    style?: CSSProperties;
+    loading?: boolean;
+    /** 消息列表 */
+    messages: IMessage[];
+    /** 开场白 */
+    prologue?: string;
+    /** 建议回复 */
+    suggestions?: string[];
+    /** 欢迎页面 */
+    welcome?: ReactNode;
+    /** 显示函数调用详情 */
+    showFnCallDetail?: boolean;
+    /** 是否初始化完成，初始化完成后自动滚动到最新消息 */
+    initialized?: boolean;
+    /**
+     * 当前会话 ID，切换时自动重置滚动状态并置底。
+     * 不传则退化为仅依赖 initialized 的单次置底行为。
+     */
+    sessionId?: string;
+    /** 提交回调 */
+    onSubmit?: ({ text, files }: SendContent) => void;
+    /** 函数调用确认回调 */
+    onConfirm?: (fnCall: FunctionCall, confirmed: boolean) => void;
+    /** 停止回调 */
+    onStop?: () => void;
+    /** 清除回调 */
+    onClear?: () => void;
+    /** 建议回复回调 */
+    onSuggest?: (text: string) => void;
+    /** Agent 名称 (欢迎页面) */
+    agentName?: string;
+    /** Agent 图标 (欢迎页面) */
+    agentIcon?: string;
+    /** Agent 描述 (欢迎页面) */
+    description?: string;
+    /** 是否显示重试按钮 */
+    showRetry?: boolean;
+    /** 是否显示复制按钮 */
+    showCopy?: boolean;
+    /** 是否显示日志按钮 */
+    showLog?: boolean;
+    /** 重试回调 */
+    onRetry?: () => void;
+    /** 复制回调 */
+    onCopy?: (text: string) => void;
+    /** 查看日志回调 */
+    onShowLog?: (invocationId: string, timestamp?: number) => void;
+    /** 是否启用消息分组 (默认 true) */
+    enableGrouping?: boolean;
+    /** 是否自动解析 process 内容并展示思维链 (默认 true) */
+    enableProcessParsing?: boolean;
+    /** 消息功能区 */
+    actions?: ActionProps;
+    /** 追加在消息功能区之后的内容，适合展示 token 消耗等业务扩展信息 */
+    actionsExtra?: ActionExtraProps;
+    /**
+     * Process 解析选项
+     * @example
+     * // 业务项目格式 (注释模式)
+     * parseOptions={{ mode: 'comment' }}
+     *
+     * @example
+     * // 自定义格式
+     * parseOptions={{
+     *   mode: 'custom',
+     *   customPatterns: [
+     *     { regex: /\[REASONING\]([\s\S]*?)\[\/REASONING\]/g, type: 'reasoning' }
+     *   ]
+     * }}
+     */
+    parseOptions?: {
+        mode?: "xml" | "comment" | "custom";
+        customPatterns?: Array<{
+            regex: RegExp;
+            type: string;
+        }>;
+        finalMarker?: string;
+    };
+    /** 是否禁用输入 */
+    disabled?: boolean;
+    /** 是否流式响应 */
+    stream?: boolean;
+    /** 点击对话中附件卡片的回调（非图片、非音视频文件） */
+    onFileClick?: (file: FileItem) => void;
+}

package/dist/esm/types/XAdkChatbot.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=XAdkChatbot.js.map

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

@@ -0,0 +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  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"],"mappings":""}