@ant-design/agentic-ui 2.30.21 → 2.30.23

package/dist/Bubble/OpenAIMessageBubble/mapOpenAIMessages.js

@@ -0,0 +1,156 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+var DEFAULT_TOOL_ROLE = 'assistant';
+/** @internal exported for OpenClaw 归一化复用 */ export function extractTextFromContent(content) {
+    if (content === undefined || content === null) {
+        return '';
+    }
+    if (typeof content === 'string') {
+        return content;
+    }
+    var parts = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = content[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var part = _step.value;
+            if (part.type === 'text' && typeof part.text === 'string') {
+                parts.push(part.text);
+                continue;
+            }
+            if ('refusal' in part && typeof part.refusal === 'string') {
+                parts.push(part.refusal);
+                continue;
+            }
+            if (part.type === 'image_url') {
+                parts.push('[image]');
+                continue;
+            }
+            parts.push("[".concat(part.type, "]"));
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return parts.join('\n');
+}
+function mapOpenAIRoleToRoleType(msg, toolRoleAs) {
+    switch(msg.role){
+        case 'user':
+            return 'user';
+        case 'system':
+            return 'system';
+        case 'assistant':
+            return 'assistant';
+        case 'tool':
+        case 'function':
+            return toolRoleAs;
+        default:
+            return 'assistant';
+    }
+}
+function appendAssistantExtras(msg, base, appendToolCalls) {
+    var _msg_tool_calls;
+    if (!appendToolCalls) {
+        return base;
+    }
+    var out = base;
+    if ((_msg_tool_calls = msg.tool_calls) === null || _msg_tool_calls === void 0 ? void 0 : _msg_tool_calls.length) {
+        out += "\n\n[tool_calls]\n".concat(JSON.stringify(msg.tool_calls, null, 2));
+    }
+    if (msg.function_call) {
+        out += "\n\n[function_call]\n".concat(JSON.stringify(msg.function_call, null, 2));
+    }
+    return out;
+}
+function defaultGetMessageId(msg, index) {
+    var _msg_id;
+    return (_msg_id = msg.id) !== null && _msg_id !== void 0 ? _msg_id : "openai-msg-".concat(index);
+}
+/**
+ * 将 OpenAI Chat Completions 风格的 messages 转为 MessageBubbleData[]
+ */ export function mapOpenAIMessagesToMessageBubbleData(messages, options, mapMessage) {
+    var _ref = options !== null && options !== void 0 ? options : {}, _ref_baseTime = _ref.baseTime, baseTime = _ref_baseTime === void 0 ? Date.now() : _ref_baseTime, _ref_timeStepMs = _ref.timeStepMs, timeStepMs = _ref_timeStepMs === void 0 ? 1 : _ref_timeStepMs, _ref_bumpUpdateAtOnLastMessage = _ref.bumpUpdateAtOnLastMessage, bumpUpdateAtOnLastMessage = _ref_bumpUpdateAtOnLastMessage === void 0 ? false : _ref_bumpUpdateAtOnLastMessage, _ref_getMessageId = _ref.getMessageId, getMessageId = _ref_getMessageId === void 0 ? defaultGetMessageId : _ref_getMessageId, _ref_toolRoleAs = _ref.toolRoleAs, toolRoleAs = _ref_toolRoleAs === void 0 ? DEFAULT_TOOL_ROLE : _ref_toolRoleAs, _ref_appendToolCallsToContent = _ref.appendToolCallsToContent, appendToolCallsToContent = _ref_appendToolCallsToContent === void 0 ? true : _ref_appendToolCallsToContent, _ref_preserveRawInExtra = _ref.preserveRawInExtra, preserveRawInExtra = _ref_preserveRawInExtra === void 0 ? true : _ref_preserveRawInExtra;
+    var lastIndex = messages.length - 1;
+    return messages.map(function(msg, index) {
+        var id = getMessageId(msg, index);
+        var role = mapOpenAIRoleToRoleType(msg, toolRoleAs);
+        var createAt = baseTime + index * timeStepMs;
+        var updateAt = createAt;
+        if (bumpUpdateAtOnLastMessage && index === lastIndex) {
+            updateAt = Date.now();
+        }
+        var text = '';
+        if (msg.role === 'assistant') {
+            var a = msg;
+            text = extractTextFromContent(a.content);
+            text = appendAssistantExtras(a, text, appendToolCallsToContent);
+        } else if (msg.role === 'user' || msg.role === 'system') {
+            text = extractTextFromContent(msg.content);
+        } else if (msg.role === 'tool') {
+            var _msg_content;
+            var prefix = msg.tool_call_id ? "[tool_call_id: ".concat(msg.tool_call_id, "]\n") : '';
+            text = prefix + ((_msg_content = msg.content) !== null && _msg_content !== void 0 ? _msg_content : '');
+        } else if (msg.role === 'function') {
+            var _msg_content1;
+            var prefix1 = msg.name ? "[function: ".concat(msg.name, "]\n") : '';
+            text = prefix1 + ((_msg_content1 = msg.content) !== null && _msg_content1 !== void 0 ? _msg_content1 : '');
+        }
+        var originContent = text;
+        var extra = preserveRawInExtra ? {
+            openai: {
+                role: msg.role,
+                raw: msg
+            }
+        } : {};
+        var draft = _object_spread({
+            id: id,
+            role: role,
+            content: text,
+            originContent: originContent,
+            createAt: createAt,
+            updateAt: updateAt
+        }, Object.keys(extra).length ? {
+            extra: extra
+        } : {});
+        if (mapMessage) {
+            draft = mapMessage(msg, index, draft);
+        }
+        return draft;
+    });
+}

package/dist/Bubble/OpenAIMessageBubble/mapOpenClawMessages.d.ts

@@ -0,0 +1,8 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { OpenAIMessagesMapMessage } from './types';
+import type { OpenClawChatMessage, OpenClawMessagesMapOptions } from './openClawTypes';
+/**
+ * 将 OpenClaw 会话 / transcript 风格的 `messages` 转为 `MessageBubbleData[]`
+ *（内部先归一化为 OpenAI 形状再复用 {@link mapOpenAIMessagesToMessageBubbleData}）。
+ */
+export declare function mapOpenClawMessagesToMessageBubbleData(messages: OpenClawChatMessage[], options?: OpenClawMessagesMapOptions, mapMessage?: OpenAIMessagesMapMessage): MessageBubbleData[];

package/dist/Bubble/OpenAIMessageBubble/mapOpenClawMessages.js

@@ -0,0 +1,127 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _object_without_properties(source, excluded) {
+    if (source == null) return {};
+    var target = {}, sourceKeys, key, i;
+    if (typeof Reflect !== "undefined" && Reflect.ownKeys) {
+        sourceKeys = Reflect.ownKeys(source);
+        for(i = 0; i < sourceKeys.length; i++){
+            key = sourceKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+        return target;
+    }
+    target = _object_without_properties_loose(source, excluded);
+    if (Object.getOwnPropertySymbols) {
+        sourceKeys = Object.getOwnPropertySymbols(source);
+        for(i = 0; i < sourceKeys.length; i++){
+            key = sourceKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+    }
+    return target;
+}
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {}, sourceKeys = Object.getOwnPropertyNames(source), key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+import { mapOpenAIMessagesToMessageBubbleData } from "./mapOpenAIMessages";
+import { normalizeOpenClawMessagesToOpenAI } from "./normalizeOpenClawMessages";
+/**
+ * 将 OpenClaw 会话 / transcript 风格的 `messages` 转为 `MessageBubbleData[]`
+ *（内部先归一化为 OpenAI 形状再复用 {@link mapOpenAIMessagesToMessageBubbleData}）。
+ */ export function mapOpenClawMessagesToMessageBubbleData(messages, options, mapMessage) {
+    var openai = normalizeOpenClawMessagesToOpenAI(messages);
+    var _ref = options !== null && options !== void 0 ? options : {}, _ref_useOpenClawTimestamps = _ref.useOpenClawTimestamps, useOpenClawTimestamps = _ref_useOpenClawTimestamps === void 0 ? true : _ref_useOpenClawTimestamps, _ref_preserveOpenClawRawInExtra = _ref.preserveOpenClawRawInExtra, preserveOpenClawRawInExtra = _ref_preserveOpenClawRawInExtra === void 0 ? true : _ref_preserveOpenClawRawInExtra, rest = _object_without_properties(_ref, [
+        "useOpenClawTimestamps",
+        "preserveOpenClawRawInExtra"
+    ]);
+    if (!useOpenClawTimestamps && !preserveOpenClawRawInExtra && !mapMessage) {
+        return mapOpenAIMessagesToMessageBubbleData(openai, rest);
+    }
+    var innerMap = function innerMap(msg, index, draft) {
+        var d = draft;
+        var rawClaw = messages[index];
+        if (useOpenClawTimestamps && rawClaw && typeof rawClaw.timestamp === 'number' && Number.isFinite(rawClaw.timestamp)) {
+            d = _object_spread_props(_object_spread({}, d), {
+                createAt: rawClaw.timestamp,
+                updateAt: rawClaw.timestamp
+            });
+        }
+        if (preserveOpenClawRawInExtra && rawClaw) {
+            d = _object_spread_props(_object_spread({}, d), {
+                extra: _object_spread_props(_object_spread({}, d.extra), {
+                    openclaw: {
+                        raw: rawClaw
+                    }
+                })
+            });
+        }
+        if (mapMessage) {
+            d = mapMessage(msg, index, d);
+        }
+        return d;
+    };
+    return mapOpenAIMessagesToMessageBubbleData(openai, rest, innerMap);
+}

package/dist/Bubble/OpenAIMessageBubble/normalizeOllamaMessages.d.ts

@@ -0,0 +1,16 @@
+import type { OpenAIChatMessage } from './types';
+import type { OllamaChatMessage } from './ollamaTypes';
+/**
+ * 将单条 Ollama `ChatMessage` 转为 {@link OpenAIChatMessage}，供统一映射层使用。
+ */
+export declare function normalizeOllamaMessageToOpenAI(msg: OllamaChatMessage, options?: {
+    appendThinkingToContent?: boolean;
+    appendImagesPlaceholder?: boolean;
+}): OpenAIChatMessage;
+/**
+ * 批量将 Ollama `messages` 转为 OpenAI 形状
+ */
+export declare function normalizeOllamaMessagesToOpenAI(messages: OllamaChatMessage[], options?: {
+    appendThinkingToContent?: boolean;
+    appendImagesPlaceholder?: boolean;
+}): OpenAIChatMessage[];

package/dist/Bubble/OpenAIMessageBubble/normalizeOllamaMessages.js

@@ -0,0 +1,110 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function buildDisplayContent(msg, appendThinking, appendImagesPlaceholder) {
+    var _msg_content;
+    var text = (_msg_content = msg.content) !== null && _msg_content !== void 0 ? _msg_content : '';
+    if (appendThinking && msg.thinking) {
+        text += "".concat(text ? '\n\n' : '', "[thinking]\n").concat(msg.thinking);
+    }
+    if (appendImagesPlaceholder && msg.images && msg.images.length > 0) {
+        text += "".concat(text ? '\n\n' : '', "[images: ").concat(msg.images.length, " attached]");
+    }
+    return text;
+}
+/**
+ * 将单条 Ollama `ChatMessage` 转为 {@link OpenAIChatMessage}，供统一映射层使用。
+ */ export function normalizeOllamaMessageToOpenAI(msg, options) {
+    var appendThinking = (options === null || options === void 0 ? void 0 : options.appendThinkingToContent) !== false;
+    var appendImages = (options === null || options === void 0 ? void 0 : options.appendImagesPlaceholder) !== false;
+    var content = buildDisplayContent(msg, appendThinking, appendImages);
+    var base = {
+        id: msg.id
+    };
+    if (msg.role === 'assistant') {
+        var _msg_tool_calls;
+        return _object_spread(_object_spread_props(_object_spread({}, base), {
+            role: 'assistant',
+            content: content
+        }), ((_msg_tool_calls = msg.tool_calls) === null || _msg_tool_calls === void 0 ? void 0 : _msg_tool_calls.length) ? {
+            tool_calls: msg.tool_calls
+        } : {});
+    }
+    if (msg.role === 'tool') {
+        var prefix = msg.tool_name ? "[tool_name: ".concat(msg.tool_name, "]\n") : '';
+        return _object_spread(_object_spread_props(_object_spread({}, base), {
+            role: 'tool',
+            content: prefix + content
+        }), msg.tool_call_id ? {
+            tool_call_id: msg.tool_call_id
+        } : {}, msg.tool_name ? {
+            name: msg.tool_name
+        } : {});
+    }
+    if (msg.role === 'system') {
+        return _object_spread_props(_object_spread({}, base), {
+            role: 'system',
+            content: content
+        });
+    }
+    return _object_spread_props(_object_spread({}, base), {
+        role: 'user',
+        content: content
+    });
+}
+/**
+ * 批量将 Ollama `messages` 转为 OpenAI 形状
+ */ export function normalizeOllamaMessagesToOpenAI(messages, options) {
+    return messages.map(function(m) {
+        return normalizeOllamaMessageToOpenAI(m, options);
+    });
+}

package/dist/Bubble/OpenAIMessageBubble/normalizeOpenClawMessages.d.ts

@@ -0,0 +1,10 @@
+import type { OpenAIChatMessage } from './types';
+import type { OpenClawChatMessage } from './openClawTypes';
+/**
+ * 将单条 OpenClaw 风格消息转为可与 {@link mapOpenAIMessagesToMessageBubbleData} 兼容的 OpenAI 形状（`toolResult` → `tool`）。
+ */
+export declare function normalizeOpenClawMessageToOpenAI(msg: OpenClawChatMessage): OpenAIChatMessage;
+/**
+ * 批量将 OpenClaw transcript 消息转为 OpenAI Chat Completions 兼容结构
+ */
+export declare function normalizeOpenClawMessagesToOpenAI(messages: OpenClawChatMessage[]): OpenAIChatMessage[];

package/dist/Bubble/OpenAIMessageBubble/normalizeOpenClawMessages.js

@@ -0,0 +1,61 @@
+function _object_without_properties(source, excluded) {
+    if (source == null) return {};
+    var target = {}, sourceKeys, key, i;
+    if (typeof Reflect !== "undefined" && Reflect.ownKeys) {
+        sourceKeys = Reflect.ownKeys(source);
+        for(i = 0; i < sourceKeys.length; i++){
+            key = sourceKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+        return target;
+    }
+    target = _object_without_properties_loose(source, excluded);
+    if (Object.getOwnPropertySymbols) {
+        sourceKeys = Object.getOwnPropertySymbols(source);
+        for(i = 0; i < sourceKeys.length; i++){
+            key = sourceKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+    }
+    return target;
+}
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {}, sourceKeys = Object.getOwnPropertyNames(source), key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+import { extractTextFromContent } from "./mapOpenAIMessages";
+/**
+ * 将单条 OpenClaw 风格消息转为可与 {@link mapOpenAIMessagesToMessageBubbleData} 兼容的 OpenAI 形状（`toolResult` → `tool`）。
+ */ export function normalizeOpenClawMessageToOpenAI(msg) {
+    if (msg.role === 'toolResult') {
+        var m = msg;
+        var content = m.content === undefined || m.content === null ? '' : typeof m.content === 'string' ? m.content : extractTextFromContent(m.content);
+        return {
+            role: 'tool',
+            id: m.id,
+            name: m.name,
+            content: content,
+            tool_call_id: m.tool_call_id
+        };
+    }
+    var _ts = msg.timestamp, rest = _object_without_properties(msg, [
+        "timestamp"
+    ]);
+    return rest;
+}
+/**
+ * 批量将 OpenClaw transcript 消息转为 OpenAI Chat Completions 兼容结构
+ */ export function normalizeOpenClawMessagesToOpenAI(messages) {
+    return messages.map(normalizeOpenClawMessageToOpenAI);
+}

package/dist/Bubble/OpenAIMessageBubble/ollamaTypes.d.ts

@@ -0,0 +1,48 @@
+import type { OpenAIMessagesMapOptions } from './types';
+/**
+ * Ollama Chat API 中 ToolCall（见官方 OpenAPI `ToolCall`）
+ */
+export interface OllamaToolCall {
+    function?: {
+        name: string;
+        description?: string;
+        arguments?: Record<string, unknown>;
+    };
+    /** 部分实现会带 id */
+    id?: string;
+    type?: string;
+}
+/**
+ * Ollama POST /api/chat 请求体中的单条 `messages[]`（见官方 `ChatMessage`）
+ */
+export interface OllamaChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /** 流式片段可能为空字符串 */
+    content: string;
+    /** 客户端为稳定列表 key 可带 id */
+    id?: string;
+    /** 多模态：base64 图片列表 */
+    images?: string[];
+    /** assistant 上模型发起的工具调用 */
+    tool_calls?: OllamaToolCall[];
+    /** `think` 开启时的思考过程（流式或完整响应） */
+    thinking?: string;
+    /** `role: tool` 时常用，与 OpenAI 的 tool 名称对应 */
+    tool_name?: string;
+    tool_call_id?: string;
+}
+/** Ollama 映射选项 */
+export interface OllamaMessagesMapOptions extends OpenAIMessagesMapOptions {
+    /**
+     * 为 true（默认）时，将 `thinking` 拼入展示用正文（映射后的 OpenAI assistant 文本）
+     */
+    appendThinkingToContent?: boolean;
+    /**
+     * 为 true（默认）时，若有 `images`，在正文中追加占位说明（不嵌入 base64）
+     */
+    appendImagesPlaceholder?: boolean;
+    /**
+     * 为 true（默认）时，在 `extra.ollama.raw` 保留原始 Ollama 消息
+     */
+    preserveOllamaRawInExtra?: boolean;
+}

package/dist/Bubble/OpenAIMessageBubble/ollamaTypes.js

@@ -0,0 +1 @@
+/** Ollama 映射选项 */ export { };

package/dist/Bubble/OpenAIMessageBubble/openClawTypes.d.ts

@@ -0,0 +1,27 @@
+import type { OpenAIChatContentPart, OpenAIChatMessageAssistant, OpenAIChatMessageFunction, OpenAIChatMessageSystem, OpenAIChatMessageTool, OpenAIChatMessageUser, OpenAIMessagesMapOptions } from './types';
+/**
+ * OpenClaw 会话 / transcript 常见字段：毫秒时间戳
+ */
+export type OpenClawChatMeta = {
+    id?: string;
+    timestamp?: number;
+    name?: string;
+};
+/** OpenClaw transcript 中工具结果常用 `toolResult`，与 OpenAI 的 `tool` 对应 */
+export interface OpenClawChatMessageToolResult extends OpenClawChatMeta {
+    role: 'toolResult';
+    content: string | OpenAIChatContentPart[] | null;
+    tool_call_id?: string;
+}
+export type OpenClawChatMessage = (OpenAIChatMessageSystem & OpenClawChatMeta) | (OpenAIChatMessageUser & OpenClawChatMeta) | (OpenAIChatMessageAssistant & OpenClawChatMeta) | (OpenAIChatMessageTool & OpenClawChatMeta) | (OpenAIChatMessageFunction & OpenClawChatMeta) | OpenClawChatMessageToolResult;
+/** OpenClaw 映射选项（在 OpenAI 选项基础上增加 transcript 行为） */
+export interface OpenClawMessagesMapOptions extends OpenAIMessagesMapOptions {
+    /**
+     * 为 true（默认）时，若消息含 `timestamp`（毫秒），写入 `createAt` / `updateAt`
+     */
+    useOpenClawTimestamps?: boolean;
+    /**
+     * 为 true（默认）时，在 `extra.openclaw.raw` 保留原始 OpenClaw 消息
+     */
+    preserveOpenClawRawInExtra?: boolean;
+}

package/dist/Bubble/OpenAIMessageBubble/openClawTypes.js

@@ -0,0 +1 @@
+/** OpenClaw 映射选项（在 OpenAI 选项基础上增加 transcript 行为） */ export { };

package/dist/Bubble/OpenAIMessageBubble/types.d.ts

@@ -0,0 +1,71 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { RoleType } from '../../Types/common';
+/**
+ * OpenAI Chat Completions 风格的多段 content（与官方结构兼容，库内自建）
+ */
+export interface OpenAIChatTextPart {
+    type: 'text';
+    text: string;
+}
+export interface OpenAIChatRefusalPart {
+    type?: 'refusal';
+    refusal?: string;
+}
+/** 多模态等其它 part 以弱类型保留 */
+export interface OpenAIChatContentPartFallback {
+    type: string;
+    [key: string]: unknown;
+}
+export type OpenAIChatContentPart = OpenAIChatTextPart | OpenAIChatRefusalPart | OpenAIChatContentPartFallback;
+export interface OpenAIChatMessageBase {
+    id?: string;
+    name?: string;
+    tool_calls?: unknown[];
+    function_call?: {
+        name?: string;
+        arguments?: string;
+    } | null;
+}
+export interface OpenAIChatMessageSystem extends OpenAIChatMessageBase {
+    role: 'system';
+    content: string | null;
+}
+export interface OpenAIChatMessageUser extends OpenAIChatMessageBase {
+    role: 'user';
+    content: string | OpenAIChatContentPart[] | null;
+}
+export interface OpenAIChatMessageAssistant extends OpenAIChatMessageBase {
+    role: 'assistant';
+    content: string | OpenAIChatContentPart[] | null;
+    tool_calls?: unknown[];
+    function_call?: OpenAIChatMessageBase['function_call'];
+}
+export interface OpenAIChatMessageTool extends OpenAIChatMessageBase {
+    role: 'tool';
+    content: string | null;
+    tool_call_id?: string;
+}
+export interface OpenAIChatMessageFunction extends OpenAIChatMessageBase {
+    role: 'function';
+    content: string | null;
+    name?: string;
+}
+export type OpenAIChatMessage = OpenAIChatMessageSystem | OpenAIChatMessageUser | OpenAIChatMessageAssistant | OpenAIChatMessageTool | OpenAIChatMessageFunction;
+/** 单条映射覆盖 */
+export type OpenAIMessagesMapMessage = (msg: OpenAIChatMessage, index: number, draft: MessageBubbleData) => MessageBubbleData;
+export interface OpenAIMessagesMapOptions {
+    /** createAt / updateAt 基准（毫秒） */
+    baseTime?: number;
+    /** 第 i 条：createAt = baseTime + i * timeStepMs */
+    timeStepMs?: number;
+    /** 为 true 时最后一条的 updateAt 使用 Date.now()（流式可选） */
+    bumpUpdateAtOnLastMessage?: boolean;
+    /** 生成 MessageBubbleData.id，默认不用 content，避免 SSE 抖动 */
+    getMessageId?: (msg: OpenAIChatMessage, index: number) => string;
+    /** tool / function 行映射到的 RoleType */
+    toolRoleAs?: RoleType;
+    /** assistant 是否将 tool_calls 等拼入展示文案 */
+    appendToolCallsToContent?: boolean;
+    /** 在 extra.openai 中保留原始 role 与 raw */
+    preserveRawInExtra?: boolean;
+}

package/dist/Bubble/OpenAIMessageBubble/types.js

@@ -0,0 +1 @@
+export { };

package/dist/Bubble/OpenAIMessageBubble/useOllamaMessageBubbleData.d.ts

@@ -0,0 +1,7 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { OpenAIMessagesMapMessage } from './types';
+import type { OllamaChatMessage, OllamaMessagesMapOptions } from './ollamaTypes';
+/**
+ * 将 Ollama `/api/chat` 的 messages 转为 MessageBubbleData[]（与 {@link mapOllamaMessagesToMessageBubbleData} 一致，带 memo）。
+ */
+export declare function useOllamaMessageBubbleData(messages: OllamaChatMessage[], mapOptions?: OllamaMessagesMapOptions, mapMessage?: OpenAIMessagesMapMessage): MessageBubbleData[];