@mentra/bluetooth-sdk 3.2.1-beta.508 → 3.2.1-beta.512

package/android/src/main/java/com/mentra/bluetoothsdk/GeneratedReleaseMetadata.kt

@@ -3,9 +3,9 @@ package com.mentra.bluetoothsdk
 /** Generated by release CI. Do not edit in a release checkout. */
 internal object GeneratedReleaseMetadata {
     const val FAMILY_BASE_VERSION: String = "3.2.1"
-    const val RELEASE_IDENTITY: String = "3.2.1-beta.508"
-    const val RELEASE_SET_ID: String = "mentra-3.2.1-beta.508"
-    const val SOURCE_COMMIT: String = "68789e3eb85a07a4297208c6322f92e9262d8e31"
-    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.508.json"
-    const val OTA_MANIFEST_SHA256: String = "a1b8ffb1b635bc7e1e933fe18741eeb6133c6208c6c681bb2c3e966ef10e3eaa"
+    const val RELEASE_IDENTITY: String = "3.2.1-beta.512"
+    const val RELEASE_SET_ID: String = "mentra-3.2.1-beta.512"
+    const val SOURCE_COMMIT: String = "e09a07ee7b71972e75a5051003ec561c12e6cb9b"
+    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.512.json"
+    const val OTA_MANIFEST_SHA256: String = "bd24cbd8279319912d643699eeb435df3ca88582194953583491a3625799ec01"
 }

package/android/src/main/java/com/mentra/bluetoothsdk/sgcs/Nimo.kt

@@ -2145,7 +2145,10 @@ class Nimo : SGCManager() {
             )
         }
         diagnostics?.connected((negotiatedMtu - 3).coerceIn(20, 512))
-        canvas.readiness(twsConnected && peerCompanionReady == true)
+        // Launch checks peer readiness in firmware; do not wait up to a minute for
+        // the first unsolicited heartbeat just because peer status is still unknown.
+        canvas.activate()
+        canvas.readiness(twsConnected && peerCompanionReady != false)
     }
 
     private fun handshakeFailed() {
@@ -2221,6 +2224,7 @@ class Nimo : SGCManager() {
         if (diagnostics?.onPacket(packet) == true) return
         if (packet.size >= 10 && packet[8].toInt() == 7 && (packet[9].toInt() and 255) in listOf(1, 3, 4)) {
             val response = NimoCanvasCodec.response(packet) ?: return
+            if (response.first == 1) Bridge.log("NIMO: canvas Launch response status=${response.second.firstOrNull()?.toInt()}")
             canvas.response(response.first, response.second)
             return
         }
@@ -2252,13 +2256,13 @@ class Nimo : SGCManager() {
                             if (appId != NimoCanvasCodec.APP_ID) {
                                 diagnostics?.cancelHeldCapture("Native app takeover preempted held capture", resumeCanvas = false)
                             }
-                            if (canvas.nativeApp(appId, true)) canvasEncoder.invalidate()
+                            canvas.nativeApp(appId, true)
                         }
                         NimoProtocol.STATE_EXIT -> {
                             if (appId == NimoCanvasCodec.APP_ID) {
                                 diagnostics?.cancelHeldCapture("Canvas exit preempted held capture", resumeCanvas = false)
                             }
-                            if (canvas.nativeApp(appId, false)) canvasEncoder.invalidate()
+                            canvas.nativeApp(appId, false)
                         }
                     }
                 }
@@ -2290,7 +2294,7 @@ class Nimo : SGCManager() {
                     // Both predicates were sampled by this device report. TWS-only
                     // reports and cached state cannot release a status-7 wait.
                     if (handshakeState == HandshakeState.READY) {
-                        canvas.confirmedReadiness(twsConnected && peerCompanionReady == true)
+                        canvas.confirmedReadiness(twsConnected && peerCompanionReady != false)
                     }
                 }
             }
@@ -2316,7 +2320,7 @@ class Nimo : SGCManager() {
         if (!connected && handshakeState == HandshakeState.READY) {
             Bridge.log("NIMO: TWS service dropped mid-session (arm removed/off?)")
         }
-        if (handshakeState == HandshakeState.READY) canvas.readiness(connected && peerCompanionReady == true)
+        if (handshakeState == HandshakeState.READY) canvas.readiness(connected && peerCompanionReady != false)
     }
 
     private fun handleInputEvent(code: Int) {

package/android/src/main/java/com/mentra/bluetoothsdk/sgcs/NimoCanvasCoordinator.kt

@@ -132,6 +132,7 @@ internal class NimoCanvasCoordinator(
     private var holding = false
     private var heldScope: String? = null
     private var cancelDeadline: (() -> Unit)? = null
+    private var cancelRetry: (() -> Unit)? = null
 
     fun offer(bytes: ByteArray, scope: String, force: Boolean = false) {
         if (holding && scope != heldScope) {
@@ -140,8 +141,15 @@ internal class NimoCanvasCoordinator(
         }
         run(session.offer(bytes, scope, force))
     }
-    fun readiness(ready: Boolean) = run(session.readiness(ready))
-    fun confirmedReadiness(ready: Boolean) = run(session.confirmedReadiness(ready))
+    fun activate() = run(session.activate())
+    fun readiness(ready: Boolean) {
+        if (!ready) { cancelRetry?.invoke(); cancelRetry = null }
+        run(session.readiness(ready))
+    }
+    fun confirmedReadiness(ready: Boolean) {
+        if (!ready) { cancelRetry?.invoke(); cancelRetry = null }
+        run(session.confirmedReadiness(ready))
+    }
     fun hold(onReady: () -> Unit) {
         session.hold(true)
         holding = true
@@ -155,19 +163,14 @@ internal class NimoCanvasCoordinator(
         heldScope = null
         run(session.hold(false, resume))
     }
-    fun exit() = run(session.exit())
-    /** Whether this report also invalidates an unfinished host encode. Exit's report does not
-     * invalidate a NEW scene submitted while the explicit Exit waits for its business ACK. */
-    fun nativeApp(appId: Int, entered: Boolean): Boolean {
-        val takeover = (appId == NimoCanvasCodec.APP_ID && !entered) ||
-            (appId != NimoCanvasCodec.APP_ID && entered)
-        val expectedExitReport = appId == NimoCanvasCodec.APP_ID && !entered && flight?.action?.key == 3
-        val invalidateEncoding = takeover && !expectedExitReport
-        run(session.nativeApp(appId, entered))
-        return invalidateEncoding
+    fun exit() {
+        cancelRetry?.invoke(); cancelRetry = null
+        run(session.exit())
     }
+    fun nativeApp(appId: Int, entered: Boolean) = run(session.nativeApp(appId, entered))
 
     fun disconnected() {
+        cancelRetry?.invoke(); cancelRetry = null
         cancelDeadline?.invoke(); cancelDeadline = null
         flight = null
         holdReady = null
@@ -199,6 +202,7 @@ internal class NimoCanvasCoordinator(
     private fun run(actions: List<NimoCanvasSession.Action>) {
         for (action in actions) when (action) {
             is NimoCanvasSession.Action.Send -> {
+                cancelRetry?.invoke(); cancelRetry = null
                 cancelDeadline?.invoke()
                 val current = Flight(action)
                 flight = current
@@ -219,7 +223,16 @@ internal class NimoCanvasCoordinator(
                 }
             }
             is NimoCanvasSession.Action.Reconnect -> { disconnected(); reconnect(action.reason) }
-            is NimoCanvasSession.Action.Rejected -> rejected(action.status)
+            is NimoCanvasSession.Action.Rejected -> {
+                rejected(action.status)
+                if (action.status == 7) {
+                    cancelRetry?.invoke()
+                    cancelRetry = scheduler.post(1_000) {
+                        cancelRetry = null
+                        run(session.retryNotReady())
+                    }
+                }
+            }
         }
     }
 }

package/android/src/main/java/com/mentra/bluetoothsdk/sgcs/NimoCanvasSession.kt

@@ -9,6 +9,7 @@ internal class NimoCanvasSession {
   }
   private data class Flight(val key: Int, val frame: ByteArray, val ticket: Long)
   private var ready = false
+  private var transportReady = false
   private var active = false
   private var held = false
   private var locked = false
@@ -16,6 +17,7 @@ internal class NimoCanvasSession {
   private var waitingReadiness = false
   private var observedNotReady = false
   private var readinessRetries = 0
+  private var probeRetries = 0
   private var exitRequested = false
   private var desired: ByteArray? = null
   private var accepted: ByteArray? = null
@@ -35,6 +37,23 @@ internal class NimoCanvasSession {
     return pump()
   }
 
+  /** Enter a blank canvas on a fresh connection unless a newer host scene is retained. */
+  fun activate(): List<Action> {
+    if (desired == null) desired = byteArrayOf(0, 0, 1)
+    exitRequested = false
+    return pump()
+  }
+
+  /** Launch itself checks peer readiness in firmware. Retry only explicit NOT_READY,
+   * with a small budget; never retry an ambiguous/missing business ACK on this link. */
+  fun retryNotReady(): List<Action> {
+    if (!transportReady || !waitingReadiness || desired == null || probeRetries >= 3) return emptyList()
+    probeRetries++
+    waitingReadiness = false
+    ready = true
+    return pump()
+  }
+
   /** Debug capture seam; production behavior is unchanged unless explicitly held. */
   fun hold(value: Boolean, resume: Boolean = true): List<Action> {
     held = value
@@ -50,7 +69,8 @@ internal class NimoCanvasSession {
   fun confirmedReadiness(value: Boolean): List<Action> = updateReadiness(value, confirmed = true)
 
   private fun updateReadiness(value: Boolean, confirmed: Boolean): List<Action> {
-    if (!value) readinessRetries = 0
+    transportReady = value
+    if (!value) { readinessRetries = 0; probeRetries = 0 }
     if (!value && flight != null) return resetLink("Readiness lost during canvas command")
     if (waitingReadiness) {
       if (!value) observedNotReady = true
@@ -67,9 +87,9 @@ internal class NimoCanvasSession {
 
   /** A new transport generation has no accepted frame. Retain only the latest desired scene. */
   fun disconnected() {
-    ready = false; active = false; held = false; locked = false; launchBlocked = false
+    ready = false; transportReady = false; active = false; held = false; locked = false; launchBlocked = false
     waitingReadiness = false; observedNotReady = false
-    readinessRetries = 0
+    readinessRetries = 0; probeRetries = 0
     accepted = null; rejected = null; flight = null; ticket++; forceRevision++
   }
 
@@ -78,21 +98,13 @@ internal class NimoCanvasSession {
     return pump()
   }
 
-  /** A local gesture/native app takeover suppresses replay until the host submits another scene. */
+  /** Firmware can restore its stock UI after reconnect. Keep host ownership and
+   * replay the newest scene, serializing behind any outstanding command ACK. */
   fun nativeApp(appId: Int, entered: Boolean): List<Action> {
     if ((appId == NimoCanvasCodec.APP_ID && !entered) || (appId != NimoCanvasCodec.APP_ID && entered)) {
-      // The expected FD Exit report preserves newer host content. A different
-      // native app entering is a real takeover, even while our Exit waits for ACK.
-      if (flight?.key == 3) {
-        active = false; accepted = null
-        if (appId != NimoCanvasCodec.APP_ID && entered) {
-          desired = null; rejected = null; scope = null
-        }
-        return emptyList()
-      }
-      val ambiguous = flight != null
-      desired = null; accepted = null; rejected = null; active = false; exitRequested = false; scope = null
-      if (ambiguous) return resetLink("Native app transition interrupted canvas command")
+      active = false
+      accepted = null
+      return pump()
     }
     return emptyList()
   }
@@ -130,8 +142,8 @@ internal class NimoCanvasSession {
       return listOf(Action.Rejected(status)) + pump()
     }
     when (key) {
-      1 -> active = true
-      4 -> { accepted = current.frame; rejected = null; readinessRetries = 0 }
+      1 -> { active = true; accepted = null }
+      4 -> { accepted = current.frame; rejected = null; readinessRetries = 0; probeRetries = 0 }
       3 -> { active = false; accepted = null; exitRequested = false }
     }
     return pump()
@@ -143,7 +155,7 @@ internal class NimoCanvasSession {
   }
 
   private fun resetLink(reason: String): List<Action> {
-    ready = false; active = false; accepted = null; flight = null; ticket++; forceRevision++
+    ready = false; transportReady = false; active = false; accepted = null; flight = null; ticket++; forceRevision++
     return listOf(Action.Reconnect(reason))
   }
 

package/android/src/test/java/com/mentra/bluetoothsdk/sgcs/NimoCanvasCoordinatorTest.kt

@@ -51,6 +51,46 @@ class NimoCanvasCoordinatorTest {
         fun finishUpdate(frame: ByteArray) { repeat(NimoCanvasCodec.frames(4, frame, 20).size) { written() }; ack(4) }
     }
 
+    @Test fun notReadyRetriesLaunchPromptlyButStopsAfterThreeProbes() {
+        val f = Fixture(); f.canvas.activate(); f.canvas.readiness(true)
+        repeat(4) { attempt ->
+            f.written(); f.ack(1, 7)
+            val before = f.writes.size
+            f.clock.advance(999)
+            assertEquals(before, f.writes.size)
+            f.clock.advance(1)
+            assertEquals(before + if (attempt < 3) 1 else 0, f.writes.size)
+        }
+        f.clock.advance(60_000)
+        assertEquals(4, f.writes.size)
+        assertTrue(f.failures.isEmpty())
+    }
+
+    @Test fun pendingReadinessRetryIsCancelledOnDisconnectExitAndKnownReadinessLoss() {
+        for (stop in listOf("disconnect", "exit", "notReady")) {
+            val f = Fixture(); f.canvas.activate(); f.canvas.readiness(true)
+            f.written(); f.ack(1, 7)
+            when (stop) {
+                "disconnect" -> f.canvas.disconnected()
+                "exit" -> f.canvas.exit()
+                else -> f.canvas.readiness(false)
+            }
+            f.clock.advance(2_000)
+            assertEquals(1, f.writes.size)
+            assertTrue(f.failures.isEmpty())
+        }
+    }
+
+    @Test fun readinessHeartbeatCancelsPendingProbeAndDoesNotDuplicateLaunch() {
+        val f = Fixture(); f.canvas.activate(); f.canvas.readiness(true)
+        f.written(); f.ack(1, 7)
+        f.canvas.confirmedReadiness(true)
+        f.clock.advance(1_000)
+        assertEquals(2, f.writes.size)
+        f.written(); f.ack(1); f.finishUpdate(byteArrayOf(0, 0, 1))
+        assertTrue(f.failures.isEmpty())
+    }
+
     @Test fun bothNotificationDescriptorsGateCharacteristicWrites() {
         val f = Fixture()
         val rx = Any(); val mic = Any()
@@ -184,7 +224,7 @@ class NimoCanvasCoordinatorTest {
         val f = Fixture(); f.launch(); f.finishUpdate(byteArrayOf(0, 0, 1))
         f.canvas.exit()
         f.canvas.offer(byteArrayOf(1, 0, 1), "two:1")
-        assertFalse(f.canvas.nativeApp(0xFD, false))
+        f.canvas.nativeApp(0xFD, false)
         f.written()
         val before = f.writes.size
         f.ack(3)
@@ -192,15 +232,15 @@ class NimoCanvasCoordinatorTest {
         assertArrayEquals(NimoCanvasCodec.frames(1, writeCapacity = 20).single(), f.writes.last())
     }
 
-    @Test fun actualNativeTakeoverDuringExitInvalidatesEncodingAndDoesNotRelaunch() {
+    @Test fun nativeTakeoverDuringExitRetainsNewerSceneUntilExitAck() {
         val f = Fixture(); f.launch(); f.finishUpdate(byteArrayOf(0, 0, 1))
         f.canvas.exit()
         f.canvas.offer(byteArrayOf(1, 0, 1), "two:1")
-        assertTrue(f.canvas.nativeApp(0, true))
+        f.canvas.nativeApp(0, true)
         f.written()
         val before = f.writes.size
         f.ack(3)
-        assertEquals(before, f.writes.size)
+        assertEquals(before + 1, f.writes.size)
         assertTrue(f.failures.isEmpty())
     }
 

package/android/src/test/java/com/mentra/bluetoothsdk/sgcs/NimoCanvasSessionTest.kt

@@ -210,31 +210,100 @@ class NimoCanvasSessionTest {
     assertArrayEquals(frameB, send(success(session, 1)).frame)
   }
 
-  @Test fun actualNativeTakeoverDuringExitDiscardsNewerScene() {
+  @Test fun nativeReportDuringExitPreservesNewerHostScene() {
     val session = NimoCanvasSession()
     launched(session); success(session, 4)
     assertEquals(3, send(session.exit()).key)
     session.offer(frameB, "two:1")
     assertTrue(session.nativeApp(0, true).isEmpty())
-    assertTrue(success(session, 3).isEmpty())
+    assertEquals(1, send(success(session, 3)).key)
+    assertArrayEquals(frameB, send(success(session, 1)).frame)
+  }
+
+  @Test fun nativeTakeoverRestoresLatestSceneWithoutAnotherHostOffer() {
+    for (app in listOf(0, 0xFD)) {
+      val session = NimoCanvasSession()
+      launched(session); success(session, 4)
+      assertEquals(1, send(session.nativeApp(app, app != 0xFD)).key)
+      assertArrayEquals(frameA, send(success(session, 1)).frame)
+    }
+  }
+
+  @Test fun nativeTakeoverWaitsForCurrentAckInsteadOfOverlappingCommands() {
+    val session = NimoCanvasSession(); launched(session)
+    assertTrue(session.nativeApp(0, true).isEmpty())
+    session.offer(frameB, "one:1")
+    assertEquals(1, send(success(session, 4)).key)
+    assertTrue(session.nativeApp(0, true).isEmpty()) // Startup report during Launch.
+    assertArrayEquals(frameB, send(success(session, 1)).frame)
+  }
+
+  @Test fun takeoverDuringUpdateReplaysIdenticalFrameAfterRelaunch() {
+    val session = NimoCanvasSession(); launched(session)
+    assertTrue(session.nativeApp(0, true).isEmpty())
+    // The old Update ACK must not deduplicate the same scene on a new canvas.
+    assertEquals(1, send(success(session, 4)).key)
+    assertArrayEquals(frameA, send(success(session, 1)).frame)
+    assertTrue(success(session, 4).isEmpty())
+    assertTrue(session.offer(frameA, "one:1").isEmpty())
+  }
+
+  @Test fun startupStockUiDoesNotDiscardRetainedSceneBeforeReadiness() {
+    val session = NimoCanvasSession(); launched(session); success(session, 4)
     session.disconnected()
-    assertTrue(session.readiness(true).isEmpty())
+    assertTrue(session.nativeApp(0, true).isEmpty())
+    session.activate()
+    assertEquals(1, send(session.readiness(true)).key)
+    assertArrayEquals(frameA, send(success(session, 1)).frame)
   }
 
-  @Test fun nativeTakeoverSuppressesReplayUntilNewHostFrame() {
-    val session = NimoCanvasSession()
-    launched(session); success(session, 4)
+  @Test fun explicitExitStillReturnsControlToStockUiUntilNextConnection() {
+    val session = NimoCanvasSession(); launched(session); success(session, 4)
+    assertEquals(3, send(session.exit()).key)
     assertTrue(session.nativeApp(0, true).isEmpty())
-    assertTrue(session.readiness(true).isEmpty())
-    assertEquals(1, send(session.offer(frameA, "one:1")).key)
+    assertTrue(success(session, 3).isEmpty())
+    assertTrue(session.nativeApp(0, true).isEmpty())
+    session.disconnected(); session.activate()
+    assertEquals(1, send(session.readiness(true)).key)
+    assertArrayEquals(byteArrayOf(0, 0, 1), send(success(session, 1)).frame)
   }
 
-  @Test fun nativeTakeoverOrReadinessLossDuringCommandResets() {
-    for (takeover in listOf(true, false)) {
-      val session = NimoCanvasSession(); launched(session)
-      val actions = if (takeover) session.nativeApp(0, true) else session.readiness(false)
-      assertTrue(actions.single() is NimoCanvasSession.Action.Reconnect)
+  @Test fun activationLaunchesBlankCanvasWithoutAnyMiniapp() {
+    val session = NimoCanvasSession()
+    assertTrue(session.activate().isEmpty())
+    assertEquals(1, send(session.readiness(true)).key)
+    assertArrayEquals(byteArrayOf(0, 0, 1), send(success(session, 1)).frame)
+  }
+
+  @Test fun successfulUpdateRestoresProbeBudgetForNextRecovery() {
+    val session = NimoCanvasSession(); session.activate(); session.readiness(true)
+    repeat(2) { episode ->
+      if (episode > 0) assertEquals(1, send(session.nativeApp(0, true)).key)
+      repeat(3) {
+        session.response(1, byteArrayOf(7))
+        assertEquals(1, send(session.retryNotReady()).key)
+      }
+      assertEquals(4, send(success(session, 1)).key)
+      assertTrue(success(session, 4).isEmpty())
+    }
+  }
+
+  @Test fun notReadyProbesAreBoundedAndFreshHeartbeatStillRecovers() {
+    val session = NimoCanvasSession(); session.activate(); session.readiness(true)
+    repeat(3) {
+      session.response(1, byteArrayOf(7))
+      assertEquals(1, send(session.retryNotReady()).key)
     }
+    session.response(1, byteArrayOf(7))
+    repeat(5) { assertTrue(session.retryNotReady().isEmpty()) }
+    assertEquals(1, send(session.confirmedReadiness(true)).key)
+    assertEquals(4, send(success(session, 1)).key)
+  }
+
+  @Test fun lostReadinessDuringCommandStillResets() {
+    val session = NimoCanvasSession(); launched(session)
+    assertTrue(session.readiness(false).single() is NimoCanvasSession.Action.Reconnect)
+    assertTrue(session.retryNotReady().isEmpty())
   }
 
   @Test fun offersCopyMutableInputAndRejectOversizedFrame() {

package/android/src/testDebug/java/com/mentra/bluetoothsdk/sgcs/NimoReadinessDriverTest.kt

@@ -121,25 +121,31 @@ class NimoReadinessDriverTest {
     assertTrue(failures.isEmpty())
   }
 
-  @Test fun unknownPeerCannotLaunchFromHandshakeOrTwsOnlyReports() {
-    canvas.offer(byteArrayOf(0, 0, 1), "initial")
+  @Test fun freshHandshakeProbesCanvasWithoutWaitingForHeartbeat() {
     finishHandshake(peer = null)
-    assertKeys()
-    emit(packet(6, 3, byteArrayOf(0, 1)))
     assertNull(field("peerCompanionReady").get(nimo))
+    assertKeys(1) // Firmware validates peer readiness, not a synthetic heartbeat.
+    emit(packet(6, 2, byteArrayOf(0, 0, 1))) // Stock dashboard entering at startup.
+    assertKeys(1)
+    emit(packet(7, 1, byteArrayOf(0, 0xFD.toByte())))
+    assertKeys(1, 4)
+    assertArrayEquals(NimoCanvasCodec.frames(4, byteArrayOf(0, 0, 1), 512).single(), frames.last())
+    assertTrue(failures.isEmpty())
+  }
+
+  @Test fun knownDisconnectedPeerStillBlocksUntilReadinessArrives() {
+    finishHandshake(peer = false)
     assertKeys()
-    emit(heartbeat(peer = 0))
-    assertEquals(false, field("peerCompanionReady").get(nimo))
+    emit(packet(6, 3, byteArrayOf(0, 1)))
     assertKeys()
     emit(heartbeat())
-    assertEquals(true, field("peerCompanionReady").get(nimo))
     assertKeys(1)
     assertTrue(failures.isEmpty())
   }
 
   @Test fun queuedOldGattAndWrongServiceCannotEstablishReadiness() {
     canvas.offer(byteArrayOf(0, 0, 1), "initial")
-    finishHandshake(peer = null)
+    finishHandshake(peer = false)
     val oldGatt = currentGatt
     queue(heartbeat(), oldGatt)
     currentGatt = newGatt()
@@ -147,7 +153,7 @@ class NimoReadinessDriverTest {
     idle() // The generation check must occur when the queued callback executes.
     emit(heartbeat(), oldGatt)
     emit(heartbeat(), currentGatt, characteristic(UUID.fromString("00001234-0000-1000-8000-00805f9b34fb")))
-    assertNull(field("peerCompanionReady").get(nimo))
+    assertEquals(false, field("peerCompanionReady").get(nimo))
     assertKeys()
 
     emit(heartbeat()) // Positive control through the actual current RX callback.

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.1",
-    "releaseIdentity": "3.2.1-beta.508",
-    "releaseSetId": "mentra-3.2.1-beta.508",
-    "sourceCommit": "68789e3eb85a07a4297208c6322f92e9262d8e31",
-    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.508.json",
-    "otaManifestSha256": "a1b8ffb1b635bc7e1e933fe18741eeb6133c6208c6c681bb2c3e966ef10e3eaa"
+    "releaseIdentity": "3.2.1-beta.512",
+    "releaseSetId": "mentra-3.2.1-beta.512",
+    "sourceCommit": "e09a07ee7b71972e75a5051003ec561c12e6cb9b",
+    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.512.json",
+    "otaManifestSha256": "bd24cbd8279319912d643699eeb435df3ca88582194953583491a3625799ec01"
 });
 //# sourceMappingURL=releaseMetadata.js.map

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,gBAAgB;IACnC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,kIAAkI;IACpJ,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.1\",\n  \"releaseIdentity\": \"3.2.1-beta.508\",\n  \"releaseSetId\": \"mentra-3.2.1-beta.508\",\n  \"sourceCommit\": \"68789e3eb85a07a4297208c6322f92e9262d8e31\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.508.json\",\n  \"otaManifestSha256\": \"a1b8ffb1b635bc7e1e933fe18741eeb6133c6208c6c681bb2c3e966ef10e3eaa\"\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,gBAAgB;IACnC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,kIAAkI;IACpJ,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.1\",\n  \"releaseIdentity\": \"3.2.1-beta.512\",\n  \"releaseSetId\": \"mentra-3.2.1-beta.512\",\n  \"sourceCommit\": \"e09a07ee7b71972e75a5051003ec561c12e6cb9b\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.512.json\",\n  \"otaManifestSha256\": \"bd24cbd8279319912d643699eeb435df3ca88582194953583491a3625799ec01\"\n})\n"]}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -16,7 +16,7 @@ enum BluetoothSdkDefaults {
     /// silently disable it on every pair the app touches.
     static let autoPowerOffEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.1-beta.508"
+    private static let swiftPackageSdkVersion = "3.2.1-beta.512"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/GeneratedReleaseMetadata.swift

@@ -3,9 +3,9 @@ import Foundation
 /// Generated by release CI. Do not edit in a release checkout.
 enum GeneratedReleaseMetadata {
     static let familyBaseVersion = "3.2.1"
-    static let releaseIdentity = "3.2.1-beta.508"
-    static let releaseSetId = "mentra-3.2.1-beta.508"
-    static let sourceCommit = "68789e3eb85a07a4297208c6322f92e9262d8e31"
-    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.508.json"
-    static let otaManifestSha256 = "a1b8ffb1b635bc7e1e933fe18741eeb6133c6208c6c681bb2c3e966ef10e3eaa"
+    static let releaseIdentity = "3.2.1-beta.512"
+    static let releaseSetId = "mentra-3.2.1-beta.512"
+    static let sourceCommit = "e09a07ee7b71972e75a5051003ec561c12e6cb9b"
+    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.512.json"
+    static let otaManifestSha256 = "bd24cbd8279319912d643699eeb435df3ca88582194953583491a3625799ec01"
 }

package/ios/Source/sgcs/Nimo.swift

@@ -1325,7 +1325,10 @@ class Nimo: NSObject, SGCManager {
         DeviceStore.shared.apply("glasses", "fullyBooted", true)
         DeviceStore.shared.apply("glasses", "connectionState", ConnTypes.CONNECTED)
         startTimers()
-        canvas.readiness(twsConnected && peerCompanionReady == true)
+        // The Launch ACK validates peer readiness without waiting for the first
+        // unsolicited heartbeat (which can arrive a minute after connection).
+        canvas.activate()
+        canvas.readiness(twsConnected && peerCompanionReady != false)
     }
 
     private func handshakeFailed() {
@@ -1394,6 +1397,7 @@ class Nimo: NSObject, SGCManager {
     private func handleRxPacket(_ packet: Data) {
         if packet.count >= 10, packet[8] == 7, [1, 3, 4].contains(packet[9]) {
             if let response = NimoCanvasCodec.response(packet) {
+                if response.key == 1 { Bridge.log("NIMO: canvas Launch response status=\(response.payload.first.map(Int.init) ?? -1)") }
                 canvas.response(key: response.key, payload: response.payload)
             }
             return
@@ -1427,9 +1431,9 @@ class Nimo: NSObject, SGCManager {
                 Bridge.log("NIMO: app state report appId=\(appId) phase=\(phase)")
                 switch phase {
                 case NimoProtocol.STATE_ENTER:
-                    if canvas.nativeApp(appId, entered: true) { canvasEncoder.invalidate() }
+                    canvas.nativeApp(appId, entered: true)
                 case NimoProtocol.STATE_EXIT:
-                    if canvas.nativeApp(appId, entered: false) { canvasEncoder.invalidate() }
+                    canvas.nativeApp(appId, entered: false)
                 default:
                     break
                 }
@@ -1459,7 +1463,7 @@ class Nimo: NSObject, SGCManager {
                 peerCompanionReady = v[9] != 0
                 onTwsState(Int(v[8]) >= 1)
                 if handshakeState == .ready {
-                    canvas.readiness(twsConnected && peerCompanionReady == true, confirmed: true)
+                    canvas.readiness(twsConnected && peerCompanionReady != false, confirmed: true)
                 }
             }
         case NimoProtocol.BUSINESS_BATTERY:
@@ -1482,7 +1486,7 @@ class Nimo: NSObject, SGCManager {
         if !connected, handshakeState == .ready {
             Bridge.log("NIMO: TWS service dropped mid-session (arm removed/off?)")
         }
-        if handshakeState == .ready { canvas.readiness(connected && peerCompanionReady == true) }
+        if handshakeState == .ready { canvas.readiness(connected && peerCompanionReady != false) }
     }
 
     private func handleInputEvent(_ code: Int) {

package/ios/Source/sgcs/NimoCanvasCoordinator.swift

@@ -21,6 +21,7 @@ final class NimoCanvasCoordinator {
     private let rejected: (Int) -> Void
     private let session = NimoCanvasSession()
     private var flight: Flight?
+    private var cancelRetry: (() -> Void)?
     private var cancelDeadline: (() -> Void)?
 
     init(schedule: @escaping NimoScheduler, writeCapacity: @escaping () -> Int,
@@ -35,23 +36,26 @@ final class NimoCanvasCoordinator {
         run(session.offer(bytes, scope: scope, force: force))
     }
 
+    func activate() {
+        run(session.activate())
+    }
+
     func readiness(_ value: Bool, confirmed: Bool = false) {
+        if !value { cancelRetry?(); cancelRetry = nil }
         run(session.readiness(value, confirmed: confirmed))
     }
 
     func exit() {
+        cancelRetry?(); cancelRetry = nil
         run(session.exit())
     }
 
-    /// An expected Exit report must not discard a newer host encode queued behind Exit.
-    func nativeApp(_ appId: Int, entered: Bool) -> Bool {
-        let takeover = (appId == NimoCanvasCodec.appId && !entered) || (appId != NimoCanvasCodec.appId && entered)
-        let expectedExit = appId == NimoCanvasCodec.appId && !entered && flight?.key == 3
+    func nativeApp(_ appId: Int, entered: Bool) {
         run(session.nativeApp(appId, entered: entered))
-        return takeover && !expectedExit
     }
 
     func disconnected() {
+        cancelRetry?(); cancelRetry = nil
         cancelDeadline?(); cancelDeadline = nil
         flight = nil
         session.disconnected()
@@ -72,6 +76,7 @@ final class NimoCanvasCoordinator {
         for action in actions {
             switch action {
             case let .send(key, frame, ticket):
+                cancelRetry?(); cancelRetry = nil
                 cancelDeadline?()
                 let current = Flight(key: key)
                 flight = current
@@ -93,7 +98,16 @@ final class NimoCanvasCoordinator {
                     disconnected(); reconnect("Canvas framing failed: \(error)")
                 }
             case let .reconnect(reason): disconnected(); reconnect(reason)
-            case let .rejected(status): rejected(status)
+            case let .rejected(status):
+                rejected(status)
+                if status == 7 {
+                    cancelRetry?()
+                    cancelRetry = schedule(1) { [weak self] in
+                        guard let self else { return }
+                        self.cancelRetry = nil
+                        self.run(self.session.retryNotReady())
+                    }
+                }
             }
         }
     }

package/ios/Source/sgcs/NimoCanvasSession.swift

@@ -15,12 +15,14 @@ final class NimoCanvasSession {
     }
 
     private var ready = false
+    private var transportReady = false
     private var active = false
     private var locked = false
     private var launchBlocked = false
     private var waitingReadiness = false
     private var observedNotReady = false
     private var readinessRetries = 0
+    private var probeRetries = 0
     private var exitRequested = false
     private var desired: Data?
     private var accepted: Data?
@@ -39,9 +41,27 @@ final class NimoCanvasSession {
         return pump()
     }
 
+    /// Enter a blank canvas unless a newer host scene survived the connection change.
+    func activate() -> [Action] {
+        if desired == nil { desired = Data([0, 0, 1]) }
+        exitRequested = false
+        return pump()
+    }
+
+    /// The firmware validates peer readiness on Launch. Only an explicit NOT_READY
+    /// permits a bounded retry; an ambiguous ACK still requires a new transport.
+    func retryNotReady() -> [Action] {
+        guard transportReady, waitingReadiness, desired != nil, probeRetries < 3 else { return [] }
+        probeRetries += 1
+        waitingReadiness = false
+        ready = true
+        return pump()
+    }
+
     /// Only a fresh heartbeat samples both TWS and peer Companion readiness.
     func readiness(_ value: Bool, confirmed: Bool = false) -> [Action] {
-        if !value { readinessRetries = 0 }
+        transportReady = value
+        if !value { readinessRetries = 0; probeRetries = 0 }
         if !value, flight != nil { return resetLink("Readiness lost during canvas command") }
         if waitingReadiness {
             if !value { observedNotReady = true }
@@ -58,8 +78,8 @@ final class NimoCanvasSession {
 
     /// Keep only the latest desired scene across a new transport generation.
     func disconnected() {
-        ready = false; active = false; locked = false; launchBlocked = false
-        waitingReadiness = false; observedNotReady = false; readinessRetries = 0
+        ready = false; transportReady = false; active = false; locked = false; launchBlocked = false
+        waitingReadiness = false; observedNotReady = false; readinessRetries = 0; probeRetries = 0
         accepted = nil; rejected = nil; flight = nil
         ticket &+= 1; forceRevision &+= 1
     }
@@ -69,16 +89,12 @@ final class NimoCanvasSession {
         return pump()
     }
 
+    /// Stock UI reports do not relinquish host ownership. Replay after the current ACK.
     func nativeApp(_ appId: Int, entered: Bool) -> [Action] {
         if (appId == NimoCanvasCodec.appId && !entered) || (appId != NimoCanvasCodec.appId && entered) {
-            if flight?.key == 3 {
-                active = false; accepted = nil
-                if appId != NimoCanvasCodec.appId, entered { desired = nil; rejected = nil; scope = nil }
-                return []
-            }
-            let ambiguous = flight != nil
-            desired = nil; accepted = nil; rejected = nil; active = false; exitRequested = false; scope = nil
-            if ambiguous { return resetLink("Native app transition interrupted canvas command") }
+            active = false
+            accepted = nil
+            return pump()
         }
         return []
     }
@@ -112,8 +128,8 @@ final class NimoCanvasSession {
             return [.rejected(status)] + pump()
         }
         switch key {
-        case 1: active = true
-        case 4: accepted = current.frame; rejected = nil; readinessRetries = 0
+        case 1: active = true; accepted = nil
+        case 4: accepted = current.frame; rejected = nil; readinessRetries = 0; probeRetries = 0
         case 3: active = false; accepted = nil; exitRequested = false
         default: break
         }
@@ -126,7 +142,7 @@ final class NimoCanvasSession {
     }
 
     private func resetLink(_ reason: String) -> [Action] {
-        ready = false; active = false; accepted = nil; flight = nil
+        ready = false; transportReady = false; active = false; accepted = nil; flight = nil
         ticket &+= 1; forceRevision &+= 1
         return [.reconnect(reason)]
     }

package/ios/Tests/NimoCanvasSessionTests.swift

@@ -102,11 +102,80 @@ final class NimoCanvasSessionTests: XCTestCase {
         XCTAssertEqual(frame, b)
     }
 
-    func testNativeTakeoverSuppressesReplayUntilHostOffersAgain() {
+    func testNativeTakeoverReplaysWithoutNewHostFrame() {
         let session = NimoCanvasSession(); connected(session)
-        XCTAssertTrue(session.nativeApp(1, entered: true).isEmpty)
-        XCTAssertTrue(session.readiness(true, confirmed: true).isEmpty)
-        XCTAssertEqual(sentKey(session.offer(b, scope: "new")), 1)
-        XCTAssertEqual(session.nativeApp(1, entered: true), [.reconnect("Native app transition interrupted canvas command")])
+        XCTAssertEqual(sentKey(session.nativeApp(0, entered: true)), 1)
+        XCTAssertTrue(session.nativeApp(0, entered: true).isEmpty)
+        guard case let .send(_, frame, _) = ack(session, 1).first else { return XCTFail() }
+        XCTAssertEqual(frame, a)
+        XCTAssertTrue(session.nativeApp(0xFD, entered: false).isEmpty)
+        XCTAssertEqual(sentKey(ack(session, 4)), 1)
+    }
+
+    func testTakeoverDuringUpdateReplaysIdenticalFrameAfterRelaunch() {
+        let session = NimoCanvasSession()
+        _ = session.offer(a, scope: "app:1"); _ = session.readiness(true)
+        XCTAssertEqual(sentKey(ack(session, 1)), 4)
+        XCTAssertTrue(session.nativeApp(0, entered: true).isEmpty)
+        XCTAssertEqual(sentKey(ack(session, 4)), 1)
+        guard case let .send(_, frame, _) = ack(session, 1).first else { return XCTFail("Missing replay Update") }
+        XCTAssertEqual(frame, a)
+        XCTAssertTrue(ack(session, 4).isEmpty)
+        XCTAssertTrue(session.offer(a, scope: "app:1").isEmpty)
+    }
+
+    func testStartupStockUiPreservesReconnectScene() {
+        let session = NimoCanvasSession(); connected(session)
+        session.disconnected()
+        XCTAssertTrue(session.nativeApp(0, entered: true).isEmpty)
+        XCTAssertTrue(session.activate().isEmpty)
+        XCTAssertEqual(sentKey(session.readiness(true)), 1)
+        guard case let .send(_, frame, _) = ack(session, 1).first else { return XCTFail() }
+        XCTAssertEqual(frame, a)
+    }
+
+    func testActivationEntersBlankCanvasBeforeAnyMiniapp() {
+        let session = NimoCanvasSession()
+        XCTAssertTrue(session.activate().isEmpty)
+        XCTAssertEqual(sentKey(session.readiness(true)), 1)
+        guard case let .send(_, frame, _) = ack(session, 1).first else { return XCTFail() }
+        XCTAssertEqual(frame, Data([0, 0, 1]))
+    }
+
+    func testExplicitExitStopsRestorationUntilAnotherConnection() {
+        let session = NimoCanvasSession(); connected(session)
+        XCTAssertEqual(sentKey(session.exit()), 3)
+        XCTAssertTrue(session.nativeApp(0, entered: true).isEmpty)
+        XCTAssertTrue(ack(session, 3).isEmpty)
+        XCTAssertTrue(session.nativeApp(0xFD, entered: false).isEmpty)
+        session.disconnected()
+        _ = session.activate()
+        XCTAssertEqual(sentKey(session.readiness(true)), 1)
+    }
+
+    func testSuccessfulUpdateRestoresProbeBudgetForNextRecovery() {
+        let session = NimoCanvasSession()
+        _ = session.activate(); _ = session.readiness(true)
+        for episode in 0 ..< 2 {
+            if episode > 0 { XCTAssertEqual(sentKey(session.nativeApp(0, entered: true)), 1) }
+            for _ in 0 ..< 3 {
+                _ = ack(session, 1, status: 7)
+                XCTAssertEqual(sentKey(session.retryNotReady()), 1)
+            }
+            XCTAssertEqual(sentKey(ack(session, 1)), 4)
+            XCTAssertTrue(ack(session, 4).isEmpty)
+        }
+    }
+
+    func testProbesAreBoundedAndHeartbeatCanStillRecover() {
+        let session = NimoCanvasSession()
+        _ = session.activate(); _ = session.readiness(true)
+        for _ in 0 ..< 3 {
+            _ = ack(session, 1, status: 7)
+            XCTAssertEqual(sentKey(session.retryNotReady()), 1)
+        }
+        _ = ack(session, 1, status: 7)
+        XCTAssertTrue(session.retryNotReady().isEmpty)
+        XCTAssertEqual(sentKey(session.readiness(true, confirmed: true)), 1)
     }
 }

package/ios/Tests/NimoCanvasTransportTests.swift

@@ -33,6 +33,31 @@ private final class NimoTestClock {
 final class NimoCanvasTransportTests: XCTestCase {
     private let frame = Data([0, 0, 1])
 
+    func testNotReadyProbesAreTimedBoundedAndCancelled() {
+        for stop in ["budget", "disconnect", "exit", "notReady"] {
+            let clock = NimoTestClock()
+            var keys: [Int] = []
+            let canvas = NimoCanvasCoordinator(schedule: clock.schedule, writeCapacity: { 512 }, enqueue: { frames, start, complete in
+                keys.append(Int(frames[0][9])); start(); complete(); return true
+            }, reconnect: { XCTFail($0) }, rejected: { _ in })
+            canvas.activate(); canvas.readiness(true)
+            for attempt in 0 ..< 4 {
+                canvas.response(key: 1, payload: Data([7]))
+                if stop == "disconnect" { canvas.disconnected() }
+                if stop == "exit" { canvas.exit() }
+                if stop == "notReady" { canvas.readiness(false) }
+                let before = keys.count
+                clock.advance(0.999)
+                XCTAssertEqual(keys.count, before)
+                clock.advance(0.001)
+                XCTAssertEqual(keys.count, before + (stop == "budget" && attempt < 3 ? 1 : 0))
+                if stop != "budget" { break }
+            }
+            clock.advance(60)
+            XCTAssertEqual(keys.count, stop == "budget" ? 4 : 1)
+        }
+    }
+
     func testEarlyAckOnlyAdvancesAfterFinalWriteCompletes() {
         let clock = NimoTestClock()
         var chains: [[Data]] = [], starts: [() -> Void] = [], completes: [() -> Void] = []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.2.1-beta.508",
+  "version": "3.2.1-beta.512",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -114,7 +114,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/cloud-protocol": "3.2.1-beta.508"
+    "@mentra/cloud-protocol": "3.2.1-beta.512"
   },
   "devDependencies": {
     "@types/node": "^25.9.3",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface BluetoothSdkReleaseMetadata {
 export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.2.1",
-  "releaseIdentity": "3.2.1-beta.508",
-  "releaseSetId": "mentra-3.2.1-beta.508",
-  "sourceCommit": "68789e3eb85a07a4297208c6322f92e9262d8e31",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.508.json",
-  "otaManifestSha256": "a1b8ffb1b635bc7e1e933fe18741eeb6133c6208c6c681bb2c3e966ef10e3eaa"
+  "releaseIdentity": "3.2.1-beta.512",
+  "releaseSetId": "mentra-3.2.1-beta.512",
+  "sourceCommit": "e09a07ee7b71972e75a5051003ec561c12e6cb9b",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.512.json",
+  "otaManifestSha256": "bd24cbd8279319912d643699eeb435df3ca88582194953583491a3625799ec01"
 })