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

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

@@ -80,8 +80,8 @@ function _object_spread(target) {
     return target;
 }
 import { ref } from 'vue';
-import { AGUIProtocol } from '../event/index.ts.js';
-import { MessageRole, MessageStatus } from '../message/index.ts.js';
+import { AGUIProtocol, ApprovalInterruptTicketStatus, ResumeStatus, RunFinishedOutcomeType } from '../event/index.ts.js';
+import { MessageRole, MessageStatus, UserOperation } from '../message/index.ts.js';
 import { SessionStatus } from '../session/type.ts.js';
 /**
  * Agent 模块
@@ -92,7 +92,9 @@ import { SessionStatus } from '../session/type.ts.js';
     const isInfoLoading = ref(false);
     const isChatting = ref(false);
     let usedProtocol = protocol || new AGUIProtocol();
-    let abortController = null;
+    let chatAbortController = null;
+    let resumeAbortController = null;
+    let longPollTimer = null;
     const getAgentInfo = ()=>{
         var _mediator_http;
         isInfoLoading.value = true;
@@ -121,19 +123,54 @@ import { SessionStatus } from '../session/type.ts.js';
             });
         }
     };
+    const userOperationStreamRequest = (sessionCode, operation, payload, config)=>{
+        var _mediator_http;
+        return (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.message.userOperation(sessionCode, operation, payload, config).then(()=>{
+            if (operation !== UserOperation.ApprovalCancel) {
+                streamRequest({
+                    sessionCode,
+                    config
+                });
+            } else {
+                clearLongPollTimer();
+                pollResumeSession(sessionCode);
+            }
+        });
+    };
     const streamRequest = function() {
-        var _ref = _async_to_generator(function*(sessionCode, url, config) {
-            var // 发起聊天
-            _mediator_http;
+        var _ref = _async_to_generator(function*({ sessionCode, url, config, resume, input, lastMessageId }) {
+            var _mediator_http;
             // ag-ui 协议需要注入消息模块
             if (usedProtocol instanceof AGUIProtocol) {
                 usedProtocol.injectMessageModule(mediator.message);
             }
+            if (input) {
+                var // 列表新增一个用户消息
+                _mediator_message;
+                (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value.push({
+                    role: MessageRole.User,
+                    content: input,
+                    status: MessageStatus.Complete,
+                    sessionCode
+                });
+            }
             // 事件代理
             const onDone = ()=>{
                 var _usedProtocol_onDone;
                 isChatting.value = false;
                 (_usedProtocol_onDone = usedProtocol.onDone) === null || _usedProtocol_onDone === void 0 ? void 0 : _usedProtocol_onDone.call(usedProtocol);
+                if (input) {
+                    var // 刷新列表，获取前端 mock message 的 id，并更新到列表中
+                    _mediator_http_message, _mediator_http;
+                    (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : (_mediator_http_message = _mediator_http.message) === null || _mediator_http_message === void 0 ? void 0 : _mediator_http_message.getMessages(sessionCode).then((res)=>{
+                        var _mediator_message;
+                        const lastUserMessage = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value.findLast((item)=>item.role === MessageRole.User);
+                        const lastApiUserMessage = res.findLast((item)=>item.role === MessageRole.User);
+                        lastUserMessage.id = lastApiUserMessage.id;
+                    });
+                }
+                // 轮询接口，判断是否可以继续聊天
+                pollResumeSession(sessionCode);
             };
             const onError = (error)=>{
                 var _usedProtocol_onError;
@@ -150,24 +187,31 @@ import { SessionStatus } from '../session/type.ts.js';
                 (_usedProtocol_onStart = usedProtocol.onStart) === null || _usedProtocol_onStart === void 0 ? void 0 : _usedProtocol_onStart.call(usedProtocol);
             };
             // 创建 AbortController
-            abortController = new AbortController();
-            (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.fetchClient.streamRequest(_object_spread({
+            chatAbortController = new AbortController();
+            // 发起聊天
+            void ((_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.fetchClient.streamRequest(_object_spread({
                 url: url || 'chat_completion/',
                 method: 'POST',
                 data: {
                     session_code: sessionCode,
+                    input,
                     execute_kwargs: {
-                        stream: true
+                        stream: true,
+                        persist_input: !!input,
+                        last_message_id: lastMessageId,
+                        resume
                     }
                 },
-                controller: abortController,
+                controller: chatAbortController,
                 onDone,
                 onError,
                 onMessage,
                 onStart
-            }, config));
+            }, config)).catch(()=>{
+            // 非 abort 错误已通过 onError 回调处理；abort 为正常结束
+            }));
         });
-        return function streamRequest(sessionCode, url, config) {
+        return function streamRequest(_) {
             return _ref.apply(this, arguments);
         };
     }();
@@ -191,7 +235,11 @@ import { SessionStatus } from '../session/type.ts.js';
                 property
             }));
             // 发起聊天
-            streamRequest(sessionCode, url, config);
+            streamRequest({
+                sessionCode,
+                url,
+                config
+            });
         });
         return function chat(userInput, sessionCode, url, config, property) {
             return _ref.apply(this, arguments);
@@ -206,15 +254,76 @@ import { SessionStatus } from '../session/type.ts.js';
    */ const resumeStreamingChat = (sessionCode, url, config)=>{
         var _mediator_session_current_value, _mediator_session;
         if (((_mediator_session = mediator.session) === null || _mediator_session === void 0 ? void 0 : (_mediator_session_current_value = _mediator_session.current.value) === null || _mediator_session_current_value === void 0 ? void 0 : _mediator_session_current_value.status) === SessionStatus.Running) {
-            streamRequest(sessionCode, url, config);
+            var _mediator_message_list_value_at, _mediator_message;
+            const lastMessageId = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : (_mediator_message_list_value_at = _mediator_message.list.value.at(-1)) === null || _mediator_message_list_value_at === void 0 ? void 0 : _mediator_message_list_value_at.id;
+            streamRequest({
+                sessionCode,
+                url,
+                config,
+                lastMessageId
+            });
+        }
+    };
+    /**
+   * 轮询接口，判断是否可以继续聊天
+   * @param sessionCode - 会话编码
+   * @returns 是否可以继续聊天
+   */ const pollResumeSession = (sessionCode)=>{
+        var _mediator_message, _lastMessage_content_outcome, _lastMessage_content;
+        const lastMessage = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value.at(-1);
+        const pendingApprovalInterrupt = (lastMessage === null || lastMessage === void 0 ? void 0 : (_lastMessage_content = lastMessage.content) === null || _lastMessage_content === void 0 ? void 0 : (_lastMessage_content_outcome = _lastMessage_content.outcome) === null || _lastMessage_content_outcome === void 0 ? void 0 : _lastMessage_content_outcome.type) === RunFinishedOutcomeType.Interrupt ? lastMessage.content.outcome.interrupts.find((interrupt)=>{
+            var _interrupt_metadata_ticket, _interrupt_metadata;
+            return [
+                ApprovalInterruptTicketStatus.Pending,
+                ApprovalInterruptTicketStatus.Draft
+            ].includes((_interrupt_metadata = interrupt.metadata) === null || _interrupt_metadata === void 0 ? void 0 : (_interrupt_metadata_ticket = _interrupt_metadata.ticket) === null || _interrupt_metadata_ticket === void 0 ? void 0 : _interrupt_metadata_ticket.status);
+        }) : undefined;
+        const getIsTicketLoading = ()=>{
+            const isInterruptMessage = (lastMessage === null || lastMessage === void 0 ? void 0 : lastMessage.role) === MessageRole.Interrupt;
+            return isInterruptMessage && !!pendingApprovalInterrupt;
+        };
+        if (getIsTicketLoading()) {
+            var // 轮询接口，判断是否可以继续聊天
+            _mediator_http;
+            // 清除轮询定时器和中断轮询控制器
+            clearLongPollTimer();
+            resumeAbortController = new AbortController();
+            (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.session.isResumeSession(sessionCode, {
+                controller: resumeAbortController
+            }).then((res)=>{
+                if (res) {
+                    // 可以继续聊天，重新发起聊天（携带 execute_kwargs.resume 通知后端恢复中断）
+                    streamRequest({
+                        sessionCode,
+                        resume: {
+                            interruptId: pendingApprovalInterrupt.id,
+                            status: ResumeStatus.Resolved
+                        }
+                    });
+                } else {
+                    longPollTimer = setTimeout(()=>{
+                        var _mediator_session_current_value, _mediator_session_current, _mediator_session;
+                        // 如果会话不匹配，则不继续轮询
+                        if (sessionCode !== ((_mediator_session = mediator.session) === null || _mediator_session === void 0 ? void 0 : (_mediator_session_current = _mediator_session.current) === null || _mediator_session_current === void 0 ? void 0 : (_mediator_session_current_value = _mediator_session_current.value) === null || _mediator_session_current_value === void 0 ? void 0 : _mediator_session_current_value.sessionCode)) return;
+                        pollResumeSession(sessionCode);
+                    }, 15000);
+                }
+            });
         }
     };
+    const clearLongPollTimer = ()=>{
+        var _resumeAbortController_abort;
+        clearTimeout(longPollTimer);
+        longPollTimer = null;
+        resumeAbortController === null || resumeAbortController === void 0 ? void 0 : (_resumeAbortController_abort = resumeAbortController.abort) === null || _resumeAbortController_abort === void 0 ? void 0 : _resumeAbortController_abort.call(resumeAbortController);
+        resumeAbortController = null;
+    };
     /**
    * 中止聊天（纯前端中止，后端继续处理）
    */ const abortChat = ()=>{
-        var _abortController_abort;
-        abortController === null || abortController === void 0 ? void 0 : (_abortController_abort = abortController.abort) === null || _abortController_abort === void 0 ? void 0 : _abortController_abort.call(abortController);
-        abortController = null;
+        var _chatAbortController_abort;
+        chatAbortController === null || chatAbortController === void 0 ? void 0 : (_chatAbortController_abort = chatAbortController.abort) === null || _chatAbortController_abort === void 0 ? void 0 : _chatAbortController_abort.call(chatAbortController);
+        chatAbortController = null;
     };
     /**
    * 停止会话，后端中止
@@ -269,7 +378,11 @@ import { SessionStatus } from '../session/type.ts.js';
                 property: originalProperty
             }));
             // 6. 立即发起流式请求（不等待删除和创建的 API 完成）
-            streamRequest(sessionCode, url, config);
+            streamRequest({
+                sessionCode,
+                url,
+                config
+            });
             // 7. 在后台等待 API 完成，处理可能的错误
             Promise.all([
                 deletePromise,
@@ -299,6 +412,10 @@ import { SessionStatus } from '../session/type.ts.js';
         abortChat,
         stopChat,
         getAgentInfo,
-        reset
+        reset,
+        pollResumeSession,
+        clearLongPollTimer,
+        userOperationStreamRequest,
+        streamRequest
     };
 };

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

@@ -35,6 +35,10 @@ export declare class AGUIProtocol implements ISSEProtocol {
      * 自定义事件 处理流程编排任务结束
      */
     handleFlowAgentEndCustomEvent(event: ICustomEvent): void;
+    /**
+     * 自定义事件 处理流程编排任务重启
+     */
+    handleFlowAgentRestartCustomEvent(event: ICustomEvent): void;
     /**
      * 自定义事件 处理流程编排任务结果（增量更新节点状态）
      */
@@ -43,6 +47,10 @@ export declare class AGUIProtocol implements ISSEProtocol {
      * 自定义事件 处理流程编排任务开始
      */
     handleFlowAgentStartCustomEvent(event: ICustomEvent): void;
+    /**
+     * 自定义事件 处理流程编排任务更新
+     */
+    handleFlowAgentUpdateCustomEvent(event: ICustomEvent): void;
     /**
      * 自定义事件 处理意图识别结束
      */
@@ -80,7 +88,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
     /**
      * 处理运行完成事件
      */
-    handleRunFinishedEvent(_event: IRunFinishedEvent): void;
+    handleRunFinishedEvent(event: IRunFinishedEvent): void;
     /**
      * 处理运行开始事件
      */
@@ -105,6 +113,10 @@ export declare class AGUIProtocol implements ISSEProtocol {
      * 自定义事件 处理临时消息，转换为 AI 文本消息
      */
     handleTempMessageCustomEvent(event: ICustomEvent): void;
+    /**
+     * 自定义事件 处理审批结果
+     */
+    handleApprovalResultCustomEvent(event: ICustomEvent): void;
     /**
      * 处理文本消息块事件
      */

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

@@ -37,7 +37,7 @@
 }
 import { transferMessageApi2Message } from '../http/transform/index.ts.js';
 import { ActivityType, MessageRole, MessageStatus, MessageType } from '../message/index.ts.js';
-import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
+import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } from './type.ts.js';
 /**
  * AGUI 协议
  * @param message - 消息模块
@@ -63,6 +63,9 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
             case CustomEventName.FlowAgentEnd:
                 this.handleFlowAgentEndCustomEvent(event);
                 break;
+            case CustomEventName.FlowAgentRestart:
+                this.handleFlowAgentRestartCustomEvent(event);
+                break;
             case CustomEventName.ReferenceDocument:
                 this.handleReferenceDocumentCustomEvent(event);
                 break;
@@ -81,6 +84,12 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
             case CustomEventName.TempMessage:
                 this.handleTempMessageCustomEvent(event);
                 break;
+            case CustomEventName.ApprovalResult:
+                this.handleApprovalResultCustomEvent(event);
+                break;
+            case CustomEventName.FlowAgentUpdate:
+                this.handleFlowAgentUpdateCustomEvent(event);
+                break;
             default:
                 break;
         }
@@ -102,6 +111,20 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         }
     }
     /**
+   * 自定义事件 处理流程编排任务重启
+   */ handleFlowAgentRestartCustomEvent(event) {
+        const value = event.value;
+        this.messageModule.list.value.forEach((item)=>{
+            if (item.role === MessageRole.Activity && item.activityType === ActivityType.FlowAgent) {
+                const isSameTask = item.content[0].task_id === value[0].task_id;
+                // 通过第一个 task_id 判断是否是同一个任务，是的话直接更新消息状态为 streaming
+                if (isSameTask) {
+                    item.status = MessageStatus.Streaming;
+                }
+            }
+        });
+    }
+    /**
    * 自定义事件 处理流程编排任务结果（增量更新节点状态）
    */ handleFlowAgentResultCustomEvent(event) {
         const message = this.messageModule.getCurrentLoadingMessage();
@@ -118,7 +141,7 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
             activityType: ActivityType.FlowAgent,
             content: value.map((item)=>({
                     nodes: {},
-                    task_id: Number(item.task_id),
+                    task_id: item.task_id,
                     task_name: '',
                     task_outputs: [],
                     task_state: FlowTaskState.Created
@@ -127,6 +150,20 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         });
     }
     /**
+   * 自定义事件 处理流程编排任务更新
+   */ handleFlowAgentUpdateCustomEvent(event) {
+        const value = event.value;
+        this.messageModule.list.value.forEach((item)=>{
+            if (item.role === MessageRole.Activity && item.activityType === ActivityType.FlowAgent) {
+                const isSameTask = item.content[0].task_id === value[0].task_id;
+                // 通过第一个 task_id 判断是否是同一个任务，是的话直接更新消息内容
+                if (isSameTask) {
+                    item.content = value;
+                }
+            }
+        });
+    }
+    /**
    * 自定义事件 处理意图识别结束
    */ handleKnowledgeRagEndCustomEvent(_event) {
         const message = this.messageModule.getCurrentLoadingMessage();
@@ -206,11 +243,24 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
     }
     /**
    * 处理运行完成事件
-   */ handleRunFinishedEvent(_event) {
+   */ handleRunFinishedEvent(event) {
+        var _event_outcome, _event_outcome1;
         const message = this.messageModule.getCurrentLoadingMessage();
         if (message) {
             message.status = MessageStatus.Complete;
         }
+        // 如果是中断消息，则创建一个中断消息
+        if (((_event_outcome = event.outcome) === null || _event_outcome === void 0 ? void 0 : _event_outcome.type) === RunFinishedOutcomeType.Interrupt) {
+            this.messageModule.plusMessage({
+                role: MessageRole.Interrupt,
+                content: event,
+                status: MessageStatus.Pending
+            });
+        }
+        // 二次返回，直接更新消息内容
+        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) {
+            message.content = event;
+        }
     }
     /**
    * 处理运行开始事件
@@ -249,6 +299,16 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         });
     }
     /**
+   * 自定义事件 处理审批结果
+   */ handleApprovalResultCustomEvent(event) {
+        const value = event.value;
+        const message = this.messageModule.getCurrentLoadingMessage();
+        if (message) {
+            message.content = value;
+            message.status = MessageStatus.Complete;
+        }
+    }
+    /**
    * 处理文本消息块事件
    */ handleTextMessageChunkEvent(event) {
         const message = this.messageModule.getCurrentLoadingMessage();
@@ -358,14 +418,23 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
     /**
    * 处理工具调用结果事件
    */ handleToolCallResultEvent(event) {
-        this.messageModule.plusMessage({
-            role: MessageRole.Tool,
-            content: event.content,
-            duration: event.duration,
-            status: event.isError ? MessageStatus.Error : MessageStatus.Complete,
-            toolCallId: event.toolCallId,
-            messageId: event.messageId
-        });
+        const message = this.messageModule.getCurrentLoadingMessage();
+        if ((message === null || message === void 0 ? void 0 : message.role) === MessageRole.Interrupt) {
+            // 如果是中断消息，则更新消息内容
+            message.content.result = JSON.parse(event.content);
+            message.content.outcome.type = RunFinishedOutcomeType.Success;
+            message.status = MessageStatus.Complete;
+        } else {
+            // 否则创建一个工具调用结果消息
+            this.messageModule.plusMessage({
+                role: MessageRole.Tool,
+                content: event.content,
+                duration: event.duration,
+                status: event.isError ? MessageStatus.Error : MessageStatus.Complete,
+                toolCallId: event.toolCallId,
+                messageId: event.messageId
+            });
+        }
     }
     /**
    * 处理工具调用开始事件
@@ -397,10 +466,10 @@ import { CustomEventName, EventType, FlowTaskState } from './type.ts.js';
         (_this_onDoneCallback = (_this = this).onDoneCallback) === null || _this_onDoneCallback === void 0 ? void 0 : _this_onDoneCallback.call(_this);
     }
     onError(error) {
-        var // 回调给上层
+        var // 在聊天区域显示错误消息
+        _this_messageModule, // 回调给上层
         _this_onErrorCallback, _this;
-        // 创建一个错误消息
-        this.messageModule.plusMessage({
+        (_this_messageModule = this.messageModule) === null || _this_messageModule === void 0 ? void 0 : _this_messageModule.plusMessage({
             role: MessageRole.Assistant,
             content: error.message,
             status: MessageStatus.Error

package/dist/event/type.d.ts

@@ -1,14 +1,18 @@
 import { type IMessageApi, type MessageRole, type MessageStatus } from '../message/type';
+import type { JSONSchema4 } from 'json-schema';
 export declare enum CustomEventName {
     FlowAgentEnd = "flow_agent_end",
     FlowAgentResult = "flow_agent_result",
     FlowAgentStart = "flow_agent_start",
+    FlowAgentUpdate = "flow_agent_update",
+    FlowAgentRestart = "flow_agent_restart",
     KnowledgeRagEnd = "knowledge_rag_end",
     KnowledgeRagResult = "knowledge_rag_result",
     KnowledgeRagStart = "knowledge_rag_start",
     KnowledgeRagTextContent = "knowledge_rag_text_content",
     ReferenceDocument = "reference_document",
-    TempMessage = "temp_message"
+    TempMessage = "temp_message",
+    ApprovalResult = "approval_result"
 }
 export declare enum EventType {
     ActivityDelta = "ACTIVITY_DELTA",
@@ -40,42 +44,51 @@ export declare enum EventType {
 }
 /** BKFlow 收敛后的节点状态 - task.node 的状态枚举 */
 export declare enum FlowNodeState {
-    /** 失败 */
     Failed = "failed",
-    /** 执行中 */
     Running = "running",
-    /** 成功 */
     Success = "success",
-    /** 挂起 */
     Suspended = "suspended"
 }
 /** BKFLOW 原始状态 - task 的状态枚举 */
 export declare enum FlowTaskState {
-    /** 执行中 */
     Blocked = "BLOCKED",
-    /** 执行中 */
     Created = "CREATED",
-    /** 失败 */
     Failed = "FAILED",
-    /** 成功 */
     Finished = "FINISHED",
-    /** 执行中 */
     LoopReady = "LOOP_READY",
-    /** 执行中 */
     Ready = "READY",
-    /** 失败 */
     Revoked = "REVOKED",
-    /** 失败 */
     RollBackFailed = "ROLL_BACK_FAILED",
-    /** 执行中 */
     RollBackSuccess = "ROLL_BACK_SUCCESS",
-    /** 执行中 */
     RollingBack = "ROLLING_BACK",
-    /** 执行中 */
     Running = "RUNNING",
-    /** 挂起 */
     Suspended = "SUSPENDED"
 }
+/** 运行完成结果 */
+export declare enum RunFinishedOutcomeType {
+    Success = "success",
+    Interrupt = "interrupt"
+}
+/** 审批状态 */
+export declare enum ApprovalInterruptTicketStatus {
+    Abandoned = "abandoned",
+    Approved = "approved",
+    Cancelled = "cancelled",
+    Draft = "draft",
+    Expired = "expired",
+    Rejected = "rejected",
+    Pending = "pending"
+}
+/** 中断原因 */
+export declare enum InterruptReason {
+    AIDevToolApproval = "aidev:tool_approval",
+    UserQuestion = "aidev:user_question"
+}
+/** 恢复状态 */
+export declare enum ResumeStatus {
+    Resolved = "resolved",
+    Cancelled = "cancelled"
+}
 /**
  * Activity 代表 Agent 执行过程中的活动/动作/任务，可能包含结构化数据
  * 活动状态的增量更新
@@ -112,25 +125,25 @@ export interface IBaseEvent {
 export interface ICustomEvent extends IBaseEvent {
     name: CustomEventName;
     type: EventType.Custom;
-    value: IFlowAgentEndCustomValue | IFlowAgentResultCustomValue | IFlowAgentStartCustomValue | IKnowledgeRagResultCustomValue | IKnowledgeRagTextContentCustomValue | IReferenceDocumentCustomValue | ITempMessageCustomValue;
+    value: IFlowAgentEndCustomValue | IFlowAgentResultCustomValue | IFlowAgentStartCustomValue | IFlowAgentRestartCustomValue | IKnowledgeRagResultCustomValue | IKnowledgeRagTextContentCustomValue | IReferenceDocumentCustomValue | ITempMessageCustomValue | IApprovalResultCustomValue;
 }
 export type IEvent = IActivityDeltaEvent | IActivitySnapshotEvent | ICustomEvent | IMessagesSnapshotEvent | IRawEvent | IRunErrorEvent | IRunFinishedEvent | IRunStartedEvent | IStateDeltaEvent | IStateSnapshotEvent | IStepFinishedEvent | IStepStartedEvent | ITextMessageChunkEvent | ITextMessageContentEvent | ITextMessageEndEvent | ITextMessageStartEvent | IThinkingEndEvent | IThinkingStartEvent | IThinkingTextMessageContentEvent | IThinkingTextMessageEndEvent | IThinkingTextMessageStartEvent | IToolCallArgsEvent | IToolCallChunkEvent | IToolCallEndEvent | IToolCallResultEvent | IToolCallStartEvent;
 export type IFlowAgentEndCustomValue = {
     task_outputs: string[];
 }[];
 export interface IFlowAgentNode {
-    /** 耗时(s) */
     elapsed_time: number;
-    /** 节点id */
     id: string;
-    /** 节点名称 */
     name: string;
-    /** 节点状态 */
     state: FlowNodeState;
+    retry: number;
+    skip: boolean;
+    retryable: boolean;
+    skippable: boolean;
 }
 export type IFlowAgentResultCustomValue = {
     nodes: Record<string, IFlowAgentNode>;
-    task_id: number;
+    task_id: string;
     task_name: string;
     task_outputs: string[];
     task_state: FlowTaskState;
@@ -138,6 +151,7 @@ export type IFlowAgentResultCustomValue = {
 export type IFlowAgentStartCustomValue = {
     task_id: string;
 }[];
+export type IFlowAgentRestartCustomValue = IFlowAgentStartCustomValue;
 export type IKnowledgeRagResultCustomValue = IReferenceDocumentCustomValue;
 export interface IKnowledgeRagTextContentCustomValue {
     cover: boolean;
@@ -173,15 +187,66 @@ export interface IRunErrorEvent extends IBaseEvent {
     message: string;
     type: EventType.RunError;
 }
+export interface IInterrupt<T extends InterruptReason, P extends Record<string, unknown>> {
+    id: string;
+    reason: T;
+    message?: string;
+    toolCallId?: string;
+    responseSchema?: JSONSchema4;
+    expiresAt?: string;
+    metadata?: P;
+}
+export type IApprovalInterrupt = IInterrupt<InterruptReason.AIDevToolApproval, {
+    ticket: {
+        approvers: string[];
+        sn: string;
+        status: ApprovalInterruptTicketStatus;
+        submit_time: string;
+        title: string;
+        url: string;
+    };
+}>;
+export type IUserQuestionInterrupt = IInterrupt<InterruptReason.UserQuestion, {
+    questions: {
+        header: string;
+        multiSelect?: boolean;
+        options?: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+    }[];
+}>;
+export interface IResume {
+    interruptId: string;
+    status: ResumeStatus;
+    payload?: {
+        answers: {
+            answer: {
+                description: string;
+                label: string;
+            }[];
+            multiSelect?: boolean;
+            question: string;
+        }[];
+    };
+}
+export type IRunFinishedOutcome = {
+    type: RunFinishedOutcomeType.Success;
+} | {
+    type: RunFinishedOutcomeType.Interrupt;
+    interrupts: Array<IApprovalInterrupt | IUserQuestionInterrupt>;
+};
 /**
  * 标记 Agent 运行正常结束
  * 返回最终结果 result
  */
 export interface IRunFinishedEvent extends IBaseEvent {
-    result?: unknown;
+    result?: IResume;
     runId: number;
     threadId: string;
     type: EventType.RunFinished;
+    outcome?: IRunFinishedOutcome;
 }
 /**
  * 标记一次完整的 Agent 执行开始
@@ -234,6 +299,7 @@ export interface ITempMessageCustomValue {
     message: string;
     status: MessageStatus;
 }
+export type IApprovalResultCustomValue = IRunFinishedEvent;
 export interface ITextMessageChunkEvent extends IBaseEvent {
     delta?: string;
     messageId: string;