@ai-group/chat-sdk 3.6.2 → 3.6.4

package/dist/esm/hooks/useADKChat.js

@@ -1,7 +1,7 @@
 import _regeneratorRuntime from "@babel/runtime/helpers/esm/regeneratorRuntime";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
-import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
+import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import _createForOfIteratorHelper from "@babel/runtime/helpers/esm/createForOfIteratorHelper";
 import { useEffect, useCallback, useMemo, useRef, useState } from "react";
@@ -44,10 +44,150 @@ var combineTextParts = function combineTextParts(parts) {
   }
   return result;
 };
+var DEFAULT_SESSION_EVENTS_POLLING_INTERVAL = 10000;
+var getMessageEventId = function getMessageEventId(messageItem) {
+  var _messageItem$raw;
+  return messageItem.eventId || ((_messageItem$raw = messageItem.raw) === null || _messageItem$raw === void 0 ? void 0 : _messageItem$raw.id);
+};
+var mapSessionMessages = function mapSessionMessages(sessionEvents) {
+  var mapped = [];
+  sessionEvents.forEach(function (item) {
+    if (!item || !item.content || !Array.isArray(item.content.parts)) return;
+    // 后端为异步任务插入的用户事件仅用于关联任务，不在页面展示。
+    if (item.author === "user" && item.content.parts.some(function (part) {
+      return part.task;
+    })) return;
+    var role = (item.content.role || "").toLowerCase() === "user" ? "user" : "bot";
+    var parts = item.content.parts.filter(function (part) {
+      if (!part) return false;
+      return Boolean(part.text || part.inlineData || part.functionCall || part.functionResponse || part.fileData || part.executableCode || part.codeExecutionResult || part.errorMessage);
+    });
+    if (parts.length === 0) return;
+    var textParts = parts.filter(function (part) {
+      return part.text || part.errorMessage || part.inlineData;
+    });
+    var fileDataParts = parts.filter(function (part) {
+      return part.fileData;
+    });
+    var otherParts = parts.filter(function (part) {
+      return !part.text && !part.errorMessage && !part.inlineData && !part.fileData;
+    });
+    if (textParts.length > 0 || fileDataParts.length > 0) {
+      var messageItem = {
+        id: v4(),
+        author: item.author,
+        invocationId: item.invocationId,
+        eventId: item.id,
+        timestamp: item.timestamp,
+        isLike: item.isLike,
+        role: role,
+        modelCode: item.modelCode,
+        usageMetadata: item.usageMetadata,
+        finishReason: item.finishReason,
+        raw: item
+      };
+      textParts.forEach(function (part) {
+        if (part.inlineData) {
+          messageItem.inlineData = {
+            displayName: part.inlineData.displayName,
+            data: part.inlineData.data,
+            mimeType: part.inlineData.mimeType
+          };
+        }
+        if (part.text) {
+          messageItem.text = (messageItem.text ? "".concat(messageItem.text, "\n") : "") + part.text;
+          if (typeof part.thought !== "undefined") messageItem.thought = part.thought;
+        }
+        if (part.errorMessage) {
+          messageItem.text = (messageItem.text ? "".concat(messageItem.text, "\n") : "") + part.errorMessage;
+        }
+      });
+      if (fileDataParts.length > 0) {
+        messageItem.fileData = fileDataParts.map(function (part) {
+          return {
+            displayName: part.fileData.displayName || "",
+            fileUri: part.fileData.fileUri,
+            mimeType: part.fileData.mimeType
+          };
+        });
+      }
+      mapped.push(messageItem);
+    }
+    otherParts.forEach(function (part) {
+      var messageItem = {
+        id: v4(),
+        author: item.author,
+        invocationId: item.invocationId,
+        eventId: item.id,
+        timestamp: item.timestamp,
+        isLike: item.isLike,
+        role: role,
+        modelCode: item.modelCode,
+        usageMetadata: item.usageMetadata,
+        finishReason: item.finishReason,
+        raw: item
+      };
+      if (part.functionCall) messageItem.functionCall = part.functionCall;
+      if (part.executableCode) messageItem.executableCode = part.executableCode;
+      if (part.codeExecutionResult) messageItem.codeExecutionResult = part.codeExecutionResult;
+      if (part.functionResponse) {
+        var functionCallMessage = mapped.find(function (currentMessage) {
+          var _currentMessage$funct, _part$functionRespons;
+          return ((_currentMessage$funct = currentMessage.functionCall) === null || _currentMessage$funct === void 0 ? void 0 : _currentMessage$funct.id) === ((_part$functionRespons = part.functionResponse) === null || _part$functionRespons === void 0 ? void 0 : _part$functionRespons.id);
+        });
+        if (functionCallMessage) {
+          functionCallMessage.functionResponse = part.functionResponse;
+        }
+        return;
+      }
+      mapped.push(messageItem);
+    });
+  });
+  return mapped;
+};
+var insertMissingSessionEvents = function insertMissingSessionEvents(currentMessages, sessionEvents) {
+  var renderedEventIds = new Set(currentMessages.map(getMessageEventId).filter(Boolean));
+  var missingEvents = sessionEvents.filter(function (event) {
+    var _event$content, _event$content2;
+    var parts = (_event$content = event.content) === null || _event$content === void 0 ? void 0 : _event$content.parts;
+    return Boolean(event.id) && ((_event$content2 = event.content) === null || _event$content2 === void 0 ? void 0 : _event$content2.role) === "model" && Array.isArray(parts) && parts.length > 0 && !renderedEventIds.has(event.id);
+  });
+  if (missingEvents.length === 0) return currentMessages;
+  var missingMessages = mapSessionMessages(missingEvents);
+  if (missingMessages.length === 0) return currentMessages;
+  var eventOrder = new Map(sessionEvents.map(function (event, index) {
+    return [event.id, index];
+  }));
+  var getMessageOrder = function getMessageOrder(messageItem) {
+    var _messageItem$timestam, _messageItem$raw2;
+    var eventId = getMessageEventId(messageItem);
+    if (eventId && eventOrder.has(eventId)) return eventOrder.get(eventId);
+    var timestamp = (_messageItem$timestam = messageItem.timestamp) !== null && _messageItem$timestam !== void 0 ? _messageItem$timestam : (_messageItem$raw2 = messageItem.raw) === null || _messageItem$raw2 === void 0 ? void 0 : _messageItem$raw2.timestamp;
+    if (timestamp !== undefined) {
+      var nextEventIndex = sessionEvents.findIndex(function (event) {
+        return (event.timestamp || 0) > timestamp;
+      });
+      return nextEventIndex < 0 ? sessionEvents.length + 0.5 : nextEventIndex - 0.5;
+    }
+    return Number.POSITIVE_INFINITY;
+  };
+  var nextMessages = _toConsumableArray(currentMessages);
+  missingMessages.forEach(function (messageItem) {
+    var targetOrder = getMessageOrder(messageItem);
+    var insertIndex = nextMessages.findIndex(function (currentMessage) {
+      var currentOrder = getMessageOrder(currentMessage);
+      return Number.isFinite(currentOrder) && currentOrder > targetOrder;
+    });
+    if (insertIndex < 0) insertIndex = nextMessages.length;
+    nextMessages.splice(insertIndex, 0, messageItem);
+  });
+  return nextMessages;
+};
 
 // 后台会话连接状态
 
 function useADKChat(_ref) {
+  var _config$session$pollS, _config$session, _config$session$sessi, _config$session2;
   var _ref$url = _ref.url,
     url = _ref$url === void 0 ? window.location.origin : _ref$url,
     token = _ref.token,
@@ -65,7 +205,12 @@ function useADKChat(_ref) {
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     loading = _useState2[0],
-    setLoading = _useState2[1];
+    setLoadingState = _useState2[1];
+  var loadingRef = useRef(false);
+  var setLoading = useCallback(function (nextLoading) {
+    loadingRef.current = nextLoading;
+    setLoadingState(nextLoading);
+  }, []);
   var _useState3 = useState(false),
     _useState4 = _slicedToArray(_useState3, 2),
     sessionLoading = _useState4[0],
@@ -78,6 +223,8 @@ function useADKChat(_ref) {
   var _ref2 = config || {},
     appNo = _ref2.appNo,
     showFirstSession = _ref2.showFirstSession;
+  var pollSessionEvents = (_config$session$pollS = config === null || config === void 0 || (_config$session = config.session) === null || _config$session === void 0 ? void 0 : _config$session.pollSessionEvents) !== null && _config$session$pollS !== void 0 ? _config$session$pollS : true;
+  var sessionEventsPollingInterval = Math.max((_config$session$sessi = config === null || config === void 0 || (_config$session2 = config.session) === null || _config$session2 === void 0 ? void 0 : _config$session2.sessionEventsPollingInterval) !== null && _config$session$sessi !== void 0 ? _config$session$sessi : DEFAULT_SESSION_EVENTS_POLLING_INTERVAL, 1000);
   var _useState5 = useState(null),
     _useState6 = _slicedToArray(_useState5, 2),
     appInfo = _useState6[0],
@@ -122,6 +269,10 @@ function useADKChat(_ref) {
     _useState20 = _slicedToArray(_useState19, 2),
     messages = _useState20[0],
     setMessages = _useState20[1];
+  var pendingSessionEventsRef = useRef(null);
+  var sessionEventsFlushTimerRef = useRef(null);
+  var sessionEventsSyncingRef = useRef(false);
+  var sessionDetailLoadingRef = useRef(false);
   // 用户自定义业务参数 (stateDelta)，每次发送请求时携带
   var stateDeltaRef = useRef(undefined);
 
@@ -151,6 +302,52 @@ function useADKChat(_ref) {
   }, [messages]);
   var textMsgRef = useRef(null);
   var eventDataRef = useRef(new Map());
+  var cancelSessionEventsFlush = useCallback(function () {
+    if (sessionEventsFlushTimerRef.current === null) return;
+    clearTimeout(sessionEventsFlushTimerRef.current);
+    sessionEventsFlushTimerRef.current = null;
+  }, []);
+  var flushPendingSessionEvents = useCallback(function () {
+    var pending = pendingSessionEventsRef.current;
+    var replyInProgress = loadingRef.current || sendingRef.current || textMsgRef.current !== null;
+    if (!pending || replyInProgress || pending.sessionId !== currentSessionIdRef.current) return;
+    var previewMessages = insertMissingSessionEvents(messagesRef.current, pending.events);
+    pendingSessionEventsRef.current = null;
+    if (previewMessages === messagesRef.current) return;
+    sessionEventsSyncingRef.current = true;
+    setLoading(true);
+    sessionEventsFlushTimerRef.current = setTimeout(function () {
+      sessionEventsFlushTimerRef.current = null;
+      if (pending.sessionId === currentSessionIdRef.current) {
+        setMessages(function (prev) {
+          var nextMessages = insertMissingSessionEvents(prev, pending.events);
+          messagesRef.current = nextMessages;
+          return nextMessages;
+        });
+      }
+      sessionEventsSyncingRef.current = false;
+      setLoading(false);
+    }, 0);
+  }, [setLoading]);
+  var syncSessionEvents = useCallback(function (events, targetSessionId) {
+    if (targetSessionId !== currentSessionIdRef.current) return;
+    pendingSessionEventsRef.current = {
+      sessionId: targetSessionId,
+      events: events
+    };
+    flushPendingSessionEvents();
+  }, [flushPendingSessionEvents]);
+  useEffect(function () {
+    pendingSessionEventsRef.current = null;
+    cancelSessionEventsFlush();
+    if (sessionEventsSyncingRef.current) {
+      sessionEventsSyncingRef.current = false;
+      setLoading(false);
+    }
+  }, [cancelSessionEventsFlush, currentSessionId, setLoading]);
+  useEffect(function () {
+    if (!loading) flushPendingSessionEvents();
+  }, [flushPendingSessionEvents, loading]);
 
   // 插入消息
   var insertMessage = useCallback(function (msg) {
@@ -345,9 +542,9 @@ function useADKChat(_ref) {
 
   // 处理建议类消息
   var processFollowupPart = useCallback(function (event) {
-    var _event$content;
+    var _event$content3;
     // 获取建议类消息的文本内容
-    var part = (event === null || event === void 0 || (_event$content = event.content) === null || _event$content === void 0 || (_event$content = _event$content.parts) === null || _event$content === void 0 ? void 0 : _event$content[0]) || null;
+    var part = (event === null || event === void 0 || (_event$content3 = event.content) === null || _event$content3 === void 0 || (_event$content3 = _event$content3.parts) === null || _event$content3 === void 0 ? void 0 : _event$content3[0]) || null;
     var text = (part === null || part === void 0 ? void 0 : part.text) || "";
     storeEvents(part, event);
     if (text) {
@@ -392,8 +589,10 @@ function useADKChat(_ref) {
 
       // 当 signal 被外部 abort（stopChat）时，确保外层 Promise 被 resolve
       // 否则 startChat 中的 await 会永远挂起，sendingRef 无法重置为 false
-      newCtrl.signal.addEventListener('abort', function () {
+      newCtrl.signal.addEventListener("abort", function () {
         resolve();
+      }, {
+        once: true
       });
       var requestUrl = "".concat(url, "/api/gateway-web/openApi/v1/aizt/app/").concat(appNo, "/sendMsgStreaming");
 
@@ -420,7 +619,7 @@ function useADKChat(_ref) {
                   } else if (response.status === 401 || response.status === 403) {
                     setLoading(false);
                     onError === null || onError === void 0 || onError({
-                      code: ErrorCode.API_ERROR,
+                      code: ErrorCode.AUTH_ERROR,
                       message: response.status === 401 ? "认证失败，token 无效或已过期" : "无权限访问该资源"
                     });
                     resolve();
@@ -603,7 +802,7 @@ function useADKChat(_ref) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             _ref3$text = _ref3.text, text = _ref3$text === void 0 ? "" : _ref3$text, _ref3$files = _ref3.files, files = _ref3$files === void 0 ? [] : _ref3$files, functionResponse = _ref3.functionResponse;
-            if (!(loading || sendingRef.current)) {
+            if (!(loadingRef.current || sendingRef.current)) {
               _context2.next = 3;
               break;
             }
@@ -705,7 +904,7 @@ function useADKChat(_ref) {
       return _regeneratorRuntime().wrap(function _callee3$(_context3) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
-            if (!(loading || sendingRef.current)) {
+            if (!(loadingRef.current || sendingRef.current)) {
               _context3.next = 2;
               break;
             }
@@ -789,7 +988,7 @@ function useADKChat(_ref) {
 
   // 使用建议问题
   var suggestChat = function suggestChat(text) {
-    if (loading) return;
+    if (loadingRef.current) return;
     if (!text.trim()) return;
     setSuggestedQuestions([]);
     startChat({
@@ -800,11 +999,14 @@ function useADKChat(_ref) {
   // 停止会话（只中断前台连接）
   var stopChat = useCallback(function () {
     var _ctrl$current;
+    pendingSessionEventsRef.current = null;
+    cancelSessionEventsFlush();
+    sessionEventsSyncingRef.current = false;
     (_ctrl$current = ctrl.current) === null || _ctrl$current === void 0 || _ctrl$current.abort();
     ctrl.current = null;
     setLoading(false);
     textMsgRef.current = null;
-  }, []);
+  }, [cancelSessionEventsFlush, setLoading]);
 
   // 清除/重置会话
   var clearChat = function clearChat() {
@@ -819,118 +1021,13 @@ function useADKChat(_ref) {
   };
 
   // 格式化会话记录
-  var formatMessages = function formatMessages(messages) {
+  var formatMessages = useCallback(function (sessionEvents) {
     var isReplace = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
-    var mapped = [];
-    messages.forEach(function (item) {
-      if (!item || !item.content || !Array.isArray(item.content.parts)) return;
-      var role = (item.content.role || "").toLowerCase() === "user" ? "user" : "bot";
-      var parts = Array.isArray(item.content.parts) ? item.content.parts.filter(function (p) {
-        if (!p) return false;
-        return Boolean(p.text || p.inlineData || p.functionCall || p.functionResponse || p.fileData || p.executableCode || p.codeExecutionResult || p.errorMessage);
-      }) : [];
-      if (parts.length === 0) return;
-
-      // 将同一条历史消息的 text/fileData parts 合并到一条 IMessage，避免拆分显示
-      var textParts = parts.filter(function (p) {
-        return p.text || p.errorMessage || p.inlineData;
-      });
-      var fileDataParts = parts.filter(function (p) {
-        return p.fileData;
-      });
-      var otherParts = parts.filter(function (p) {
-        return !p.text && !p.errorMessage && !p.inlineData && !p.fileData;
-      });
-
-      // 如果有 text/fileData，合并为一条消息
-      if (textParts.length > 0 || fileDataParts.length > 0) {
-        var msg = {
-          id: v4(),
-          author: item.author,
-          invocationId: item.invocationId,
-          eventId: item.id,
-          timestamp: item.timestamp,
-          isLike: item.isLike,
-          role: role,
-          modelCode: item.modelCode,
-          usageMetadata: item.usageMetadata,
-          finishReason: item.finishReason,
-          raw: item
-        };
-        var _iterator4 = _createForOfIteratorHelper(textParts),
-          _step4;
-        try {
-          for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-            var part = _step4.value;
-            if (part.inlineData) {
-              msg.inlineData = {
-                displayName: part.inlineData.displayName,
-                data: part.inlineData.data,
-                mimeType: part.inlineData.mimeType
-              };
-            }
-            if (part.text) {
-              msg.text = (msg.text ? msg.text + "\n" : "") + part.text;
-              if (typeof part.thought !== "undefined") msg.thought = part.thought;
-            }
-            if (part.errorMessage) {
-              msg.text = (msg.text ? msg.text + "\n" : "") + part.errorMessage;
-            }
-          }
-        } catch (err) {
-          _iterator4.e(err);
-        } finally {
-          _iterator4.f();
-        }
-        if (fileDataParts.length > 0) {
-          msg.fileData = fileDataParts.map(function (part) {
-            return {
-              displayName: part.fileData.displayName || "",
-              fileUri: part.fileData.fileUri,
-              mimeType: part.fileData.mimeType
-            };
-          });
-        }
-        mapped.push(msg);
-      }
-
-      // 处理其他类型的 parts（functionCall、executableCode 等）
-      otherParts.forEach(function (part) {
-        var msg = {
-          id: v4(),
-          author: item.author,
-          invocationId: item.invocationId,
-          eventId: item.id,
-          timestamp: item.timestamp,
-          isLike: item.isLike,
-          role: role,
-          modelCode: item.modelCode,
-          usageMetadata: item.usageMetadata,
-          finishReason: item.finishReason,
-          raw: item
-        };
-        if (part.functionCall) msg.functionCall = part.functionCall;
-        if (part.executableCode) msg.executableCode = part.executableCode;
-        if (part.codeExecutionResult) msg.codeExecutionResult = part.codeExecutionResult;
-        // 补全函数调用结果
-        if (part.functionResponse) {
-          // 通过 functionCall.id 寻找对应的函数调用消息，在那条消息上添加functionResponse
-          var functionCallMsg = mapped.find(function (msg) {
-            var _msg$functionCall2, _part$functionRespons;
-            return ((_msg$functionCall2 = msg.functionCall) === null || _msg$functionCall2 === void 0 ? void 0 : _msg$functionCall2.id) === ((_part$functionRespons = part.functionResponse) === null || _part$functionRespons === void 0 ? void 0 : _part$functionRespons.id);
-          });
-          if (functionCallMsg) {
-            functionCallMsg.functionResponse = part.functionResponse;
-          }
-          return;
-        }
-        mapped.push(msg);
-      });
-    });
+    var mapped = mapSessionMessages(sessionEvents);
     setMessages(function (prev) {
-      return isReplace ? mapped : [].concat(_toConsumableArray(prev), mapped);
+      return isReplace ? mapped : [].concat(_toConsumableArray(prev), _toConsumableArray(mapped));
     });
-  };
+  }, []);
 
   // 设置当前会话详情
   var setCurrentSession = /*#__PURE__*/function () {
@@ -940,7 +1037,7 @@ function useADKChat(_ref) {
         while (1) switch (_context4.prev = _context4.next) {
           case 0:
             if (!sessionId) {
-              _context4.next = 26;
+              _context4.next = 34;
               break;
             }
             if (!(sessionId === currentSessionId)) {
@@ -949,6 +1046,13 @@ function useADKChat(_ref) {
             }
             return _context4.abrupt("return");
           case 3:
+            pendingSessionEventsRef.current = null;
+            cancelSessionEventsFlush();
+            if (sessionEventsSyncingRef.current) {
+              sessionEventsSyncingRef.current = false;
+              setLoading(false);
+            }
+
             // 1. 将当前会话挂起到后台（不中断 SSE 连接）
             prevSessionId = currentSessionId;
             if (ctrl.current) {
@@ -975,7 +1079,7 @@ function useADKChat(_ref) {
             // 2. 尝试从后台恢复目标会话
             bg = backgroundRef.current.get(sessionId);
             if (!bg) {
-              _context4.next = 15;
+              _context4.next = 18;
               break;
             }
             setMessages(bg.messages);
@@ -986,18 +1090,20 @@ function useADKChat(_ref) {
             setInitialized(true);
             backgroundRef.current.delete(sessionId);
             return _context4.abrupt("return");
-          case 15:
+          case 18:
             // 3. 后台没有目标 session，走 API 加载（原有逻辑）
             setInitialized(false);
             setCurrentSessionId(sessionId);
-            _context4.next = 19;
+            sessionDetailLoadingRef.current = true;
+            _context4.prev = 21;
+            _context4.next = 24;
             return fetchSessionDetail({
               url: url,
               appNo: appNo,
               sessionId: sessionId,
               token: tokenRef.current
             });
-          case 19:
+          case 24:
             _yield$fetchSessionDe = _context4.sent;
             data = _yield$fetchSessionDe.data;
             result = _yield$fetchSessionDe.result;
@@ -1009,16 +1115,21 @@ function useADKChat(_ref) {
                 setSuggestedQuestions((appInfo === null || appInfo === void 0 || (_appInfo$onboardingIn4 = appInfo.onboardingInfo) === null || _appInfo$onboardingIn4 === void 0 ? void 0 : _appInfo$onboardingIn4.suggested_questions) || []);
               }
             }
+          case 28:
+            _context4.prev = 28;
+            sessionDetailLoadingRef.current = false;
             setInitialized(true);
-            _context4.next = 27;
+            return _context4.finish(28);
+          case 32:
+            _context4.next = 35;
             break;
-          case 26:
+          case 34:
             setCurrentSessionId(v4());
-          case 27:
+          case 35:
           case "end":
             return _context4.stop();
         }
-      }, _callee4);
+      }, _callee4, null, [[21,, 28, 32]]);
     }));
     return function setCurrentSession(_x2) {
       return _ref6.apply(this, arguments);
@@ -1100,6 +1211,12 @@ function useADKChat(_ref) {
                 clearChat();
               }
             } else {
+              // 服务端业务错误，透传原始 code + message 给接入方自行处理
+              onError === null || onError === void 0 || onError({
+                code: (result === null || result === void 0 ? void 0 : result.code) || "UNKNOWN_ERROR",
+                message: (result === null || result === void 0 ? void 0 : result.message) || "获取会话列表失败",
+                raw: result
+              });
               setSessionList([]);
               setCurrentSessionId(v4());
               setPrologue("");
@@ -1111,7 +1228,7 @@ function useADKChat(_ref) {
             _context5.prev = 13;
             _context5.t0 = _context5["catch"](1);
             onError === null || onError === void 0 || onError({
-              code: ErrorCode.API_ERROR,
+              code: ErrorCode.NETWORK_ERROR,
               message: "获取会话列表失败"
             });
           case 16:
@@ -1289,9 +1406,11 @@ function useADKChat(_ref) {
                 message: "初始化配置成功"
               });
             } else {
+              // 服务端业务错误，透传原始 code + message
               onError === null || onError === void 0 || onError({
-                code: result.code || ErrorCode.APP_NOT_FOUND,
-                message: result.message || "获取应用配置失败"
+                code: result.code || "UNKNOWN_ERROR",
+                message: result.message || "获取应用配置失败",
+                raw: result
               });
             }
             _context9.next = 13;
@@ -1300,7 +1419,7 @@ function useADKChat(_ref) {
             _context9.prev = 10;
             _context9.t0 = _context9["catch"](0);
             onError === null || onError === void 0 || onError({
-              code: ErrorCode.API_ERROR,
+              code: ErrorCode.NETWORK_ERROR,
               message: "获取应用配置失败"
             });
           case 13:
@@ -1333,10 +1452,72 @@ function useADKChat(_ref) {
     }
   }, [appInfo]);
 
+  // 轮询当前会话详情，空闲时补入后端异步任务产生的模型消息。
+  useEffect(function () {
+    if (!enabled || !initialized || !pollSessionEvents || !appNo || !currentSessionId) return;
+    var disposed = false;
+    var requesting = false;
+    var pollingSessionId = currentSessionId;
+    var poll = /*#__PURE__*/function () {
+      var _ref12 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10() {
+        var _yield$fetchSessionDe2, data, result;
+        return _regeneratorRuntime().wrap(function _callee10$(_context10) {
+          while (1) switch (_context10.prev = _context10.next) {
+            case 0:
+              if (!(requesting || sessionDetailLoadingRef.current)) {
+                _context10.next = 2;
+                break;
+              }
+              return _context10.abrupt("return");
+            case 2:
+              requesting = true;
+              _context10.prev = 3;
+              _context10.next = 6;
+              return fetchSessionDetail({
+                url: url,
+                appNo: appNo,
+                sessionId: pollingSessionId,
+                token: tokenRef.current
+              });
+            case 6:
+              _yield$fetchSessionDe2 = _context10.sent;
+              data = _yield$fetchSessionDe2.data;
+              result = _yield$fetchSessionDe2.result;
+              if (!disposed && (result === null || result === void 0 ? void 0 : result.code) === API_SUCCESS_CODE && Array.isArray(data)) {
+                syncSessionEvents(data, pollingSessionId);
+              }
+              _context10.next = 14;
+              break;
+            case 12:
+              _context10.prev = 12;
+              _context10.t0 = _context10["catch"](3);
+            case 14:
+              _context10.prev = 14;
+              requesting = false;
+              return _context10.finish(14);
+            case 17:
+            case "end":
+              return _context10.stop();
+          }
+        }, _callee10, null, [[3, 12, 14, 17]]);
+      }));
+      return function poll() {
+        return _ref12.apply(this, arguments);
+      };
+    }();
+    void poll();
+    var timer = window.setInterval(poll, sessionEventsPollingInterval);
+    return function () {
+      disposed = true;
+      window.clearInterval(timer);
+    };
+  }, [appNo, currentSessionId, enabled, initialized, pollSessionEvents, sessionEventsPollingInterval, syncSessionEvents, url]);
+
   // 组件卸载时清理所有连接（前台 + 后台）
   useEffect(function () {
     return function () {
       var _ctrl$current2;
+      cancelSessionEventsFlush();
       (_ctrl$current2 = ctrl.current) === null || _ctrl$current2 === void 0 || _ctrl$current2.abort();
       backgroundRef.current.forEach(function (bg) {
         var _bg$ctrl;
@@ -1344,7 +1525,7 @@ function useADKChat(_ref) {
       });
       backgroundRef.current.clear();
     };
-  }, []);
+  }, [cancelSessionEventsFlush]);
   return {
     appInfo: appInfo,
     startChat: startChat,