@tdesign-react/chat 1.0.2-alpha.9 → 1.0.3-alpha.2

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.1.0-alpha.11
+ * (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

@@ -1,14 +1,20 @@
 import { MessageStore } from './store/message';
+import type { ChatEventBusOptions, IChatEventBus } from './event-bus';
 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();
+    constructor(eventBusOptions?: ChatEventBusOptions);
     /**
      * 获取当前所有消息
      * @returns 消息数组
@@ -108,6 +114,7 @@ export default class ChatEngine implements IChatEngine {
     /**
      * 处理流式请求
      * 根据协议类型选择不同的处理策略
+     * SSE 原始数据 → isValidChunk验证 → onMessage解析 → processMessageResult
      */
     private handleStreamRequest;
     /**
@@ -123,10 +130,18 @@ export default class ChatEngine implements IChatEngine {
      * 支持单个内容块、多个内容块和增量更新
      */
     private processMessageResult;
+    /**
+     * 发布 AG-UI 细粒度事件
+     * 根据内容类型分发到对应的事件通道
+     * todo: 这里的类型 any问题
+     */
+    private emitAGUIDetailEvents;
     private convertMessages;
     private setMessageStatus;
     private processContentUpdate;
 }
 export * from './utils';
-export * from './adapters/agui';
+export * from './adapters';
+export * from './event-bus';
+export * from './adapters';
 export type * from './type';