@blueking/chat-helper 0.0.12-beta.20 → 0.0.12-beta.22

package/dist/agent/use-agent.d.ts

@@ -124,6 +124,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                 };
                 role: MessageRole.Activity;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -167,6 +168,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     id: string;
                     type: import("../message").MessageType.Function;
                 }[];
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -175,6 +177,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Developer;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -183,6 +186,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Guide;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -191,6 +195,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenAssistant;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -199,6 +204,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenGuide;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -207,6 +213,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Hidden;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -215,6 +222,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenSystem;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -223,6 +231,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenUser;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -231,6 +240,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Info;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -239,6 +249,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Pause;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -247,6 +258,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Placeholder;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -256,6 +268,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 content: string[];
                 duration?: number;
                 role: MessageRole.Reasoning;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -264,6 +277,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.System;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -272,6 +286,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateAssistant;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -280,6 +295,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateGuide;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -288,6 +304,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateHidden;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -296,6 +313,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateSystem;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -304,6 +322,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateUser;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -315,6 +334,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 error?: string;
                 role: MessageRole.Tool;
                 toolCallId: string;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -358,6 +378,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                 };
                 role: MessageRole.User;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -988,6 +1009,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     timestamp?: number;
                 };
                 role: MessageRole.Interrupt;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1112,6 +1134,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                 };
                 role: MessageRole.Activity;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1155,6 +1178,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     id: string;
                     type: import("../message").MessageType.Function;
                 }[];
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1163,6 +1187,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Developer;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1171,6 +1196,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Guide;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1179,6 +1205,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenAssistant;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1187,6 +1214,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenGuide;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1195,6 +1223,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Hidden;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1203,6 +1232,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenSystem;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1211,6 +1241,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.HiddenUser;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1219,6 +1250,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Info;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1227,6 +1259,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Pause;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1235,6 +1268,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.Placeholder;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1244,6 +1278,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 content: string[];
                 duration?: number;
                 role: MessageRole.Reasoning;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1252,6 +1287,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.System;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1260,6 +1296,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateAssistant;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1268,6 +1305,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateGuide;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1276,6 +1314,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateHidden;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1284,6 +1323,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateSystem;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1292,6 +1332,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
             } | {
                 content: string;
                 role: MessageRole.TemplateUser;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1303,6 +1344,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                 error?: string;
                 role: MessageRole.Tool;
                 toolCallId: string;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1346,6 +1388,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                 };
                 role: MessageRole.User;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;
@@ -1976,6 +2019,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     timestamp?: number;
                 };
                 role: MessageRole.Interrupt;
+                createdAt?: string;
                 id?: string;
                 messageId?: string;
                 name?: string;

package/dist/event/ag-ui.d.ts

@@ -71,7 +71,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
     handleKnowledgeRagTextContentCustomEvent(event: ICustomEvent): void;
     /**
      * 处理消息快照事件
-     * 用于同步多端消息状态
+     * 用于同步多端消息状态；chat_completion 首帧会全量返回历史消息（含 created_at）
      */
     handleMessagesSnapshotEvent(event: IMessagesSnapshotEvent): void;
     /**

package/dist/event/ag-ui.ts.js

@@ -35,7 +35,46 @@
     }
     return obj;
 }
-import { ActivityType, MessageRole, MessageStatus, MessageType } from '../message/index.ts.js';
+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;
+}
+import { ActivityType, MessageRole, MessageStatus, MessageType, formatEventTimestampToCreatedAt, resolveMessageCreatedAt } from '../message/index.ts.js';
 import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } from './type.ts.js';
 /**
  * AGUI 协议
@@ -242,10 +281,10 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
     }
     /**
    * 处理消息快照事件
-   * 用于同步多端消息状态
+   * 用于同步多端消息状态；chat_completion 首帧会全量返回历史消息（含 created_at）
    */ handleMessagesSnapshotEvent(event) {
         if (event.messages && event.messages.length > 0) {
-            this.messageModule.list.value = event.messages;
+            this.messageModule.list.value = event.messages.map(normalizeSnapshotMessage);
         }
     }
     /**
@@ -284,17 +323,24 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
    * 处理运行完成事件
    */ handleRunFinishedEvent(event) {
         var _event_outcome, _event_outcome1;
+        const createdAt = formatEventTimestampToCreatedAt(event.timestamp);
         const message = this.messageModule.getCurrentLoadingMessage();
         if (message) {
             message.status = MessageStatus.Complete;
         }
+        // 本轮流式消息在落库前没有 createdAt，用 RUN_FINISHED.timestamp 转成 ISO 后补上；已有时间的历史消息不覆盖
+        if (createdAt) {
+            applyCreatedAtToCurrentRun(this.messageModule.list.value, createdAt);
+        }
         // 如果是中断消息，则创建一个中断消息
         if (((_event_outcome = event.outcome) === null || _event_outcome === void 0 ? void 0 : _event_outcome.type) === RunFinishedOutcomeType.Interrupt) {
-            this.messageModule.plusMessage({
+            this.messageModule.plusMessage(_object_spread({
                 role: MessageRole.Interrupt,
                 content: event,
                 status: MessageStatus.Pending
-            });
+            }, createdAt ? {
+                createdAt
+            } : {}));
         }
         // 二次返回，直接更新消息内容
         if (((_event_outcome1 = event.outcome) === null || _event_outcome1 === void 0 ? void 0 : _event_outcome1.type) === RunFinishedOutcomeType.Success && (message === null || message === void 0 ? void 0 : message.role) === MessageRole.Interrupt) {
@@ -618,3 +664,18 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
         this.onStartCallback = params === null || params === void 0 ? void 0 : params.onStart;
     }
 }
+/** chat_completion 快照可能是 camelCase 或 REST snake_case，统一落到 createdAt */ function normalizeSnapshotMessage(message) {
+    const createdAt = resolveMessageCreatedAt(message);
+    return createdAt ? _object_spread_props(_object_spread({}, message), {
+        createdAt
+    }) : message;
+}
+/** 从列表尾部向前，给本轮尚未带时间的消息补 createdAt，遇到已有时间的历史消息即停 */ function applyCreatedAtToCurrentRun(messages, createdAt) {
+    for(let index = messages.length - 1; index >= 0; index--){
+        const item = messages[index];
+        if (item.createdAt) {
+            break;
+        }
+        item.createdAt = createdAt;
+    }
+}

package/dist/event/type.d.ts

@@ -122,6 +122,7 @@ export interface IArtifactsGeneratedCustomValue {
     status: 'complete' | 'empty';
 }
 export interface IBaseEvent {
+    /** 事件时间，毫秒时间戳；RUN_FINISHED 会转成 ISO 字符串写入消息 createdAt */
     timestamp?: number;
     type: EventType;
 }

package/dist/http/transform/message.ts.js

@@ -74,20 +74,23 @@ function _object_spread_props(target, source) {
     }
     return target;
 }
-import { ActivityType, MessageRole, MessageType } from '../../message/type.ts.js';
+import { ActivityType, MessageRole, MessageType, resolveMessageCreatedAt } from '../../message/type.ts.js';
 /**
  * 将 API 返回的消息数据转换为前端使用的消息数据
  * @param data API 返回的消息数据
  * @returns 前端使用的消息数据
  */ export const transferMessageApi2Message = (data)=>{
-    const baseMessage = {
+    const createdAt = resolveMessageCreatedAt(data);
+    const baseMessage = _object_spread_props(_object_spread({}, createdAt ? {
+        createdAt
+    } : {}), {
         id: data.id,
         messageId: data.message_id,
         name: data.name,
         role: data.role,
         sessionCode: data.session_code,
         status: data.status
-    };
+    });
     // 处理不同类型的消息
     switch(data.role){
         case MessageRole.Activity:
@@ -351,14 +354,17 @@ import { ActivityType, MessageRole, MessageType } from '../../message/type.ts.js
  * @param data 前端使用的消息数据
  * @returns API 使用的消息数据
  */ export const transferMessage2MessageApi = (data)=>{
-    const baseMessage = {
+    const createdAt = resolveMessageCreatedAt(data);
+    const baseMessage = _object_spread_props(_object_spread({}, createdAt ? {
+        created_at: createdAt
+    } : {}), {
         id: data.id,
         message_id: data.messageId,
         name: data.name,
         role: data.role,
         session_code: data.sessionCode,
         status: data.status
-    };
+    });
     // 处理不同类型的消息
     switch(data.role){
         case MessageRole.Activity: