@ai-group/chat-sdk 3.6.3 → 3.6.5

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,196 @@ 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 getComparableMessageContent = function getComparableMessageContent(messageItem) {
+  var _messageItem$text;
+  return JSON.stringify({
+    role: messageItem.role,
+    text: ((_messageItem$text = messageItem.text) === null || _messageItem$text === void 0 ? void 0 : _messageItem$text.replace(/\r\n/g, "\n").trim()) || "",
+    thought: Boolean(messageItem.thought),
+    inlineData: messageItem.inlineData || null,
+    fileData: messageItem.fileData || null,
+    functionCall: messageItem.functionCall || null,
+    functionResponse: messageItem.functionResponse || null,
+    executableCode: messageItem.executableCode || null,
+    codeExecutionResult: messageItem.codeExecutionResult || null
+  });
+};
+var isStreamMessageWithoutServerEventId = function isStreamMessageWithoutServerEventId(messageItem) {
+  var eventId = getMessageEventId(messageItem);
+  return Boolean(messageItem.invocationId) && (!eventId || eventId === messageItem.invocationId);
+};
+var insertMissingSessionEvents = function insertMissingSessionEvents(currentMessages, sessionEvents) {
+  var renderedEventIds = new Set(currentMessages.map(getMessageEventId).filter(Boolean));
+  var unmatchedStreamMessageIndexes = new Set(currentMessages.map(function (messageItem, index) {
+    return isStreamMessageWithoutServerEventId(messageItem) ? index : -1;
+  }).filter(function (index) {
+    return index >= 0;
+  }));
+  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;
+    var canRender = Boolean(event.id) && ((_event$content2 = event.content) === null || _event$content2 === void 0 ? void 0 : _event$content2.role) === "model" && Array.isArray(parts) && parts.length > 0;
+    if (!canRender || renderedEventIds.has(event.id)) return false;
+
+    // 新版 SSE 包装数据没有事件 id，只能临时使用 invocationId。
+    // 用 invocationId + 完整渲染内容做一次性身份对齐，避免会话轮询重复插入；
+    // 同 invocation 下内容不同或后续出现的事件，仍然按独立 event.id 补入。
+    var eventMessages = mapSessionMessages([event]);
+    var matchedIndexes = [];
+    var isRenderedByStream = eventMessages.length > 0 && eventMessages.every(function (eventMessage) {
+      var comparableContent = getComparableMessageContent(eventMessage);
+      var matchedIndex = currentMessages.findIndex(function (currentMessage, index) {
+        return unmatchedStreamMessageIndexes.has(index) && !matchedIndexes.includes(index) && currentMessage.invocationId === eventMessage.invocationId && getComparableMessageContent(currentMessage) === comparableContent;
+      });
+      if (matchedIndex < 0) return false;
+      matchedIndexes.push(matchedIndex);
+      return true;
+    });
+    if (isRenderedByStream) {
+      matchedIndexes.forEach(function (index) {
+        return unmatchedStreamMessageIndexes.delete(index);
+      });
+      return false;
+    }
+    return true;
+  });
+  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 +251,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 +269,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 +315,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 +348,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 +588,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) {
@@ -449,7 +692,7 @@ function useADKChat(_ref) {
               content: rawData.data,
               invocationId: rawData.result.invocationId,
               sessionId: rawData.result.sessionId,
-              id: rawData.result.invocationId
+              id: rawData.data.id || rawData.result.id || rawData.result.eventId || rawData.result.invocationId
             });
           }
           if (chunkJson.error) {
@@ -605,7 +848,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;
             }
@@ -707,7 +950,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;
             }
@@ -791,7 +1034,7 @@ function useADKChat(_ref) {
 
   // 使用建议问题
   var suggestChat = function suggestChat(text) {
-    if (loading) return;
+    if (loadingRef.current) return;
     if (!text.trim()) return;
     setSuggestedQuestions([]);
     startChat({
@@ -802,11 +1045,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() {
@@ -821,118 +1067,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 () {
@@ -942,7 +1083,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)) {
@@ -951,6 +1092,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) {
@@ -977,7 +1125,7 @@ function useADKChat(_ref) {
             // 2. 尝试从后台恢复目标会话
             bg = backgroundRef.current.get(sessionId);
             if (!bg) {
-              _context4.next = 15;
+              _context4.next = 18;
               break;
             }
             setMessages(bg.messages);
@@ -988,18 +1136,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;
@@ -1011,16 +1161,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);
@@ -1104,7 +1259,7 @@ function useADKChat(_ref) {
             } else {
               // 服务端业务错误，透传原始 code + message 给接入方自行处理
               onError === null || onError === void 0 || onError({
-                code: (result === null || result === void 0 ? void 0 : result.code) || 'UNKNOWN_ERROR',
+                code: (result === null || result === void 0 ? void 0 : result.code) || "UNKNOWN_ERROR",
                 message: (result === null || result === void 0 ? void 0 : result.message) || "获取会话列表失败",
                 raw: result
               });
@@ -1299,7 +1454,7 @@ function useADKChat(_ref) {
             } else {
               // 服务端业务错误，透传原始 code + message
               onError === null || onError === void 0 || onError({
-                code: result.code || 'UNKNOWN_ERROR',
+                code: result.code || "UNKNOWN_ERROR",
                 message: result.message || "获取应用配置失败",
                 raw: result
               });
@@ -1343,10 +1498,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;
@@ -1354,7 +1571,7 @@ function useADKChat(_ref) {
       });
       backgroundRef.current.clear();
     };
-  }, []);
+  }, [cancelSessionEventsFlush]);
   return {
     appInfo: appInfo,
     startChat: startChat,