@blueking/chat-helper 0.0.12-beta.10 → 0.0.12-beta.12

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

@@ -80,9 +80,38 @@ function _object_spread(target) {
     return target;
 }
 import { ref } from 'vue';
-import { AGUIProtocol, ApprovalInterruptTicketStatus, ResumeStatus, RunFinishedOutcomeType } from '../event/index.ts.js';
+import { AGUIProtocol, ApprovalInterruptTicketStatus, EventType, ResumeStatus, RunFinishedOutcomeType } from '../event/index.ts.js';
 import { MessageRole, MessageStatus, UserOperation } from '../message/index.ts.js';
 import { SessionStatus } from '../session/type.ts.js';
+/** SSE 静默重连最大次数（退避总时长约 23s，落在后端 orphan grace ~30s 内） */ const MAX_RECONNECT_ATTEMPTS = 5;
+const RECONNECT_BASE_DELAY_MS = 1000;
+const RECONNECT_MAX_DELAY_MS = 8000;
+const getReconnectDelayMs = (attempt)=>Math.min(RECONNECT_BASE_DELAY_MS * Math.pow(2, attempt - 1), RECONNECT_MAX_DELAY_MS);
+/**
+ * 判断流式错误是否可静默重连。
+ * 不重试：Abort、401/403 等业务 4xx（408/429 除外）；可重试：网络错误、5xx、无状态码的中断。
+ */ const isRecoverableStreamError = (error)=>{
+    var _requestError_response;
+    if (error.name === 'AbortError') {
+        return false;
+    }
+    const requestError = error;
+    const statusFromResponse = (_requestError_response = requestError.response) === null || _requestError_response === void 0 ? void 0 : _requestError_response.status;
+    const statusFromMessage = error.message.match(/status code (\d+)/i);
+    const status = statusFromResponse !== null && statusFromResponse !== void 0 ? statusFromResponse : statusFromMessage ? Number(statusFromMessage[1]) : undefined;
+    if (status !== undefined) {
+        if (status === 408 || status === 429) {
+            return true;
+        }
+        if (status >= 400 && status < 500) {
+            return false;
+        }
+        if (status >= 500) {
+            return true;
+        }
+    }
+    return true;
+};
 /**
  * Agent 模块
  * @param options - 配置选项
@@ -91,10 +120,39 @@ import { SessionStatus } from '../session/type.ts.js';
     const info = ref(null);
     const isInfoLoading = ref(false);
     const isChatting = ref(false);
+    const models = ref([]);
+    const isModelsLoading = ref(false);
     let usedProtocol = protocol || new AGUIProtocol();
     let chatAbortController = null;
     let resumeAbortController = null;
     let longPollTimer = null;
+    /** 用户主动中止（abortChat），禁止自动重连 */ let manualAbort = false;
+    /** 当前轮次已静默重连次数 */ let reconnectAttempt = 0;
+    /** 本轮流是否已收到 RUN_FINISHED */ let runFinished = false;
+    let reconnectTimer = null;
+    let reconnectWaitResolve = null;
+    let activeStreamContext = null;
+    /**
+   * 获取可用模型列表，写入 models；失败时清空列表并抛出
+   */ const getLlms = (params, config)=>{
+        var _mediator_http;
+        isModelsLoading.value = true;
+        const request = (_mediator_http = mediator.http) === null || _mediator_http === void 0 ? void 0 : _mediator_http.agent.getLlms(params, config);
+        if (!request) {
+            isModelsLoading.value = false;
+            models.value = [];
+            return Promise.resolve([]);
+        }
+        return request.then((res)=>{
+            models.value = res;
+            return res;
+        })['catch']((error)=>{
+            models.value = [];
+            throw error;
+        })['finally'](()=>{
+            isModelsLoading.value = false;
+        });
+    };
     const getAgentInfo = ()=>{
         var _mediator_http;
         isInfoLoading.value = true;
@@ -123,23 +181,132 @@ import { SessionStatus } from '../session/type.ts.js';
             });
         }
     };
-    const userOperationStreamRequest = (sessionCode, operation, payload, config)=>{
+    const userOperationStreamRequest = (sessionCode, operation, payload, config, model)=>{
         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
+                    config,
+                    model
                 });
             } else {
                 clearLongPollTimer();
-                pollResumeSession(sessionCode);
+                pollResumeSession(sessionCode, model);
             }
         });
     };
+    const clearReconnectTimer = (continued = false)=>{
+        if (reconnectTimer) {
+            clearTimeout(reconnectTimer);
+            reconnectTimer = null;
+        }
+        if (reconnectWaitResolve) {
+            const resolve = reconnectWaitResolve;
+            reconnectWaitResolve = null;
+            resolve(continued);
+        }
+    };
+    const waitForReconnectDelay = (ms)=>new Promise((resolve)=>{
+            reconnectWaitResolve = resolve;
+            reconnectTimer = setTimeout(()=>{
+                reconnectTimer = null;
+                reconnectWaitResolve = null;
+                resolve(true);
+            }, ms);
+        });
+    const resetStreamReconnectState = ()=>{
+        manualAbort = false;
+        reconnectAttempt = 0;
+        runFinished = false;
+        clearReconnectTimer(false);
+    };
+    /** 裁掉尾部尚未完成的非用户消息，避免 DLQ 重放时重复气泡 */ const pruneTrailingIncompleteMessages = ()=>{
+        var _mediator_message;
+        const list = (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value;
+        if (!(list === null || list === void 0 ? void 0 : list.length)) {
+            return;
+        }
+        while(list.length > 0){
+            const last = list[list.length - 1];
+            if (last.role === MessageRole.User) {
+                break;
+            }
+            if (last.status === MessageStatus.Streaming || last.status === MessageStatus.Pending) {
+                list.pop();
+                continue;
+            }
+            break;
+        }
+    };
+    const isSameActiveSession = (sessionCode)=>{
+        var _mediator_session_current_value, _mediator_session_current, _mediator_session;
+        return 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);
+    };
+    /**
+   * 尝试静默重连。
+   * @returns reconnected | finished（服务端已结束）| failed（需对外报错或中止）
+   */ const attemptSilentReconnect = function() {
+        var _ref = _async_to_generator(function*(sessionCode) {
+            var _mediator_session_current_value, _mediator_session, _mediator_session_current_value1, _mediator_session1, _mediator_message_list_value_at, _mediator_message;
+            if (manualAbort || !isSameActiveSession(sessionCode)) {
+                return 'failed';
+            }
+            try {
+                var _mediator_session2;
+                yield (_mediator_session2 = mediator.session) === null || _mediator_session2 === void 0 ? void 0 : _mediator_session2.getSession(sessionCode);
+            } catch (e) {
+            // 状态刷新失败时沿用本地 session.status
+            }
+            if (manualAbort || !isSameActiveSession(sessionCode)) {
+                return 'failed';
+            }
+            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) {
+                return 'finished';
+            }
+            if (reconnectAttempt >= MAX_RECONNECT_ATTEMPTS) {
+                return 'failed';
+            }
+            reconnectAttempt += 1;
+            // 静默重连期间保持「生成中」态
+            isChatting.value = true;
+            const delayMs = getReconnectDelayMs(reconnectAttempt);
+            const waited = yield waitForReconnectDelay(delayMs);
+            if (!waited || manualAbort || !isSameActiveSession(sessionCode)) {
+                return 'failed';
+            }
+            if (((_mediator_session1 = mediator.session) === null || _mediator_session1 === void 0 ? void 0 : (_mediator_session_current_value1 = _mediator_session1.current.value) === null || _mediator_session_current_value1 === void 0 ? void 0 : _mediator_session_current_value1.status) !== SessionStatus.Running) {
+                return 'finished';
+            }
+            pruneTrailingIncompleteMessages();
+            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;
+            const ctx = activeStreamContext;
+            streamRequest({
+                sessionCode,
+                model: ctx === null || ctx === void 0 ? void 0 : ctx.model,
+                url: ctx === null || ctx === void 0 ? void 0 : ctx.url,
+                config: ctx === null || ctx === void 0 ? void 0 : ctx.config,
+                lastMessageId: lastMessageId !== undefined ? String(lastMessageId) : undefined,
+                isReconnect: true
+            });
+            return 'reconnected';
+        });
+        return function attemptSilentReconnect(sessionCode) {
+            return _ref.apply(this, arguments);
+        };
+    }();
     const streamRequest = function() {
-        var _ref = _async_to_generator(function*({ sessionCode, url, config, resume, input, lastMessageId }) {
+        var _ref = _async_to_generator(function*({ sessionCode, model, url, config, resume, input, lastMessageId, isReconnect = false }) {
             var _mediator_http;
+            if (!isReconnect) {
+                resetStreamReconnectState();
+            }
+            activeStreamContext = {
+                sessionCode,
+                model: model,
+                url,
+                config
+            };
             // ag-ui 协议需要注入消息模块
             if (usedProtocol instanceof AGUIProtocol) {
                 usedProtocol.injectMessageModule(mediator.message);
@@ -154,8 +321,7 @@ import { SessionStatus } from '../session/type.ts.js';
                     sessionCode
                 });
             }
-            // 事件代理
-            const onDone = ()=>{
+            const finishSuccessfully = ()=>{
                 var _usedProtocol_onDone;
                 isChatting.value = false;
                 (_usedProtocol_onDone = usedProtocol.onDone) === null || _usedProtocol_onDone === void 0 ? void 0 : _usedProtocol_onDone.call(usedProtocol);
@@ -166,19 +332,73 @@ import { SessionStatus } from '../session/type.ts.js';
                         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;
+                        if (lastUserMessage && lastApiUserMessage) {
+                            lastUserMessage.id = lastApiUserMessage.id;
+                        }
                     });
                 }
                 // 轮询接口，判断是否可以继续聊天
                 pollResumeSession(sessionCode);
             };
-            const onError = (error)=>{
+            const failWithError = (error)=>{
                 var _usedProtocol_onError;
                 isChatting.value = false;
                 (_usedProtocol_onError = usedProtocol.onError) === null || _usedProtocol_onError === void 0 ? void 0 : _usedProtocol_onError.call(usedProtocol, error);
             };
+            // 事件代理
+            const onDone = ()=>{
+                // 用户 abort：FetchClient 将 AbortError 转为 onDone，不重连
+                if (manualAbort || runFinished) {
+                    finishSuccessfully();
+                    return;
+                }
+                // 连接被干净掐断且未收到 RUN_FINISHED：尝试静默重连
+                void attemptSilentReconnect(sessionCode).then((result)=>{
+                    if (result === 'reconnected') {
+                        // 保持 isChatting=true，不展示错误
+                        return;
+                    }
+                    if (result === 'finished') {
+                        finishSuccessfully();
+                        return;
+                    }
+                    // abort / 切会话导致的失败：静默结束，不展示错误气泡
+                    if (manualAbort || !isSameActiveSession(sessionCode)) {
+                        isChatting.value = false;
+                        return;
+                    }
+                    failWithError(new Error('Connection lost, please try again'));
+                });
+            };
+            const onError = (error)=>{
+                if (manualAbort) {
+                    return;
+                }
+                if (!isRecoverableStreamError(error)) {
+                    failWithError(error);
+                    return;
+                }
+                void attemptSilentReconnect(sessionCode).then((result)=>{
+                    if (result === 'reconnected') {
+                        return;
+                    }
+                    if (result === 'finished') {
+                        finishSuccessfully();
+                        return;
+                    }
+                    if (manualAbort || !isSameActiveSession(sessionCode)) {
+                        isChatting.value = false;
+                        return;
+                    }
+                    failWithError(error);
+                });
+            };
             const onMessage = (event)=>{
                 var _usedProtocol_onMessage;
+                const typedEvent = event;
+                if ((typedEvent === null || typedEvent === void 0 ? void 0 : typedEvent.type) === EventType.RunFinished) {
+                    runFinished = true;
+                }
                 (_usedProtocol_onMessage = usedProtocol.onMessage) === null || _usedProtocol_onMessage === void 0 ? void 0 : _usedProtocol_onMessage.call(usedProtocol, event);
             };
             const onStart = ()=>{
@@ -194,6 +414,7 @@ import { SessionStatus } from '../session/type.ts.js';
                 method: 'POST',
                 data: {
                     session_code: sessionCode,
+                    model,
                     input,
                     execute_kwargs: {
                         stream: true,
@@ -222,8 +443,9 @@ import { SessionStatus } from '../session/type.ts.js';
    * @param url - 请求 URL（可选）
    * @param config - 请求配置（可选）
    * @param property - 消息属性，用于传递引用内容或快捷键相关信息（可选）
+   * @param model - 模型标识（可选）
    */ const chat = function() {
-        var _ref = _async_to_generator(function*(userInput, sessionCode, url, config, property) {
+        var _ref = _async_to_generator(function*(userInput, sessionCode, url, config, property, model) {
             var _mediator_message;
             // 先新增一个 message
             yield (_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.createAndPlusMessage(_object_spread({
@@ -237,11 +459,12 @@ import { SessionStatus } from '../session/type.ts.js';
             // 发起聊天
             streamRequest({
                 sessionCode,
+                model,
                 url,
                 config
             });
         });
-        return function chat(userInput, sessionCode, url, config, property) {
+        return function chat(userInput, sessionCode, url, config, property, model) {
             return _ref.apply(this, arguments);
         };
     }();
@@ -251,13 +474,15 @@ import { SessionStatus } from '../session/type.ts.js';
    * @param sessionCode - 会话代码
    * @param url - 请求 URL（可选）
    * @param config - 请求配置（可选）
-   */ const resumeStreamingChat = (sessionCode, url, config)=>{
+   * @param model - 模型标识（可选）
+   */ const resumeStreamingChat = (sessionCode, url, config, model)=>{
         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) {
             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,
+                model,
                 url,
                 config,
                 lastMessageId
@@ -268,7 +493,7 @@ import { SessionStatus } from '../session/type.ts.js';
    * 轮询接口，判断是否可以继续聊天
    * @param sessionCode - 会话编码
    * @returns 是否可以继续聊天
-   */ const pollResumeSession = (sessionCode)=>{
+   */ const pollResumeSession = (sessionCode, model)=>{
         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)=>{
@@ -295,6 +520,7 @@ import { SessionStatus } from '../session/type.ts.js';
                     // 可以继续聊天，重新发起聊天（携带 execute_kwargs.resume 通知后端恢复中断）
                     streamRequest({
                         sessionCode,
+                        model,
                         resume: {
                             interruptId: pendingApprovalInterrupt.id,
                             status: ResumeStatus.Resolved
@@ -305,7 +531,7 @@ import { SessionStatus } from '../session/type.ts.js';
                         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);
+                        pollResumeSession(sessionCode, model);
                     }, 10000);
                 }
             });
@@ -322,6 +548,8 @@ import { SessionStatus } from '../session/type.ts.js';
    * 中止聊天（纯前端中止，后端继续处理）
    */ const abortChat = ()=>{
         var _chatAbortController_abort;
+        manualAbort = true;
+        clearReconnectTimer(false);
         chatAbortController === null || chatAbortController === void 0 ? void 0 : (_chatAbortController_abort = chatAbortController.abort) === null || _chatAbortController_abort === void 0 ? void 0 : _chatAbortController_abort.call(chatAbortController);
         chatAbortController = null;
     };
@@ -346,8 +574,9 @@ import { SessionStatus } from '../session/type.ts.js';
    * @param newContent - 新内容（可选，不传则使用原消息内容；支持多模态）
    * @param url - 请求 URL（可选）
    * @param config - 请求配置（可选）
+   * @param model - 模型标识（可选）
    */ const resendMessage = function() {
-        var _ref = _async_to_generator(function*(messageId, sessionCode, newContent, url, config) {
+        var _ref = _async_to_generator(function*(messageId, sessionCode, newContent, url, config, model) {
             var _mediator_message, _mediator_message1, _mediator_message2;
             const messages = ((_mediator_message = mediator.message) === null || _mediator_message === void 0 ? void 0 : _mediator_message.list.value) || [];
             // 1. 找到目标用户消息
@@ -380,6 +609,7 @@ import { SessionStatus } from '../session/type.ts.js';
             // 6. 立即发起流式请求（不等待删除和创建的 API 完成）
             streamRequest({
                 sessionCode,
+                model,
                 url,
                 config
             });
@@ -391,20 +621,29 @@ import { SessionStatus } from '../session/type.ts.js';
                 console.error('[resendMessage] API error:', error);
             });
         });
-        return function resendMessage(messageId, sessionCode, newContent, url, config) {
+        return function resendMessage(messageId, sessionCode, newContent, url, config, model) {
             return _ref.apply(this, arguments);
         };
     }();
     const reset = (protocol)=>{
-        // 重置状态
+        abortChat();
+        // 重置状态（保留 manualAbort=true，避免 abort 异步 onDone 误触发重连；下次 streamRequest 会复位）
         usedProtocol = protocol || new AGUIProtocol();
         info.value = null;
         isInfoLoading.value = false;
+        isChatting.value = false;
+        models.value = [];
+        isModelsLoading.value = false;
+        activeStreamContext = null;
+        reconnectAttempt = 0;
+        runFinished = false;
     };
     return {
         info,
         isInfoLoading,
         isChatting,
+        models,
+        isModelsLoading,
         chat,
         handleRole,
         resendMessage,
@@ -412,6 +651,7 @@ import { SessionStatus } from '../session/type.ts.js';
         abortChat,
         stopChat,
         getAgentInfo,
+        getLlms,
         reset,
         pollResumeSession,
         clearLongPollTimer,

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

@@ -27,6 +27,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
      * 记录活动的完整状态
      */
     handleActivitySnapshotEvent(event: IActivitySnapshotEvent): void;
+    handleArtifactsGeneratedCustomEvent(event: ICustomEvent): void;
     /**
      * 处理自定义事件
      */
@@ -51,6 +52,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
      * 自定义事件 处理流程编排任务更新
      */
     handleFlowAgentUpdateCustomEvent(event: ICustomEvent): void;
+    handleInfoCustomEvent(event: ICustomEvent): void;
     /**
      * 自定义事件 处理意图识别结束
      */
@@ -131,6 +133,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
     handleTextMessageEndEvent(event: ITextMessageEndEvent): void;
     /**
      * 处理文本消息开始事件
+     * 断线续传时 DLQ 会重放事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
      */
     handleTextMessageStartEvent(event: ITextMessageStartEvent): void;
     /**

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

@@ -35,7 +35,7 @@
     }
     return obj;
 }
-import { transferMessageApi2Message } from '../http/transform/index.ts.js';
+import { mergeArtifactsActivityIntoMessages, transferMessageApi2Message } from '../http/transform/index.ts.js';
 import { ActivityType, MessageRole, MessageStatus, MessageType } from '../message/index.ts.js';
 import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } from './type.ts.js';
 /**
@@ -50,18 +50,38 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
    * 处理活动快照事件
    * 记录活动的完整状态
    */ handleActivitySnapshotEvent(event) {
-        const message = this.messageModule.getCurrentLoadingMessage();
+        if (event.activityType === ActivityType.Info) {
+            const message = this.messageModule.getMessageByMessageId(event.messageId);
+            if ((message === null || message === void 0 ? void 0 : message.role) === MessageRole.Info) {
+                message.content = event.content;
+            }
+            return;
+        }
         if (event.activityType === ActivityType.Interrupt) {
+            const message = this.messageModule.getCurrentLoadingMessage();
             if ((message === null || message === void 0 ? void 0 : message.role) === MessageRole.Interrupt) {
                 message.content = event.content;
                 message.status = MessageStatus.Complete;
             }
         }
     }
+    handleArtifactsGeneratedCustomEvent(event) {
+        const message = this.messageModule.list.value.findLast((item)=>item.role === MessageRole.Assistant);
+        if (message) {
+            var _message;
+            const value = event.value;
+            var _property;
+            (_property = (_message = message).property) !== null && _property !== void 0 ? _property : _message.property = {};
+            message.property.artifacts = value.artifacts;
+        }
+    }
     /**
    * 处理自定义事件
    */ handleCustomEvent(event) {
         switch(event.name){
+            case CustomEventName.ArtifactsGenerated:
+                this.handleArtifactsGeneratedCustomEvent(event);
+                break;
             case CustomEventName.FlowAgentStart:
                 this.handleFlowAgentStartCustomEvent(event);
                 break;
@@ -98,6 +118,9 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
             case CustomEventName.FlowAgentUpdate:
                 this.handleFlowAgentUpdateCustomEvent(event);
                 break;
+            case CustomEventName.Info:
+                this.handleInfoCustomEvent(event);
+                break;
             default:
                 break;
         }
@@ -171,6 +194,15 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
             }
         });
     }
+    handleInfoCustomEvent(event) {
+        const value = event.value;
+        this.messageModule.plusMessage({
+            role: MessageRole.Info,
+            messageId: value.messageId,
+            content: value.content,
+            status: MessageStatus.Complete
+        });
+    }
     /**
    * 自定义事件 处理意图识别结束
    */ handleKnowledgeRagEndCustomEvent(_event) {
@@ -214,7 +246,7 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
    * 用于同步多端消息状态
    */ handleMessagesSnapshotEvent(event) {
         if (event.messages && event.messages.length > 0) {
-            this.messageModule.list.value = event.messages.map(transferMessageApi2Message);
+            this.messageModule.list.value = mergeArtifactsActivityIntoMessages(event.messages.map(transferMessageApi2Message));
         }
     }
     /**
@@ -349,7 +381,14 @@ import { CustomEventName, EventType, FlowTaskState, RunFinishedOutcomeType } fro
     }
     /**
    * 处理文本消息开始事件
+   * 断线续传时 DLQ 会重放事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
    */ handleTextMessageStartEvent(event) {
+        const existing = this.messageModule.getMessageByMessageId(event.messageId);
+        if (existing) {
+            existing.content = '';
+            existing.status = MessageStatus.Streaming;
+            return;
+        }
         this.messageModule.plusMessage({
             role: event.role,
             content: '',

package/dist/event/type.d.ts

@@ -1,11 +1,13 @@
-import { type IMessageApi, type MessageRole, type MessageStatus } from '../message/type';
+import { type IMessageApi, type IMessageArtifact, type MessageRole, type MessageStatus } from '../message/type';
 import type { JSONSchema4 } from 'json-schema';
 export declare enum CustomEventName {
+    ArtifactsGenerated = "artifacts_generated",
     FlowAgentEnd = "flow_agent_end",
     FlowAgentResult = "flow_agent_result",
     FlowAgentStart = "flow_agent_start",
     FlowAgentUpdate = "flow_agent_update",
     FlowAgentRestart = "flow_agent_restart",
+    Info = "info",
     KnowledgeRagEnd = "knowledge_rag_end",
     KnowledgeRagResult = "knowledge_rag_result",
     KnowledgeRagStart = "knowledge_rag_start",
@@ -114,6 +116,11 @@ export interface IActivitySnapshotEvent extends IBaseEvent {
     replace?: boolean;
     type: EventType.ActivitySnapshot;
 }
+export interface IArtifactsGeneratedCustomValue {
+    artifacts: IMessageArtifact[];
+    runId: string;
+    status: 'complete' | 'empty';
+}
 export interface IBaseEvent {
     timestamp?: number;
     type: EventType;
@@ -125,7 +132,7 @@ export interface IBaseEvent {
 export interface ICustomEvent extends IBaseEvent {
     name: CustomEventName;
     type: EventType.Custom;
-    value: IFlowAgentEndCustomValue | IFlowAgentResultCustomValue | IFlowAgentStartCustomValue | IFlowAgentRestartCustomValue | IKnowledgeRagResultCustomValue | IKnowledgeRagTextContentCustomValue | IReferenceDocumentCustomValue | ITempMessageCustomValue | IApprovalResultCustomValue;
+    value: IArtifactsGeneratedCustomValue | IFlowAgentEndCustomValue | IFlowAgentResultCustomValue | IFlowAgentStartCustomValue | IFlowAgentRestartCustomValue | IInfoCustomValue | 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 = {
@@ -152,6 +159,10 @@ export type IFlowAgentStartCustomValue = {
     task_id: string;
 }[];
 export type IFlowAgentRestartCustomValue = IFlowAgentStartCustomValue;
+export interface IInfoCustomValue {
+    content: string;
+    messageId: string;
+}
 export type IKnowledgeRagResultCustomValue = IReferenceDocumentCustomValue;
 export interface IKnowledgeRagTextContentCustomValue {
     cover: boolean;

package/dist/event/type.ts.js

@@ -24,11 +24,13 @@
  * IN THE SOFTWARE.
  */ export var CustomEventName;
 (function(CustomEventName) {
+    CustomEventName["ArtifactsGenerated"] = "artifacts_generated";
     CustomEventName["FlowAgentEnd"] = "flow_agent_end";
     CustomEventName["FlowAgentResult"] = "flow_agent_result";
     CustomEventName["FlowAgentStart"] = "flow_agent_start";
     CustomEventName["FlowAgentUpdate"] = "flow_agent_update";
     CustomEventName["FlowAgentRestart"] = "flow_agent_restart";
+    CustomEventName["Info"] = "info";
     CustomEventName["KnowledgeRagEnd"] = "knowledge_rag_end";
     CustomEventName["KnowledgeRagResult"] = "knowledge_rag_result";
     CustomEventName["KnowledgeRagStart"] = "knowledge_rag_start";

package/dist/http/index.d.ts

@@ -12,6 +12,7 @@ export declare const useHttp: (options: IUseChatHelperOptions) => {
     onError: (handler: import("./fetch").GlobalErrorHandler, options?: import("./fetch").ErrorHandlerOptions) => void;
     agent: {
         getAgentInfo: (config?: import("./fetch").IRequestConfig) => Promise<import("..").IAgentInfo>;
+        getLlms: (params?: import("..").ILlmListQuery, config?: import("./fetch").IRequestConfig) => Promise<import("..").ILlmItem[]>;
     };
     session: {
         clearSession: (sessionCode: string, config?: import("./fetch").IRequestConfig) => Promise<unknown>;
@@ -38,6 +39,7 @@ export declare const useHttp: (options: IUseChatHelperOptions) => {
         uploadFile: (sessionCode: string, file: File, config?: import("./fetch").IRequestConfig) => Promise<{
             download_url?: string;
         }>;
+        getPvFileDownloadUrl: (sessionCode: string, path: string, options?: import("..").GetPvFileDownloadUrlOptions, config?: import("./fetch").IRequestConfig) => Promise<import("..").IPvFileDownloadUrlResult>;
         isResumeSession: (sessionCode: string, config?: import("./fetch").IRequestConfig) => Promise<boolean>;
     };
     message: {

package/dist/http/module/agent.d.ts

@@ -1,3 +1,4 @@
+import type { ILlmItem, ILlmListQuery } from '../../agent/type';
 import type { FetchClient, IRequestConfig } from '../fetch';
 /**
  * agent 相关 http 接口
@@ -6,4 +7,5 @@ import type { FetchClient, IRequestConfig } from '../fetch';
  */
 export declare const useAgent: (fetchClient: FetchClient) => {
     getAgentInfo: (config?: IRequestConfig) => Promise<import("../../agent/type").IAgentInfo>;
+    getLlms: (params?: ILlmListQuery, config?: IRequestConfig) => Promise<ILlmItem[]>;
 };