@blueking/chat-helper 0.0.12-beta.2 → 0.0.12-beta.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,11 @@
1
- import type { IFlowAgentResultCustomValue } from '../event/type';
1
+ import type { IArtifactsGeneratedCustomValue, IFlowAgentResultCustomValue, IRunFinishedEvent } from '../event/type';
2
2
  export declare enum ActivityType {
3
+ ArtifactsGenerated = "artifacts_generated",
3
4
  FlowAgent = "flow_agent",
4
5
  KnowledgeRag = "knowledge_rag",
5
- ReferenceDocument = "reference_document"
6
+ ReferenceDocument = "reference_document",
7
+ Info = "info",
8
+ Interrupt = "interrupt"
6
9
  }
7
10
  export declare enum MessageRole {
8
11
  Activity = "activity",
@@ -25,7 +28,8 @@ export declare enum MessageRole {
25
28
  TemplateSystem = "template-system",
26
29
  TemplateUser = "template-user",
27
30
  Tool = "tool",
28
- User = "user"
31
+ User = "user",
32
+ Interrupt = "interrupt"
29
33
  }
30
34
  export declare enum MessageStatus {
31
35
  Complete = "complete",
@@ -39,14 +43,27 @@ export declare enum MessageType {
39
43
  Function = "function",
40
44
  Text = "text"
41
45
  }
46
+ export declare enum UserOperation {
47
+ FlowNodeRetry = "flow_node_retry",
48
+ FlowNodeSkip = "flow_node_skip",
49
+ ApprovalCancel = "approval_cancel"
50
+ }
51
+ export type IUserOperationPayload = {
52
+ node_id: string;
53
+ task_id: string;
54
+ } | {
55
+ interrupt_id: number | string;
56
+ };
42
57
  export interface IActivityMessage extends IBaseMessage {
43
58
  activityType: ActivityType;
44
- content: IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
59
+ content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
60
+ property?: IMessageProperty;
45
61
  role: MessageRole.Activity;
46
62
  }
47
63
  export interface IActivityMessageApi extends IBaseMessageApi {
48
64
  activity_type: ActivityType;
49
- content: IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
65
+ content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
66
+ property?: IMessageProperty;
50
67
  role: MessageRole.Activity;
51
68
  }
52
69
  export interface IAssistantMessage extends IBaseMessage {
@@ -62,6 +79,8 @@ export interface IAssistantMessageApi extends IBaseMessageApi {
62
79
  tool_calls?: IToolCallApi[];
63
80
  }
64
81
  export interface IBaseMessage {
82
+ /** 消息创建时间(ISO 字符串),用于前端展示 */
83
+ createdAt?: string;
65
84
  id?: string;
66
85
  messageId?: string;
67
86
  name?: string;
@@ -70,6 +89,7 @@ export interface IBaseMessage {
70
89
  status: MessageStatus;
71
90
  }
72
91
  export interface IBaseMessageApi {
92
+ created_at?: string;
73
93
  id?: string;
74
94
  message_id?: string;
75
95
  name?: string;
@@ -77,6 +97,13 @@ export interface IBaseMessageApi {
77
97
  session_code?: string;
78
98
  status: MessageStatus;
79
99
  }
100
+ /** 同时兼容 REST `created_at` 与前端 / AG-UI `createdAt` */
101
+ export declare const resolveMessageCreatedAt: (data: {
102
+ createdAt?: string;
103
+ created_at?: string;
104
+ }) => string | undefined;
105
+ /** RUN_FINISHED.timestamp 为毫秒时间戳,转成与 REST created_at 一致的 ISO 字符串 */
106
+ export declare const formatEventTimestampToCreatedAt: (timestamp?: number) => string | undefined;
80
107
  export interface IBinaryInputContent {
81
108
  data?: string;
82
109
  filename?: string;
@@ -109,6 +136,14 @@ export interface IDeveloperMessageApi extends IBaseMessageApi {
109
136
  content: string;
110
137
  role: MessageRole.Developer;
111
138
  }
139
+ export interface IInterruptMessage extends IBaseMessage {
140
+ content: IRunFinishedEvent;
141
+ role: MessageRole.Interrupt;
142
+ }
143
+ export interface IInterruptMessageApi extends IBaseMessageApi {
144
+ content: IRunFinishedEvent;
145
+ role: MessageRole.Interrupt;
146
+ }
112
147
  export interface IFlowAgentTaskNodeInfo {
113
148
  inputs: Record<string, unknown>;
114
149
  node_id: string;
@@ -228,8 +263,18 @@ export interface IKnowledgeRagApi {
228
263
  content: string;
229
264
  reference_document: IReferenceDocumentApi;
230
265
  }
231
- export type IMessage = IActivityMessage | IAssistantMessage | IDeveloperMessage | IGuideMessage | IHiddenAssistantMessage | IHiddenGuideMessage | IHiddenMessage | IHiddenSystemMessage | IHiddenUserMessage | IInfoMessage | IPauseMessage | IPlaceholderMessage | IReasoningMessage | ISystemMessage | ITemplateAssistantMessage | ITemplateGuideMessage | ITemplateHiddenMessage | ITemplateSystemMessage | ITemplateUserMessage | IToolMessage | IUserMessage;
232
- export type IMessageApi = IActivityMessageApi | IAssistantMessageApi | IDeveloperMessageApi | IGuideMessageApi | IHiddenAssistantMessageApi | IHiddenGuideMessageApi | IHiddenMessageApi | IHiddenSystemMessageApi | IHiddenUserMessageApi | IInfoMessageApi | IPauseMessageApi | IPlaceholderMessageApi | IReasoningMessageApi | ISystemMessageApi | ITemplateAssistantMessageApi | ITemplateGuideMessageApi | ITemplateHiddenMessageApi | ITemplateSystemMessageApi | ITemplateUserMessageApi | IToolMessageApi | IUserMessageApi;
266
+ 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;
267
+ 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;
268
+ export interface IMessageArtifact {
269
+ name: string;
270
+ outputId: string;
271
+ size: number;
272
+ type: string;
273
+ /** 事件不再下发;仅兼容旧数据 */
274
+ previewUrl?: string;
275
+ /** 事件不再下发;仅兼容旧数据 */
276
+ url?: string;
277
+ }
233
278
  /**
234
279
  * 消息属性 - 用于传递引用内容或快捷键相关信息
235
280
  * 该类型设计为灵活的结构,由外部调用方决定具体内容
@@ -237,6 +282,7 @@ export type IMessageApi = IActivityMessageApi | IAssistantMessageApi | IDevelope
237
282
  export interface IMessageProperty {
238
283
  /** 其他扩展字段 */
239
284
  [key: string]: unknown;
285
+ artifacts?: IMessageArtifact[];
240
286
  extra?: {
241
287
  /** 其他扩展字段 */
242
288
  [key: string]: unknown;
@@ -24,9 +24,12 @@
24
24
  * IN THE SOFTWARE.
25
25
  */ export var ActivityType;
26
26
  (function(ActivityType) {
27
+ ActivityType["ArtifactsGenerated"] = "artifacts_generated";
27
28
  ActivityType["FlowAgent"] = "flow_agent";
28
29
  ActivityType["KnowledgeRag"] = "knowledge_rag";
29
30
  ActivityType["ReferenceDocument"] = "reference_document";
31
+ ActivityType["Info"] = "info";
32
+ ActivityType["Interrupt"] = "interrupt";
30
33
  })(ActivityType || (ActivityType = {}));
31
34
  export var MessageRole;
32
35
  (function(MessageRole) {
@@ -51,6 +54,7 @@ export var MessageRole;
51
54
  MessageRole["TemplateUser"] = "template-user";
52
55
  MessageRole["Tool"] = "tool";
53
56
  MessageRole["User"] = "user";
57
+ MessageRole["Interrupt"] = "interrupt";
54
58
  })(MessageRole || (MessageRole = {}));
55
59
  export var MessageStatus;
56
60
  (function(MessageStatus) {
@@ -66,3 +70,23 @@ export var MessageType;
66
70
  MessageType["Function"] = "function";
67
71
  MessageType["Text"] = "text";
68
72
  })(MessageType || (MessageType = {}));
73
+ export var UserOperation;
74
+ (function(UserOperation) {
75
+ UserOperation["FlowNodeRetry"] = "flow_node_retry";
76
+ UserOperation["FlowNodeSkip"] = "flow_node_skip";
77
+ UserOperation["ApprovalCancel"] = "approval_cancel";
78
+ })(UserOperation || (UserOperation = {}));
79
+ /** 同时兼容 REST `created_at` 与前端 / AG-UI `createdAt` */ export const resolveMessageCreatedAt = (data)=>{
80
+ var _data_createdAt;
81
+ return (_data_createdAt = data.createdAt) !== null && _data_createdAt !== void 0 ? _data_createdAt : data.created_at;
82
+ };
83
+ /** RUN_FINISHED.timestamp 为毫秒时间戳,转成与 REST created_at 一致的 ISO 字符串 */ export const formatEventTimestampToCreatedAt = (timestamp)=>{
84
+ if (typeof timestamp !== 'number' || !Number.isFinite(timestamp)) {
85
+ return undefined;
86
+ }
87
+ const date = new Date(timestamp);
88
+ if (Number.isNaN(date.getTime())) {
89
+ return undefined;
90
+ }
91
+ return date.toISOString();
92
+ };