@mentra/engine 3.2.0-dev.261 → 3.2.0-dev.262

package/build/services/LocalMiniappRuntime.d.ts

@@ -423,6 +423,7 @@ declare class LocalMiniappRuntime {
     private checkpointSoftapAttempt;
     /** Publishes a checklist snapshot, unless this attempt has already been superseded. */
     private emitSoftapProgress;
+    private softapRecoveryFields;
     /**
      * Narrates preflight work on the first row while it is still pending.
      *
@@ -433,6 +434,23 @@ declare class LocalMiniappRuntime {
      */
     private narrateSoftapPreflight;
     private runSoftapAttempt;
+    /**
+     * SoftAP loss is a media outage. Keep ACS, destroy generation N, wait for the glasses,
+     * then build generation N+1. Duplicate losses do not renew the deadline.
+     */
+    private beginSoftapRecovery;
+    /**
+     * Wait for a link the hotspot commands can actually use.
+     *
+     * The hotspot goes away a couple of seconds before the phone declares the BLE link dead, so the
+     * snapshot at loss time still reads "ready". Taking that at face value sent `set_hotspot_state`
+     * into a dying link twice, and each one burned its full timeout before the wearer was even back.
+     * Requiring the link to hold steady turns that into waiting, which is what the budget is for.
+     */
+    private waitForGlassesReturn;
+    private awaitGlassesReady;
+    /** True when the link stays ready for [ms]; false the moment it drops again. */
+    private glassesLinkHoldsSteady;
     /**
      * Cancels a SoftAP attempt and does not return until everything it owns has been released.
      *
@@ -457,6 +475,17 @@ declare class LocalMiniappRuntime {
      * is what lets the next call start on leaked state.
      */
     private teardownSoftapAttempt;
+    /**
+     * Send one hotspot command, re-sending it once if a session refresh cancelled it.
+     *
+     * The retry lives inside the unit chained onto [glassesHotspotCommand] rather than around it,
+     * which is what holds the invariant: one logical hotspot operation issues at most two native
+     * commands, and no later operation runs between them. A retry outside the queue would let an
+     * `on` land between the two halves of an `off` and leave the glasses in the opposite state.
+     *
+     * Re-sending is free because ASG compares against current state first and answers a same-state
+     * command with its current status instead of cycling the AP.
+     */
     private setGlassesHotspotState;
     /**
      * The last two gates, and the point where a timeout stops being treated as consent.
@@ -468,9 +497,9 @@ declare class LocalMiniappRuntime {
      * failure — the listener was still inside its 3s tombstone and the glasses AP was still up.
      *
      * A bound that expires is not success. It means the resource is still held by a call nobody is
-     * in any more, so it is taken by force and re-verified. Only if *that* fails does the next join
-     * get refused, which is a worse outcome than a slow teardown and a better one than two calls
-     * sharing a port.
+     * in any more, so it is taken by force and re-verified. An ingest port that is still held
+     * refuses the next join. A glasses hotspot that missed its off-ack does not — the next join
+     * wants the AP up and will raise it again.
      *
      * @returns failures to record; a non-empty list refuses the next join.
      */

package/build/services/LocalMiniappRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalMiniappRuntime.d.ts","sourceRoot":"","sources":["../../src/services/LocalMiniappRuntime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LocalMiniappRuntime.d.ts","sourceRoot":"","sources":["../../src/services/LocalMiniappRuntime.ts"],"names":[],"mappings":"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"}

package/build/services/LocalMiniappRuntime.js

@@ -23,7 +23,7 @@ import { storage as mmkvStorage } from "../utils/storage/storage";
 import { BgTimer } from "../utils/timers";
 import devServerBridge from "./DevServerBridge";
 import { islandNotifications } from "./NotificationsEmitter";
-import { isGlassesConnected } from "./GlassesReadiness";
+import { isGlassesConnected, isGlassesReady, waitForGlassesReady } from "./GlassesReadiness";
 import { toMiniappConnectionData } from "./GlassesStatusProjection";
 import audioPlaybackService from "./AudioPlaybackService";
 import { phoneLocationService } from "./PhoneLocationService";
@@ -56,11 +56,11 @@ import { NavigationHandlers } from "./NavigationHandlers";
 import { useAppStatusStore } from "../stores/apps";
 import appRegistry, { getDevAppAttestation, getDevAppSourcePackage } from "./AppRegistry";
 import { resolveForegroundLocationPermission } from "./ForegroundLocationPermission";
-import { advanceMiniappPingLiveness } from "./MiniappLiveness";
+import { advanceMiniappPingLiveness, shouldHoldMiniappPingLiveness } from "./MiniappLiveness";
 import { listPhoneCalendarEvents, PhoneCalendarError } from "./PhoneCalendarService";
 import { LocalMiniappStorage } from "./LocalMiniappStorage";
 import acsMeetingService, { parseAcsCallOrigin, parseAcsOutgoingVideo, parseAcsVideoSource, resolveAcsAudioSource, } from "./AcsMeetingService";
-import { createSoftapCallDeps, SoftapCallError, SoftapCallTransport, SOFTAP_STEPS, } from "./SoftapCallTransport";
+import { createSoftapCallDeps, SoftapCallError, SoftapCallTransport, RETURN_DEADLINE_MS, SOFTAP_STEPS, } from "./SoftapCallTransport";
 import { awaitCleanupBarrier } from "./SoftapCleanupBarrier";
 import { softapTrace, softapTraceFailure } from "../utils/softapTrace";
 import { PermissionFeatures, permissions } from "../facades/permissions";
@@ -120,6 +120,11 @@ const FOREGROUND_LIVENESS_PROBE_TIMEOUT_MS = 2_500;
  * rather than sit in "connecting" while the wearer waits.
  */
 const SOFTAP_FIRST_FRAME_MS = 20_000;
+/**
+ * How long the BLE link must stay up before SoftAP recovery trusts it. Covers the gap between
+ * the hotspot dying and the phone noticing the link died with it.
+ */
+const GLASSES_LINK_SETTLE_MS = 4_000;
 const REQUEST_WIFI_SETUP_TYPE = "miniapp_request_wifi_setup";
 // Unregister after this many missed pongs. Generous on purpose: a busy
 // context (heavy interim translation traffic) or OS scheduling while idle can
@@ -265,6 +270,25 @@ const SOFTAP_INGEST_CLOSE_WAIT_MS = 3_500;
 const SOFTAP_HOTSPOT_OFF_ACK_MS = 5_000;
 /** After a forced close there is nothing left to wait for, so this only catches a real failure. */
 const SOFTAP_FORCED_VERIFY_MS = 500;
+/**
+ * Rejection codes meaning the glasses replaced their Wi-Fi protocol session, not that the
+ * command failed.
+ *
+ * The glasses emit `wifi_protocol_session_ready` on every `glasses_ready`, which fires on BLE
+ * reconnects and ASG restarts — routine during a SoftAP teardown. The SDK cancels every pending
+ * Wi-Fi request when that lands, so a hotspot command in flight is lost even though nothing is
+ * actually wrong. `wifi_session_disconnected` is deliberately absent: that one is raised from the
+ * store update where the glasses went away, so there is nothing left to re-send to.
+ */
+const HOTSPOT_SESSION_REFRESH_CODES = new Set(["wifi_session_restarted", "wifi_session_changed"]);
+/**
+ * Let the restarted ASG command path settle before re-sending.
+ *
+ * `handleSetHotspotState` returns false when its network manager is not up yet, which drops the
+ * command silently, so an immediate re-send would just race the same initialization. Mirrors the
+ * retry spacing `disableHotspotWithRetry` uses for the sibling ASG-replacement case.
+ */
+const HOTSPOT_SESSION_RETRY_DELAY_MS = 500;
 /** Reject with [reason] if [work] has not settled in [ms]. The work itself is not cancellable. */
 function withTimeout(work, ms, reason) {
     return new Promise((resolve, reject) => {
@@ -3097,6 +3121,7 @@ class LocalMiniappRuntime {
             this.sendToMiniapp(owner, {
                 type: MiniappResponseType.MEETING_STATE,
                 ...state,
+                ...this.softapRecoveryFields(attempt?.packageName === owner ? attempt : null),
             });
             if (attempt?.ownsResources && attempt.transport?.shouldRepublish(state.mediaSource)) {
                 void attempt.transport.republish(state.mediaSourceReason ?? "mediaSource failed");
@@ -3282,8 +3307,12 @@ class LocalMiniappRuntime {
                 phase: "starting",
                 steps: SOFTAP_STEPS.map((step) => ({ step, status: "pending" })),
                 elapsedMs: 0,
+                mediaGeneration: 0,
             },
             scopedLostUnsub: null,
+            recovery: null,
+            recoveryActive: false,
+            recoveryDeadlineAt: null,
             body: null,
             teardown: null,
             settled,
@@ -3348,8 +3377,21 @@ class LocalMiniappRuntime {
             // join *is* in progress, and `idle` would make the miniapp think the call ended.
             state: current.state === "idle" ? "connecting" : current.state,
             softap: progress,
+            ...this.softapRecoveryFields(attempt),
         });
     }
+    softapRecoveryFields(attempt) {
+        if (!attempt?.recoveryDeadlineAt)
+            return {};
+        return {
+            recovery: {
+                active: attempt.recoveryActive,
+                generation: attempt.transport?.currentMediaGeneration(),
+                deadlineAt: attempt.recoveryDeadlineAt,
+                phase: attempt.transport?.currentPhase(),
+            },
+        };
+    }
     /**
      * Narrates preflight work on the first row while it is still pending.
      *
@@ -3388,10 +3430,12 @@ class LocalMiniappRuntime {
         this.checkpointSoftapAttempt(attempt, "cleanup barrier");
         const cleanupError = this.softapCleanupError;
         if (cleanupError) {
-            // Report once, allowing a retry after the wearer power-cycles the glasses.
+            // Cleared on read, so this refuses at most once and the next attempt always gets through —
+            // which is why the wearer is told to retry rather than to go power-cycle anything. The
+            // native reason stays in the trace: it names a leaked port, not something they can act on.
             this.softapCleanupError = null;
             softapTraceFailure("softap_join_refused", { packageName, reason: cleanupError });
-            throw new Error(`Previous call cleanup failed: ${cleanupError}. Power-cycle the glasses hotspot and try again.`);
+            throw new Error("Previous call cleanup has not finished yet. Please try joining again.");
         }
         attempt.releaseHotspot = acquireGlassesHotspot();
         attempt.ownsResources = true;
@@ -3420,7 +3464,7 @@ class LocalMiniappRuntime {
             token: args.token,
             displayName: args.displayName,
             video: args.video,
-            awaitFirstFrame: () => acsMeetingService.waitForFirstFrame(SOFTAP_FIRST_FRAME_MS),
+            awaitFirstFrame: (_report, options) => acsMeetingService.waitForFirstFrame(SOFTAP_FIRST_FRAME_MS, options),
             waitUntilLive: (timeoutMs) => acsMeetingService.waitUntilMediaLive(timeoutMs),
             subsystems: {
                 setHotspotState: async (enabled) => {
@@ -3484,6 +3528,15 @@ class LocalMiniappRuntime {
                 glassesLc3Uplink: () => acsMeetingService.glassesLc3UplinkActive(),
                 startPublishing: (pkg, options) => phoneStreamCoordinator.startUnmanaged(pkg, options),
                 stopPublishing: (pkg) => phoneStreamCoordinator.stop(pkg),
+                discardPendingBleStop: () => phoneStreamCoordinator.discardPendingBleStop(),
+                rebindIngest: async (report) => {
+                    report?.("Rebinding the glasses video receiver on the hotspot");
+                    const ingestUrl = await acsMeetingService.rebindSoftApIngest();
+                    if (!ingestUrl)
+                        throw new Error("the rebound meeting reported no ingest URL");
+                    report?.(`Receiver rebound at ${ingestUrl}`);
+                    return { ingestUrl };
+                },
             },
         }));
         attempt.transport = transport;
@@ -3515,14 +3568,7 @@ class LocalMiniappRuntime {
                 reason: error.message,
                 attemptAgeMs: Date.now() - attempt.startedAt,
             });
-            const current = acsMeetingService.getState();
-            this.sendToMiniapp(packageName, {
-                type: MiniappResponseType.MEETING_STATE,
-                ...current,
-                state: "error",
-                error: `SOFTAP_NETWORK_LOST: ${error.message}`,
-                softap: transport.progress(),
-            });
+            this.beginSoftapRecovery(attempt, transport, error);
         });
         // Sign in on the phone's current internet *before* the glasses hotspot takes DNS. On device,
         // createCallAgent after the scoped join timed out at 20s and only finished once SoftAP was
@@ -3561,6 +3607,163 @@ class LocalMiniappRuntime {
         });
         return state;
     }
+    /**
+     * SoftAP loss is a media outage. Keep ACS, destroy generation N, wait for the glasses,
+     * then build generation N+1. Duplicate losses do not renew the deadline.
+     */
+    beginSoftapRecovery(attempt, transport, error) {
+        // Gate on the live flag, not the promise: a settled Promise is still truthy, so a second
+        // walk-away after a successful re-arm was dropped as "in-flight" and the glasses kept
+        // POSTing WHIP at a hotspot the phone had already left.
+        if (attempt.recoveryActive) {
+            softapTrace("softap_recovery_dropped", { attempt: attempt.id, cause: "in-flight" });
+            return;
+        }
+        if (attempt.cancelled || this.softapAttempt !== attempt) {
+            softapTrace("softap_recovery_dropped", {
+                attempt: attempt.id,
+                cause: attempt.cancelled ? "retired" : "superseded",
+            });
+            return;
+        }
+        const lostAt = Date.now();
+        attempt.recoveryDeadlineAt = lostAt + RETURN_DEADLINE_MS;
+        attempt.recoveryActive = true;
+        this.emitSoftapProgress(attempt, transport.progress());
+        softapTrace("softap_recovery_begin", {
+            attempt: attempt.id,
+            deadlineAt: attempt.recoveryDeadlineAt,
+            mediaGeneration: transport.currentMediaGeneration(),
+            reason: error.message,
+        });
+        let run;
+        run = (async () => {
+            try {
+                await transport.recover(`${error.code}: ${error.message}`, {
+                    wait: async () => {
+                        const remaining = (attempt.recoveryDeadlineAt ?? 0) - Date.now();
+                        if (remaining <= 0) {
+                            throw new SoftapCallError("hotspot", "RETURN_DEADLINE", "The glasses did not return in time");
+                        }
+                        const ready = await this.waitForGlassesReturn(remaining, () => attempt.cancelled);
+                        if (attempt.cancelled || this.softapAttempt !== attempt) {
+                            throw new SoftapCallError("hotspot", "CANCELLED", "SoftAP recovery was cancelled");
+                        }
+                        if (!ready) {
+                            throw new SoftapCallError("hotspot", "RETURN_DEADLINE", "The glasses did not return in time");
+                        }
+                    },
+                });
+                if (attempt.cancelled || this.softapAttempt !== attempt)
+                    return;
+                this.emitSoftapProgress(attempt, transport.progress());
+                const current = acsMeetingService.getState();
+                this.sendToMiniapp(attempt.packageName, {
+                    type: MiniappResponseType.MEETING_STATE,
+                    ...current,
+                    softap: transport.progress(),
+                    ...this.softapRecoveryFields(attempt),
+                });
+                softapTrace("softap_recovery_live", {
+                    attempt: attempt.id,
+                    mediaGeneration: transport.currentMediaGeneration(),
+                    elapsedMs: Date.now() - lostAt,
+                });
+            }
+            catch (recoveryError) {
+                if (attempt.cancelled || this.softapAttempt !== attempt)
+                    return;
+                const message = recoveryError instanceof Error ? recoveryError.message : String(recoveryError);
+                softapTraceFailure("softap_recovery_failed", {
+                    attempt: attempt.id,
+                    reason: message,
+                    elapsedMs: Date.now() - lostAt,
+                });
+                const current = acsMeetingService.getState();
+                this.sendToMiniapp(attempt.packageName, {
+                    type: MiniappResponseType.MEETING_STATE,
+                    ...current,
+                    state: "error",
+                    error: `SOFTAP_NETWORK_LOST: ${error.message}`,
+                    softap: transport.progress(),
+                    recovery: {
+                        active: false,
+                        generation: transport.currentMediaGeneration(),
+                        deadlineAt: attempt.recoveryDeadlineAt ?? undefined,
+                        phase: transport.currentPhase(),
+                    },
+                });
+            }
+            finally {
+                attempt.recoveryActive = false;
+                if (attempt.recovery === run)
+                    attempt.recovery = null;
+            }
+        })();
+        attempt.recovery = run;
+    }
+    /**
+     * Wait for a link the hotspot commands can actually use.
+     *
+     * The hotspot goes away a couple of seconds before the phone declares the BLE link dead, so the
+     * snapshot at loss time still reads "ready". Taking that at face value sent `set_hotspot_state`
+     * into a dying link twice, and each one burned its full timeout before the wearer was even back.
+     * Requiring the link to hold steady turns that into waiting, which is what the budget is for.
+     */
+    async waitForGlassesReturn(timeoutMs, cancelled) {
+        const deadlineAt = Date.now() + timeoutMs;
+        while (!cancelled()) {
+            const remaining = deadlineAt - Date.now();
+            if (remaining <= 0)
+                return false;
+            if (!isGlassesReady(useGlassesStore.getState().connection) && !(await this.awaitGlassesReady(remaining, cancelled))) {
+                return false;
+            }
+            const settleMs = Math.min(GLASSES_LINK_SETTLE_MS, Math.max(0, deadlineAt - Date.now()));
+            if (await this.glassesLinkHoldsSteady(settleMs, cancelled))
+                return true;
+        }
+        return false;
+    }
+    awaitGlassesReady(timeoutMs, cancelled) {
+        const controller = new AbortController();
+        const poll = setInterval(() => {
+            if (cancelled())
+                controller.abort();
+        }, 250);
+        return waitForGlassesReady({
+            getConnection: () => useGlassesStore.getState().connection,
+            subscribe: (listener) => useGlassesStore.subscribe((state) => state.connection, listener),
+            timeoutMs,
+            signal: controller.signal,
+        }).finally(() => clearInterval(poll));
+    }
+    /** True when the link stays ready for [ms]; false the moment it drops again. */
+    glassesLinkHoldsSteady(ms, cancelled) {
+        if (ms <= 0)
+            return Promise.resolve(isGlassesReady(useGlassesStore.getState().connection));
+        return new Promise((resolve) => {
+            let done = false;
+            const settle = (steady) => {
+                if (done)
+                    return;
+                done = true;
+                clearTimeout(timer);
+                clearInterval(poll);
+                unsubscribe();
+                resolve(steady);
+            };
+            const unsubscribe = useGlassesStore.subscribe((state) => state.connection, (connection) => {
+                if (!isGlassesReady(connection))
+                    settle(false);
+            });
+            const poll = setInterval(() => {
+                if (cancelled())
+                    settle(false);
+            }, 250);
+            const timer = setTimeout(() => settle(true), ms);
+        });
+    }
     /**
      * Cancels a SoftAP attempt and does not return until everything it owns has been released.
      *
@@ -3603,7 +3806,11 @@ class LocalMiniappRuntime {
                     afterMs: SOFTAP_CLEANUP_STALL_LOG_MS,
                 });
             }, SOFTAP_CLEANUP_STALL_LOG_MS);
-            void Promise.allSettled([attempt.teardown, attempt.body ?? Promise.resolve()]).then(() => {
+            void Promise.allSettled([
+                attempt.teardown,
+                attempt.body ?? Promise.resolve(),
+                attempt.recovery ?? Promise.resolve(),
+            ]).then(() => {
                 clearTimeout(stallWatchdog);
                 attempt.markSettled();
                 if (this.softapAttempt === attempt)
@@ -3690,8 +3897,17 @@ class LocalMiniappRuntime {
             // so this is the caller's business, not a reason to block the next call.
             endFailure = await releaseStep("transport.stop", () => transport.stop(mode ? { mode } : {}));
             const undoFailures = transport.lastTeardownFailures();
-            if (undoFailures.length > 0)
-                failures.push(`could not release ${undoFailures.join(", ")}`);
+            // A hotspot that did not ACK off is leftover ON — the next join wants it on and will
+            // call setHotspotState(true). Refusing that join is how we got hotspot_off_ack_timeout
+            // as a wearer-facing "power-cycle the glasses" dead end.
+            const blockingUndos = undoFailures.filter((step) => step !== "hotspot");
+            if (blockingUndos.length > 0)
+                failures.push(`could not release ${blockingUndos.join(", ")}`);
+            if (undoFailures.includes("hotspot")) {
+                console.warn("[LocalMiniappRuntime] glasses hotspot undo timed out; next join will raise it again", {
+                    attempt: attempt.id,
+                });
+            }
         }
         const scopedFailure = await releaseStep("leaveScopedNetwork", () => acsMeetingService.leaveScopedNetwork());
         if (scopedFailure) {
@@ -3791,8 +4007,32 @@ class LocalMiniappRuntime {
         if (endFailure)
             throw endFailure;
     }
+    /**
+     * Send one hotspot command, re-sending it once if a session refresh cancelled it.
+     *
+     * The retry lives inside the unit chained onto [glassesHotspotCommand] rather than around it,
+     * which is what holds the invariant: one logical hotspot operation issues at most two native
+     * commands, and no later operation runs between them. A retry outside the queue would let an
+     * `on` land between the two halves of an `off` and leave the glasses in the opposite state.
+     *
+     * Re-sending is free because ASG compares against current state first and answers a same-state
+     * command with its current status instead of cycling the AP.
+     */
     setGlassesHotspotState(enabled) {
-        const run = this.glassesHotspotCommand.then(() => BluetoothSdk.setHotspotState(enabled), () => BluetoothSdk.setHotspotState(enabled));
+        const send = async () => {
+            try {
+                return await BluetoothSdk.setHotspotState(enabled);
+            }
+            catch (error) {
+                const code = error?.code;
+                if (!code || !HOTSPOT_SESSION_REFRESH_CODES.has(code))
+                    throw error;
+                softapTrace("softap_hotspot_session_retry", { enabled, code });
+                await new Promise((resolve) => setTimeout(resolve, HOTSPOT_SESSION_RETRY_DELAY_MS));
+                return await BluetoothSdk.setHotspotState(enabled);
+            }
+        };
+        const run = this.glassesHotspotCommand.then(send, send);
         this.glassesHotspotCommand = run.then(() => undefined, () => undefined);
         return run;
     }
@@ -3806,9 +4046,9 @@ class LocalMiniappRuntime {
      * failure — the listener was still inside its 3s tombstone and the glasses AP was still up.
      *
      * A bound that expires is not success. It means the resource is still held by a call nobody is
-     * in any more, so it is taken by force and re-verified. Only if *that* fails does the next join
-     * get refused, which is a worse outcome than a slow teardown and a better one than two calls
-     * sharing a port.
+     * in any more, so it is taken by force and re-verified. An ingest port that is still held
+     * refuses the next join. A glasses hotspot that missed its off-ack does not — the next join
+     * wants the AP up and will raise it again.
      *
      * @returns failures to record; a non-empty list refuses the next join.
      */
@@ -3888,11 +4128,18 @@ class LocalMiniappRuntime {
         if (!gates.hotspotOff) {
             try {
                 const status = await withTimeout(this.setGlassesHotspotState(false), SOFTAP_HOTSPOT_OFF_ACK_MS, "hotspot_off_ack_timeout");
-                if (status.state !== "disabled")
-                    failures.push(`the glasses hotspot is still ${status.state}`);
+                if (status.state !== "disabled") {
+                    console.warn("[LocalMiniappRuntime] glasses hotspot still reported after disable; next join will raise it", {
+                        attempt: attempt.id,
+                        state: status.state,
+                    });
+                }
             }
             catch (error) {
-                failures.push(`glasses hotspot off: ${error instanceof Error ? error.message : String(error)}`);
+                console.warn("[LocalMiniappRuntime] glasses hotspot off ack missed; next join will raise it", {
+                    attempt: attempt.id,
+                    reason: error instanceof Error ? error.message : String(error),
+                });
             }
         }
         softapTrace("softap_teardown_forced_done", {
@@ -5032,13 +5279,20 @@ class LocalMiniappRuntime {
     doPingRound() {
         const toRemove = [];
         for (const [packageName, app] of this.connectedApps) {
-            const liveness = advanceMiniappPingLiveness(app.unansweredPingRounds, PING_TIMEOUT_THRESHOLD);
-            if (liveness.shouldUnregister) {
-                console.warn(`${LOG_TAG}: ${packageName} missed ${PING_TIMEOUT_THRESHOLD} pings, unregistering`);
-                toRemove.push(packageName);
-                continue;
+            const holdPingLiveness = shouldHoldMiniappPingLiveness({
+                packageName,
+                softapPackageName: this.softapAttempt?.packageName,
+                softapCancelled: this.softapAttempt?.cancelled,
+            });
+            if (!holdPingLiveness) {
+                const liveness = advanceMiniappPingLiveness(app.unansweredPingRounds, PING_TIMEOUT_THRESHOLD);
+                if (liveness.shouldUnregister) {
+                    console.warn(`${LOG_TAG}: ${packageName} missed ${PING_TIMEOUT_THRESHOLD} pings, unregistering`);
+                    toRemove.push(packageName);
+                    continue;
+                }
+                app.unansweredPingRounds = liveness.unansweredPingRounds;
             }
-            app.unansweredPingRounds = liveness.unansweredPingRounds;
             // Send PING — SDK auto-replies with PONG
             this.sendToMiniapp(packageName, {
                 type: MiniappRequestType.PING,