@blueking/chat-helper 0.0.12-beta.9 → 0.0.12

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 +84 -0
  3. package/dist/agent/type.ts.js +5 -1
  4. package/dist/agent/use-agent.d.ts +573 -360
  5. package/dist/agent/use-agent.ts.js +365 -25
  6. package/dist/event/ag-ui.d.ts +4 -1
  7. package/dist/event/ag-ui.ts.js +106 -7
  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 +32 -2
  23. package/dist/http/transform/message.ts.js +17 -5
  24. package/dist/index.d.ts +3844 -2720
  25. package/dist/message/type.d.ts +30 -3
  26. package/dist/message/type.ts.js +16 -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,10 @@
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
6
  ReferenceDocument = "reference_document",
7
+ Info = "info",
6
8
  Interrupt = "interrupt"
7
9
  }
8
10
  export declare enum MessageRole {
@@ -54,12 +56,14 @@ export type IUserOperationPayload = {
54
56
  };
55
57
  export interface IActivityMessage extends IBaseMessage {
56
58
  activityType: ActivityType;
57
- content: IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
59
+ content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRag | IReferenceDocument;
60
+ property?: IMessageProperty;
58
61
  role: MessageRole.Activity;
59
62
  }
60
63
  export interface IActivityMessageApi extends IBaseMessageApi {
61
64
  activity_type: ActivityType;
62
- content: IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
65
+ content: IArtifactsGeneratedCustomValue | IFlowAgentResultCustomValue | IKnowledgeRagApi | IReferenceDocumentApi;
66
+ property?: IMessageProperty;
63
67
  role: MessageRole.Activity;
64
68
  }
65
69
  export interface IAssistantMessage extends IBaseMessage {
@@ -75,6 +79,8 @@ export interface IAssistantMessageApi extends IBaseMessageApi {
75
79
  tool_calls?: IToolCallApi[];
76
80
  }
77
81
  export interface IBaseMessage {
82
+ /** 消息创建时间(ISO 字符串),用于前端展示 */
83
+ createdAt?: string;
78
84
  id?: string;
79
85
  messageId?: string;
80
86
  name?: string;
@@ -83,6 +89,7 @@ export interface IBaseMessage {
83
89
  status: MessageStatus;
84
90
  }
85
91
  export interface IBaseMessageApi {
92
+ created_at?: string;
86
93
  id?: string;
87
94
  message_id?: string;
88
95
  name?: string;
@@ -90,11 +97,19 @@ export interface IBaseMessageApi {
90
97
  session_code?: string;
91
98
  status: MessageStatus;
92
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;
93
107
  export interface IBinaryInputContent {
94
108
  data?: string;
95
109
  filename?: string;
96
110
  id?: string;
97
111
  mimeType: string;
112
+ size?: number;
98
113
  type: MessageType.Binary;
99
114
  url?: string;
100
115
  }
@@ -103,6 +118,7 @@ export interface IBinaryInputContentApi {
103
118
  filename?: string;
104
119
  id?: string;
105
120
  mime_type: string;
121
+ size?: number;
106
122
  type: MessageType.Binary;
107
123
  url?: string;
108
124
  }
@@ -251,6 +267,16 @@ export interface IKnowledgeRagApi {
251
267
  }
252
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;
253
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
+ }
254
280
  /**
255
281
  * 消息属性 - 用于传递引用内容或快捷键相关信息
256
282
  * 该类型设计为灵活的结构,由外部调用方决定具体内容
@@ -258,6 +284,7 @@ export type IMessageApi = IActivityMessageApi | IAssistantMessageApi | IDevelope
258
284
  export interface IMessageProperty {
259
285
  /** 其他扩展字段 */
260
286
  [key: string]: unknown;
287
+ artifacts?: IMessageArtifact[];
261
288
  extra?: {
262
289
  /** 其他扩展字段 */
263
290
  [key: string]: unknown;
@@ -24,9 +24,11 @@
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";
30
32
  ActivityType["Interrupt"] = "interrupt";
31
33
  })(ActivityType || (ActivityType = {}));
32
34
  export var MessageRole;
@@ -74,3 +76,17 @@ export var UserOperation;
74
76
  UserOperation["FlowNodeSkip"] = "flow_node_skip";
75
77
  UserOperation["ApprovalCancel"] = "approval_cancel";
76
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
+ };