@blueking/chat-helper 0.0.12-beta.9 → 0.0.13-dev.1

package/dist/message/type.d.ts

@@ -1,8 +1,10 @@
-import type { IFlowAgentResultCustomValue, IRunFinishedEvent } from '../event/type';
+import type { IArtifactsGeneratedCustomValue, IFlowAgentResultCustomValue, IRunFinishedEvent } from '../event/type';
 export declare enum ActivityType {
+    ArtifactsGenerated = "artifacts_generated",
     FlowAgent = "flow_agent",
     KnowledgeRag = "knowledge_rag",
     ReferenceDocument = "reference_document",
+    Info = "info",
     Interrupt = "interrupt"
 }
 export declare enum MessageRole {
@@ -54,12 +56,14 @@ export type IUserOperationPayload = {
 };
 export interface IActivityMessage extends IBaseMessage {
     activityType: ActivityType;
-    content: IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
+    content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
+    property?: IMessageProperty;
     role: MessageRole.Activity;
 }
 export interface IActivityMessageApi extends IBaseMessageApi {
     activity_type: ActivityType;
-    content: IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
+    content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
+    property?: IMessageProperty;
     role: MessageRole.Activity;
 }
 export interface IAssistantMessage extends IBaseMessage {
@@ -75,6 +79,8 @@ export interface IAssistantMessageApi extends IBaseMessageApi {
     tool_calls?: IToolCallApi[];
 }
 export interface IBaseMessage {
+    /** 消息创建时间（ISO 字符串），用于前端展示 */
+    createdAt?: string;
     id?: string;
     messageId?: string;
     name?: string;
@@ -83,6 +89,7 @@ export interface IBaseMessage {
     status: MessageStatus;
 }
 export interface IBaseMessageApi {
+    created_at?: string;
     id?: string;
     message_id?: string;
     name?: string;
@@ -90,11 +97,21 @@ export interface IBaseMessageApi {
     session_code?: string;
     status: MessageStatus;
 }
+/** 同时兼容 REST `created_at` 与前端 / AG-UI `createdAt` */
+export declare const resolveMessageCreatedAt: (data: {
+    createdAt?: string;
+    created_at?: string;
+}) => string | undefined;
+/** RUN_FINISHED.timestamp 为毫秒时间戳，转成与 REST created_at 一致的 ISO 字符串 */
+export declare const formatEventTimestampToCreatedAt: (timestamp?: number) => string | undefined;
 export interface IBinaryInputContent {
     data?: string;
     filename?: string;
     id?: string;
     mimeType: string;
+    /** 上传接口返回的 path，文件在会话内的永久身份，用于引用、预览与下载 */
+    outputId?: string;
+    size?: number;
     type: MessageType.Binary;
     url?: string;
 }
@@ -103,6 +120,8 @@ export interface IBinaryInputContentApi {
     filename?: string;
     id?: string;
     mime_type: string;
+    output_id?: string;
+    size?: number;
     type: MessageType.Binary;
     url?: string;
 }
@@ -251,6 +270,16 @@ export interface IKnowledgeRagApi {
 }
 export type IMessage = IActivityMessage | IAssistantMessage | IDeveloperMessage | IGuideMessage | IHiddenAssistantMessage | IHiddenGuideMessage | IHiddenMessage | IHiddenSystemMessage | IHiddenUserMessage | IInfoMessage | IPauseMessage | IPlaceholderMessage | IReasoningMessage | ISystemMessage | ITemplateAssistantMessage | ITemplateGuideMessage | ITemplateHiddenMessage | ITemplateSystemMessage | ITemplateUserMessage | IToolMessage | IUserMessage | IInterruptMessage;
 export type IMessageApi = IActivityMessageApi | IAssistantMessageApi | IDeveloperMessageApi | IGuideMessageApi | IHiddenAssistantMessageApi | IHiddenGuideMessageApi | IHiddenMessageApi | IHiddenSystemMessageApi | IHiddenUserMessageApi | IInfoMessageApi | IPauseMessageApi | IPlaceholderMessageApi | IReasoningMessageApi | ISystemMessageApi | ITemplateAssistantMessageApi | ITemplateGuideMessageApi | ITemplateHiddenMessageApi | ITemplateSystemMessageApi | ITemplateUserMessageApi | IToolMessageApi | IUserMessageApi | IInterruptMessageApi;
+export interface IMessageArtifact {
+    name: string;
+    outputId: string;
+    size: number;
+    type: string;
+    /** 事件不再下发；仅兼容旧数据 */
+    previewUrl?: string;
+    /** 事件不再下发；仅兼容旧数据 */
+    url?: string;
+}
 /**
  * 消息属性 - 用于传递引用内容或快捷键相关信息
  * 该类型设计为灵活的结构，由外部调用方决定具体内容
@@ -258,6 +287,9 @@ export type IMessageApi = IActivityMessageApi | IAssistantMessageApi | IDevelope
 export interface IMessageProperty {
     /** 其他扩展字段 */
     [key: string]: unknown;
+    artifacts?: IMessageArtifact[];
+    /** 输入框富文本文档；承载资源引用协议，与 extra 同级。不导入 chat-x 类型 */
+    docSchema?: unknown;
     extra?: {
         /** 其他扩展字段 */
         [key: string]: unknown;

package/dist/message/type.ts.js

@@ -24,9 +24,11 @@
  * IN THE SOFTWARE.
  */ export var ActivityType;
 (function(ActivityType) {
+    ActivityType["ArtifactsGenerated"] = "artifacts_generated";
     ActivityType["FlowAgent"] = "flow_agent";
     ActivityType["KnowledgeRag"] = "knowledge_rag";
     ActivityType["ReferenceDocument"] = "reference_document";
+    ActivityType["Info"] = "info";
     ActivityType["Interrupt"] = "interrupt";
 })(ActivityType || (ActivityType = {}));
 export var MessageRole;
@@ -74,3 +76,17 @@ export var UserOperation;
     UserOperation["FlowNodeSkip"] = "flow_node_skip";
     UserOperation["ApprovalCancel"] = "approval_cancel";
 })(UserOperation || (UserOperation = {}));
+/** 同时兼容 REST `created_at` 与前端 / AG-UI `createdAt` */ export const resolveMessageCreatedAt = (data)=>{
+    var _data_createdAt;
+    return (_data_createdAt = data.createdAt) !== null && _data_createdAt !== void 0 ? _data_createdAt : data.created_at;
+};
+/** RUN_FINISHED.timestamp 为毫秒时间戳，转成与 REST created_at 一致的 ISO 字符串 */ export const formatEventTimestampToCreatedAt = (timestamp)=>{
+    if (typeof timestamp !== 'number' || !Number.isFinite(timestamp)) {
+        return undefined;
+    }
+    const date = new Date(timestamp);
+    if (Number.isNaN(date.getTime())) {
+        return undefined;
+    }
+    return date.toISOString();
+};