@oxy.so/services 12.13.0 → 12.14.0

package/lib/module/ui/boot/runProviderColdBoot.js

@@ -82,9 +82,177 @@ async function detectOfflineHint() {
     return false;
   }
 }
+/** Starts the provider's fresh classification; a rejection is observed, not swallowed. */
+function startClassification(opts) {
+  const classification = (async () => opts.resolveSessionLane?.() ?? resolveApplicationSessionLane(opts.oxyServices, opts.clientId))();
+  // Observed so a rejection that lands before it is awaited is not reported as
+  // unhandled; every caller still awaits it and sees the rejection.
+  classification.catch(() => undefined);
+  return classification;
+}
+
+/** What the device lanes made of this holder: a session, a verdict against it, or no answer. */
+
+/**
+ * The device lanes of the boot (`runSessionColdBoot`), for a first boot or for
+ * the background check of a painted one.
+ *
+ * A first boot (`painted: false`) is on the critical path: its committed
+ * session resolves auth, bounded by {@link SESSION_HANDOFF_DEADLINE_MS}. A
+ * painted boot already resolved auth from the cache, so nothing waits on the
+ * handoff and the pure-local warm token is skipped: the check needs the mint's
+ * verdict, which a still-valid token cannot give.
+ */
+async function restoreDeviceSession(opts, painted) {
+  const {
+    oxyServices,
+    authStore,
+    sessionMode = 'account',
+    identity,
+    sessionClient,
+    syncDeviceCredentialToHost,
+    commitSession,
+    markAuthResolved
+  } = opts;
+  await opts.beforeDeviceBoot?.();
+
+  // Best-effort connectivity probe up front: an EXPLICIT offline verdict skips
+  // the two doomed network steps so routing settles immediately instead of
+  // burning the overall deadline on a mint that cannot succeed. Any ambiguity
+  // resolves to "online" — the network steps still run.
+  const offline = await detectOfflineHint();
+  let outcome = 'unreachable';
+  let holderRejected = false;
+  await runSessionColdBoot({
+    oxy: oxyServices,
+    store: authStore,
+    platform: {
+      isWeb: isWebBrowser(),
+      isNative: !isWebBrowser()
+    },
+    sessionMode,
+    identity,
+    // The device-wide shared credential slot, enabling the `shared-device-adopt`
+    // lane: a newly installed official app joins this device's existing session
+    // instead of falling back to signing a challenge with the Commons identity
+    // key. `null` on web, where each origin is its own device by design; the
+    // core lane is also skipped outright in `sessionMode: 'identity'`.
+    sharedDeviceCredential: createPlatformSharedDeviceCredentialStore() ?? undefined,
+    overallDeadlineMs: COLD_BOOT_OVERALL_DEADLINE_MS,
+    isOffline: () => offline,
+    requireServerVerdict: painted,
+    onHolderRejected: () => {
+      holderRejected = true;
+    },
+    onStepDeadline: stepId => {
+      loggerUtil.warn(`Cold-boot step "${stepId}" exceeded the ${COLD_BOOT_OVERALL_DEADLINE_MS}ms overall deadline — abandoned; routing proceeds signed-out`, {
+        component: 'runProviderColdBoot',
+        method: 'onStepDeadline'
+      });
+    },
+    onSession: async session => {
+      outcome = 'session';
+      // Mint already persisted `{deviceId, deviceSecret}` to the store; sync the
+      // in-memory SessionClient host so sockets + tab-focus re-mint can use it.
+      await syncDeviceCredentialToHost();
+      const handoff = commitSession({
+        sessionId: session.sessionId,
+        accessToken: session.accessToken,
+        userId: session.userId,
+        deviceState: session.state
+      }, {
+        activate: false
+      });
+      if (painted) {
+        // The account is already on screen; the commit refreshes its profile.
+        await handoff;
+        return;
+      }
+      let handoffDeadlineId;
+      await Promise.race([handoff, new Promise(resolve => {
+        handoffDeadlineId = setTimeout(resolve, SESSION_HANDOFF_DEADLINE_MS);
+      })]).finally(() => {
+        if (handoffDeadlineId !== undefined) {
+          clearTimeout(handoffDeadlineId);
+        }
+      });
+      markAuthResolved();
+    },
+    onSignedOut: async () => {
+      outcome = holderRejected ? 'rejected' : 'unreachable';
+      await syncDeviceCredentialToHost();
+      // A painted session is the caller's to end or keep (see verifyCachedSession).
+      if (painted) return;
+      const cred = await loadPersistedDeviceCredential(authStore);
+      if (cred) {
+        try {
+          await sessionClient.start();
+        } catch (socketError) {
+          if (__DEV__) {
+            loggerUtil.debug('Device socket start failed (non-fatal)', {
+              component: 'runProviderColdBoot'
+            }, socketError);
+          }
+        }
+      }
+      markAuthResolved();
+    },
+    onStepError: (id, error) => {
+      if (__DEV__) {
+        loggerUtil.debug(`Cold-boot step "${id}" errored (non-fatal, falling through)`, {
+          component: 'runProviderColdBoot'
+        }, error);
+      }
+    }
+  });
+  await opts.afterDeviceBoot?.();
+  return outcome;
+}
+
+/**
+ * The background check of a painted session: the registry's classification and
+ * a mint with this holder's own credential (whose commit refreshes the profile).
+ * Each is asked until the server answers it. A verdict against the session
+ * signs out at that moment; no answer keeps the cached session on screen and
+ * hands the caller a retry.
+ */
+async function verifyCachedSession(opts, verified, classification) {
+  if (!verified.lane) {
+    let lane = null;
+    try {
+      lane = await classification;
+    } catch {
+      // The registry could not be asked (offline, timeout, 5xx). That is no
+      // verdict on this app: the cached `device` classification stands until it
+      // answers.
+    }
+    if (lane === 'oauth') {
+      await opts.onCachedSessionRejected?.();
+      return;
+    }
+    verified.lane = lane === 'device';
+  }
+  if (!verified.session) {
+    const outcome = await restoreDeviceSession(opts, true);
+    if (outcome === 'rejected') {
+      await opts.onCachedSessionRejected?.();
+      return;
+    }
+    verified.session = outcome === 'session';
+  }
+  if (!verified.lane || !verified.session) {
+    opts.onCachedSessionUnconfirmed?.(() => verifyCachedSession(opts, verified, verified.lane ? Promise.resolve('device') : startClassification(opts)));
+  }
+}
+
 /**
  * Device-first cold boot for `@oxy.so/services` providers.
  *
+ * A returning session saved on this device (account mode, the app last
+ * classified `device`, its profile cached) paints first, with no network, and
+ * is then checked in the background — see `paintCachedSession`. Otherwise, a
+ * first boot:
+ *
  * Ordered pipeline:
  * 1. Complete an OAuth authorization-code return already on the URL (web)
  * 2. `runSessionColdBoot` — device-secret mint (+ the native Commons-proof lane,
@@ -107,9 +275,6 @@ export async function runProviderColdBoot(opts) {
     clientId,
     authRedirectUri,
     sessionMode = 'account',
-    identity,
-    sessionClient,
-    syncDeviceCredentialToHost,
     commitSession,
     markAuthResolved,
     setTokenReady
@@ -118,13 +283,24 @@ export async function runProviderColdBoot(opts) {
   setTokenReady(false);
   try {
     // Classification precedes every USE of a local secret, the shared credential
-    // and the identity key. Unavailable registry metadata fails closed, including
-    // offline boot. It starts now, before anything else, so its round trip
-    // overlaps the local work below.
-    const classification = (async () => opts.resolveSessionLane?.() ?? resolveApplicationSessionLane(oxyServices, clientId))();
-    // Observed so a rejection that lands before it is awaited is not reported as
-    // unhandled; every path below still awaits it and sees the rejection.
-    classification.catch(() => undefined);
+    // and the identity key. Unavailable registry metadata fails closed on a first
+    // boot, including offline. It starts now, before anything else, so its round
+    // trip overlaps the local work below.
+    const classification = startClassification(opts);
+
+    // A returning session saved on this device paints at once from the cache:
+    // the account, its cached content, auth resolved, no network on the way.
+    // The classification and the session are then checked in the background,
+    // and a verdict against either signs out at that moment. Identity-bound
+    // clients and OAuth returns keep the path below.
+    const freshLaunch = !identityBound && !hasOAuthReturnOnUrl();
+    if (freshLaunch && (await opts.paintCachedSession?.())) {
+      await verifyCachedSession(opts, {
+        lane: false,
+        session: false
+      }, classification);
+      return;
+    }
 
     // The verdict decides HOW a session is restored, never WHETHER there is one.
     // A web origin with nothing to restore and no OAuth return on the URL ends
@@ -132,7 +308,7 @@ export async function runProviderColdBoot(opts) {
     // for an answer that cannot change the outcome. The classification still
     // completes below and still gates every later sign-in
     // (`ensureDeviceSessionLane` shares this same in-flight lookup).
-    if (!identityBound && isWebBrowser() && !hasOAuthReturnOnUrl()) {
+    if (freshLaunch && isWebBrowser()) {
       if (!(await hasRestorableState(authStore))) {
         markAuthResolved();
         const lane = await classification;
@@ -168,83 +344,7 @@ export async function runProviderColdBoot(opts) {
       setTokenReady(true);
       return;
     }
-    await opts.beforeDeviceBoot?.();
-
-    // Best-effort connectivity probe up front: an EXPLICIT offline verdict skips
-    // the two doomed network steps so routing settles immediately instead of
-    // burning the overall deadline on a mint that cannot succeed. Any ambiguity
-    // resolves to "online" — the network steps still run.
-    const offline = await detectOfflineHint();
-    await runSessionColdBoot({
-      oxy: oxyServices,
-      store: authStore,
-      platform: {
-        isWeb: isWebBrowser(),
-        isNative: !isWebBrowser()
-      },
-      sessionMode,
-      identity,
-      // The device-wide shared credential slot, enabling the `shared-device-adopt`
-      // lane: a newly installed official app joins this device's existing session
-      // instead of falling back to signing a challenge with the Commons identity
-      // key. `null` on web, where each origin is its own device by design; the
-      // core lane is also skipped outright in `sessionMode: 'identity'`.
-      sharedDeviceCredential: createPlatformSharedDeviceCredentialStore() ?? undefined,
-      overallDeadlineMs: COLD_BOOT_OVERALL_DEADLINE_MS,
-      isOffline: () => offline,
-      onStepDeadline: stepId => {
-        loggerUtil.warn(`Cold-boot step "${stepId}" exceeded the ${COLD_BOOT_OVERALL_DEADLINE_MS}ms overall deadline — abandoned; routing proceeds signed-out`, {
-          component: 'runProviderColdBoot',
-          method: 'onStepDeadline'
-        });
-      },
-      onSession: async session => {
-        // Mint already persisted `{deviceId, deviceSecret}` to the store; sync the
-        // in-memory SessionClient host so sockets + tab-focus re-mint can use it.
-        await syncDeviceCredentialToHost();
-        const handoff = commitSession({
-          sessionId: session.sessionId,
-          accessToken: session.accessToken,
-          userId: session.userId,
-          deviceState: session.state
-        }, {
-          activate: false
-        });
-        let handoffDeadlineId;
-        await Promise.race([handoff, new Promise(resolve => {
-          handoffDeadlineId = setTimeout(resolve, SESSION_HANDOFF_DEADLINE_MS);
-        })]).finally(() => {
-          if (handoffDeadlineId !== undefined) {
-            clearTimeout(handoffDeadlineId);
-          }
-        });
-        markAuthResolved();
-      },
-      onSignedOut: async () => {
-        await syncDeviceCredentialToHost();
-        const cred = await loadPersistedDeviceCredential(authStore);
-        if (cred) {
-          try {
-            await sessionClient.start();
-          } catch (socketError) {
-            if (__DEV__) {
-              loggerUtil.debug('Device socket start failed (non-fatal)', {
-                component: 'runProviderColdBoot'
-              }, socketError);
-            }
-          }
-        }
-        markAuthResolved();
-      },
-      onStepError: (id, error) => {
-        if (__DEV__) {
-          loggerUtil.debug(`Cold-boot step "${id}" errored (non-fatal, falling through)`, {
-            component: 'runProviderColdBoot'
-          }, error);
-        }
-      }
-    });
-    await opts.afterDeviceBoot?.();
+    await restoreDeviceSession(opts, false);
   } catch (error) {
     if (__DEV__) {
       loggerUtil.error('Cold boot error', error instanceof Error ? error : new Error(String(error)), {

package/lib/module/ui/boot/runProviderColdBoot.js.map

@@ -1 +1 @@
-{"version":3,"names":["resolveApplicationSessionLane","logger","loggerUtil","runSessionColdBoot","loadPersistedDeviceCredential","createPlatformSharedDeviceCredentialStore","tryCompleteOAuthReturn","isWebBrowser","isNetConnectivityExplicitlyOffline","hasOAuthReturnOnUrl","search","globalThis","location","params","URLSearchParams","has","hasRestorableState","store","persisted","load","Boolean","accessToken","deviceSecret","SESSION_HANDOFF_DEADLINE_MS","COLD_BOOT_OVERALL_DEADLINE_MS","OFFLINE_PROBE_TIMEOUT_MS","detectOfflineHint","online","navigator","onLine","NetInfo","state","Promise","race","default","fetch","resolve","setTimeout","runProviderColdBoot","opts","oxyServices","authStore","clientId","authRedirectUri","sessionMode","identity","sessionClient","syncDeviceCredentialToHost","commitSession","markAuthResolved","setTokenReady","identityBound","classification","resolveSessionLane","catch","undefined","lane","onClassified","oauthCompleted","input","activate","oauth","beforeDeviceBoot","offline","oxy","platform","isWeb","isNative","sharedDeviceCredential","overallDeadlineMs","isOffline","onStepDeadline","stepId","warn","component","method","onSession","session","handoff","sessionId","userId","deviceState","handoffDeadlineId","finally","clearTimeout","onSignedOut","cred","start","socketError","__DEV__","debug","onStepError","id","error","afterDeviceBoot","Error","String"],"sourceRoot":"../../../../src","sources":["ui/boot/runProviderColdBoot.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["resolveApplicationSessionLane","logger","loggerUtil","runSessionColdBoot","loadPersistedDeviceCredential","createPlatformSharedDeviceCredentialStore","tryCompleteOAuthReturn","isWebBrowser","isNetConnectivityExplicitlyOffline","hasOAuthReturnOnUrl","search","globalThis","location","params","URLSearchParams","has","hasRestorableState","store","persisted","load","Boolean","accessToken","deviceSecret","SESSION_HANDOFF_DEADLINE_MS","COLD_BOOT_OVERALL_DEADLINE_MS","OFFLINE_PROBE_TIMEOUT_MS","detectOfflineHint","online","navigator","onLine","NetInfo","state","Promise","race","default","fetch","resolve","setTimeout","startClassification","opts","classification","resolveSessionLane","oxyServices","clientId","catch","undefined","restoreDeviceSession","painted","authStore","sessionMode","identity","sessionClient","syncDeviceCredentialToHost","commitSession","markAuthResolved","beforeDeviceBoot","offline","outcome","holderRejected","oxy","platform","isWeb","isNative","sharedDeviceCredential","overallDeadlineMs","isOffline","requireServerVerdict","onHolderRejected","onStepDeadline","stepId","warn","component","method","onSession","session","handoff","sessionId","userId","deviceState","activate","handoffDeadlineId","finally","clearTimeout","onSignedOut","cred","start","socketError","__DEV__","debug","onStepError","id","error","afterDeviceBoot","verifyCachedSession","verified","lane","onCachedSessionRejected","onCachedSessionUnconfirmed","runProviderColdBoot","authRedirectUri","setTokenReady","identityBound","freshLaunch","paintCachedSession","onClassified","oauthCompleted","input","oauth","Error","String"],"sourceRoot":"../../../../src","sources":["ui/boot/runProviderColdBoot.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/context/OxyContext.js

@@ -21,7 +21,8 @@ import { runProviderColdBoot } from "../boot/runProviderColdBoot.js";
 import { resolveApplicationSessionLane } from "../oauth/applicationSessionLane.js";
 import { handleAuthError } from "../utils/errorHandlers.js";
 import { hasPersistedSessionCredential, loadPersistedDeviceCredential } from "../utils/deviceCredential.js";
-import { createTokenLossRecovery } from "../session/tokenLossRecovery.js";
+import { createTokenLossRecovery, TOKEN_RECOVERY_BACKOFF_MS } from "../session/tokenLossRecovery.js";
+import { createCachedBootStore } from "../session/cachedBoot.js";
 import { bindAuthStoreToRuntime } from "../stores/authStore.js";
 import { useLanguageManagement } from "../hooks/useLanguageManagement.js";
 import { useSessionManagement } from "../hooks/useSessionManagement.js";
@@ -143,6 +144,7 @@ export const OxyRuntimeProvider = ({
     clientId: clientIdProp,
     services: oxyServices,
     lane: null,
+    provisional: false,
     pending: null
   });
   if (registeredLaneRef.current.clientId !== clientIdProp || registeredLaneRef.current.services !== oxyServices) {
@@ -150,6 +152,7 @@ export const OxyRuntimeProvider = ({
       clientId: clientIdProp,
       services: oxyServices,
       lane: null,
+      provisional: false,
       pending: null
     };
   }
@@ -272,6 +275,12 @@ export const OxyRuntimeProvider = ({
     storageReadyRef.current = buildStorageDeferred();
   }
   const storageReady = storageReadyRef.current;
+
+  // What a returning session's first paint needs (the app's classification and
+  // the account's profile), kept in the same storage as the account query cache.
+  const cachedBoot = useMemo(() => storage ? createCachedBootStore(storage, storageKeyPrefix) : null, [storage, storageKeyPrefix]);
+  const cachedBootRef = useRef(cachedBoot);
+  cachedBootRef.current = cachedBoot;
   useEffect(() => {
     // `null` means the public provider owns initialization and has not resolved
     // it yet. `undefined` means this internal provider was mounted directly and
@@ -419,10 +428,16 @@ export const OxyRuntimeProvider = ({
     const selected = registeredLaneRef.current;
     if (selected.clientId !== clientIdProp || selected.services !== oxyServices) throw new Error('Provider classification was superseded');
     if (selected.pending) return selected.pending;
-    selected.lane = null;
+    if (!selected.provisional) selected.lane = null;
     const pending = (async () => {
       const lane = await resolveApplicationSessionLane(oxyServices, clientIdProp);
       if (registeredLaneRef.current !== selected) throw new Error('Provider classification was superseded');
+      if (clientIdProp) void cachedBootRef.current?.saveLane(clientIdProp, lane);
+      if (selected.provisional) {
+        // The registry has answered: its verdict replaces the cached one now.
+        selected.provisional = false;
+        selected.lane = lane;
+      }
       if (lane === 'oauth' && !hasIsolatedOAuthSession(runtime)) {
         sessionClient.resetLocalState();
         sessionClientHost.setDeviceCredential(null);
@@ -1075,6 +1090,100 @@ export const OxyRuntimeProvider = ({
     if (!accountDialogOpen) clearSignInFlows(accountDialogControllerRef.current);
   }, [accountDialogOpen]);
 
+  // ── Cached first paint ───────────────────────────────────────────────────
+  // Keep the profile the runtime holds for the signed-in account, so the next
+  // cold boot can paint it before the network answers. Only for a device-lane
+  // account session: an identity-bound client and an isolated OAuth session
+  // always boot through the network. A sign-out deletes it.
+  const cachedAccountJsonRef = useRef(null);
+  useEffect(() => {
+    if (!cachedBoot || identity) return;
+    if (user === null) {
+      if (cachedAccountJsonRef.current !== null) {
+        cachedAccountJsonRef.current = null;
+        void cachedBoot.clearAccount();
+      }
+      return;
+    }
+    if (registeredLaneRef.current.lane !== 'device' || hasIsolatedOAuthSession(runtime)) return;
+    const json = JSON.stringify(user);
+    if (json === cachedAccountJsonRef.current) return;
+    cachedAccountJsonRef.current = json;
+    void cachedBoot.saveAccount(user);
+  }, [cachedBoot, identity, user, runtime]);
+
+  // Paint the session saved on this device: the bearer it left (when still
+  // valid), the session mirror, the account from its cached profile, auth
+  // resolved. Local reads only; the boot checks it all in the background.
+  const paintCachedSession = useCallback(async () => {
+    const cache = cachedBootRef.current;
+    if (identity || !clientIdProp || !cache) return false;
+    const cached = await cache.readSession(clientIdProp, authStore);
+    const selected = registeredLaneRef.current;
+    if (!cached || selected.clientId !== clientIdProp || selected.services !== oxyServices || selected.lane === 'oauth') {
+      return false;
+    }
+    if (selected.lane === null) {
+      // The cached verdict stands in for the registry until it answers, so the
+      // refresh handler, lost-token recovery and sign-in treat this app as the
+      // device lane it was on last run.
+      selected.lane = 'device';
+      selected.provisional = true;
+    }
+    if (cached.warmToken) oxyServices.session.setAccessToken(cached.warmToken);
+    await syncDeviceCredentialToHost();
+    const now = new Date();
+    runtime.batch(() => {
+      runtime.mergeSessions([{
+        sessionId: cached.sessionId,
+        deviceId: cached.deviceId,
+        expiresAt: new Date(now.getTime() + DEFAULT_SESSION_VALIDITY_MS).toISOString(),
+        lastActive: now.toISOString(),
+        userId: cached.userId,
+        isCurrent: true
+      }], {
+        merge: true
+      });
+      runtime.setActiveSessionId(cached.sessionId);
+      runtime.setAccount(cached.user);
+    });
+    onAuthStateChangeRef.current?.(cached.user);
+    markAuthResolvedRef.current();
+    return true;
+  }, [identity, clientIdProp, authStore, oxyServices, runtime, syncDeviceCredentialToHost]);
+
+  // A painted session the server could not be asked about yet stays on screen
+  // and is asked again: on the lost-token backoff, and at once when the device
+  // comes back online. Signed out meanwhile, there is nothing left to ask.
+  const cachedSessionCheckRef = useRef({
+    timer: null,
+    attempt: 0,
+    runNow: null
+  });
+  const scheduleCachedSessionCheck = useCallback(retry => {
+    const check = cachedSessionCheckRef.current;
+    if (check.timer !== null) clearTimeout(check.timer);
+    const run = () => {
+      if (check.timer !== null) clearTimeout(check.timer);
+      check.timer = null;
+      check.runNow = null;
+      if (runtime.getSnapshot().account === null) return;
+      retry().catch(retryError => {
+        logger('Failed to check the cached session', retryError);
+      });
+    };
+    const delay = TOKEN_RECOVERY_BACKOFF_MS[Math.min(check.attempt, TOKEN_RECOVERY_BACKOFF_MS.length - 1)];
+    check.attempt += 1;
+    check.runNow = run;
+    check.timer = setTimeout(run, delay);
+  }, [runtime, logger]);
+  useEffect(() => () => {
+    const check = cachedSessionCheckRef.current;
+    if (check.timer !== null) clearTimeout(check.timer);
+    check.timer = null;
+    check.runNow = null;
+  }, []);
+
   // ── Cold boot ────────────────────────────────────────────────────────────
   // Device-first session restore via `runProviderColdBoot` (see boot/runProviderColdBoot.ts).
   const runColdBoot = useCallback(async () => {
@@ -1100,12 +1209,15 @@ export const OxyRuntimeProvider = ({
       syncDeviceCredentialToHost,
       commitSession: (input, options) => commitSessionRef.current(input, options),
       markAuthResolved: () => markAuthResolvedRef.current(),
-      setTokenReady
+      setTokenReady,
+      paintCachedSession,
+      onCachedSessionRejected: () => clearSessionStateRef.current(),
+      onCachedSessionUnconfirmed: scheduleCachedSessionCheck
     });
     // The boot may have (re-)established the identity session or cleared a pin
     // whose key no longer exists, so re-resolve rather than trusting the memo
     // taken before it ran.
-  }, [resolveRegisteredLane, oxyServices, authStore, clientIdProp, authRedirectUri, sessionMode, identity, syncDeviceCredentialToHost, sessionClient, setTokenReady]);
+  }, [resolveRegisteredLane, oxyServices, authStore, clientIdProp, authRedirectUri, sessionMode, identity, syncDeviceCredentialToHost, sessionClient, setTokenReady, paintCachedSession, scheduleCachedSessionCheck]);
   useEffect(() => {
     if (initialized) {
       return;
@@ -1188,6 +1300,7 @@ export const OxyRuntimeProvider = ({
       if (!online || !wasOffline) {
         return;
       }
+      cachedSessionCheckRef.current.runNow?.();
       void (async () => {
         if (hasIsolatedOAuthSession(runtime)) return;
         if (oxyServices.session.accessToken || !sessionClientHost.getDeviceCredential()) {