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

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

@@ -1,4 +1,4 @@
-import { ApprovalInterruptTicketStatus, ResumeStatus, RunFinishedOutcomeType, type IResume } from '../event';
+import { ApprovalInterruptTicketStatus, EventType, ResumeStatus, RunFinishedOutcomeType, type IResume } from '../event';
 import { MessageRole, MessageStatus, UserOperation } from '../message';
 import type { IRequestConfig, ISSEProtocol } from '../http';
 import type { IMediatorModule } from '../mediator';
@@ -154,7 +154,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                     runId: number;
                     threadId: string;
-                    type: import("../event").EventType.RunFinished;
+                    type: EventType.RunFinished;
                     outcome?: {
                         type: RunFinishedOutcomeType.Success;
                     } | {
@@ -1090,7 +1090,7 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
                     };
                     runId: number;
                     threadId: string;
-                    type: import("../event").EventType.RunFinished;
+                    type: EventType.RunFinished;
                     outcome?: {
                         type: RunFinishedOutcomeType.Success;
                     } | {
@@ -1896,13 +1896,15 @@ export declare const useAgent: (mediator: IMediatorModule, protocol: ISSEProtoco
     pollResumeSession: (sessionCode: string) => void;
     clearLongPollTimer: () => void;
     userOperationStreamRequest: (sessionCode: string, operation: UserOperation, payload: IUserOperationPayload, config?: IRequestConfig) => Promise<void>;
-    streamRequest: ({ sessionCode, url, config, resume, input, lastMessageId, }: {
+    streamRequest: ({ sessionCode, url, config, resume, input, lastMessageId, isReconnect, }: {
         sessionCode: string;
         url?: string;
         config?: IRequestConfig;
         resume?: IResume;
         input?: string;
         lastMessageId?: string;
+        /** 内部静默重连，不重置重连计数 */
+        isReconnect?: boolean;
     }) => Promise<void>;
 };
 export type IAgentModule = ReturnType<typeof useAgent>;

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 - 配置选项
@@ -95,6 +124,12 @@ import { SessionStatus } from '../session/type.ts.js';
     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;
     const getAgentInfo = ()=>{
         var _mediator_http;
         isInfoLoading.value = true;
@@ -137,9 +172,115 @@ import { SessionStatus } from '../session/type.ts.js';
             }
         });
     };
+    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,
+                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, url, config, resume, input, lastMessageId, isReconnect = false }) {
             var _mediator_http;
+            if (!isReconnect) {
+                resetStreamReconnectState();
+            }
+            activeStreamContext = {
+                sessionCode,
+                url,
+                config
+            };
             // ag-ui 协议需要注入消息模块
             if (usedProtocol instanceof AGUIProtocol) {
                 usedProtocol.injectMessageModule(mediator.message);
@@ -154,8 +295,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 +306,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 = ()=>{
@@ -322,6 +516,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;
     };
@@ -396,10 +592,15 @@ import { SessionStatus } from '../session/type.ts.js';
         };
     }();
     const reset = (protocol)=>{
-        // 重置状态
+        abortChat();
+        // 重置状态（保留 manualAbort=true，避免 abort 异步 onDone 误触发重连；下次 streamRequest 会复位）
         usedProtocol = protocol || new AGUIProtocol();
         info.value = null;
         isInfoLoading.value = false;
+        isChatting.value = false;
+        activeStreamContext = null;
+        reconnectAttempt = 0;
+        runFinished = false;
     };
     return {
         info,

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

@@ -131,6 +131,7 @@ export declare class AGUIProtocol implements ISSEProtocol {
     handleTextMessageEndEvent(event: ITextMessageEndEvent): void;
     /**
      * 处理文本消息开始事件
+     * 断线续传时 DLQ 会重放事件：同 messageId 已存在则重置内容，避免重复气泡/文本翻倍
      */
     handleTextMessageStartEvent(event: ITextMessageStartEvent): void;
     /**

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

@@ -349,7 +349,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/index.d.ts

@@ -1898,13 +1898,14 @@ export declare const useChatHelper: (options: IUseChatHelperOptions) => {
         pollResumeSession: (sessionCode: string) => void;
         clearLongPollTimer: () => void;
         userOperationStreamRequest: (sessionCode: string, operation: import("./message").UserOperation, payload: import("./message").IUserOperationPayload, config?: import("./http").IRequestConfig) => Promise<void>;
-        streamRequest: ({ sessionCode, url, config, resume, input, lastMessageId, }: {
+        streamRequest: ({ sessionCode, url, config, resume, input, lastMessageId, isReconnect, }: {
             sessionCode: string;
             url?: string;
             config?: import("./http").IRequestConfig;
             resume?: import("./event").IResume;
             input?: string;
             lastMessageId?: string;
+            isReconnect?: boolean;
         }) => Promise<void>;
     };
     session: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/chat-helper",
-  "version": "0.0.12-beta.10",
+  "version": "0.0.12-beta.11",
   "description": "",
   "main": "./dist/index.ts.js",
   "types": "./dist/index.d.ts",