@ai-matrx/meet 0.11.27 → 0.11.29

package/dist/index.cjs

@@ -36,6 +36,7 @@ __export(src_exports, {
   CAPTION_LANGUAGES: () => CAPTION_LANGUAGES,
   CONSENT_NOTICE_ATTRIBUTE: () => CONSENT_NOTICE_ATTRIBUTE,
   DATA_TOPICS: () => DATA_TOPICS,
+  DEFAULT_CONNECTION_POLICY: () => DEFAULT_CONNECTION_POLICY,
   DEFAULT_EFFECTS: () => DEFAULT_EFFECTS,
   DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
   EMPTY_COLLAB: () => EMPTY_COLLAB,
@@ -50,6 +51,7 @@ __export(src_exports, {
   IDLE_TRACK: () => IDLE_TRACK,
   JOIN_REFUSAL_REASONS: () => JOIN_REFUSAL_REASONS,
   LISTEN_ONLY_NOTICE: () => LISTEN_ONLY_NOTICE,
+  LIVEKIT_BASE_DELAYS_MS: () => LIVEKIT_BASE_DELAYS_MS,
   LIVE_PHASES: () => LIVE_PHASES,
   MEETING_INVITE_KIND: () => MEETING_INVITE_KIND,
   MEETING_INVITE_VERSION: () => MEETING_INVITE_VERSION,
@@ -73,6 +75,7 @@ __export(src_exports, {
   PARTICIPANT_STANDING_ATTRIBUTE: () => PARTICIPANT_STANDING_ATTRIBUTE,
   REACTION_TTL_MS: () => REACTION_TTL_MS,
   REFUSED_ABSENCE: () => REFUSED_ABSENCE,
+  RESUME_WINDOW_MS: () => RESUME_WINDOW_MS,
   ROLE_RANK: () => ROLE_RANK,
   ROOM_EVENTS: () => ROOM_EVENTS,
   ROOM_EVENT_PREFIX: () => ROOM_EVENT_PREFIX,
@@ -102,6 +105,7 @@ __export(src_exports, {
   attendanceTotals: () => attendanceTotals,
   attendeeKey: () => attendeeKey,
   autoAssign: () => autoAssign,
+  autoRejoinDelayMs: () => autoRejoinDelayMs,
   availableActivities: () => availableActivities,
   breakoutRemainingMs: () => breakoutRemainingMs,
   callInviteAction: () => callInviteAction,
@@ -116,9 +120,11 @@ __export(src_exports, {
   clockPosition: () => clockPosition,
   collabFromState: () => collabFromState,
   computeStage: () => computeStage,
+  connectionPolicyFrom: () => connectionPolicyFrom,
   countLabel: () => countLabel,
   createCallCenter: () => createCallCenter,
   createCallInviteHandler: () => createCallInviteHandler,
+  createConnectionSupervisor: () => createConnectionSupervisor,
   createDeviceManager: () => createDeviceManager,
   createInRoomClient: () => createInRoomClient,
   createLiveKitDriver: () => createLiveKitDriver,
@@ -130,11 +136,15 @@ __export(src_exports, {
   createMeetingRecordCache: () => createMeetingRecordCache,
   createMeetingSession: () => createMeetingSession,
   createMemoryDeviceStorage: () => createMemoryDeviceStorage,
+  createReachabilityProbe: () => createReachabilityProbe,
+  createReconnectPolicy: () => createReconnectPolicy,
   createRecordingController: () => createRecordingController,
   createRoomEngine: () => createRoomEngine,
   createTokenClient: () => createTokenClient,
   createWebDeviceStorage: () => createWebDeviceStorage,
   createWebEffectsStorage: () => createWebEffectsStorage,
+  createWebNetworkPort: () => createWebNetworkPort,
+  createWebResumeStorage: () => createWebResumeStorage,
   createWebRoomTokenStorage: () => createWebRoomTokenStorage,
   defaultCaptionLanguage: () => defaultCaptionLanguage,
   displayNameFor: () => displayNameFor,
@@ -147,6 +157,7 @@ __export(src_exports, {
   guestRecordAccessSetting: () => guestRecordAccessSetting,
   hasEnded: () => hasEnded,
   hostUserIds: () => hostUserIds,
+  httpUrlOf: () => httpUrlOf,
   invalidResponse: () => invalidResponse,
   isGuest: () => isGuest,
   isGuestIdentity: () => isGuestIdentity,
@@ -160,6 +171,7 @@ __export(src_exports, {
   isRealName: () => isRealName,
   isRefusedPhase: () => isRefusedPhase,
   isRoomEventTopic: () => isRoomEventTopic,
+  isUnannouncedDeparture: () => isUnannouncedDeparture,
   isWaitingPhase: () => isWaitingPhase,
   learnName: () => learnName,
   learnNames: () => learnNames,
@@ -181,6 +193,7 @@ __export(src_exports, {
   meetingTopic: () => meetingTopic,
   meetingWhen: () => meetingWhen,
   mergeCaption: () => mergeCaption,
+  mergeGhosts: () => mergeGhosts,
   mergeRecord: () => mergeRecord,
   microphoneNoticeCode: () => microphoneNoticeCode,
   moveToRoom: () => moveToRoom,
@@ -456,6 +469,352 @@ function invalidResponse(operation, detail) {
   );
 }
 
+// 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/core/tokens.ts
 function createWebRoomTokenStorage(onDiagnostic) {
   const store = globalThis.localStorage;
@@ -641,7 +1000,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) {
@@ -1367,8 +1727,14 @@ function nextPhase(from, event) {
       return from === "resolving" ? "prejoin" : null;
     case "unsupported":
       return from === "resolving" ? "unsupported" : null;
+    case "link_state":
+      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":
@@ -1775,6 +2141,8 @@ var RPCS = {
   getOrCreateMeeting: "meet_get_or_create_meeting",
   /** Resolve a durable public link, before/during/after its scheduled time. */
   meetingBySlug: "meet_meeting_by_slug",
+  /** The current run of a durable link (open / not started / ended + next start), no pass needed. */
+  linkState: "meet_link_state",
   /*
    * ── S4 ADMISSION (CORE-DESIGN §2.4). Each returns the decided row; the caller then
    * sends the payload-free `mx.state.changed` hint. Authorized by `who_may_admit`.
@@ -2083,6 +2451,14 @@ function createMeetRepository(options) {
       if (response.error !== null) throw normalizeMeetError(response.error, operation);
     }
   }
+  async function readLinkRun(slug) {
+    try {
+      const response = await db.rpc(RPCS.linkState, { p_slug: slug });
+      return projectLinkRun(response.error === null ? response.data : null);
+    } catch {
+      return void 0;
+    }
+  }
   async function guard(operation, run) {
     let response = await run();
     if (response.error !== null) {
@@ -2484,11 +2860,12 @@ function createMeetRepository(options) {
       return projectMeeting(row);
     },
     async meetingBySlug(slug) {
-      const row = await guard(
-        "meet.meetingBySlug",
-        () => db.rpc(RPCS.meetingBySlug, { p_slug: slug })
-      );
-      return withRunNoteTaker(projectMeeting(row));
+      const [row, linkRun] = await Promise.all([
+        guard("meet.meetingBySlug", () => db.rpc(RPCS.meetingBySlug, { p_slug: slug })),
+        readLinkRun(slug)
+      ]);
+      const record = withRunNoteTaker(projectMeeting(row));
+      return linkRun === void 0 ? record : { ...record, linkRun };
     },
     async meeting(id) {
       const response = await db.from(TABLES.meetings).select(MEETING_COLUMNS).eq("id", id).single();
@@ -2677,6 +3054,15 @@ function snippetRuns(snippet) {
   if (last < snippet.length) runs.push({ text: snippet.slice(last), hit: false });
   return runs;
 }
+function projectLinkRun(value) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const row = value;
+  const state = row["state"];
+  if (state !== "open" && state !== "not_started" && state !== "ended" && state !== "cancelled") return void 0;
+  const reason = row["reason"] === "ended" || row["reason"] === "cancelled" ? row["reason"] : null;
+  const nextStart = typeof row["next_start"] === "string" ? row["next_start"] : null;
+  return { state, reason, nextStart };
+}
 
 // src/core/app-panel.ts
 function appPanelOf(meeting) {
@@ -3262,6 +3648,7 @@ var EMPTY = {
   phaseNotice: null,
   roomName: null,
   connection: "stable",
+  connectionBanner: false,
   share: NO_SHARE,
   call: null,
   waiting: null,
@@ -4216,8 +4603,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";
   }
@@ -4298,8 +4688,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 : module2.DisconnectReason?.[reason] ?? String(reason);
     const roster = () => {
       const local = snapshotParticipant(created.localParticipant, true);
       const remotes = [...created.remoteParticipants.values()].map(
@@ -4317,7 +4711,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));
@@ -4334,8 +4731,7 @@ function createLiveKitDriver(handlers, options = {}) {
     }).on(RoomEvent.Disconnected, (reason) => {
       audioContainer?.remove();
       audioContainer = null;
-      const named = reason === void 0 ? null : module2?.DisconnectReason?.[reason] ?? String(reason);
-      handlers.disconnected(named);
+      handlers.disconnected(reasonName(reason));
     });
     try {
       created.registerTextStreamHandler(TRANSCRIPTION_TOPIC, (reader, participantInfo) => {
@@ -5708,6 +6104,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;
@@ -5718,6 +6126,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() {
@@ -5785,7 +6194,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)
@@ -5797,6 +6206,9 @@ function createRoomEngine(options) {
         );
       }
     },
+    participantLeft(who, reason) {
+      departures.set(who, reason);
+    },
     roomMetadata(metadata) {
       let spotlight = null;
       if (metadata.length > 0) {
@@ -5823,12 +6235,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();
@@ -5961,6 +6369,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) {
@@ -5974,7 +6383,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: {
@@ -6006,6 +6415,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,
@@ -6110,7 +6521,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 })) {
@@ -6155,6 +6618,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) {
@@ -6322,6 +6814,8 @@ function createRoomEngine(options) {
     token: () => current,
     async dispose() {
       disposed = true;
+      supervisor.dispose();
+      clearGhosts();
       if (driver !== null) {
         const target = driver;
         driver = null;
@@ -6330,6 +6824,7 @@ function createRoomEngine(options) {
       store.reset();
     }
   };
+  return engine;
 }
 function canModerate(participant) {
   return participant !== void 0 && isHostRole(participant.role);
@@ -7415,7 +7910,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;
 }