magic-agent 2.3.0 → 2.3.2

package/client-ui/shared/transport-http.js

@@ -364,49 +364,194 @@
            event: snapshot  data: {session, after, lastSeq}   游标超前 → 重拉历史
            event: end       data: {session, after, state, reason}  reason ∈ terminal / max_duration
          h.onOpen(open) / h.onEvent(ev) / h.onSnapshot(snap) / h.onEnd(end) / h.onError(err)。
-         返回 {cancel}：换会话 / 组件销毁时调它断流。老服务端没有这个路由 → onError(404)。 */
+         返回 {cancel}：换会话 / 组件销毁时调它断流。老服务端没有这个路由 → onError(404)。
+
+         ── 断线自动重连（2026-10-24 用户：「移动端会话同步断连时要有重试机制」）──
+         移动网络 / WebView 切后台 / 反向代理空闲超时都会把这条长连接掐掉，
+         而服务端明确把 `reason=max_duration` 定义为「会话还在跑，客户端重连接着跟」。
+         所以断流**不再是终态**：这里保留游标、按指数退避重新 `GET .../follow?after=`，
+         从断点续推，只有真正拿到 `end` 或重试用尽才交给 onEnd。
+           · 游标 = 最后一条事件的 seq（文件级，允许跳号；不能取全文件最大，见契约 3.4）；
+           · 退避 0.8s 起、翻倍、15s 封顶；连续 12 次或 6 分钟仍连不上才算失败；
+           · 4xx（404 老网关 / 401 令牌失效）**不重试** —— 重试也不会有，立即如实收尾；
+           · `max_duration` 是服务端 30 分钟轮换，不是断开：健康连接（>60s）立刻续接；
+           · 重连成功但一次事件都没收到就再断（代理秒断）→ 不重置退避，避免空转。
+         h.onRetry({reason, attempt, delay, after}) / h.onResume({attempts, after}) 可选：
+         给界面显示「正在重连 / 已恢复」用，老宿主不实现也不影响续流。 */
       followSession: function (id, after, h) {
-        var ctl = typeof AbortController !== 'undefined' ? new AbortController() : null;
-        var ended = false;
+        /* 几档退避集中在这里，排查「为什么两分钟才放弃」时只看这一处。 */
+        var FOLLOW_BASE = 800;             // 第一次重连等待（移动网络瞬断通常 <1s 就回来）
+        var FOLLOW_CAP = 15000;            // 单次退避上限
+        var FOLLOW_MAX_TRIES = 12;         // 连续失败上限（合计约 2 分钟）
+        var FOLLOW_MAX_WINDOW = 6 * 60 * 1000;  // 或连续断了 6 分钟（后台计时器被节流等）
+
+        var cursor = Math.max(0, Number(after) || 0);
+        var stopped = false, finished = false, timer = 0, abort = null;
+        var tries = 0, firstDropAt = 0;
+        var wakeOnline = null, wakeVisible = null;
+
+        var clearTimer = function () { if (timer) { clearTimeout(timer); timer = 0; } };
+        /* 网络刚回来 / 用户切回前台时，别干等最长 15s 的退避 —— 立刻重连一次。
+           只在「有重连计时器在等」时生效；正常连接期间这两个监听什么都不做。 */
+        var wake = function () {
+          if (stopped || finished || !timer) return;
+          clearTimer();
+          connect();
+        };
+        var bindWake = function () {
+          if (wakeOnline || typeof window === 'undefined' || !window.addEventListener) return;
+          wakeOnline = wake;
+          wakeVisible = function () {
+            if (typeof document === 'undefined' || !document.visibilityState
+              || document.visibilityState === 'visible') wake();
+          };
+          try { window.addEventListener('online', wakeOnline); } catch (e) {}
+          if (typeof document !== 'undefined' && document.addEventListener) {
+            try { document.addEventListener('visibilitychange', wakeVisible); } catch (e) {}
+          }
+        };
+        var unbindWake = function () {
+          if (wakeOnline && typeof window !== 'undefined' && window.removeEventListener) {
+            try { window.removeEventListener('online', wakeOnline); } catch (e) {}
+          }
+          if (wakeVisible && typeof document !== 'undefined' && document.removeEventListener) {
+            try { document.removeEventListener('visibilitychange', wakeVisible); } catch (e) {}
+          }
+          wakeOnline = null; wakeVisible = null;
+        };
+        var detach = function () { var a = abort; abort = null; if (a) { try { a(); } catch (e) {} } };
         var finish = function (info) {
-          if (ended) return;
-          ended = true;
-          if (h && h.onEnd) h.onEnd(info || {});
+          if (finished) return;
+          finished = true;
+          clearTimer();
+          unbindWake();
+          detach();
+          if (!stopped && h && h.onEnd) h.onEnd(info || {});
         };
-        var q = '?lean=1' + (after == null ? '' : '&after=' + encodeURIComponent(after));
-        api('/desk/session/' + encodeURIComponent(id) + '/follow' + q, { signal: ctl ? ctl.signal : undefined })
-          .then(function (resp) {
-            var reader = resp.body.getReader(), dec = new TextDecoder(), buf = '';
-            return (function pump() {
-              return reader.read().then(function (chunk) {
-                if (chunk.done) return finish({ reason: 'closed' });
-                buf += dec.decode(chunk.value, { stream: true });
-                var blocks = buf.split('\n\n');
-                buf = blocks.pop();
-                blocks.forEach(function (b) {
-                  var name = '', data = '';
-                  b.split('\n').forEach(function (ln) {
-                    if (ln.indexOf('event: ') === 0) name = ln.slice(7).trim();
-                    else if (ln.indexOf('data: ') === 0) data += ln.slice(6);
+        var stop = function () {
+          if (stopped) return;
+          stopped = true;
+          clearTimer();
+          unbindWake();
+          detach();
+        };
+        var retryDelay = function (n) {
+          return Math.min(FOLLOW_CAP, FOLLOW_BASE * Math.pow(2, Math.max(0, n)));
+        };
+        var schedule = function (reason, lived) {
+          if (stopped || finished || timer) return;
+          /* 服务端 30 分钟主动轮换：健康连接立刻续接，不计失败次数。
+             若不到 60s 就轮换（异常代理 / 测试桩），按普通断流退避，别原地打转。 */
+          var rotate = (reason === 'max_duration' && lived >= 60000);
+          if (rotate) {
+            tries = 0; firstDropAt = 0;
+            timer = setTimeout(function () { timer = 0; connect(); }, 250);
+            return;
+          }
+          if (!firstDropAt) firstDropAt = Date.now();
+          if (tries >= FOLLOW_MAX_TRIES || Date.now() - firstDropAt > FOLLOW_MAX_WINDOW) {
+            var err = new Error('会话同步连续重连失败：' + (reason || 'error'));
+            err.reason = reason || 'error';
+            if (h && h.onError) { try { h.onError(err); } catch (e) {} }
+            finish({ reason: reason === 'max_duration' ? 'max_duration' : 'error' });
+            return;
+          }
+          var delay = retryDelay(tries++);
+          if (h && h.onRetry) {
+            try { h.onRetry({ reason: reason || 'error', attempt: tries, delay: delay, after: cursor }); } catch (e) {}
+          }
+          timer = setTimeout(function () { timer = 0; connect(); }, delay);
+        };
+
+        /* 打开一轮连接。每轮都有自己的 AbortController 与 settled 标记：
+           旧连接迟到的 error / end 不许影响新一轮（否则会多排一次重连或提前收尾）。 */
+        var connect = function () {
+          if (stopped || finished) return;
+          var my = { settled: false, openedAt: 0, gotEvent: false };
+          var ctl = typeof AbortController !== 'undefined' ? new AbortController() : null;
+          abort = function () { if (ctl) ctl.abort(); };
+          var drop = function (reason, info) {
+            if (my.settled) return;
+            my.settled = true;
+            if (stopped || finished) return;
+            detach();
+            var lived = my.openedAt ? Date.now() - my.openedAt : 0;
+            if (reason === 'terminal') {
+              finish(info || { reason: 'terminal' });
+              return;
+            }
+            /* 健康过（收到过事件或稳定 5s 以上）才把退避清零：
+               「连上→秒断→再连」不该每次从 0.8s 重来。 */
+            if (my.gotEvent || lived >= 5000) { tries = 0; firstDropAt = 0; }
+            schedule(reason, lived);
+          };
+          var q = '?lean=1&after=' + encodeURIComponent(cursor);
+          api('/desk/session/' + encodeURIComponent(id) + '/follow' + q, { signal: ctl ? ctl.signal : undefined })
+            .then(function (resp) {
+              if (!resp || !resp.body) throw new Error('服务端没有返回流');
+              var reader = resp.body.getReader(), dec = new TextDecoder(), buf = '';
+              return (function pump() {
+                return reader.read().then(function (chunk) {
+                  if (my.settled) return;
+                  if (chunk.done) { drop('closed'); return; }
+                  buf += dec.decode(chunk.value, { stream: true });
+                  var blocks = buf.split('\n\n');
+                  buf = blocks.pop();
+                  blocks.forEach(function (b) {
+                    if (my.settled) return;
+                    var name = '', data = '';
+                    b.split('\n').forEach(function (ln) {
+                      if (ln.indexOf('event: ') === 0) name = ln.slice(7).trim();
+                      else if (ln.indexOf('data: ') === 0) data += ln.slice(6);
+                    });
+                    if (!data) return;                       // `: ping` 心跳注释帧
+                    var ev; try { ev = JSON.parse(data); } catch (e) { return; }
+                    if (name === 'open') {
+                      if (!my.openedAt) {
+                        my.openedAt = Date.now();
+                        /* 只有「断过又回来」才报恢复：首连不打扰界面。 */
+                        if (tries > 0 && h && h.onResume) {
+                          try { h.onResume({ attempts: tries, after: cursor }); } catch (e) {}
+                        }
+                      }
+                      if (h && h.onOpen) h.onOpen(ev);
+                      return;
+                    }
+                    if (name === 'snapshot') {
+                      var last = Number(ev && ev.lastSeq);
+                      if (isFinite(last) && last >= 0) cursor = last;
+                      if (h && h.onSnapshot) h.onSnapshot(ev);
+                      return;
+                    }
+                    if (name === 'end') {
+                      drop(String((ev && ev.reason) || 'closed'), ev);
+                      return;
+                    }
+                    my.gotEvent = true;
+                    var seq = Number(ev && ev.seq);
+                    if (isFinite(seq) && seq > cursor) cursor = seq;
+                    if (h && h.onEvent) h.onEvent(ev);
                   });
-                  if (!data) return;                       // `: ping` 心跳注释帧
-                  var ev; try { ev = JSON.parse(data); } catch (e) { return; }
-                  if (name === 'open') { if (h && h.onOpen) h.onOpen(ev); return; }
-                  if (name === 'snapshot') { if (h && h.onSnapshot) h.onSnapshot(ev); return; }
-                  if (name === 'end') { finish(ev); return; }
-                  if (h && h.onEvent) h.onEvent(ev);
+                  if (my.settled) return;
+                  return pump();
                 });
-                if (ended) return;
-                return pump();
-              });
-            })();
-          })
-          .catch(function (e) {
-            if (ended) return;
-            if (h && h.onError) h.onError(e);
-            finish({ reason: 'error' });
-          });
-        return { cancel: function () { if (ctl) ctl.abort(); } };
+              })();
+            })
+            .catch(function (e) {
+              if (my.settled || stopped || finished) return;
+              /* 4xx 是确定性失败：老网关没有这个路由（404）/ 令牌失效（401/403）——
+                 重试只会白等两分钟，立即按原样交给调用方（它会退回 ask 缓冲或报错）。 */
+              if (e && (e.status === 400 || e.status === 401 || e.status === 403 || e.status === 404)) {
+                if (h && h.onError) { try { h.onError(e); } catch (e2) {} }
+                finish({ reason: 'error' });
+                return;
+              }
+              drop('error');
+            });
+        };
+        bindWake();
+        connect();
+        return { cancel: stop };
       }
     };
   }