@mentra/engine 3.4.0-dev.971 → 3.4.0-dev.973

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/engine",
-  "version": "3.4.0-dev.971",
+  "version": "3.4.0-dev.973",
   "description": "Mentra Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,13 +97,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/acs-meeting": "3.4.0-dev.971",
-    "@mentra/glasses-media": "3.4.0-dev.971",
-    "@mentra/bluetooth-sdk": "3.4.0-dev.971",
-    "@mentra/cloud-client": "3.4.0-dev.971",
-    "@mentra/cloud-protocol": "3.4.0-dev.971",
-    "@mentra/crust": "3.4.0-dev.971",
-    "@mentra/miniapp": "3.4.0-dev.971",
+    "@mentra/acs-meeting": "3.4.0-dev.973",
+    "@mentra/glasses-media": "3.4.0-dev.973",
+    "@mentra/bluetooth-sdk": "3.4.0-dev.973",
+    "@mentra/cloud-client": "3.4.0-dev.973",
+    "@mentra/cloud-protocol": "3.4.0-dev.973",
+    "@mentra/crust": "3.4.0-dev.973",
+    "@mentra/miniapp": "3.4.0-dev.973",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "jszip": "^3.10.1",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.4.0",
-  "releaseIdentity": "3.4.0-dev.971",
-  "releaseSetId": "mentra-3.4.0-dev.971",
-  "sourceCommit": "c72b7ecf63112a98579639fc4fdb126aedbf425d",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.4.0/mentra-live-ota-3.4.0-dev.971.json",
-  "otaManifestSha256": "5be88fa1406efdd5024b94ae18c9124f33ed1cd8e1661f5bcfbabc522a120037"
+  "releaseIdentity": "3.4.0-dev.973",
+  "releaseSetId": "mentra-3.4.0-dev.973",
+  "sourceCommit": "fd4df756e0e979c229fee7ee145db7f7ee2ed1b4",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.4.0/mentra-live-ota-3.4.0-dev.973.json",
+  "otaManifestSha256": "79f09b7f9267d33febe4346b9aae9595c14cbff97caf661ee301e582b4bbbb66"
 })

package/src/react/MentraLiveOtaFlow.tsx

@@ -79,8 +79,6 @@ const ENGLISH_COPY: Record<string, string> = {
   "ota:startingHotspotUpdate": "Starting update…",
   "ota:transferringToGlasses": "Transferring update to glasses…",
   "ota:installingOnGlasses": "Installing update on glasses…",
-  "ota:transportHotspot": "Using glasses hotspot",
-  "ota:transportWifi": "Using Wi-Fi",
   "ota:componentApk": "Glasses software",
   "ota:componentMtk": "System firmware",
   "ota:componentBes": "Bluetooth firmware",
@@ -242,36 +240,12 @@ export function MentraLiveOtaPreview({
 }
 
 function OtaFlowFrame({allowDevSkip, colors, controller, deviceName, style, superMode, translate}: OtaFlowFrameProps) {
-  const {state} = controller
-  const transportLabel =
-    state.transport &&
-    [
-      "starting",
-      "preparing_hotspot",
-      "updating",
-      "restarting",
-      "verifying",
-      "complete",
-      "failed",
-      "disconnected",
-    ].includes(state.screen)
-      ? translate(state.transport === "hotspot" ? "ota:transportHotspot" : "ota:transportWifi")
-      : null
-
   return (
     <SafeAreaView style={[styles.safeArea, {backgroundColor: colors.background}, style]}>
       <View style={styles.header}>
         <View />
         <MentraMark color={colors.primary} />
       </View>
-      {transportLabel ? (
-        <Text
-          accessibilityLabel={transportLabel}
-          style={[styles.transport, {color: colors.textDim}]}
-          testID={`ota.transport.${state.transport}`}>
-          {transportLabel}
-        </Text>
-      ) : null}
       <OtaFlowContent
         allowDevSkip={allowDevSkip}
         colors={colors}
@@ -369,7 +343,7 @@ function OtaFlowContent({
           <>
             <FlowButton
               colors={colors}
-              disabled={!state.wifiStatusKnown}
+              disabled={state.screen === "wifi_required" ? !state.wifiStatusKnown : !state.canInstall}
               label={translate(state.screen === "wifi_required" ? "ota:setupWifi" : "ota:updateNow")}
               onPress={state.screen === "wifi_required" ? controller.openWifiSetup : controller.install}
             />
@@ -924,7 +898,6 @@ const styles = StyleSheet.create({
   svgIcon: {alignItems: "center", height: 72, justifyContent: "center", width: 72},
   title: {fontSize: 20, fontWeight: "600", textAlign: "center"},
   body: {fontSize: 14, lineHeight: 20, maxWidth: 420, textAlign: "center"},
-  transport: {fontSize: 12, lineHeight: 16, textAlign: "center"},
   errorCode: {fontSize: 12, fontVariant: ["tabular-nums"], lineHeight: 16, opacity: 0.7, textAlign: "center"},
   percent: {fontSize: 30, fontVariant: ["tabular-nums"], fontWeight: "700"},
   progressTrack: {borderRadius: 4, height: 8, maxWidth: 420, overflow: "hidden", width: "100%"},

package/src/react/useMentraLiveOta.ts

@@ -325,7 +325,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         return false
       if (installActionPendingRef.current || !isOtaAutoChainActive() || !result.updateInfo) return false
       const snapshot = ota.snapshot()
-      if (!snapshot.wifiStatusKnown || (!snapshot.wifiConnected && snapshot.hotspotOtaVersion !== 1)) return false
+      if (snapshot.hotspotOtaVersion !== 1 && (!snapshot.wifiStatusKnown || !snapshot.wifiConnected)) return false
 
       const admission = tryAdvanceOtaAutoChain(
         otaAutoChainFingerprint(result),
@@ -484,7 +484,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
             const fromVersion = currentReleaseVersion(ota.snapshot().appVersion)
             setOfferedReleaseTransition(result.releaseVersion ? {fromVersion, toVersion: result.releaseVersion} : null)
           }
-          if (isOtaAutoChainActive() && !ota.snapshot().wifiStatusKnown) {
+          if (isOtaAutoChainActive() && !ota.snapshot().wifiStatusKnown && ota.snapshot().hotspotOtaVersion !== 1) {
             checkCompletedRef.current = true
             return
           }
@@ -534,7 +534,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
       !runtimeReady ||
       page !== "check" ||
       (checkState !== "checking" && checkState !== "update_available") ||
-      !otaSnapshot.wifiStatusKnown ||
+      (!otaSnapshot.wifiStatusKnown && otaSnapshot.hotspotOtaVersion !== 1) ||
       !isOtaAutoChainActive()
     ) {
       return
@@ -624,7 +624,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
       setBatteryBlocked(true)
       return
     }
-    if (!snapshot.wifiStatusKnown) {
+    if (!snapshot.wifiStatusKnown && snapshot.hotspotOtaVersion !== 1) {
       check()
       return
     }
@@ -667,6 +667,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
   const finish = useCallback(async () => {
     if (deviceRevision !== otaDeviceSessionRevision()) return
     if (page === "check") {
+      stopOtaAutoChain()
       onFinishedRef.current?.()
       return
     }
@@ -702,7 +703,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
 
   const state = useMemo<MentraLiveOtaState>(() => {
     const hotspotSupported = otaSnapshot.hotspotOtaVersion === 1
-    const canInstall = otaSnapshot.wifiStatusKnown && (otaSnapshot.wifiConnected || hotspotSupported)
+    const canInstall = hotspotSupported || (otaSnapshot.wifiStatusKnown && otaSnapshot.wifiConnected)
     const autoChainActive = isOtaAutoChainActive()
     if (!runtimeReady) {
       return {
@@ -776,7 +777,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         screen,
         connected: otaSnapshot.connected,
         batteryLevel: otaSnapshot.batteryLevel,
-        transport: otaSnapshot.wifiConnected ? "wifi" : hotspotSupported ? "hotspot" : null,
+        transport: hotspotSupported ? "hotspot" : otaSnapshot.wifiConnected ? "wifi" : null,
         updateRequired: isUpdateRequired,
         versionChange: isVersionChange,
         versionChangeConverged: false,
@@ -896,7 +897,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
       canFinish: screen === "complete" || (screen === "failed" && requiresGlassesReboot),
       canDismiss: false,
       canDiscard: screen === "disconnected",
-      canOpenWifiSetup: screen === "failed" && showChangeWifi,
+      canOpenWifiSetup: screen === "failed" && !hotspotSupported && showChangeWifi,
       continueDisabled: installSnapshot.continueButtonDisabled,
       completedUpdate: false,
       releaseTransition: releaseTransitionFromRange(otaAutoChainReleaseRange()),

package/src/services/OtaInstallCoordinator.ts

@@ -27,7 +27,7 @@ import {waitForOtaInternet} from "./OtaInternetRecovery"
 import {submitOtaFailureReport, type OtaFailureReason} from "./OtaFailureReportService"
 import type {OtaArtifactDownloadProgress} from "./OtaArtifactDownloader"
 import {otaDeviceSessionRevision, subscribeOtaDeviceSession} from "./OtaDeviceSession"
-import {isOtaCheckForCurrentDevice} from "./OtaUpdateCheckService"
+import {checkCurrentGlassesForUpdate, isOtaCheckForCurrentDevice} from "./OtaUpdateCheckService"
 import type {OtaCheckCurrentGlassesResult} from "./OtaUpdateCheckService"
 import {deriveDisplayState, type DisplayState} from "./otaDisplayState"
 import {
@@ -325,17 +325,17 @@ class OtaInstallCoordinator {
   prepare(checkResult: OtaCheckCurrentGlassesResult): "wifi" | "hotspot" {
     if (!isOtaCheckForCurrentDevice(checkResult)) throw new Error("The checked glasses have changed")
     const state = useGlassesStore.getState()
-    if (!state.wifiStatusKnown) {
+    const hotspotSupported = state.hotspotOtaVersion === 1
+    if (!hotspotSupported && !state.wifiStatusKnown) {
       throw new Error("Glasses Wi-Fi status is not available")
     }
-    const hotspotSupported = state.hotspotOtaVersion === 1
     const wifiConnected = state.wifi.state === "connected"
     if (!wifiConnected && !hotspotSupported) {
       throw new Error("Connected glasses require Wi-Fi for OTA")
     }
     this.reportAttemptId = `${Date.now()}-${++this.reportAttemptSequence}`
     this.preparedCheckResult = checkResult
-    this.selectedTransport = wifiConnected ? "wifi" : "hotspot"
+    this.selectedTransport = hotspotSupported ? "hotspot" : "wifi"
     this.observedTransport = this.selectedTransport
     this.hotspotManifestUrl = null
     this.hotspotPhase = "idle"
@@ -345,6 +345,18 @@ class OtaInstallCoordinator {
     return this.selectedTransport
   }
 
+  private initializeCheckedInstall(selected: OtaCheckCurrentGlassesResult["updateInfo"]): void {
+    const target =
+      selected?.isDowngrade && typeof selected.versionCode === "number" && selected.versionCode > 0
+        ? selected.versionCode
+        : null
+    this.versionChangeSession = target !== null
+    this.versionChangeTarget = target
+    if (target !== null) {
+      console.log(`[OTA_PROGRESS] version-change (downgrade) session, target=${target}`)
+    }
+  }
+
   /**
    * Bind the state machine to a mounted progress screen. Idempotent per
    * attach/detach cycle. Runs the initial-mount arbitration (send ota_start
@@ -364,11 +376,7 @@ class OtaInstallCoordinator {
     // A late completion from the previous OTA step can clear the store's offer
     // between check and mount. Keep this install bound to its prepared check.
     const selected = this.preparedCheckResult ? this.preparedCheckResult.updateInfo : initialState.otaUpdateAvailable
-    if (selected?.isDowngrade && typeof selected.versionCode === "number" && selected.versionCode > 0) {
-      this.versionChangeSession = true
-      this.versionChangeTarget = selected.versionCode
-      console.log(`[OTA_PROGRESS] version-change (downgrade) session, target=${selected.versionCode}`)
-    }
+    this.initializeCheckedInstall(selected)
     const recoveryTarget = this.otaStartOwnership?.versionChangeTarget
     if (this.otaStartOwnership?.outcome === "acknowledged" && recoveryTarget !== undefined) {
       // The progress route is an observer of this acknowledged install. A remount
@@ -1648,6 +1656,9 @@ class OtaInstallCoordinator {
     if (existingOwnership?.outcome === "rejected" && !this.prepareFreshOtaStartAttempt()) {
       return Promise.resolve()
     }
+    // Capability is cleared on link loss before version_info returns. Preserve
+    // hotspot selection for these paired glasses; the device boundary resets it.
+    if (useGlassesStore.getState().hotspotOtaVersion === 1) this.selectedTransport = "hotspot"
     const ownership: OtaStartOwnership = {
       outcome: "pending",
       promise: Promise.resolve(),
@@ -1674,7 +1685,20 @@ class OtaInstallCoordinator {
       if (this.selectedTransport === "hotspot") {
         if (!this.hotspotManifestUrl) {
           if (!this.preparedCheckResult) {
-            throw new Error("No selected OTA check is available for hotspot staging")
+            const result = await checkCurrentGlassesForUpdate()
+            if (!isCurrentAttempt()) return
+            if (!result.hasCheckCompleted || !result.updateAvailable || !result.manifestBody) {
+              throw new Error("No selected OTA check is available for hotspot staging")
+            }
+            this.preparedCheckResult = result
+            this.initializeCheckedInstall(result.updateInfo)
+            // The recovery check can reveal a downgrade after the start attempt
+            // was created. Give that detour its full bounded recovery deadline.
+            if (this.versionChangeSession) {
+              ownership.deadlineAt = Date.now() + LEGACY_GLOBAL_OTA_TIMEOUT_MS
+              this.clearGlobalTimeout()
+              this.maybeStartGlobalTimeout()
+            }
           }
           const manifestUrl = await hotspotOtaTransport.prepare(this.preparedCheckResult, (progress) => {
             if (!isCurrentAttempt()) return