@tdesign-react/chat 1.1.0-alpha.16 → 1.1.0-alpha.17

package/es/chat-engine/core/adapters/openclaw/history-converter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * OpenClaw 历史消息转换器
+ *
+ * 将 OpenClaw `sessions.history` RPC 返回的消息格式转换为 ChatEngine 的 ChatMessagesData 格式。
+ *
+ * OpenClaw 历史消息格式（来自实际 Gateway 返回）：
+ *
+ * 1. user 消息:
+ * {
+ *   role: 'user',
+ *   content: [{ type: 'text', text: '...' }],
+ *   timestamp: number,
+ *   senderLabel: string,
+ * }
+ *
+ * 2. assistant 消息:
+ * {
+ *   role: 'assistant',
+ *   content: [
+ *     { type: 'text', text: '...' },                                       // 文本内容
+ *     { type: 'toolCall', id: '...', name: '...', arguments: {...} },      // 工具调用
+ *   ],
+ *   api: string, provider: string, model: string,
+ *   stopReason: 'stop' | 'toolUse' | 'aborted',
+ *   timestamp: number,
+ *   errorMessage?: string,
+ *   openclawAbort?: { aborted: boolean, origin: string, runId: string },
+ * }
+ *
+ * 3. toolResult 消息:
+ * {
+ *   role: 'toolResult',
+ *   toolCallId: string,
+ *   toolName: string,
+ *   content: [{ type: 'text', text: '...' }],
+ *   isError: boolean,
+ *   timestamp: number,
+ * }
+ */
+import type { ChatMessagesData } from '../../type';
+/**
+ * OpenClaw 历史消息内容项
+ */
+export interface OpenClawHistoryContentItem {
+    type: string;
+    text?: string;
+    id?: string;
+    name?: string;
+    arguments?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * OpenClaw 历史消息
+ */
+export interface OpenClawHistoryMessage {
+    role: 'user' | 'assistant' | 'toolResult' | 'system';
+    content?: OpenClawHistoryContentItem[] | string;
+    timestamp?: number;
+    senderLabel?: string;
+    api?: string;
+    provider?: string;
+    model?: string;
+    stopReason?: string;
+    errorMessage?: string;
+    openclawAbort?: {
+        aborted: boolean;
+        origin: string;
+        runId: string;
+    };
+    toolCallId?: string;
+    toolName?: string;
+    isError?: boolean;
+}
+/**
+ * OpenClaw sessions.history 响应
+ */
+export interface OpenClawHistoryResponse {
+    sessionKey: string;
+    sessionId: string;
+    messages: OpenClawHistoryMessage[];
+    thinkingLevel?: string;
+}
+/**
+ * 将 OpenClaw 历史消息数组转换为 ChatEngine 的 ChatMessagesData 数组
+ *
+ * 转换策略：
+ * 1. user → UserMessage（直接映射文本内容）
+ * 2. assistant → AIMessage（文本内容 + toolCall 转为 toolcall content）
+ * 3. toolResult → 合并到前一个 assistant 消息的对应 toolcall 中作为 result
+ * 4. 跳过空内容和被中止的消息
+ * 5. 连续的 assistant 消息（stopReason: 'toolUse' 后跟 toolResult 再跟 assistant）
+ *    会被合并为一条完整的 AIMessage
+ *
+ * @param messages OpenClaw 格式的历史消息数组
+ * @param options 转换选项
+ * @returns ChatEngine 格式的消息数组
+ */
+export declare function convertOpenClawHistory(messages: OpenClawHistoryMessage[], options?: ConvertHistoryOptions): ChatMessagesData[];
+/**
+ * 从 OpenClaw sessions.history 响应体中提取并转换消息
+ * 这是一个便捷方法，直接接受 RPC 响应的 payload
+ */
+export declare function convertOpenClawHistoryResponse(response: OpenClawHistoryResponse, options?: ConvertHistoryOptions): ChatMessagesData[];
+export interface ConvertHistoryOptions {
+    /**
+     * 是否将 toolCall 的详细参数和结果展示在 toolcall 组件中
+     * 默认 true
+     */
+    showToolCallDetails?: boolean;
+    /**
+     * 是否跳过被中止的消息
+     * 默认 true
+     */
+    skipAborted?: boolean;
+    /**
+     * 自定义 toolCall 渲染名映射
+     * 例如 { 'read': 'file_reader', 'exec': 'command_runner' }
+     */
+    toolCallNameMap?: Record<string, string>;
+}

package/es/chat-engine/core/adapters/openclaw/history-converter.js

@@ -0,0 +1,251 @@
+/**
+ * tdesign v1.1.0-alpha.16
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+import '../shared/index.js';
+import { generateUUID } from './utils.js';
+import { createToolCallContent } from '../agui/utils.js';
+import '../shared/content-factory.js';
+import '../shared/merge-utils.js';
+import '../shared/activity-manager.js';
+import '../agui/ActivityManager.js';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/defineProperty';
+import '../../utils/index.js';
+import '../../utils/immutable-patch.js';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import '@babel/runtime/helpers/toArray';
+
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function convertOpenClawHistory(messages, options) {
+  var result = [];
+  var toolResultMap = /* @__PURE__ */new Map();
+  var _iterator = _createForOfIteratorHelper(messages),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _msg = _step.value;
+      if (_msg.role === "toolResult" && _msg.toolCallId) {
+        var _msg$isError;
+        var _text = extractTextFromContent(_msg.content);
+        toolResultMap.set(_msg.toolCallId, {
+          content: _text,
+          isError: (_msg$isError = _msg.isError) !== null && _msg$isError !== void 0 ? _msg$isError : false
+        });
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var pendingAIMessage = null;
+  for (var i = 0; i < messages.length; i++) {
+    var msg = messages[i];
+    switch (msg.role) {
+      case "user":
+        {
+          if (pendingAIMessage) {
+            result.push(pendingAIMessage);
+            pendingAIMessage = null;
+          }
+          var userMsg = convertUserMessage(msg);
+          if (userMsg) {
+            result.push(userMsg);
+          }
+          break;
+        }
+      case "assistant":
+        {
+          if (isAbortedEmpty(msg)) {
+            break;
+          }
+          var aiContents = convertAssistantContent(msg, toolResultMap, options);
+          if (aiContents.length === 0) {
+            break;
+          }
+          if (pendingAIMessage) {
+            pendingAIMessage.content = [].concat(_toConsumableArray(pendingAIMessage.content || []), _toConsumableArray(aiContents));
+            if (msg.stopReason === "stop") {
+              pendingAIMessage.status = "complete";
+            }
+          } else {
+            pendingAIMessage = {
+              id: generateUUID(),
+              role: "assistant",
+              content: aiContents,
+              status: msg.stopReason === "stop" ? "complete" : "complete",
+              datetime: msg.timestamp ? new Date(msg.timestamp).toISOString() : void 0,
+              ext: {
+                model: msg.model,
+                provider: msg.provider
+              }
+            };
+          }
+          if (msg.stopReason === "stop" || msg.stopReason === "aborted") {
+            if (pendingAIMessage) {
+              result.push(pendingAIMessage);
+              pendingAIMessage = null;
+            }
+          }
+          break;
+        }
+      case "toolResult":
+        {
+          break;
+        }
+      case "system":
+        {
+          if (pendingAIMessage) {
+            result.push(pendingAIMessage);
+            pendingAIMessage = null;
+          }
+          var text = extractTextFromContent(msg.content);
+          if (text) {
+            result.push({
+              id: generateUUID(),
+              role: "system",
+              content: [{
+                type: "text",
+                data: text,
+                status: "complete"
+              }],
+              datetime: msg.timestamp ? new Date(msg.timestamp).toISOString() : void 0
+            });
+          }
+          break;
+        }
+      default:
+        break;
+    }
+  }
+  if (pendingAIMessage) {
+    result.push(pendingAIMessage);
+  }
+  return result;
+}
+function convertOpenClawHistoryResponse(response, options) {
+  return convertOpenClawHistory(response.messages || [], options);
+}
+function convertUserMessage(msg) {
+  var text = extractTextFromContent(msg.content);
+  if (!text) return null;
+  return {
+    id: generateUUID(),
+    role: "user",
+    content: [{
+      type: "text",
+      data: text
+    }],
+    datetime: msg.timestamp ? new Date(msg.timestamp).toISOString() : void 0
+  };
+}
+function convertAssistantContent(msg, toolResultMap, options) {
+  var contents = [];
+  var contentArr = normalizeContent(msg.content);
+  var _iterator2 = _createForOfIteratorHelper(contentArr),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var item = _step2.value;
+      switch (item.type) {
+        case "text":
+          {
+            if (item.text) {
+              contents.push({
+                type: "text",
+                data: item.text,
+                status: "complete"
+              });
+            }
+            break;
+          }
+        case "toolCall":
+          {
+            var toolCallId = item.id || "";
+            var toolCallName = getToolCallName(item.name, options);
+            var rawArgs = item.arguments;
+            var argsStr = rawArgs ? typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs) : "";
+            var toolResult = toolResultMap.get(toolCallId);
+            var resultStr = (toolResult === null || toolResult === void 0 ? void 0 : toolResult.content) || "";
+            var toolCall = {
+              toolCallId: toolCallId,
+              toolCallName: toolCallName,
+              eventType: toolResult ? "TOOL_CALL_RESULT" : "TOOL_CALL_START",
+              parentMessageId: "",
+              args: argsStr,
+              result: resultStr
+            };
+            var status = toolResult ? "complete" : "complete";
+            contents.push(createToolCallContent(toolCall, status, "append"));
+            break;
+          }
+        default:
+          if (item.text) {
+            contents.push({
+              type: "text",
+              data: item.text,
+              status: "complete"
+            });
+          }
+          break;
+      }
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return contents;
+}
+function extractTextFromContent(content) {
+  if (!content) return "";
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content.filter(function (c) {
+    return (c === null || c === void 0 ? void 0 : c.type) === "text" && (c === null || c === void 0 ? void 0 : c.text);
+  }).map(function (c) {
+    return c.text;
+  }).join("");
+}
+function normalizeContent(content) {
+  if (!content) return [];
+  if (typeof content === "string") {
+    return [{
+      type: "text",
+      text: content
+    }];
+  }
+  if (Array.isArray(content)) return content;
+  return [];
+}
+function getToolCallName(name, options) {
+  if (options !== null && options !== void 0 && options.toolCallNameMap && name in options.toolCallNameMap) {
+    return options.toolCallNameMap[name];
+  }
+  return name || "unknown";
+}
+function isAbortedEmpty(msg) {
+  var _msg$openclawAbort;
+  if (msg.stopReason === "aborted" || (_msg$openclawAbort = msg.openclawAbort) !== null && _msg$openclawAbort !== void 0 && _msg$openclawAbort.aborted) {
+    var contentArr = normalizeContent(msg.content);
+    if (contentArr.length === 0) return true;
+    var hasContent = contentArr.some(function (c) {
+      if (c.type === "text" && c.text) return true;
+      if (c.type === "toolCall") return true;
+      return false;
+    });
+    return !hasContent;
+  }
+  return false;
+}
+
+export { convertOpenClawHistory, convertOpenClawHistoryResponse };
+//# sourceMappingURL=history-converter.js.map

package/es/chat-engine/core/adapters/openclaw/history-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-converter.js","sources":["../../../../../../pro-components/chat/chat-engine/core/adapters/openclaw/history-converter.ts"],"sourcesContent":["/**\n * OpenClaw 历史消息转换器\n *\n * 将 OpenClaw `sessions.history` RPC 返回的消息格式转换为 ChatEngine 的 ChatMessagesData 格式。\n *\n * OpenClaw 历史消息格式（来自实际 Gateway 返回）：\n *\n * 1. user 消息:\n * {\n *   role: 'user',\n *   content: [{ type: 'text', text: '...' }],\n *   timestamp: number,\n *   senderLabel: string,\n * }\n *\n * 2. assistant 消息:\n * {\n *   role: 'assistant',\n *   content: [\n *     { type: 'text', text: '...' },                                       // 文本内容\n *     { type: 'toolCall', id: '...', name: '...', arguments: {...} },      // 工具调用\n *   ],\n *   api: string, provider: string, model: string,\n *   stopReason: 'stop' | 'toolUse' | 'aborted',\n *   timestamp: number,\n *   errorMessage?: string,\n *   openclawAbort?: { aborted: boolean, origin: string, runId: string },\n * }\n *\n * 3. toolResult 消息:\n * {\n *   role: 'toolResult',\n *   toolCallId: string,\n *   toolName: string,\n *   content: [{ type: 'text', text: '...' }],\n *   isError: boolean,\n *   timestamp: number,\n * }\n */\nimport type {\n  ChatMessagesData,\n  AIMessageContent,\n  TextContent,\n  UserMessage,\n  AIMessage,\n} from '../../type';\nimport { createToolCallContent } from '../shared';\nimport { generateUUID } from './utils';\n\n// ==================== OpenClaw 历史消息类型 ====================\n\n/**\n * OpenClaw 历史消息内容项\n */\nexport interface OpenClawHistoryContentItem {\n  type: string;\n  text?: string;\n  // toolCall 类型\n  id?: string;\n  name?: string;\n  arguments?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\n/**\n * OpenClaw 历史消息\n */\nexport interface OpenClawHistoryMessage {\n  role: 'user' | 'assistant' | 'toolResult' | 'system';\n  content?: OpenClawHistoryContentItem[] | string;\n  timestamp?: number;\n  senderLabel?: string;\n  // assistant 专有\n  api?: string;\n  provider?: string;\n  model?: string;\n  stopReason?: string;\n  errorMessage?: string;\n  openclawAbort?: {\n    aborted: boolean;\n    origin: string;\n    runId: string;\n  };\n  // toolResult 专有\n  toolCallId?: string;\n  toolName?: string;\n  isError?: boolean;\n}\n\n/**\n * OpenClaw sessions.history 响应\n */\nexport interface OpenClawHistoryResponse {\n  sessionKey: string;\n  sessionId: string;\n  messages: OpenClawHistoryMessage[];\n  thinkingLevel?: string;\n}\n\n// ==================== 转换器 ====================\n\n/**\n * 将 OpenClaw 历史消息数组转换为 ChatEngine 的 ChatMessagesData 数组\n *\n * 转换策略：\n * 1. user → UserMessage（直接映射文本内容）\n * 2. assistant → AIMessage（文本内容 + toolCall 转为 toolcall content）\n * 3. toolResult → 合并到前一个 assistant 消息的对应 toolcall 中作为 result\n * 4. 跳过空内容和被中止的消息\n * 5. 连续的 assistant 消息（stopReason: 'toolUse' 后跟 toolResult 再跟 assistant）\n *    会被合并为一条完整的 AIMessage\n *\n * @param messages OpenClaw 格式的历史消息数组\n * @param options 转换选项\n * @returns ChatEngine 格式的消息数组\n */\nexport function convertOpenClawHistory(\n  messages: OpenClawHistoryMessage[],\n  options?: ConvertHistoryOptions,\n): ChatMessagesData[] {\n  const result: ChatMessagesData[] = [];\n  const toolResultMap = new Map<string, { content: string; isError: boolean }>();\n\n  // 第一遍：收集所有 toolResult，建立 toolCallId → result 映射\n  for (const msg of messages) {\n    if (msg.role === 'toolResult' && msg.toolCallId) {\n      const text = extractTextFromContent(msg.content);\n      toolResultMap.set(msg.toolCallId, {\n        content: text,\n        isError: msg.isError ?? false,\n      });\n    }\n  }\n\n  // 第二遍：转换消息\n  // 用于追踪当前可合并的 assistant 消息\n  let pendingAIMessage: AIMessage | null = null;\n\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n\n    switch (msg.role) {\n      case 'user': {\n        // 先 flush 之前的 pending AI 消息\n        if (pendingAIMessage) {\n          result.push(pendingAIMessage);\n          pendingAIMessage = null;\n        }\n        const userMsg = convertUserMessage(msg);\n        if (userMsg) {\n          result.push(userMsg);\n        }\n        break;\n      }\n\n      case 'assistant': {\n        // 跳过被中止且无内容的消息\n        if (isAbortedEmpty(msg)) {\n          break;\n        }\n\n        const aiContents = convertAssistantContent(msg, toolResultMap, options);\n\n        if (aiContents.length === 0) {\n          break;\n        }\n\n        if (pendingAIMessage) {\n          // 合并到前一个 pending AI 消息中（多轮 tool loop 场景）\n          pendingAIMessage.content = [...(pendingAIMessage.content || []), ...aiContents];\n          // 更新 status\n          if (msg.stopReason === 'stop') {\n            pendingAIMessage.status = 'complete';\n          }\n        } else {\n          pendingAIMessage = {\n            id: generateUUID(),\n            role: 'assistant',\n            content: aiContents,\n            status: msg.stopReason === 'stop' ? 'complete' : 'complete',\n            datetime: msg.timestamp ? new Date(msg.timestamp).toISOString() : undefined,\n            ext: {\n              model: msg.model,\n              provider: msg.provider,\n            },\n          };\n        }\n\n        // 如果 stopReason 是 'stop'，flush 这个 AI 消息\n        // 如果是 'toolUse'，保持 pending 等待后续 toolResult + assistant 合并\n        if (msg.stopReason === 'stop' || msg.stopReason === 'aborted') {\n          if (pendingAIMessage) {\n            result.push(pendingAIMessage);\n            pendingAIMessage = null;\n          }\n        }\n        break;\n      }\n\n      case 'toolResult': {\n        // toolResult 已经在第一遍收集到 toolResultMap 中\n        // 它们会在 convertAssistantContent 时自动关联到对应的 toolCall\n        // 这里不需要额外处理\n        break;\n      }\n\n      case 'system': {\n        // flush pending\n        if (pendingAIMessage) {\n          result.push(pendingAIMessage);\n          pendingAIMessage = null;\n        }\n        const text = extractTextFromContent(msg.content);\n        if (text) {\n          result.push({\n            id: generateUUID(),\n            role: 'system',\n            content: [{ type: 'text', data: text, status: 'complete' }],\n            datetime: msg.timestamp ? new Date(msg.timestamp).toISOString() : undefined,\n          });\n        }\n        break;\n      }\n\n      default:\n        break;\n    }\n  }\n\n  // flush 最后一个 pending AI 消息\n  if (pendingAIMessage) {\n    result.push(pendingAIMessage);\n  }\n\n  return result;\n}\n\n/**\n * 从 OpenClaw sessions.history 响应体中提取并转换消息\n * 这是一个便捷方法，直接接受 RPC 响应的 payload\n */\nexport function convertOpenClawHistoryResponse(\n  response: OpenClawHistoryResponse,\n  options?: ConvertHistoryOptions,\n): ChatMessagesData[] {\n  return convertOpenClawHistory(response.messages || [], options);\n}\n\n// ==================== 转换选项 ====================\n\nexport interface ConvertHistoryOptions {\n  /**\n   * 是否将 toolCall 的详细参数和结果展示在 toolcall 组件中\n   * 默认 true\n   */\n  showToolCallDetails?: boolean;\n\n  /**\n   * 是否跳过被中止的消息\n   * 默认 true\n   */\n  skipAborted?: boolean;\n\n  /**\n   * 自定义 toolCall 渲染名映射\n   * 例如 { 'read': 'file_reader', 'exec': 'command_runner' }\n   */\n  toolCallNameMap?: Record<string, string>;\n}\n\n// ==================== 内部转换方法 ====================\n\n/**\n * 转换 user 消息\n */\nfunction convertUserMessage(msg: OpenClawHistoryMessage): UserMessage | null {\n  const text = extractTextFromContent(msg.content);\n  if (!text) return null;\n\n  return {\n    id: generateUUID(),\n    role: 'user',\n    content: [{ type: 'text', data: text }],\n    datetime: msg.timestamp ? new Date(msg.timestamp).toISOString() : undefined,\n  };\n}\n\n/**\n * 转换 assistant 消息的 content 数组为 AIMessageContent 数组\n */\nfunction convertAssistantContent(\n  msg: OpenClawHistoryMessage,\n  toolResultMap: Map<string, { content: string; isError: boolean }>,\n  options?: ConvertHistoryOptions,\n): AIMessageContent[] {\n  const contents: AIMessageContent[] = [];\n  const contentArr = normalizeContent(msg.content);\n\n  for (const item of contentArr) {\n    switch (item.type) {\n      case 'text': {\n        if (item.text) {\n          contents.push({\n            type: 'text',\n            data: item.text,\n            status: 'complete',\n          } as TextContent);\n        }\n        break;\n      }\n\n      case 'toolCall': {\n        // 将 OpenClaw 历史中的 toolCall 转换为 ChatEngine 的 toolcall content\n        const toolCallId = (item.id || '') as string;\n        const toolCallName = getToolCallName(item.name as string, options);\n        const rawArgs = item.arguments;\n        const argsStr = rawArgs ? (typeof rawArgs === 'string' ? rawArgs : JSON.stringify(rawArgs)) : '';\n\n        // 查找对应的 toolResult\n        const toolResult = toolResultMap.get(toolCallId);\n        const resultStr = toolResult?.content || '';\n\n        const toolCall = {\n          toolCallId,\n          toolCallName,\n          eventType: toolResult ? 'TOOL_CALL_RESULT' : 'TOOL_CALL_START',\n          parentMessageId: '',\n          args: argsStr,\n          result: resultStr,\n        };\n\n        const status = toolResult ? 'complete' : 'complete';\n        contents.push(createToolCallContent(toolCall, status, 'append'));\n        break;\n      }\n\n      default:\n        // 其他未知类型，尝试作为文本处理\n        if (item.text) {\n          contents.push({\n            type: 'text',\n            data: item.text,\n            status: 'complete',\n          } as TextContent);\n        }\n        break;\n    }\n  }\n\n  return contents;\n}\n\n/**\n * 从 content 中提取文本\n */\nfunction extractTextFromContent(content: OpenClawHistoryMessage['content']): string {\n  if (!content) return '';\n  if (typeof content === 'string') return content;\n  if (!Array.isArray(content)) return '';\n\n  return content\n    .filter((c) => c?.type === 'text' && c?.text)\n    .map((c) => c.text!)\n    .join('');\n}\n\n/**\n * 标准化 content 为数组\n */\nfunction normalizeContent(content: OpenClawHistoryMessage['content']): OpenClawHistoryContentItem[] {\n  if (!content) return [];\n  if (typeof content === 'string') {\n    return [{ type: 'text', text: content }];\n  }\n  if (Array.isArray(content)) return content;\n  return [];\n}\n\n/**\n * 获取映射后的工具名\n */\nfunction getToolCallName(name: string, options?: ConvertHistoryOptions): string {\n  if (options?.toolCallNameMap && name in options.toolCallNameMap) {\n    return options.toolCallNameMap[name];\n  }\n  return name || 'unknown';\n}\n\n/**\n * 判断消息是否为被中止的空消息\n */\nfunction isAbortedEmpty(msg: OpenClawHistoryMessage): boolean {\n  if (msg.stopReason === 'aborted' || msg.openclawAbort?.aborted) {\n    const contentArr = normalizeContent(msg.content);\n    // 如果内容为空或只有空文本\n    if (contentArr.length === 0) return true;\n    const hasContent = contentArr.some((c) => {\n      if (c.type === 'text' && c.text) return true;\n      if (c.type === 'toolCall') return true;\n      return false;\n    });\n    return !hasContent;\n  }\n  return false;\n}\n"],"names":["convertOpenClawHistory","messages","options","result","toolResultMap","Map","_iterator","_createForOfIteratorHelper","_step","s","n","done","msg","role","toolCallId","_msg$isError","text","extractTextFromContent","content","set","isError","err","e","f","pendingAIMessage","i","length","push","userMsg","convertUserMessage","isAbortedEmpty","aiContents","convertAssistantContent","concat","_toConsumableArray","stopReason","status","id","generateUUID","datetime","timestamp","Date","toISOString","ext","model","provider","type","data","convertOpenClawHistoryResponse","response","contents","contentArr","normalizeContent","_iterator2","_step2","item","toolCallName","getToolCallName","name","rawArgs","arguments","argsStr","JSON","stringify","toolResult","get","resultStr","toolCall","eventType","parentMessageId","args","createToolCallContent","Array","isArray","filter","c","map","join","toolCallNameMap","_msg$openclawAbort","openclawAbort","aborted","hasContent","some"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAoHgB,SAAAA,sBAAAA,CACdC,UACAC,OACoB,EAAA;EACpB,IAAMC,SAA6B,EAAC,CAAA;AAC9B,EAAA,IAAAC,aAAA,sBAAoBC,GAAmD,EAAA,CAAA;AAAA,EAAA,IAAAC,SAAA,GAAAC,0BAAA,CAG3DN,QAAU,CAAA;IAAAO,KAAA,CAAA;AAAA,EAAA,IAAA;IAA5B,KAAAF,SAAA,CAAAG,CAAA,EAAAD,EAAAA,CAAAA,CAAAA,KAAA,GAAAF,SAAA,CAAAI,CAAA,EAAAC,EAAAA,IAAA,GAA4B;AAAA,MAAA,IAAjBC;MACT,IAAIA,IAAI,CAAAC,IAAA,KAAS,YAAgB,IAAAD,IAAA,CAAIE,UAAY,EAAA;AAAA,QAAA,IAAAC,YAAA,CAAA;AACzC,QAAA,IAAAC,KAAA,GAAOC,sBAAuB,CAAAL,IAAA,CAAIM,OAAO,CAAA,CAAA;AACjCd,QAAAA,aAAA,CAAAe,GAAA,CAAIP,KAAIE,UAAY,EAAA;AAChCI,UAAAA,OAAS,EAAAF,KAAA;UACTI,OAAA,EAAA,CAAAL,YAAA,GAASH,KAAIQ,OAAW,MAAAL,IAAAA,IAAAA,YAAA,KAAAA,KAAAA,CAAAA,GAAAA,YAAA,GAAA,KAAA;AAC1B,SAAC,CAAA,CAAA;AACH,OAAA;AACF,KAAA;AAAA,GAAA,CAAA,OAAAM,GAAA,EAAA;IAAAf,SAAA,CAAAgB,CAAA,CAAAD,GAAA,CAAA,CAAA;AAAA,GAAA,SAAA;AAAAf,IAAAA,SAAA,CAAAiB,CAAA,EAAA,CAAA;AAAA,GAAA;EAIA,IAAIC,gBAAqC,GAAA,IAAA,CAAA;AAEzC,EAAA,KAAA,IAASC,CAAI,GAAA,CAAA,EAAGA,CAAI,GAAAxB,QAAA,CAASyB,QAAQD,CAAK,EAAA,EAAA;AACxC,IAAA,IAAMb,MAAMX,QAAS,CAAAwB,CAAA,CAAA,CAAA;IAErB,QAAQb,GAAI,CAAAC,IAAA;AAAA,MAAA,KACL,MAAQ;AAAA,QAAA;AAEX,UAAA,IAAIW,gBAAkB,EAAA;AACpBrB,YAAAA,MAAA,CAAOwB,KAAKH,gBAAgB,CAAA,CAAA;AACTA,YAAAA,gBAAA,GAAA,IAAA,CAAA;AACrB,WAAA;AACM,UAAA,IAAAI,OAAA,GAAUC,mBAAmBjB,GAAG,CAAA,CAAA;AACtC,UAAA,IAAIgB,OAAS,EAAA;AACXzB,YAAAA,MAAA,CAAOwB,KAAKC,OAAO,CAAA,CAAA;AACrB,WAAA;AACA,UAAA,MAAA;AACF,SAAA;AAAA,MAAA,KAEK,WAAa;AAAA,QAAA;AAEZ,UAAA,IAAAE,cAAA,CAAelB,GAAG,CAAG,EAAA;AACvB,YAAA,MAAA;AACF,WAAA;UAEA,IAAMmB,UAAa,GAAAC,uBAAA,CAAwBpB,GAAK,EAAAR,aAAA,EAAeF,OAAO,CAAA,CAAA;AAElE,UAAA,IAAA6B,UAAA,CAAWL,WAAW,CAAG,EAAA;AAC3B,YAAA,MAAA;AACF,WAAA;AAEA,UAAA,IAAIF,gBAAkB,EAAA;AAEHA,YAAAA,gBAAA,CAAAN,OAAA,GAAA,EAAA,CAAAe,MAAA,CAAAC,kBAAA,CAAeV,gBAAA,CAAiBN,WAAW,EAAC,CAAA,EAAAgB,kBAAA,CAAOH,UAAU,CAAA,CAAA,CAAA;AAE1E,YAAA,IAAAnB,GAAA,CAAIuB,eAAe,MAAQ,EAAA;cAC7BX,gBAAA,CAAiBY,MAAS,GAAA,UAAA,CAAA;AAC5B,aAAA;AACF,WAAO,MAAA;AACcZ,YAAAA,gBAAA,GAAA;cACjBa,IAAIC,YAAa,EAAA;AACjBzB,cAAAA,IAAM,EAAA,WAAA;AACNK,cAAAA,OAAS,EAAAa,UAAA;cACTK,MAAQ,EAAAxB,GAAA,CAAIuB,UAAe,KAAA,MAAA,GAAS,UAAa,GAAA,UAAA;AACjDI,cAAAA,QAAA,EAAU3B,IAAI4B,SAAY,GAAA,IAAIC,KAAK7B,GAAI,CAAA4B,SAAS,CAAE,CAAAE,WAAA,EAAgB,GAAA,KAAA,CAAA;AAClEC,cAAAA,GAAK,EAAA;gBACHC,OAAOhC,GAAI,CAAAgC,KAAA;gBACXC,UAAUjC,GAAI,CAAAiC,QAAAA;AAChB,eAAA;aACF,CAAA;AACF,WAAA;UAIA,IAAIjC,GAAI,CAAAuB,UAAA,KAAe,MAAU,IAAAvB,GAAA,CAAIuB,eAAe,SAAW,EAAA;AAC7D,YAAA,IAAIX,gBAAkB,EAAA;AACpBrB,cAAAA,MAAA,CAAOwB,KAAKH,gBAAgB,CAAA,CAAA;AACTA,cAAAA,gBAAA,GAAA,IAAA,CAAA;AACrB,aAAA;AACF,WAAA;AACA,UAAA,MAAA;AACF,SAAA;AAAA,MAAA,KAEK,YAAc;AAAA,QAAA;AAIjB,UAAA,MAAA;AACF,SAAA;AAAA,MAAA,KAEK,QAAU;AAAA,QAAA;AAEb,UAAA,IAAIA,gBAAkB,EAAA;AACpBrB,YAAAA,MAAA,CAAOwB,KAAKH,gBAAgB,CAAA,CAAA;AACTA,YAAAA,gBAAA,GAAA,IAAA,CAAA;AACrB,WAAA;AACM,UAAA,IAAAR,IAAA,GAAOC,sBAAuB,CAAAL,GAAA,CAAIM,OAAO,CAAA,CAAA;AAC/C,UAAA,IAAIF,IAAM,EAAA;YACRb,MAAA,CAAOwB,IAAK,CAAA;cACVU,IAAIC,YAAa,EAAA;AACjBzB,cAAAA,IAAM,EAAA,QAAA;AACNK,cAAAA,OAAA,EAAS,CAAC;AAAE4B,gBAAAA,IAAA,EAAM;AAAQC,gBAAAA,IAAM,EAAA/B,IAAA;AAAMoB,gBAAAA,MAAQ,EAAA,UAAA;AAAW,eAAC,CAAA;AAC1DG,cAAAA,QAAA,EAAU3B,IAAI4B,SAAY,GAAA,IAAIC,KAAK7B,GAAI,CAAA4B,SAAS,CAAE,CAAAE,WAAA,EAAgB,GAAA,KAAA,CAAA;AACpE,aAAC,CAAA,CAAA;AACH,WAAA;AACA,UAAA,MAAA;AACF,SAAA;AAAA,MAAA;AAGE,QAAA,MAAA;AAAA,KAAA;AAEN,GAAA;AAGA,EAAA,IAAIlB,gBAAkB,EAAA;AACpBrB,IAAAA,MAAA,CAAOwB,KAAKH,gBAAgB,CAAA,CAAA;AAC9B,GAAA;AAEO,EAAA,OAAArB,MAAA,CAAA;AACT,CAAA;AAMgB,SAAA6C,8BAAAA,CACdC,UACA/C,OACoB,EAAA;EACpB,OAAOF,sBAAuB,CAAAiD,QAAA,CAAShD,QAAY,IAAA,IAAIC,OAAO,CAAA,CAAA;AAChE,CAAA;AA6BA,SAAS2B,mBAAmBjB,GAAiD,EAAA;AACrE,EAAA,IAAAI,IAAA,GAAOC,sBAAuB,CAAAL,GAAA,CAAIM,OAAO,CAAA,CAAA;AAC/C,EAAA,IAAI,CAACF,IAAA,EAAa,OAAA,IAAA,CAAA;EAEX,OAAA;IACLqB,IAAIC,YAAa,EAAA;AACjBzB,IAAAA,IAAM,EAAA,MAAA;AACNK,IAAAA,SAAS,CAAC;AAAE4B,MAAAA,MAAM,MAAQ;AAAAC,MAAAA,IAAA,EAAM/B,IAAAA;AAAK,KAAC,CAAA;AACtCuB,IAAAA,QAAA,EAAU3B,IAAI4B,SAAY,GAAA,IAAIC,KAAK7B,GAAI,CAAA4B,SAAS,CAAE,CAAAE,WAAA,EAAgB,GAAA,KAAA,CAAA;GACpE,CAAA;AACF,CAAA;AAKA,SAASV,uBAAAA,CACPpB,GACA,EAAAR,aAAA,EACAF,OACoB,EAAA;EACpB,IAAMgD,WAA+B,EAAC,CAAA;AAChC,EAAA,IAAAC,UAAA,GAAaC,gBAAiB,CAAAxC,GAAA,CAAIM,OAAO,CAAA,CAAA;AAAA,EAAA,IAAAmC,UAAA,GAAA9C,0BAAA,CAE5B4C,UAAY,CAAA;IAAAG,MAAA,CAAA;AAAA,EAAA,IAAA;IAA/B,KAAAD,UAAA,CAAA5C,CAAA,EAAA6C,EAAAA,CAAAA,CAAAA,MAAA,GAAAD,UAAA,CAAA3C,CAAA,EAAAC,EAAAA,IAAA,GAA+B;AAAA,MAAA,IAApB4C;MACT,QAAQA,IAAK,CAAAT,IAAA;AAAA,QAAA,KACN,MAAQ;AAAA,UAAA;YACX,IAAIS,KAAKvC,IAAM,EAAA;cACbkC,QAAA,CAASvB,IAAK,CAAA;AACZmB,gBAAAA,IAAM,EAAA,MAAA;gBACNC,MAAMQ,IAAK,CAAAvC,IAAA;AACXoB,gBAAAA,MAAQ,EAAA,UAAA;AACV,eAAgB,CAAA,CAAA;AAClB,aAAA;AACA,YAAA,MAAA;AACF,WAAA;AAAA,QAAA,KAEK,UAAY;AAAA,UAAA;AAET,YAAA,IAAAtB,UAAA,GAAcyC,KAAKlB,EAAM,IAAA,EAAA,CAAA;YAC/B,IAAMmB,YAAe,GAAAC,eAAA,CAAgBF,IAAK,CAAAG,IAAA,EAAgBxD,OAAO,CAAA,CAAA;AACjE,YAAA,IAAMyD,UAAUJ,IAAK,CAAAK,SAAA,CAAA;AACf,YAAA,IAAAC,OAAA,GAAUF,UAAW,OAAOA,OAAA,KAAY,WAAWA,OAAU,GAAAG,IAAA,CAAKC,SAAU,CAAAJ,OAAO,CAAK,GAAA,EAAA,CAAA;AAGxF,YAAA,IAAAK,UAAA,GAAa5D,aAAc,CAAA6D,GAAA,CAAInD,UAAU,CAAA,CAAA;YACzC,IAAAoD,SAAA,GAAY,CAAAF,uBAAAA,iCAAAA,WAAY9C,OAAW,KAAA,EAAA,CAAA;AAEzC,YAAA,IAAMiD,QAAW,GAAA;AACfrD,cAAAA,UAAA,EAAAA,UAAA;AACA0C,cAAAA,YAAA,EAAAA,YAAA;AACAY,cAAAA,SAAA,EAAWJ,aAAa,kBAAqB,GAAA,iBAAA;AAC7CK,cAAAA,eAAiB,EAAA,EAAA;AACjBC,cAAAA,IAAM,EAAAT,OAAA;AACN1D,cAAAA,MAAQ,EAAA+D,SAAAA;aACV,CAAA;AAEM,YAAA,IAAA9B,MAAA,GAAS4B,aAAa,UAAa,GAAA,UAAA,CAAA;YACzCd,QAAA,CAASvB,IAAK,CAAA4C,qBAAA,CAAsBJ,QAAU,EAAA/B,MAAA,EAAQ,QAAQ,CAAC,CAAA,CAAA;AAC/D,YAAA,MAAA;AACF,WAAA;AAAA,QAAA;UAIE,IAAImB,KAAKvC,IAAM,EAAA;YACbkC,QAAA,CAASvB,IAAK,CAAA;AACZmB,cAAAA,IAAM,EAAA,MAAA;cACNC,MAAMQ,IAAK,CAAAvC,IAAA;AACXoB,cAAAA,MAAQ,EAAA,UAAA;AACV,aAAgB,CAAA,CAAA;AAClB,WAAA;AACA,UAAA,MAAA;AAAA,OAAA;AAEN,KAAA;AAAA,GAAA,CAAA,OAAAf,GAAA,EAAA;IAAAgC,UAAA,CAAA/B,CAAA,CAAAD,GAAA,CAAA,CAAA;AAAA,GAAA,SAAA;AAAAgC,IAAAA,UAAA,CAAA9B,CAAA,EAAA,CAAA;AAAA,GAAA;AAEO,EAAA,OAAA2B,QAAA,CAAA;AACT,CAAA;AAKA,SAASjC,uBAAuBC,OAAoD,EAAA;AAClF,EAAA,IAAI,CAACA,OAAA,EAAgB,OAAA,EAAA,CAAA;AACrB,EAAA,IAAI,OAAOA,OAAY,KAAA,QAAA,EAAiB,OAAAA,OAAA,CAAA;EACpC,IAAA,CAACsD,KAAM,CAAAC,OAAA,CAAQvD,OAAO,CAAA,EAAU,OAAA,EAAA,CAAA;AAEpC,EAAA,OAAOA,QACJwD,MAAO,CAAA,UAACC,CAAM,EAAA;AAAA,IAAA,OAAA,CAAAA,CAAA,KAAA,IAAA,IAAAA,CAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAAA,CAAA,CAAG7B,UAAS,MAAU,KAAA6B,CAAA,KAAA,IAAA,IAAAA,CAAA,KAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,CAAA,CAAG3D,IAAI,CAAA,CAAA;AAAA,GAAA,CAAA,CAC3C4D,IAAI,UAACD,CAAA,EAAA;IAAA,OAAMA,EAAE3D,IAAK,CAAA;AAAA,GAAA,CAAA,CAClB6D,KAAK,EAAE,CAAA,CAAA;AACZ,CAAA;AAKA,SAASzB,iBAAiBlC,OAA0E,EAAA;AAClG,EAAA,IAAI,CAACA,OAAA,EAAS,OAAO,EAAC,CAAA;AAClB,EAAA,IAAA,OAAOA,YAAY,QAAU,EAAA;AAC/B,IAAA,OAAO,CAAC;AAAE4B,MAAAA,IAAA,EAAM,MAAQ;AAAA9B,MAAAA,IAAA,EAAME,OAAAA;AAAQ,KAAC,CAAA,CAAA;AACzC,GAAA;EACI,IAAAsD,KAAA,CAAMC,QAAQvD,OAAO,CAAA,EAAU,OAAAA,OAAA,CAAA;AACnC,EAAA,OAAO,EAAC,CAAA;AACV,CAAA;AAKA,SAASuC,eAAAA,CAAgBC,MAAcxD,OAAyC,EAAA;AAC9E,EAAA,IAAIA,OAAS,KAAA,IAAA,IAATA,OAAS,KAAA,KAAA,CAAA,IAATA,OAAS,CAAA4E,eAAA,IAAmBpB,IAAQ,IAAAxD,OAAA,CAAQ4E,eAAiB,EAAA;AAC/D,IAAA,OAAO5E,QAAQ4E,eAAgB,CAAApB,IAAA,CAAA,CAAA;AACjC,GAAA;EACA,OAAOA,IAAQ,IAAA,SAAA,CAAA;AACjB,CAAA;AAKA,SAAS5B,eAAelB,GAAsC,EAAA;AAAA,EAAA,IAAAmE,kBAAA,CAAA;AAC5D,EAAA,IAAInE,GAAI,CAAAuB,UAAA,KAAe,SAAa,KAAA4C,kBAAA,GAAAnE,GAAA,CAAIoE,4DAAJD,kBAAA,CAAmBE,OAAS,EAAA;AACxD,IAAA,IAAA9B,UAAA,GAAaC,gBAAiB,CAAAxC,GAAA,CAAIM,OAAO,CAAA,CAAA;AAE/C,IAAA,IAAIiC,WAAWzB,MAAW,KAAA,CAAA,EAAU,OAAA,IAAA,CAAA;IACpC,IAAMwD,UAAa,GAAA/B,UAAA,CAAWgC,IAAK,CAAA,UAACR,CAAM,EAAA;MACpC,IAAAA,CAAA,CAAE7B,IAAS,KAAA,MAAA,IAAU6B,CAAE,CAAA3D,IAAA,EAAa,OAAA,IAAA,CAAA;AACxC,MAAA,IAAI2D,EAAE7B,IAAS,KAAA,UAAA,EAAmB,OAAA,IAAA,CAAA;AAC3B,MAAA,OAAA,KAAA,CAAA;AACT,KAAC,CAAA,CAAA;AACD,IAAA,OAAO,CAACoC,UAAA,CAAA;AACV,GAAA;AACO,EAAA,OAAA,KAAA,CAAA;AACT;;;;"}

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

@@ -11,9 +11,11 @@ import EventEmitter from '../../utils/eventEmitter';
 import type { AIMessageContent, ChatRequestParams, SSEChunkData } from '../../type';
 import type { OpenClawConfig } from './types';
 import { OpenClawConnectionState } from './types/events';
+import { type ConvertHistoryOptions } from './history-converter';
 export * from './types';
 export { OpenClawEventMapper, type EventMapResult } from './event-mapper';
 export { OpenClawRPCHandler, RPCError } from './rpc-handler';
+export { convertOpenClawHistory, convertOpenClawHistoryResponse, type OpenClawHistoryMessage, type OpenClawHistoryResponse, type ConvertHistoryOptions, } from './history-converter';
 /**
  * OpenClaw 适配器回调接口
  */
@@ -30,6 +32,14 @@ export interface OpenClawAdapterCallbacks {
     onError?: (error: Error) => void;
     /** 消息内容更新 */
     onMessage?: (content: AIMessageContent | AIMessageContent[]) => void;
+    /**
+     * 历史消息加载完成
+     *
+     * OpenClaw Gateway 在 connect 响应中可能附带历史消息（messages 字段），
+     * 当检测到历史消息时，适配器会自动将其转换为 ChatEngine 格式并触发此回调。
+     * 上层可以通过 chatEngine.setMessages(messages, 'replace') 回填到对话界面。
+     */
+    onHistoryLoaded?: (messages: import('../../type').ChatMessagesData[]) => void;
 }
 /**
  * OpenClaw 适配器配置
@@ -115,6 +125,23 @@ export declare class OpenClawAdapter extends EventEmitter {
         action: string;
         payload: unknown;
     }): Promise<unknown>;
+    /**
+     * 获取会话历史消息
+     *
+     * 通过 OpenClaw 的 sessions.history RPC 方法获取指定会话的历史消息，
+     * 并自动转换为 ChatEngine 的 ChatMessagesData 格式。
+     *
+     * @param sessionKey - 会话标识
+     * @param options - 转换选项
+     * @returns ChatEngine 格式的消息数组，可直接传给 chatEngine.setMessages() 或 useChat 的 defaultMessages
+     *
+     * @example
+     * ```tsx
+     * const messages = await adapter.fetchHistory('agent:main:main');
+     * chatEngine.setMessages(messages, 'replace');
+     * ```
+     */
+    fetchHistory(sessionKey: string, options?: ConvertHistoryOptions): Promise<import('../../type').ChatMessagesData[]>;
     /**
      * 断开连接
      */
@@ -153,6 +180,9 @@ export declare class OpenClawAdapter extends EventEmitter {
     private handleEventFrame;
     /**
      * 处理连接挑战（握手）
+     *
+     * 认证成功后，如果 connect 响应中包含 messages 字段（历史消息），
+     * 会自动转换为 ChatEngine 格式并触发 onHistoryLoaded 回调。
      */
     private handleConnectChallenge;
 }