@tdesign-react/chat 1.1.0-alpha.11 → 1.1.0-alpha.13

package/es/chat-engine/core/adapters/openclaw/event-mapper.d.ts

@@ -0,0 +1,212 @@
+/**
+ * OpenClaw 事件映射器
+ *
+ * 将 OpenClaw 事件（chat、agent 等）转换为 ChatEngine 统一的 AIMessageContent 格式
+ *
+ * 支持的 stream 类型：
+ * - assistant：文本流（标准文本对话）
+ * - tool：工具调用流（start → args → result → end 四阶段）
+ * - activity：Activity 组件流（snapshot / delta 增量合并）
+ */
+import type { AIMessageContent, ToolCall } from '../../type';
+import type { OpenClawEventFrame } from './types';
+/**
+ * 事件映射结果
+ */
+export interface EventMapResult {
+    /** 映射后的内容 */
+    content: AIMessageContent | AIMessageContent[] | null;
+    /** 是否是最终消息 */
+    isFinal: boolean;
+    /** 是否有错误 */
+    hasError: boolean;
+    /** 错误消息 */
+    errorMessage?: string;
+    /** 原始运行 ID */
+    runId?: string;
+}
+/**
+ * OpenClaw 事件映射器
+ */
+export declare class OpenClawEventMapper {
+    /** 当前流式文本缓冲 */
+    private textBuffer;
+    /** 当前运行 ID */
+    private currentRunId;
+    /** 工具调用状态映射（toolCallId → ToolCall） */
+    private toolCallMap;
+    /** 已结束的工具调用 ID 集合 */
+    private toolCallEnded;
+    /**
+     * 映射 OpenClaw 事件帧到 AIMessageContent
+     */
+    mapEvent(frame: OpenClawEventFrame): EventMapResult;
+    /**
+     * 映射 chat 事件
+     */
+    private mapChatEvent;
+    /**
+     * 处理 chat delta（增量更新）
+     *
+     * chat 事件的 message.content 包含全量文本快照。
+     * 需要计算与上次的增量，只返回新增部分，
+     * 因为 ChatEngine 的 text handler 会拼接内容。
+     */
+    private handleChatDelta;
+    /**
+     * 处理 chat final（最终消息）
+     *
+     * 在实际 OpenClaw 流程中，chat final 在 agent 流式结束后发送。
+     * 此时所有文本已通过 agent 事件累积完毕，
+     * 所以 final 只需标记完成状态，不应再输出全量内容。
+     */
+    private handleChatFinal;
+    /**
+     * 映射 agent 事件
+     *
+     * 根据 stream 字段分发到不同的处理器：
+     * - assistant / 缺省：文本流
+     * - tool：工具调用流
+     * - activity：Activity 组件流
+     */
+    private mapAgentEvent;
+    /**
+     * 处理 assistant stream（文本流）
+     *
+     * 实际 OpenClaw agent 事件格式：
+     * {
+     *   "type": "event",
+     *   "event": "agent",
+     *   "payload": {
+     *     "runId": "xxx",
+     *     "stream": "assistant",
+     *     "data": { "text": "全量快照", "delta": "增量" },
+     *     "sessionKey": "agent:main:main",
+     *     "seq": 12,
+     *     "ts": 1772612049089
+     *   }
+     * }
+     */
+    private handleAssistantStream;
+    /**
+     * 处理 agent 文本快照
+     *
+     * 实际 OpenClaw agent 事件中，data.text 是全量快照，data.delta 是本次增量。
+     * ChatEngine 的 text 合并策略是 existing + incoming（拼接），
+     * 所以这里必须返回 delta（增量）而非全量快照，否则会导致内容重复。
+     * textBuffer 保存全量快照，用于 final 阶段和状态恢复。
+     */
+    private handleAgentTextSnapshot;
+    /**
+     * 处理 agent 文本增量
+     */
+    private handleAgentTextDelta;
+    /**
+     * 处理 agent 完成
+     *
+     * 完成时不再输出内容（之前的 delta 已经都输出了），
+     * 只返回一个空 data + complete 状态来标记结束。
+     */
+    private handleAgentComplete;
+    /**
+     * 处理通用 agent 数据
+     *
+     * 兜底处理逻辑：优先使用 delta 增量，避免全量快照被 ChatEngine 拼接导致重复
+     */
+    private handleAgentGenericData;
+    /**
+     * 处理 tool stream
+     *
+     * OpenClaw tool stream data 约定：
+     * {
+     *   toolCallId: string,       // 工具调用 ID
+     *   toolCallName: string,     // 工具名称
+     *   state: 'start' | 'args' | 'result' | 'end',
+     *   delta?: string,           // args 增量
+     *   content?: string,         // result 内容
+     *   args?: string,            // 全量 args（snapshot 模式）
+     *   result?: string,          // 全量 result（snapshot 模式）
+     *   parentMessageId?: string, // 父消息 ID
+     * }
+     */
+    private handleToolStream;
+    /**
+     * 处理工具调用开始
+     */
+    private handleToolCallStart;
+    /**
+     * 处理工具调用参数增量
+     */
+    private handleToolCallArgs;
+    /**
+     * 处理工具调用结果
+     */
+    private handleToolCallResult;
+    /**
+     * 处理工具调用结束
+     */
+    private handleToolCallEnd;
+    /**
+     * 兜底处理工具调用数据（无 state 字段时）
+     */
+    private handleToolCallGeneric;
+    /**
+     * 处理旧版工具调用（通过 type 字段而非 stream=tool）
+     */
+    private handleToolCall;
+    /**
+     * 处理旧版工具结果（通过 type 字段而非 stream=tool）
+     */
+    private handleToolResult;
+    /**
+     * 处理 activity stream
+     *
+     * 直接复用 activityManager 的 snapshot/delta 处理逻辑。
+     *
+     * OpenClaw activity stream data 约定：
+     * {
+     *   activityType: string,                  // Activity 组件类型
+     *   state: 'snapshot' | 'delta',           // 全量 or 增量
+     *   content?: Record<string, any>,         // snapshot 全量数据
+     *   patch?: any[],                         // delta JSON Patch 数组
+     *   messageId?: string,                    // 关联消息 ID
+     * }
+     */
+    private handleActivityStream;
+    /**
+     * 映射通用事件
+     */
+    private mapGenericEvent;
+    /**
+     * 从 content 数组中提取文本
+     */
+    private extractTextFromContent;
+    /**
+     * 创建错误内容
+     */
+    private createErrorContent;
+    /**
+     * 获取当前文本缓冲
+     */
+    getTextBuffer(): string;
+    /**
+     * 获取当前运行 ID
+     */
+    getCurrentRunId(): string | null;
+    /**
+     * 获取指定工具调用
+     */
+    getToolCall(toolCallId: string): ToolCall | undefined;
+    /**
+     * 获取所有工具调用
+     */
+    getToolCalls(): ToolCall[];
+    /**
+     * 检查工具调用是否已结束
+     */
+    isToolCallEnded(toolCallId: string): boolean;
+    /**
+     * 重置映射器状态
+     */
+    reset(): void;
+}