@blueking/chat-helper 0.0.12-beta.3 → 0.0.12-beta.31

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.
Files changed (37) hide show
  1. package/README.md +21 -7
  2. package/dist/agent/type.d.ts +82 -0
  3. package/dist/agent/type.ts.js +5 -1
  4. package/dist/agent/use-agent.d.ts +571 -360
  5. package/dist/agent/use-agent.ts.js +366 -26
  6. package/dist/event/ag-ui.d.ts +5 -2
  7. package/dist/event/ag-ui.ts.js +122 -24
  8. package/dist/event/type.d.ts +15 -3
  9. package/dist/event/type.ts.js +2 -0
  10. package/dist/http/fetch/fetch.spec.d.ts +1 -0
  11. package/dist/http/fetch/fetch.ts.js +106 -22
  12. package/dist/http/index.d.ts +13 -7
  13. package/dist/http/module/agent.d.ts +2 -0
  14. package/dist/http/module/agent.ts.js +19 -2
  15. package/dist/http/module/index.d.ts +13 -7
  16. package/dist/http/module/message.d.ts +3 -3
  17. package/dist/http/module/message.ts.js +4 -3
  18. package/dist/http/module/session.d.ts +10 -5
  19. package/dist/http/module/session.ts.js +60 -3
  20. package/dist/http/transform/agent.d.ts +9 -1
  21. package/dist/http/transform/agent.spec.d.ts +1 -0
  22. package/dist/http/transform/agent.ts.js +29 -0
  23. package/dist/http/transform/message.ts.js +17 -5
  24. package/dist/index.d.ts +3842 -2720
  25. package/dist/message/type.d.ts +32 -4
  26. package/dist/message/type.ts.js +17 -0
  27. package/dist/message/use-message.d.ts +685 -385
  28. package/dist/session/index.d.ts +1 -0
  29. package/dist/session/index.ts.js +2 -1
  30. package/dist/session/pv-file-upload.d.ts +7 -0
  31. package/dist/session/pv-file-upload.spec.d.ts +1 -0
  32. package/dist/session/pv-file-upload.ts.js +64 -0
  33. package/dist/session/type.d.ts +57 -0
  34. package/dist/session/use-session.d.ts +2539 -1933
  35. package/dist/session/use-session.spec.d.ts +1 -0
  36. package/dist/session/use-session.ts.js +117 -10
  37. package/package.json +4 -2
@@ -1,8 +1,11 @@
1
- import type { IFlowAgentResultCustomValue, IRunFinishedEvent } 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",
@@ -53,12 +56,14 @@ export type IUserOperationPayload = {
53
56
  };
54
57
  export interface IActivityMessage extends IBaseMessage {
55
58
  activityType: ActivityType;
56
- content: IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
59
+ content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
60
+ property?: IMessageProperty;
57
61
  role: MessageRole.Activity;
58
62
  }
59
63
  export interface IActivityMessageApi extends IBaseMessageApi {
60
64
  activity_type: ActivityType;
61
- content: IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
65
+ content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
66
+ property?: IMessageProperty;
62
67
  role: MessageRole.Activity;
63
68
  }
64
69
  export interface IAssistantMessage extends IBaseMessage {
@@ -74,6 +79,8 @@ export interface IAssistantMessageApi extends IBaseMessageApi {
74
79
  tool_calls?: IToolCallApi[];
75
80
  }
76
81
  export interface IBaseMessage {
82
+ /** 消息创建时间(ISO 字符串),用于前端展示 */
83
+ createdAt?: string;
77
84
  id?: string;
78
85
  messageId?: string;
79
86
  name?: string;
@@ -82,6 +89,7 @@ export interface IBaseMessage {
82
89
  status: MessageStatus;
83
90
  }
84
91
  export interface IBaseMessageApi {
92
+ created_at?: string;
85
93
  id?: string;
86
94
  message_id?: string;
87
95
  name?: string;
@@ -89,11 +97,19 @@ export interface IBaseMessageApi {
89
97
  session_code?: string;
90
98
  status: MessageStatus;
91
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;
92
107
  export interface IBinaryInputContent {
93
108
  data?: string;
94
109
  filename?: string;
95
110
  id?: string;
96
111
  mimeType: string;
112
+ size?: number;
97
113
  type: MessageType.Binary;
98
114
  url?: string;
99
115
  }
@@ -102,6 +118,7 @@ export interface IBinaryInputContentApi {
102
118
  filename?: string;
103
119
  id?: string;
104
120
  mime_type: string;
121
+ size?: number;
105
122
  type: MessageType.Binary;
106
123
  url?: string;
107
124
  }
@@ -250,6 +267,16 @@ export interface IKnowledgeRagApi {
250
267
  }
251
268
  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;
252
269
  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;
270
+ export interface IMessageArtifact {
271
+ name: string;
272
+ outputId: string;
273
+ size: number;
274
+ type: string;
275
+ /** 事件不再下发;仅兼容旧数据 */
276
+ previewUrl?: string;
277
+ /** 事件不再下发;仅兼容旧数据 */
278
+ url?: string;
279
+ }
253
280
  /**
254
281
  * 消息属性 - 用于传递引用内容或快捷键相关信息
255
282
  * 该类型设计为灵活的结构,由外部调用方决定具体内容
@@ -257,6 +284,7 @@ export type IMessageApi = IActivityMessageApi | IAssistantMessageApi | IDevelope
257
284
  export interface IMessageProperty {
258
285
  /** 其他扩展字段 */
259
286
  [key: string]: unknown;
287
+ artifacts?: IMessageArtifact[];
260
288
  extra?: {
261
289
  /** 其他扩展字段 */
262
290
  [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) {
@@ -73,3 +76,17 @@ export var UserOperation;
73
76
  UserOperation["FlowNodeSkip"] = "flow_node_skip";
74
77
  UserOperation["ApprovalCancel"] = "approval_cancel";
75
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
+ };