@ai-matrx/meet 0.11.28 → 0.11.29

package/dist/react.js

@@ -1,6 +1,352 @@
 "use client";
 "use client";
 
+// src/core/connection-supervisor.ts
+var DEFAULT_CONNECTION_POLICY = {
+  bannerDelayMs: 2e3,
+  autoRejoin: true,
+  autoRejoinMaxAttempts: 5,
+  reconnectGraceSeconds: 30
+};
+function clampInt(value, min, max, fallback) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return Math.min(max, Math.max(min, Math.round(value)));
+}
+function connectionPolicyFrom(raw) {
+  if (typeof raw !== "object" || raw === null) return DEFAULT_CONNECTION_POLICY;
+  const row = raw;
+  const d = DEFAULT_CONNECTION_POLICY;
+  return {
+    bannerDelayMs: clampInt(row["reconnect_banner_delay_ms"], 0, 1e4, d.bannerDelayMs),
+    autoRejoin: typeof row["auto_rejoin"] === "boolean" ? row["auto_rejoin"] : d.autoRejoin,
+    autoRejoinMaxAttempts: clampInt(row["auto_rejoin_max_attempts"], 0, 20, d.autoRejoinMaxAttempts),
+    reconnectGraceSeconds: clampInt(row["reconnect_grace_seconds"], 0, 600, d.reconnectGraceSeconds)
+  };
+}
+var LIVEKIT_BASE_DELAYS_MS = [0, 300, 1200, 2700, 4800, 7e3];
+function createReconnectPolicy(options = {}) {
+  const delays = options.delaysMs !== void 0 && options.delaysMs.length > 0 ? options.delaysMs : LIVEKIT_BASE_DELAYS_MS;
+  const giveUpMs = options.giveUpMs ?? 45e3;
+  const maxAttempts = options.maxAttempts ?? 12;
+  const random = options.random ?? Math.random;
+  return {
+    nextRetryDelayInMs({ retryCount, elapsedMs }) {
+      if (retryCount >= maxAttempts || elapsedMs >= giveUpMs) return null;
+      const base = delays[Math.min(retryCount, delays.length - 1)] ?? 0;
+      const spread = Math.min(2e3, Math.max(500, base / 2));
+      return Math.round(base + random() * spread);
+    }
+  };
+}
+function createWebNetworkPort() {
+  const scope = globalThis;
+  return {
+    online: () => scope.navigator?.onLine !== false,
+    subscribe(listener) {
+      if (typeof scope.addEventListener !== "function") return () => void 0;
+      const on = () => listener(true);
+      const off = () => listener(false);
+      scope.addEventListener("online", on);
+      scope.addEventListener("offline", off);
+      return () => {
+        scope.removeEventListener?.("online", on);
+        scope.removeEventListener?.("offline", off);
+      };
+    }
+  };
+}
+function createReachabilityProbe(urls, timeoutMs = 4e3) {
+  return async () => {
+    const targets = urls().filter((url) => url.length > 0);
+    if (targets.length === 0 || typeof fetch !== "function") return true;
+    const one = async (url) => {
+      const controller = typeof AbortController === "function" ? new AbortController() : null;
+      const timer = setTimeout(() => controller?.abort(), timeoutMs);
+      try {
+        await fetch(url, {
+          method: "GET",
+          mode: "no-cors",
+          cache: "no-store",
+          credentials: "omit",
+          ...controller !== null ? { signal: controller.signal } : {}
+        });
+        return true;
+      } catch {
+        return false;
+      } finally {
+        clearTimeout(timer);
+      }
+    };
+    const answers = await Promise.all(targets.map(one));
+    return answers.every(Boolean);
+  };
+}
+function httpUrlOf(serverUrl) {
+  return serverUrl.replace(/^ws(s?):\/\//i, "http$1://");
+}
+var RESUME_WINDOW_MS = 15 * 6e4;
+var RESUME_KEY = "mx-meet:resume:";
+function createWebResumeStorage() {
+  const storage = globalThis.sessionStorage;
+  if (storage === void 0) return void 0;
+  return {
+    load(roomName) {
+      try {
+        const raw = storage.getItem(RESUME_KEY + roomName);
+        if (raw === null) return null;
+        const parsed = JSON.parse(raw);
+        return typeof parsed?.at === "number" && typeof parsed.request?.roomName === "string" ? parsed : null;
+      } catch {
+        return null;
+      }
+    },
+    save(roomName, marker) {
+      try {
+        storage.setItem(RESUME_KEY + roomName, JSON.stringify(marker));
+      } catch {
+      }
+    },
+    clear(roomName) {
+      try {
+        storage.removeItem(RESUME_KEY + roomName);
+      } catch {
+      }
+    }
+  };
+}
+var CLEARS_RESUME = (phase) => phase === "left" || phase === "removed" || phase === "superseded" || phase === "inactive" || phase === "ended" || phase === "record" || phase === "prejoin" || phase.startsWith("refused:") || phase.startsWith("waiting:");
+function autoRejoinDelayMs(attempt, random = Math.random) {
+  const base = Math.min(15e3, 1e3 * 2 ** Math.max(0, attempt));
+  return Math.round(base * (0.5 + random()));
+}
+function createConnectionSupervisor(options) {
+  const { store, network } = options;
+  const now = options.now ?? (() => Date.now());
+  const random = options.random ?? Math.random;
+  const probeEveryMs = options.probeEveryMs ?? 3e3;
+  let driverRegion = null;
+  let probeTimer = null;
+  let probing = false;
+  let bannerTimer = null;
+  let rejoinTimer = null;
+  let rejoinAttempts = 0;
+  let lastPhase = store.snapshot().phase;
+  let lastSavedAt = 0;
+  let disposed = false;
+  const inCall = () => store.snapshot().phase === "in_call";
+  const dropped = () => store.snapshot().phase === "disconnected";
+  function setRegion(next) {
+    if (store.snapshot().connection !== next) store.patch({ connection: next });
+  }
+  function regionFor(reachable) {
+    if (!network.online()) return "offline";
+    if (reachable === false) return "server_unreachable";
+    if (dropped()) return reachable === true ? "stable" : store.snapshot().connection;
+    return driverRegion ?? "stable";
+  }
+  function needsWatch() {
+    const snap = store.snapshot();
+    if (dropped()) return true;
+    return inCall() && (driverRegion !== null || snap.connection !== "stable");
+  }
+  function stopProbe() {
+    if (probeTimer !== null) clearTimeout(probeTimer);
+    probeTimer = null;
+  }
+  function scheduleProbe(delayMs) {
+    if (disposed || probeTimer !== null) return;
+    probeTimer = setTimeout(() => {
+      probeTimer = null;
+      void runProbe();
+    }, delayMs);
+  }
+  async function runProbe() {
+    if (disposed || probing) return;
+    if (!needsWatch()) return;
+    if (!network.online()) {
+      setRegion("offline");
+      scheduleProbe(probeEveryMs);
+      return;
+    }
+    probing = true;
+    let reachable = false;
+    try {
+      reachable = await options.probe();
+    } catch {
+      reachable = false;
+    } finally {
+      probing = false;
+    }
+    if (disposed) return;
+    if (inCall() || dropped()) setRegion(regionFor(reachable));
+    if (dropped() && reachable) maybeRejoin();
+    if (needsWatch()) scheduleProbe(Math.round(probeEveryMs * (0.75 + random() * 0.5)));
+  }
+  function syncBanner() {
+    const snap = store.snapshot();
+    const unstable = snap.phase === "in_call" && snap.connection !== "stable";
+    if (!unstable) {
+      if (bannerTimer !== null) clearTimeout(bannerTimer);
+      bannerTimer = null;
+      if (snap.connectionBanner) store.patch({ connectionBanner: false });
+      return;
+    }
+    if (snap.connectionBanner || bannerTimer !== null) return;
+    const delay = options.policy().bannerDelayMs;
+    if (delay <= 0) {
+      store.patch({ connectionBanner: true });
+      return;
+    }
+    bannerTimer = setTimeout(() => {
+      bannerTimer = null;
+      const latest = store.snapshot();
+      if (latest.phase === "in_call" && latest.connection !== "stable" && !latest.connectionBanner) {
+        store.patch({ connectionBanner: true });
+      }
+    }, delay);
+  }
+  function stopRejoin() {
+    if (rejoinTimer !== null) clearTimeout(rejoinTimer);
+    rejoinTimer = null;
+  }
+  function maybeRejoin() {
+    if (disposed || rejoinTimer !== null || !dropped()) return;
+    const policy = options.policy();
+    if (!policy.autoRejoin) return;
+    if (rejoinAttempts >= policy.autoRejoinMaxAttempts) return;
+    if (!network.online()) return;
+    const attempt = rejoinAttempts;
+    rejoinTimer = setTimeout(() => {
+      rejoinTimer = null;
+      if (disposed || !dropped() || !network.online()) return;
+      rejoinAttempts = attempt + 1;
+      options.report?.("info", `meet: rejoining by itself (attempt ${rejoinAttempts} of ${policy.autoRejoinMaxAttempts})`);
+      void options.autoRejoin().catch(() => void 0);
+    }, autoRejoinDelayMs(attempt, random));
+  }
+  function saveMarker(force) {
+    const resume = options.resume;
+    const snap = store.snapshot();
+    if (resume === void 0 || snap.roomName === null) return;
+    const at = now();
+    if (!force && at - lastSavedAt < 1e4) return;
+    const request = options.currentRequest();
+    if (request === null) return;
+    lastSavedAt = at;
+    resume.save(snap.roomName, { request, at });
+  }
+  const unsubscribeStore = store.subscribe(() => {
+    if (disposed) return;
+    const snap = store.snapshot();
+    const phase = snap.phase;
+    const changed = phase !== lastPhase;
+    lastPhase = phase;
+    if (changed) {
+      if (phase === "in_call") {
+        rejoinAttempts = 0;
+        stopRejoin();
+        saveMarker(true);
+      } else if (phase === "disconnected") {
+        driverRegion = null;
+        saveMarker(true);
+        stopProbe();
+        scheduleProbe(0);
+      } else {
+        stopRejoin();
+        if (phase !== "joining") driverRegion = null;
+        if (CLEARS_RESUME(phase) && snap.roomName !== null) options.resume?.clear(snap.roomName);
+      }
+    } else if (phase === "in_call" || phase === "disconnected") {
+      saveMarker(false);
+    }
+    syncBanner();
+  });
+  const unsubscribeNetwork = network.subscribe((online) => {
+    if (disposed) return;
+    if (!online) {
+      if (inCall() || dropped()) setRegion("offline");
+      stopRejoin();
+      stopProbe();
+      if (needsWatch()) scheduleProbe(probeEveryMs);
+      return;
+    }
+    stopProbe();
+    if (needsWatch()) scheduleProbe(0);
+  });
+  return {
+    driverState(state) {
+      if (disposed) return;
+      if (state === "connected") {
+        driverRegion = null;
+        if (inCall() || store.snapshot().phase === "joining") setRegion(network.online() ? "stable" : "offline");
+        if (!needsWatch()) stopProbe();
+        return;
+      }
+      if (state === "reconnecting" || state === "signal_reconnecting") {
+        driverRegion = state;
+        if (inCall()) {
+          setRegion(network.online() ? state : "offline");
+          stopProbe();
+          scheduleProbe(0);
+        }
+      }
+    },
+    exitConnection() {
+      return network.online() ? "server_unreachable" : "offline";
+    },
+    resumable(roomName) {
+      const resume = options.resume;
+      if (resume === void 0) return null;
+      const marker = resume.load(roomName);
+      if (marker === null) return null;
+      if (now() - marker.at > RESUME_WINDOW_MS) {
+        resume.clear(roomName);
+        return null;
+      }
+      return marker;
+    },
+    dispose() {
+      disposed = true;
+      stopProbe();
+      stopRejoin();
+      if (bannerTimer !== null) clearTimeout(bannerTimer);
+      bannerTimer = null;
+      unsubscribeStore();
+      unsubscribeNetwork();
+    }
+  };
+}
+var DELIBERATE_DEPARTURES = /* @__PURE__ */ new Set([
+  "CLIENT_INITIATED",
+  "PARTICIPANT_REMOVED",
+  "ROOM_DELETED",
+  "ROOM_CLOSED",
+  "DUPLICATE_IDENTITY",
+  "USER_REJECTED",
+  "USER_UNAVAILABLE",
+  "SIP_TRUNK_FAILURE"
+]);
+function isUnannouncedDeparture(reason) {
+  return reason === null || !DELIBERATE_DEPARTURES.has(reason);
+}
+function mergeGhosts(live, ghosts, at) {
+  const present = new Set(live.map((p) => p.identity));
+  const kept = /* @__PURE__ */ new Map();
+  const extra = [];
+  for (const [identity, ghost] of ghosts) {
+    if (present.has(identity) || ghost.until <= at) continue;
+    kept.set(identity, ghost);
+    extra.push({
+      ...ghost.participant,
+      micEnabled: false,
+      cameraEnabled: false,
+      screenSharing: false,
+      reconnecting: true
+    });
+  }
+  return { roster: [...live, ...extra], kept };
+}
+
 // src/react/provider.tsx
 import { globalSlot as globalSlot2 } from "@ai-matrx/kit/global-slot";
 import {
@@ -410,7 +756,8 @@ function parseRoomToken(body, roomName) {
     admissionState: readString(payload, "admission_state") ?? void 0,
     pollSeconds: typeof payload["poll_seconds"] === "number" ? payload["poll_seconds"] : void 0,
     breakoutRoomId: readString(payload, "breakout_room_id") ?? null,
-    observersVisibleTo: readString(payload, "observers_visible_to") === "hosts" ? "hosts" : "everyone"
+    observersVisibleTo: readString(payload, "observers_visible_to") === "hosts" ? "hosts" : "everyone",
+    connectionPolicy: connectionPolicyFrom(payload["connection_policy"])
   };
 }
 function createTokenClient(options) {
@@ -1115,6 +1462,10 @@ function nextPhase(from, event) {
       return from === "resolving" && event.reason !== null && isJoinRefusalReason(event.reason) ? refusalPhase(event.reason) : null;
     case "join":
       return JOINABLE_FROM.has(from) ? "joining" : null;
+    case "auto_rejoin":
+      return from === "disconnected" ? "joining" : null;
+    case "resumed":
+      return from === "resolving" ? "joining" : null;
     case "back_to_prejoin":
       return from === "left" || from === "disconnected" ? "prejoin" : null;
     case "retry":
@@ -3254,6 +3605,7 @@ var EMPTY = {
   phaseNotice: null,
   roomName: null,
   connection: "stable",
+  connectionBanner: false,
   share: NO_SHARE,
   call: null,
   waiting: null,
@@ -4535,6 +4887,18 @@ function createRoomEngine(options) {
   let disposed = false;
   let moving = false;
   const confirmingEnds = /* @__PURE__ */ new WeakSet();
+  let lastServerUrl = null;
+  let connectionPolicy = DEFAULT_CONNECTION_POLICY;
+  let ghosts = /* @__PURE__ */ new Map();
+  let ghostTimer = null;
+  let liveRoster = [];
+  const departures = /* @__PURE__ */ new Map();
+  function requestAsNow() {
+    if (lastRequest === null) return null;
+    const media = store.snapshot().media;
+    if (store.snapshot().phase !== "in_call") return lastRequest;
+    return { ...lastRequest, mode: media.camera.enabled ? "video" : "audio", microphone: media.microphone.enabled };
+  }
   async function dropRoom() {
     const target = driver;
     driver = null;
@@ -4545,6 +4909,7 @@ function createRoomEngine(options) {
     store.setLocalTrack("microphone", IDLE_TRACK);
     store.setLocalTrack("camera", IDLE_TRACK);
     store.patch({ share: NO_SHARE, connection: "stable" });
+    clearGhosts();
     await target?.disconnect();
   }
   async function leaveRoom() {
@@ -4612,7 +4977,7 @@ function createRoomEngine(options) {
     participants(list) {
       const joinedAt = new Date(now()).toISOString();
       const before = new Set(store.snapshot().participants.map((p) => p.identity));
-      store.setParticipants(list.map((entry) => projectParticipant(entry, joinedAt)));
+      projectRoster(list, joinedAt);
       const snapshot = store.snapshot();
       const newcomer = snapshot.participants.some(
         (participant) => !participant.isLocal && !before.has(participant.identity)
@@ -4624,6 +4989,9 @@ function createRoomEngine(options) {
         );
       }
     },
+    participantLeft(who, reason) {
+      departures.set(who, reason);
+    },
     roomMetadata(metadata) {
       let spotlight = null;
       if (metadata.length > 0) {
@@ -4650,12 +5018,8 @@ function createRoomEngine(options) {
       store.setQuality(asParticipantIdentity(who), value);
     },
     connectionState(state) {
-      if (state === "connected") {
-        if (store.snapshot().connection !== "stable") store.patch({ connection: "stable" });
-        store.dispatch({ type: "connected" });
-      } else if (state === "reconnecting") {
-        store.patch({ connection: "reconnecting" });
-      }
+      supervisor.driverState(state);
+      if (state === "connected" && store.snapshot().phase === "joining") store.dispatch({ type: "connected" });
     },
     transcription(event) {
       const snapshot = store.snapshot();
@@ -4788,6 +5152,7 @@ function createRoomEngine(options) {
   };
   async function resolveExitAndApply(hint) {
     const connection = current?.identity ?? store.snapshot().localIdentity ?? null;
+    lastRequest = requestAsNow();
     await dropRoom();
     let server;
     if (options.readExit === void 0 || connection === null || store.snapshot().meeting === null) {
@@ -4801,7 +5166,7 @@ function createRoomEngine(options) {
     }
     if (disposed) return;
     const resolved = resolveExit({ server, hint, frozen: options.wasFrozen?.() ?? false });
-    store.patch({ connection: resolved.connection });
+    store.patch({ connection: server === null ? supervisor.exitConnection() : resolved.connection });
     if (resolved.to === "waiting:knocking") {
       store.patch({
         waiting: {
@@ -4833,6 +5198,8 @@ function createRoomEngine(options) {
       ...request.observe === true ? { observe: true } : {}
     });
     current = token;
+    lastServerUrl = token.serverUrl;
+    connectionPolicy = token.connectionPolicy ?? DEFAULT_CONNECTION_POLICY;
     store.patch({
       localIdentity: token.identity,
       breakoutRoomId: token.breakoutRoomId ?? null,
@@ -4937,7 +5304,59 @@ function createRoomEngine(options) {
       throw normalized;
     }
   }
-  return {
+  function projectRoster(list, joinedAt) {
+    const at = now();
+    const previous = new Map(liveRoster.map((p) => [p.identity, p]));
+    const present = new Set(list.map((p) => p.identity));
+    const graceMs = connectionPolicy.reconnectGraceSeconds * 1e3;
+    for (const [who, reason] of departures) {
+      const last = previous.get(who);
+      if (last !== void 0 && !last.isLocal && !present.has(who) && graceMs > 0 && isUnannouncedDeparture(reason)) {
+        ghosts.set(who, { participant: last, until: at + graceMs });
+      }
+    }
+    departures.clear();
+    liveRoster = list;
+    const merged = mergeGhosts(list, ghosts, at);
+    ghosts = merged.kept;
+    store.setParticipants(
+      merged.roster.map((entry) => {
+        const projected = projectParticipant(entry, joinedAt);
+        return entry.reconnecting === true ? { ...projected, reconnecting: true, quality: "lost" } : projected;
+      })
+    );
+    scheduleGhostExpiry();
+  }
+  function scheduleGhostExpiry() {
+    if (ghostTimer !== null) clearTimeout(ghostTimer);
+    ghostTimer = null;
+    if (ghosts.size === 0 || disposed) return;
+    const next = Math.min(...[...ghosts.values()].map((g) => g.until));
+    ghostTimer = setTimeout(() => {
+      ghostTimer = null;
+      if (disposed || driver === null) return;
+      projectRoster(liveRoster, new Date(now()).toISOString());
+    }, Math.max(0, next - now()) + 50);
+  }
+  function clearGhosts() {
+    ghosts = /* @__PURE__ */ new Map();
+    departures.clear();
+    liveRoster = [];
+    if (ghostTimer !== null) clearTimeout(ghostTimer);
+    ghostTimer = null;
+  }
+  const supervisor = createConnectionSupervisor({
+    store,
+    network: options.connection?.network ?? createWebNetworkPort(),
+    probe: () => options.connection?.probe?.(current?.serverUrl ?? lastServerUrl) ?? Promise.resolve(true),
+    policy: () => connectionPolicy,
+    autoRejoin: () => engine.autoRejoin(),
+    currentRequest: requestAsNow,
+    resume: options.connection?.resume,
+    now,
+    report: (level, message) => report(level, message)
+  });
+  const engine = {
     join(request) {
       if (joining !== null) return joining;
       if (store.snapshot().phase !== "joining" && !store.dispatch({ type: "join", click: true })) {
@@ -4982,6 +5401,35 @@ function createRoomEngine(options) {
       });
       return joining;
     },
+    async autoRejoin() {
+      const request = lastRequest;
+      if (request === null || joining !== null) return joining ?? void 0;
+      if (!store.dispatch({ type: "auto_rejoin" })) return;
+      tokens.invalidate(request.roomName);
+      current = null;
+      joining = connect(request).catch((error) => {
+        throw failJoin(error, "meet.autoRejoin");
+      }).finally(() => {
+        joining = null;
+      });
+      return joining;
+    },
+    resume(roomName) {
+      const marker = supervisor.resumable(roomName);
+      if (marker === null || joining !== null) return false;
+      if (!store.dispatch({ type: "resumed" })) return false;
+      lastRequest = { ...marker.request, roomName };
+      report("info", "meet: this tab was in the call before the page reloaded \u2014 rejoining");
+      tokens.invalidate(roomName);
+      current = null;
+      joining = connect(lastRequest).catch((error) => {
+        throw failJoin(error, "meet.resume");
+      }).finally(() => {
+        joining = null;
+      });
+      joining.catch(() => void 0);
+      return true;
+    },
     async moveToBreakout(roomId) {
       const request = lastRequest;
       if (request === null || driver === null) {
@@ -5149,6 +5597,8 @@ function createRoomEngine(options) {
     token: () => current,
     async dispose() {
       disposed = true;
+      supervisor.dispose();
+      clearGhosts();
       if (driver !== null) {
         const target = driver;
         driver = null;
@@ -5157,6 +5607,7 @@ function createRoomEngine(options) {
       store.reset();
     }
   };
+  return engine;
 }
 function canModerate(participant) {
   return participant !== void 0 && isHostRole(participant.role);
@@ -5467,8 +5918,11 @@ function mapConnectionState(state) {
     case "connecting":
       return "connecting";
     case "reconnecting":
-    case "signalReconnecting":
       return "reconnecting";
+    // Only the signal socket is down (S6b): its own region value, so the supervisor can tell a
+    // signal blip from a full media reconnect.
+    case "signalReconnecting":
+      return "signal_reconnecting";
     default:
       return "disconnected";
   }
@@ -5549,8 +6003,12 @@ function createLiveKitDriver(handlers, options = {}) {
       // R5: large meetings degrade gracefully instead of melting a laptop.
       adaptiveStream: true,
       dynacast: true,
+      // S6b: OUR retry schedule — jittered from attempt 0 (the SDK's default has no jitter on its
+      // first two attempts), give-up limits in one place (`connection-supervisor.ts`).
+      reconnectPolicy: createReconnectPolicy(),
       ...options.roomOptions
     });
+    const reasonName = (reason) => reason === void 0 || reason === null ? null : module.DisconnectReason?.[reason] ?? String(reason);
     const roster = () => {
       const local = snapshotParticipant(created.localParticipant, true);
       const remotes = [...created.remoteParticipants.values()].map(
@@ -5568,7 +6026,10 @@ function createLiveKitDriver(handlers, options = {}) {
       if (track.kind !== Track.Kind.Audio) return;
       for (const element of track.detach()) element.remove();
     });
-    created.on(RoomEvent.ParticipantConnected, roster).on(RoomEvent.ParticipantDisconnected, roster).on(RoomEvent.TrackSubscribed, roster).on(RoomEvent.TrackUnsubscribed, roster).on(RoomEvent.TrackMuted, roster).on(RoomEvent.TrackUnmuted, roster).on(RoomEvent.LocalTrackPublished, roster).on(RoomEvent.LocalTrackUnpublished, roster).on(RoomEvent.ParticipantNameChanged, roster).on(RoomEvent.ParticipantAttributesChanged, roster).on(RoomEvent.ParticipantMetadataChanged, roster).on(RoomEvent.RoomMetadataChanged, (metadata) => {
+    created.on(RoomEvent.ParticipantConnected, roster).on(RoomEvent.ParticipantDisconnected, (participant, reason) => {
+      handlers.participantLeft?.(participant.identity, reasonName(reason));
+      roster();
+    }).on(RoomEvent.TrackSubscribed, roster).on(RoomEvent.TrackUnsubscribed, roster).on(RoomEvent.TrackMuted, roster).on(RoomEvent.TrackUnmuted, roster).on(RoomEvent.LocalTrackPublished, roster).on(RoomEvent.LocalTrackUnpublished, roster).on(RoomEvent.ParticipantNameChanged, roster).on(RoomEvent.ParticipantAttributesChanged, roster).on(RoomEvent.ParticipantMetadataChanged, roster).on(RoomEvent.RoomMetadataChanged, (metadata) => {
       handlers.roomMetadata?.(metadata ?? "");
     }).on(RoomEvent.ActiveSpeakersChanged, (speakers) => {
       handlers.activeSpeakers(speakers.map((speaker) => speaker.identity));
@@ -5585,8 +6046,7 @@ function createLiveKitDriver(handlers, options = {}) {
     }).on(RoomEvent.Disconnected, (reason) => {
       audioContainer?.remove();
       audioContainer = null;
-      const named = reason === void 0 ? null : module?.DisconnectReason?.[reason] ?? String(reason);
-      handlers.disconnected(named);
+      handlers.disconnected(reasonName(reason));
     });
     try {
       created.registerTextStreamHandler(TRANSCRIPTION_TOPIC, (reader, participantInfo) => {
@@ -5976,7 +6436,14 @@ function MeetRuntime(props) {
       effectsStorage,
       resolveDevice: (kind) => devicesHolder.current?.resolve(kind) ?? null,
       // §3.4: on every LiveKit disconnect, ask the server what happened to this connection.
-      readExit: (connection) => meetings.readExit(connection)
+      readExit: (connection) => meetings.readExit(connection),
+      // S6b: the connection supervisor's ports — the device's network, whether OUR servers (the
+      // API and the media server) answer, and the per-tab reload-after-offline marker.
+      connection: {
+        network: createWebNetworkPort(),
+        resume: createWebResumeStorage(),
+        probe: (serverUrl) => createReachabilityProbe(() => [baseUrl, ...serverUrl !== null ? [httpUrlOf(serverUrl)] : []])()
+      }
     });
     const meetings = createMeetingSession({
       manager,
@@ -6304,7 +6771,7 @@ function participantAttributes(p) {
     "data-meet-participant-role": observedRole(p.role, p.standing),
     "data-meet-participant-self": String(p.isLocal)
   };
-  const quality = observedQuality(p.quality);
+  const quality = p.reconnecting === true ? "reconnecting" : observedQuality(p.quality);
   if (quality !== null) attrs["data-meet-participant-connection"] = quality;
   return attrs;
 }
@@ -8523,6 +8990,7 @@ function useMeetCore() {
       reason: snapshot?.reason ?? null,
       phaseNotice: snapshot?.phaseNotice ?? null,
       connection: snapshot?.connection ?? "stable",
+      connectionBanner: snapshot?.connectionBanner ?? false,
       share: snapshot?.share ?? NO_SHARE,
       call: snapshot?.call ?? null,
       actions
@@ -9789,7 +10257,8 @@ function ParticipantTile({
             participant.displayName,
             participant.isLocal ? " (you)" : "",
             participant.isAgent ? /* @__PURE__ */ jsx6("span", { className: "mx-meet__badge", children: "AI" }) : null,
-            /* @__PURE__ */ jsx6(RoleBadge, { role: participant.role, standing: participant.standing })
+            /* @__PURE__ */ jsx6(RoleBadge, { role: participant.role, standing: participant.standing }),
+            participant.reconnecting === true ? /* @__PURE__ */ jsx6("span", { className: "mx-meet__badge", children: "Reconnecting\u2026" }) : null
           ] }),
           !participant.micEnabled ? /* @__PURE__ */ jsx6(MicOffIcon, { width: 14, height: 14 }) : null,
           /* @__PURE__ */ jsx6(QualityBars, { quality: participant.quality })
@@ -9832,6 +10301,12 @@ function QualityBars({ quality }) {
   const label = quality === "lost" ? "Connection lost" : quality === "poor" ? "Poor connection" : `Connection ${quality}`;
   return /* @__PURE__ */ jsx6("span", { className: `mx-meet__signal mx-meet__signal--${quality}`, title: label, "aria-label": label, role: "img", children: /* @__PURE__ */ jsx6(SignalIcon, { bars, width: 14, height: 14 }) });
 }
+var CONNECTION_BANNER = {
+  signal_reconnecting: "Reconnecting\u2026",
+  reconnecting: "Reconnecting\u2026",
+  offline: "You're offline. Reconnecting when your internet is back\u2026",
+  server_unreachable: "Can't reach the meeting server. Retrying\u2026"
+};
 function Stage({ pageSize }) {
   const stage = useStage(pageSize);
   const columns = gridColumns(stage.tiles.length);
@@ -11539,7 +12014,7 @@ function MeetSkinRoom({
       headerControls !== void 0 && headerControls !== null ? /* @__PURE__ */ jsx6("span", { className: "mx-meet__header-controls", "data-meet-header-controls": "", children: headerControls }) : null,
       isHost ? /* @__PURE__ */ jsx6(HostMenu, {}) : null
     ] }),
-    core.connection !== "stable" ? /* @__PURE__ */ jsx6("p", { className: "mx-meet__banner", role: "status", children: "Reconnecting\u2026" }) : null,
+    core.connectionBanner && core.connection !== "stable" ? /* @__PURE__ */ jsx6("p", { className: "mx-meet__banner", role: "status", "data-meet-notice": `connection-${core.connection}`, children: CONNECTION_BANNER[core.connection] }) : null,
     /* @__PURE__ */ jsx6(ShareNotice, {}),
     /* @__PURE__ */ jsx6(Stage, {}),
     /* @__PURE__ */ jsx6(Captions, {}),
@@ -11573,7 +12048,7 @@ var REFUSED_TITLES = {
   registration_required: "Register to join this meeting"
 };
 function ExitScreen({ onLeave }) {
-  const { phase, reason, host, snapshot, actions, call } = useMeetCore();
+  const { phase, reason, host, snapshot, actions, call, connection } = useMeetCore();
   const [busy, setBusy] = useState4(false);
   const failure = snapshot?.failure ?? null;
   const rejoin = /* @__PURE__ */ jsx6(
@@ -11629,7 +12104,7 @@ function ExitScreen({ onLeave }) {
         break;
       case "disconnected":
         title = "You lost your connection to the meeting";
-        line = failure?.remedy ?? "Check your internet connection, then rejoin.";
+        line = connection === "offline" ? "You're offline. You'll rejoin automatically when your internet is back." : connection === "server_unreachable" ? "Can't reach the meeting server. You'll rejoin automatically when it answers." : failure?.remedy ?? "Check your internet connection, then rejoin.";
         notice = "disconnected";
         actionsNode = /* @__PURE__ */ jsxs3(Fragment, { children: [
           rejoin,
@@ -12238,6 +12713,7 @@ function MeetingSkinRootBody({
       host.store.dispatch({ type: "reset" });
     }
     if (host.store.snapshot().phase !== "resolving") return;
+    if (given?.linkRun?.reason == null && host.engine.resume(roomName)) return;
     const reason = given?.linkRun?.reason ?? null;
     if (reason !== null && given?.linkRun !== void 0) {
       const words = linkRunWords(given.linkRun);
@@ -12523,6 +12999,7 @@ export {
   CAPTION_LANGUAGES,
   CONSENT_NOTICE_ATTRIBUTE,
   DATA_TOPICS,
+  DEFAULT_CONNECTION_POLICY,
   DEFAULT_EFFECTS,
   DEFAULT_PAGE_SIZE,
   EMPTY_COLLAB,
@@ -12540,6 +13017,7 @@ export {
   IncomingCallHost,
   JOIN_REFUSAL_REASONS,
   LISTEN_ONLY_NOTICE,
+  LIVEKIT_BASE_DELAYS_MS,
   LIVE_PHASES,
   MEETING_INVITE_KIND,
   MEETING_INVITE_VERSION,
@@ -12569,6 +13047,7 @@ export {
   PARTICIPANT_STANDING_ATTRIBUTE,
   REACTION_TTL_MS,
   REFUSED_ABSENCE,
+  RESUME_WINDOW_MS,
   ROLE_RANK,
   ROOM_EVENTS,
   ROOM_EVENT_PREFIX,
@@ -12599,6 +13078,7 @@ export {
   attendanceTotals,
   attendeeKey,
   autoAssign,
+  autoRejoinDelayMs,
   availableActivities,
   breakoutRemainingMs,
   callInviteAction,
@@ -12613,9 +13093,11 @@ export {
   clockPosition,
   collabFromState,
   computeStage,
+  connectionPolicyFrom,
   countLabel,
   createCallCenter,
   createCallInviteHandler,
+  createConnectionSupervisor,
   createDeviceManager,
   createInRoomClient,
   createLiveKitDriver,
@@ -12627,11 +13109,15 @@ export {
   createMeetingRecordCache,
   createMeetingSession,
   createMemoryDeviceStorage,
+  createReachabilityProbe,
+  createReconnectPolicy,
   createRecordingController,
   createRoomEngine,
   createTokenClient,
   createWebDeviceStorage,
   createWebEffectsStorage,
+  createWebNetworkPort,
+  createWebResumeStorage,
   createWebRoomTokenStorage,
   defaultCaptionLanguage,
   displayNameFor,
@@ -12644,6 +13130,7 @@ export {
   guestRecordAccessSetting,
   hasEnded,
   hostUserIds,
+  httpUrlOf,
   invalidResponse,
   isGuest,
   isGuestIdentity,
@@ -12657,6 +13144,7 @@ export {
   isRealName,
   isRefusedPhase,
   isRoomEventTopic,
+  isUnannouncedDeparture,
   isWaitingPhase,
   learnName,
   learnNames,
@@ -12679,6 +13167,7 @@ export {
   meetingTopic,
   meetingWhen,
   mergeCaption,
+  mergeGhosts,
   mergeRecord,
   microphoneNoticeCode,
   moveToRoom,