@tdesign-react/chat 1.0.2-alpha.8 → 1.1.0-alpha.1

package/es/chat-engine/core/event-bus/types.d.ts

@@ -0,0 +1,230 @@
+/**
+ * ChatEngine 事件总线类型定义
+ */
+import type { AIMessageContent, ChatMessagesData, ChatRequestParams, ChatStatus, ToolCall } from '../type';
+/**
+ * 事件类型枚举
+ */
+export declare enum ChatEngineEventType {
+    ENGINE_INIT = "engine:init",
+    ENGINE_DESTROY = "engine:destroy",
+    MESSAGE_CREATE = "message:create",
+    MESSAGE_UPDATE = "message:update",
+    MESSAGE_DELETE = "message:delete",
+    MESSAGE_CLEAR = "message:clear",
+    MESSAGE_STATUS_CHANGE = "message:status",
+    MESSAGE_CONTENT_APPEND = "message:content:append",
+    REQUEST_START = "request:start",
+    REQUEST_STREAM = "request:stream",
+    REQUEST_COMPLETE = "request:complete",
+    REQUEST_ERROR = "request:error",
+    REQUEST_ABORT = "request:abort",
+    AGUI_RUN_START = "agui:run:start",
+    AGUI_RUN_COMPLETE = "agui:run:complete",
+    AGUI_RUN_ERROR = "agui:run:error",
+    AGUI_STATE_UPDATE = "agui:state:update",
+    AGUI_TOOLCALL = "agui:toolcall",
+    AGUI_ACTIVITY = "agui:activity",
+    CUSTOM = "custom"
+}
+/**
+ * 事件载荷类型映射
+ */
+export interface ChatEngineEventPayloadMap {
+    [ChatEngineEventType.ENGINE_INIT]: {
+        timestamp: number;
+    };
+    [ChatEngineEventType.ENGINE_DESTROY]: {
+        timestamp: number;
+    };
+    [ChatEngineEventType.MESSAGE_CREATE]: {
+        message: ChatMessagesData;
+        messages: ChatMessagesData[];
+    };
+    [ChatEngineEventType.MESSAGE_UPDATE]: {
+        messageId: string;
+        content: AIMessageContent | AIMessageContent[];
+        message: ChatMessagesData;
+    };
+    [ChatEngineEventType.MESSAGE_DELETE]: {
+        messageId: string;
+        messages: ChatMessagesData[];
+    };
+    [ChatEngineEventType.MESSAGE_CLEAR]: {
+        timestamp: number;
+    };
+    [ChatEngineEventType.MESSAGE_STATUS_CHANGE]: {
+        messageId: string;
+        status: ChatStatus;
+        previousStatus?: ChatStatus;
+    };
+    [ChatEngineEventType.MESSAGE_CONTENT_APPEND]: {
+        messageId: string;
+        content: AIMessageContent;
+        contentIndex: number;
+    };
+    [ChatEngineEventType.REQUEST_START]: {
+        params: ChatRequestParams;
+        messageId?: string;
+    };
+    [ChatEngineEventType.REQUEST_STREAM]: {
+        messageId: string;
+        chunk: unknown;
+        content?: AIMessageContent | AIMessageContent[] | null;
+    };
+    [ChatEngineEventType.REQUEST_COMPLETE]: {
+        messageId: string;
+        params: ChatRequestParams;
+        message: ChatMessagesData;
+    };
+    [ChatEngineEventType.REQUEST_ERROR]: {
+        messageId: string;
+        error: Error | unknown;
+        params?: ChatRequestParams;
+    };
+    [ChatEngineEventType.REQUEST_ABORT]: {
+        messageId: string;
+        params: ChatRequestParams;
+    };
+    [ChatEngineEventType.AGUI_RUN_START]: {
+        runId: string;
+        threadId?: string;
+        timestamp: number;
+    };
+    [ChatEngineEventType.AGUI_RUN_COMPLETE]: {
+        runId: string;
+        threadId?: string;
+        timestamp: number;
+    };
+    [ChatEngineEventType.AGUI_RUN_ERROR]: {
+        error: Error | unknown;
+        runId?: string;
+    };
+    [ChatEngineEventType.AGUI_STATE_UPDATE]: {
+        stateKey: string;
+        state: unknown;
+        previousState?: unknown;
+    };
+    [ChatEngineEventType.AGUI_TOOLCALL]: {
+        toolCall: ToolCall;
+        eventType: string;
+    };
+    [ChatEngineEventType.AGUI_ACTIVITY]: {
+        activityType: string;
+        messageId?: string;
+        content: unknown;
+    };
+    [ChatEngineEventType.CUSTOM]: {
+        eventName: string;
+        data: unknown;
+    };
+}
+/**
+ * 事件回调函数类型
+ */
+export type EventCallback<T = unknown> = (payload: T) => void;
+/**
+ * 取消订阅函数类型
+ */
+export type UnsubscribeFn = () => void;
+/**
+ * 事件过滤器类型
+ */
+export type EventFilter<T = unknown> = (payload: T) => boolean;
+/**
+ * 事件总线配置
+ */
+export interface ChatEventBusOptions {
+    /**
+     * 是否启用调试模式
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * 最大监听器数量（每个事件）
+     * @default 100
+     */
+    maxListeners?: number;
+    /**
+     * 事件历史记录长度（用于调试）
+     * @default 0
+     */
+    historySize?: number;
+}
+/**
+ * 事件历史记录
+ */
+export interface EventHistoryItem {
+    event: ChatEngineEventType | string;
+    payload: unknown;
+    timestamp: number;
+}
+/**
+ * 事件总线接口
+ */
+export interface IChatEventBus {
+    /**
+     * 订阅事件
+     * @param event 事件类型
+     * @param callback 回调函数
+     * @returns 取消订阅函数
+     */
+    on<E extends ChatEngineEventType>(event: E, callback: EventCallback<ChatEngineEventPayloadMap[E]>): UnsubscribeFn;
+    /**
+     * 一次性订阅
+     * @param event 事件类型
+     * @param callback 回调函数
+     * @returns 取消订阅函数
+     */
+    once<E extends ChatEngineEventType>(event: E, callback: EventCallback<ChatEngineEventPayloadMap[E]>): UnsubscribeFn;
+    /**
+     * 取消订阅
+     * @param event 事件类型
+     * @param callback 可选的回调函数，不传则取消该事件所有订阅
+     */
+    off<E extends ChatEngineEventType>(event: E, callback?: EventCallback<ChatEngineEventPayloadMap[E]>): void;
+    /**
+     * 发布事件
+     * @param event 事件类型
+     * @param payload 事件载荷
+     */
+    emit<E extends ChatEngineEventType>(event: E, payload: ChatEngineEventPayloadMap[E]): void;
+    /**
+     * 等待事件（Promise 方式）
+     * @param event 事件类型
+     * @param timeout 超时时间（毫秒）
+     * @returns Promise
+     */
+    waitFor<E extends ChatEngineEventType>(event: E, timeout?: number): Promise<ChatEngineEventPayloadMap[E]>;
+    /**
+     * 带过滤条件的等待
+     * @param event 事件类型
+     * @param filter 过滤函数
+     * @param timeout 超时时间
+     */
+    waitForMatch<E extends ChatEngineEventType>(event: E, filter: EventFilter<ChatEngineEventPayloadMap[E]>, timeout?: number): Promise<ChatEngineEventPayloadMap[E]>;
+    /**
+     * 订阅自定义事件
+     * @param eventName 自定义事件名
+     * @param callback 回调函数
+     */
+    onCustom<T = unknown>(eventName: string, callback: EventCallback<T>): UnsubscribeFn;
+    /**
+     * 发布自定义事件
+     * @param eventName 自定义事件名
+     * @param data 数据
+     */
+    emitCustom<T = unknown>(eventName: string, data: T): void;
+    /**
+     * 获取事件历史记录
+     */
+    getHistory(): EventHistoryItem[];
+    /**
+     * 清理所有订阅
+     */
+    clear(): void;
+    /**
+     * 销毁事件总线
+     */
+    destroy(): void;
+}

package/es/chat-engine/core/event-bus/types.js

@@ -0,0 +1,32 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+var ChatEngineEventType = /* @__PURE__ */function (ChatEngineEventType2) {
+  ChatEngineEventType2["ENGINE_INIT"] = "engine:init";
+  ChatEngineEventType2["ENGINE_DESTROY"] = "engine:destroy";
+  ChatEngineEventType2["MESSAGE_CREATE"] = "message:create";
+  ChatEngineEventType2["MESSAGE_UPDATE"] = "message:update";
+  ChatEngineEventType2["MESSAGE_DELETE"] = "message:delete";
+  ChatEngineEventType2["MESSAGE_CLEAR"] = "message:clear";
+  ChatEngineEventType2["MESSAGE_STATUS_CHANGE"] = "message:status";
+  ChatEngineEventType2["MESSAGE_CONTENT_APPEND"] = "message:content:append";
+  ChatEngineEventType2["REQUEST_START"] = "request:start";
+  ChatEngineEventType2["REQUEST_STREAM"] = "request:stream";
+  ChatEngineEventType2["REQUEST_COMPLETE"] = "request:complete";
+  ChatEngineEventType2["REQUEST_ERROR"] = "request:error";
+  ChatEngineEventType2["REQUEST_ABORT"] = "request:abort";
+  ChatEngineEventType2["AGUI_RUN_START"] = "agui:run:start";
+  ChatEngineEventType2["AGUI_RUN_COMPLETE"] = "agui:run:complete";
+  ChatEngineEventType2["AGUI_RUN_ERROR"] = "agui:run:error";
+  ChatEngineEventType2["AGUI_STATE_UPDATE"] = "agui:state:update";
+  ChatEngineEventType2["AGUI_TOOLCALL"] = "agui:toolcall";
+  ChatEngineEventType2["AGUI_ACTIVITY"] = "agui:activity";
+  ChatEngineEventType2["CUSTOM"] = "custom";
+  return ChatEngineEventType2;
+}(ChatEngineEventType || {});
+
+export { ChatEngineEventType };
+//# sourceMappingURL=types.js.map

package/es/chat-engine/core/event-bus/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../../../pro-components/chat/chat-engine/core/event-bus/types.ts"],"sourcesContent":["/**\n * ChatEngine 事件总线类型定义\n */\nimport type { AIMessageContent, ChatMessagesData, ChatRequestParams, ChatStatus, ToolCall } from '../type';\n\n/**\n * 事件类型枚举\n */\nexport enum ChatEngineEventType {\n  // 生命周期事件\n  ENGINE_INIT = 'engine:init',\n  ENGINE_DESTROY = 'engine:destroy',\n\n  // 消息事件\n  MESSAGE_CREATE = 'message:create',\n  MESSAGE_UPDATE = 'message:update',\n  MESSAGE_DELETE = 'message:delete',\n  MESSAGE_CLEAR = 'message:clear',\n  MESSAGE_STATUS_CHANGE = 'message:status',\n  MESSAGE_CONTENT_APPEND = 'message:content:append',\n\n  // 请求事件\n  REQUEST_START = 'request:start',\n  REQUEST_STREAM = 'request:stream',\n  REQUEST_COMPLETE = 'request:complete',\n  REQUEST_ERROR = 'request:error',\n  REQUEST_ABORT = 'request:abort',\n\n  // AG-UI 协议事件\n  AGUI_RUN_START = 'agui:run:start',\n  AGUI_RUN_COMPLETE = 'agui:run:complete',\n  AGUI_RUN_ERROR = 'agui:run:error',\n  AGUI_STATE_UPDATE = 'agui:state:update',\n  AGUI_TOOLCALL = 'agui:toolcall',\n  AGUI_ACTIVITY = 'agui:activity',\n\n  // 自定义事件\n  CUSTOM = 'custom',\n}\n\n/**\n * 事件载荷类型映射\n */\nexport interface ChatEngineEventPayloadMap {\n  // 生命周期事件\n  [ChatEngineEventType.ENGINE_INIT]: {\n    timestamp: number;\n  };\n  [ChatEngineEventType.ENGINE_DESTROY]: {\n    timestamp: number;\n  };\n\n  // 消息事件\n  [ChatEngineEventType.MESSAGE_CREATE]: {\n    message: ChatMessagesData;\n    messages: ChatMessagesData[];\n  };\n  [ChatEngineEventType.MESSAGE_UPDATE]: {\n    messageId: string;\n    content: AIMessageContent | AIMessageContent[];\n    message: ChatMessagesData;\n  };\n  [ChatEngineEventType.MESSAGE_DELETE]: {\n    messageId: string;\n    messages: ChatMessagesData[];\n  };\n  [ChatEngineEventType.MESSAGE_CLEAR]: {\n    timestamp: number;\n  };\n  [ChatEngineEventType.MESSAGE_STATUS_CHANGE]: {\n    messageId: string;\n    status: ChatStatus;\n    previousStatus?: ChatStatus;\n  };\n  [ChatEngineEventType.MESSAGE_CONTENT_APPEND]: {\n    messageId: string;\n    content: AIMessageContent;\n    contentIndex: number;\n  };\n\n  // 请求事件\n  [ChatEngineEventType.REQUEST_START]: {\n    params: ChatRequestParams;\n    messageId?: string;\n  };\n  [ChatEngineEventType.REQUEST_STREAM]: {\n    messageId: string;\n    chunk: unknown;\n    content?: AIMessageContent | AIMessageContent[] | null;\n  };\n  [ChatEngineEventType.REQUEST_COMPLETE]: {\n    messageId: string;\n    params: ChatRequestParams;\n    message: ChatMessagesData;\n  };\n  [ChatEngineEventType.REQUEST_ERROR]: {\n    messageId: string;\n    error: Error | unknown;\n    params?: ChatRequestParams;\n  };\n  [ChatEngineEventType.REQUEST_ABORT]: {\n    messageId: string;\n    params: ChatRequestParams;\n  };\n\n  // AG-UI 协议事件\n  [ChatEngineEventType.AGUI_RUN_START]: {\n    runId: string;\n    threadId?: string;\n    timestamp: number;\n  };\n  [ChatEngineEventType.AGUI_RUN_COMPLETE]: {\n    runId: string;\n    threadId?: string;\n    timestamp: number;\n  };\n  [ChatEngineEventType.AGUI_RUN_ERROR]: {\n    error: Error | unknown;\n    runId?: string;\n  };\n  [ChatEngineEventType.AGUI_STATE_UPDATE]: {\n    stateKey: string;\n    state: unknown;\n    previousState?: unknown;\n  };\n  [ChatEngineEventType.AGUI_TOOLCALL]: {\n    toolCall: ToolCall;\n    eventType: string;\n  };\n  [ChatEngineEventType.AGUI_ACTIVITY]: {\n    activityType: string;\n    messageId?: string;\n    content: unknown;\n  };\n\n  // 自定义事件\n  [ChatEngineEventType.CUSTOM]: {\n    eventName: string;\n    data: unknown;\n  };\n}\n\n/**\n * 事件回调函数类型\n */\nexport type EventCallback<T = unknown> = (payload: T) => void;\n\n/**\n * 取消订阅函数类型\n */\nexport type UnsubscribeFn = () => void;\n\n/**\n * 事件过滤器类型\n */\nexport type EventFilter<T = unknown> = (payload: T) => boolean;\n\n/**\n * 事件总线配置\n */\nexport interface ChatEventBusOptions {\n  /**\n   * 是否启用调试模式\n   * @default false\n   */\n  debug?: boolean;\n  /**\n   * 最大监听器数量（每个事件）\n   * @default 100\n   */\n  maxListeners?: number;\n  /**\n   * 事件历史记录长度（用于调试）\n   * @default 0\n   */\n  historySize?: number;\n}\n\n/**\n * 事件历史记录\n */\nexport interface EventHistoryItem {\n  event: ChatEngineEventType | string;\n  payload: unknown;\n  timestamp: number;\n}\n\n/**\n * 事件总线接口\n */\nexport interface IChatEventBus {\n  /**\n   * 订阅事件\n   * @param event 事件类型\n   * @param callback 回调函数\n   * @returns 取消订阅函数\n   */\n  on<E extends ChatEngineEventType>(event: E, callback: EventCallback<ChatEngineEventPayloadMap[E]>): UnsubscribeFn;\n\n  /**\n   * 一次性订阅\n   * @param event 事件类型\n   * @param callback 回调函数\n   * @returns 取消订阅函数\n   */\n  once<E extends ChatEngineEventType>(event: E, callback: EventCallback<ChatEngineEventPayloadMap[E]>): UnsubscribeFn;\n\n  /**\n   * 取消订阅\n   * @param event 事件类型\n   * @param callback 可选的回调函数，不传则取消该事件所有订阅\n   */\n  off<E extends ChatEngineEventType>(event: E, callback?: EventCallback<ChatEngineEventPayloadMap[E]>): void;\n\n  /**\n   * 发布事件\n   * @param event 事件类型\n   * @param payload 事件载荷\n   */\n  emit<E extends ChatEngineEventType>(event: E, payload: ChatEngineEventPayloadMap[E]): void;\n\n  /**\n   * 等待事件（Promise 方式）\n   * @param event 事件类型\n   * @param timeout 超时时间（毫秒）\n   * @returns Promise\n   */\n  waitFor<E extends ChatEngineEventType>(event: E, timeout?: number): Promise<ChatEngineEventPayloadMap[E]>;\n\n  /**\n   * 带过滤条件的等待\n   * @param event 事件类型\n   * @param filter 过滤函数\n   * @param timeout 超时时间\n   */\n  waitForMatch<E extends ChatEngineEventType>(\n    event: E,\n    filter: EventFilter<ChatEngineEventPayloadMap[E]>,\n    timeout?: number,\n  ): Promise<ChatEngineEventPayloadMap[E]>;\n\n  /**\n   * 订阅自定义事件\n   * @param eventName 自定义事件名\n   * @param callback 回调函数\n   */\n  onCustom<T = unknown>(eventName: string, callback: EventCallback<T>): UnsubscribeFn;\n\n  /**\n   * 发布自定义事件\n   * @param eventName 自定义事件名\n   * @param data 数据\n   */\n  emitCustom<T = unknown>(eventName: string, data: T): void;\n\n  /**\n   * 获取事件历史记录\n   */\n  getHistory(): EventHistoryItem[];\n\n  /**\n   * 清理所有订阅\n   */\n  clear(): void;\n\n  /**\n   * 销毁事件总线\n   */\n  destroy(): void;\n}\n"],"names":["ChatEngineEventType"],"mappings":";;;;;;IAQYA,mBAAA,4BAAAA,oBAAL,EAAA;AAELA,EAAAA,qBAAA,aAAc,CAAA,GAAA,aAAA,CAAA;AACdA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AAGjBA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AACjBA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AACjBA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AACjBA,EAAAA,qBAAA,eAAgB,CAAA,GAAA,eAAA,CAAA;AAChBA,EAAAA,qBAAA,uBAAwB,CAAA,GAAA,gBAAA,CAAA;AACxBA,EAAAA,qBAAA,wBAAyB,CAAA,GAAA,wBAAA,CAAA;AAGzBA,EAAAA,qBAAA,eAAgB,CAAA,GAAA,eAAA,CAAA;AAChBA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AACjBA,EAAAA,qBAAA,kBAAmB,CAAA,GAAA,kBAAA,CAAA;AACnBA,EAAAA,qBAAA,eAAgB,CAAA,GAAA,eAAA,CAAA;AAChBA,EAAAA,qBAAA,eAAgB,CAAA,GAAA,eAAA,CAAA;AAGhBA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AACjBA,EAAAA,qBAAA,mBAAoB,CAAA,GAAA,mBAAA,CAAA;AACpBA,EAAAA,qBAAA,gBAAiB,CAAA,GAAA,gBAAA,CAAA;AACjBA,EAAAA,qBAAA,mBAAoB,CAAA,GAAA,mBAAA,CAAA;AACpBA,EAAAA,qBAAA,eAAgB,CAAA,GAAA,eAAA,CAAA;AAChBA,EAAAA,qBAAA,eAAgB,CAAA,GAAA,eAAA,CAAA;AAGhBA,EAAAA,qBAAA,QAAS,CAAA,GAAA,QAAA,CAAA;AA7BCA,EAAAA,OAAAA,oBAAAA,CAAAA;AAAA,CAAA,CAAAA,mBAAA,IAAA,EAAA;;;;"}

package/es/chat-engine/core/index.d.ts

@@ -0,0 +1,147 @@
+import type { ChatEventBusOptions, IChatEventBus } from './event-bus';
+import { MessageStore } from './store/message';
+import type { AIMessageContent, ChatMessagesData, ChatMessageSetterMode, ChatRequestParams, ChatServiceConfigSetter, ChatStatus, IChatEngine, ToolCall } from './type';
+export default class ChatEngine implements IChatEngine {
+    messageStore: MessageStore;
+    /**
+     * 事件总线实例
+     * @description 用于发布/订阅引擎事件，支持无 UI 场景下的事件分发
+     */
+    readonly eventBus: IChatEventBus;
+    private messageProcessor;
+    private llmService;
+    private config;
+    private lastRequestParams;
+    private stopReceive;
+    private aguiAdapter;
+    constructor(eventBusOptions?: ChatEventBusOptions);
+    /**
+     * 获取当前所有消息
+     * @returns 消息数组
+     * @description 返回消息存储中的所有消息
+     */
+    get messages(): ChatMessagesData[];
+    /**
+     * 获取当前聊天状态
+     * @returns 聊天状态：'idle'、'pending'、'streaming'、'complete'、'stop'或'error'
+     * @description 返回最后一条消息的状态，如果没有消息则返回'idle'
+     */
+    get status(): ChatStatus;
+    /**
+     * 销毁聊天引擎实例
+     * @description 中止请求，清理消息存储和适配器，释放资源
+     */
+    destroy(): void;
+    /**
+     * 初始化聊天引擎
+     * @param configSetter 聊天服务配置或配置生成函数
+     * @param initialMessages 初始消息列表，用于恢复历史对话
+     * @description 设置初始消息、配置服务参数，并根据协议类型初始化适配器
+     */
+    init(configSetter: ChatServiceConfigSetter, initialMessages?: ChatMessagesData[]): void;
+    /**
+     * 发送用户消息并获取AI回复
+     * @param requestParams 请求参数，包含用户输入的文本和附件
+     * @param sendRequest 是否立即发送
+     * @description 创建用户消息和AI消息，并发送请求获取AI回复
+     */
+    sendUserMessage(requestParams: ChatRequestParams, sendRequest?: boolean): Promise<void>;
+    /**
+     * 发送系统消息
+     * @param msg 系统消息文本内容
+     * @description 创建并存储一条系统消息，通常用于设置上下文或控制对话流程
+     */
+    sendSystemMessage(msg: string): Promise<void>;
+    /**
+     * 手动发送AI消息
+     * @param options 包含请求参数params、发送消息内容content和是否发送请求的标志sendRequest
+     * @description 创建并存储一条AI消息，可选择是否同时发送请求
+     */
+    sendAIMessage(options?: {
+        params?: ChatRequestParams;
+        content?: AIMessageContent[];
+        sendRequest?: boolean;
+    }): Promise<void>;
+    /**
+     * 中止当前进行中的聊天请求
+     * @description 停止接收流式响应，关闭连接，并调用配置的onAbort回调
+     */
+    abortChat(): Promise<void>;
+    /**
+     * 注册内容块合并策略
+     * @param type 内容类型，如'text'、'markdown'等
+     * @param handler 合并处理函数，接收新块和现有块，返回合并后的内容块
+     * @description 用于自定义不同类型内容的增量更新逻辑
+     */
+    registerMergeStrategy<T extends AIMessageContent>(type: T['type'], // 使用类型中定义的type字段作为参数类型
+    handler: (chunk: T, existing?: T) => T): void;
+    /**
+     * 设置消息列表
+     * @param messages 要设置的消息数组
+     * @param mode 设置模式：'replace'(替换)、'prepend'(前置)、'append'(追加)，默认为'replace'
+     * @description 用于批量更新消息，如加载历史消息或重置对话
+     */
+    setMessages(messages: ChatMessagesData[], mode?: ChatMessageSetterMode): void;
+    /**
+     * 清空所有消息
+     * @description 清除消息存储中的所有历史记录
+     */
+    clearMessages(): void;
+    /**
+     * 重新生成AI回复
+     * @param keepVersion 是否保留历史版本，默认为false
+     * @description
+     * - 当keepVersion=false时：删除最后一条AI消息，创建新消息并重新请求
+     * - 当keepVersion=true时：保留旧消息，创建分支消息并重新请求
+     */
+    regenerateAIMessage(keepVersion?: boolean): Promise<void>;
+    /**
+     * 发送请求获取AI回复
+     * @param params 请求参数
+     * @description 根据配置选择流式或批量请求模式，处理响应并更新消息状态
+     */
+    sendRequest(params: ChatRequestParams): Promise<void>;
+    /**
+     * 根据名称获取工具调用
+     * @param name 工具调用名称
+     * @returns 匹配的工具调用对象，如果未找到则返回undefined
+     * @description 用于获取特定名称的工具调用信息，仅在AGUI协议下可用
+     */
+    getToolcallByName(name: string): ToolCall | undefined;
+    private handleBatchRequest;
+    private handleError;
+    private handleComplete;
+    /**
+     * 处理流式请求
+     * 根据协议类型选择不同的处理策略
+     */
+    private handleStreamRequest;
+    /**
+     * 处理AGUI协议的流式请求
+     */
+    private handleAGUIStreamRequest;
+    /**
+     * 处理默认协议的流式请求
+     */
+    private handleDefaultStreamRequest;
+    /**
+     * 统一处理消息结果
+     * 支持单个内容块、多个内容块和增量更新
+     */
+    private processMessageResult;
+    /**
+     * 发布 AG-UI 细粒度事件
+     * 根据内容类型分发到对应的事件通道
+     * todo: 这里的类型 any问题
+     */
+    private emitAGUIDetailEvents;
+    private convertMessages;
+    private setMessageStatus;
+    private processContentUpdate;
+}
+export * from './utils';
+export * from './adapters/agui';
+export * from './event-bus';
+export { stateManager } from './adapters/agui/state-manager';
+export { activityManager } from './adapters/agui/activity-manager';
+export type * from './type';