@mentra/bluetooth-sdk 3.2.0-dev.261 → 3.2.0-dev.262

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

@@ -16,6 +16,7 @@ import com.mentra.bluetoothsdk.services.ForegroundService
 import com.mentra.bluetoothsdk.services.PhoneMic
 import com.mentra.bluetoothsdk.sgcs.Ar99
 import com.mentra.bluetoothsdk.sgcs.G1
+import com.mentra.bluetoothsdk.sgcs.GlassesLinkDiagnostics
 import com.mentra.bluetoothsdk.sgcs.G2
 import com.mentra.bluetoothsdk.sgcs.SceneElement
 import com.mentra.bluetoothsdk.sgcs.SceneFrame
@@ -879,6 +880,7 @@ class DeviceManager {
 
     private fun micDbgLc3Window(lc3: ByteArray, seq: Int?, pcm: ByteArray) {
         val now = System.currentTimeMillis()
+        GlassesLinkDiagnostics.recordMicPacket(now)
         if (micDbgWindowStart == 0L) micDbgWindowStart = now
         micDbgPkts++
         micDbgLc3Bytes += lc3.size

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.0"
-    const val RELEASE_IDENTITY: String = "3.2.0-dev.261"
-    const val RELEASE_SET_ID: String = "mentra-3.2.0-dev.261"
-    const val SOURCE_COMMIT: String = "ebd405ff0f311035faccac6e19b0a5a38b3a1483"
-    const val OTA_MANIFEST_URL: String = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.261.json"
-    const val OTA_MANIFEST_SHA256: String = "e9d88a258f276ee9ddc5396e9c5745f91f924449b802248e6d37dfe9bb8bb3ee"
+    const val RELEASE_IDENTITY: String = "3.2.0-dev.262"
+    const val RELEASE_SET_ID: String = "mentra-3.2.0-dev.262"
+    const val SOURCE_COMMIT: String = "545ed70c7afa46ca09b895d2dcd651b45510dbb5"
+    const val OTA_MANIFEST_URL: String = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.262.json"
+    const val OTA_MANIFEST_SHA256: String = "d1c4e63ae2c1cd8de479d4bbc57219d2b85e904c26a491441265f5182220125f"
 }

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

@@ -89,6 +89,9 @@ class MentraBluetoothSdk private constructor(
             activityLifecycleCallbacksRegistered = true
         }
         bridgeEventSinkId = Bridge.addEventSink { eventName, data -> dispatchBridgeEvent(eventName, data) }
+        // DeviceManager/MentraLive outlive Expo module remounts. glasses_ready already
+        // ran on this BLE session; replay it so startStream does not claim old firmware.
+        deviceManager.sgc?.replayStreamControlReady()
         // Baseline the analytics connection state before subscribing to the store:
         // store updates invoke listeners synchronously on the updating thread, so a
         // connected status observed before the baseline would be reported as a fresh

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

@@ -0,0 +1,96 @@
+package com.mentra.bluetoothsdk.sgcs
+
+/**
+ * Keeps the handful of measurements that explain why a Mentra Live BLE link died, and renders them
+ * as one line when it does.
+ *
+ * <p>A BES watchdog reboot reaches the phone only as `GATT connection error: status=8`, which says
+ * nothing about whether the link faded, went abruptly quiet, or was dropped while healthy. The
+ * answer is always in the seconds before: how far the RSSI had fallen, how long since the glasses
+ * last said anything, and how long since a mic packet arrived. Those exist today only as thousands
+ * of separate `RSSI:` and `MICDBG-RX` lines that have to be correlated by hand after the fact.
+ *
+ * <p>Phone-side, because the glasses' own log is the artifact most likely to be missing or to have
+ * lost the window: it uploads only a 600-line logcat tail, which the post-reboot reconnect fills.
+ */
+object GlassesLinkDiagnostics {
+
+    /** Grep marker. Never build this by concatenation — a single grep must be exhaustive. */
+    const val MARKER = "LINK_DEATH"
+
+    private const val RSSI_HISTORY = 12
+
+    private val rssiHistory = ArrayDeque<Sample>(RSSI_HISTORY)
+    private var lastInboundMs: Long? = null
+    private var lastMicPacketMs: Long? = null
+    private var sessionStartMs: Long? = null
+
+    private data class Sample(val atMs: Long, val rssi: Int)
+
+    /** Called when a BLE session is established, so ages are measured against this link only. */
+    @Synchronized
+    fun onSessionStart(nowMs: Long = System.currentTimeMillis()) {
+        rssiHistory.clear()
+        lastInboundMs = null
+        lastMicPacketMs = null
+        sessionStartMs = nowMs
+    }
+
+    /** Called for every JSON message the glasses send. */
+    @Synchronized
+    fun recordInbound(nowMs: Long = System.currentTimeMillis()) {
+        lastInboundMs = nowMs
+    }
+
+    /** Called for every LC3 mic packet. Mic gaps lead the control-channel failure by seconds. */
+    @Synchronized
+    fun recordMicPacket(nowMs: Long = System.currentTimeMillis()) {
+        lastMicPacketMs = nowMs
+    }
+
+    @Synchronized
+    fun recordRssi(rssi: Int, nowMs: Long = System.currentTimeMillis()) {
+        while (rssiHistory.size >= RSSI_HISTORY) {
+            rssiHistory.removeFirst()
+        }
+        rssiHistory.addLast(Sample(nowMs, rssi))
+    }
+
+    /**
+     * One-line summary of the link's final seconds.
+     *
+     * @param reason the transition being explained, e.g. `gatt_error` or `gatt_disconnected`
+     * @param status the GATT status code, or null when the stack did not report one
+     */
+    @Synchronized
+    fun summary(
+            reason: String,
+            status: Int? = null,
+            streamActive: Boolean? = null,
+            nowMs: Long = System.currentTimeMillis()
+    ): String {
+        val parts = mutableListOf<String>()
+        parts.add(MARKER)
+        parts.add("reason=$reason")
+        if (status != null) parts.add("status=$status")
+        parts.add("sessionMs=${age(sessionStartMs, nowMs)}")
+        parts.add("msSinceInbound=${age(lastInboundMs, nowMs)}")
+        parts.add("msSinceMicPacket=${age(lastMicPacketMs, nowMs)}")
+        parts.add("lastRssi=${rssiHistory.lastOrNull()?.rssi ?: UNKNOWN}")
+        parts.add("minRssi=${rssiHistory.minOfOrNull { it.rssi } ?: UNKNOWN}")
+        parts.add("rssiTrend=${trend()}")
+        if (streamActive != null) parts.add("streamActive=$streamActive")
+        return parts.joinToString(" ")
+    }
+
+    /** Oldest-to-newest RSSI so a fade is distinguishable from an abrupt drop at full signal. */
+    private fun trend(): String =
+            if (rssiHistory.isEmpty()) "none"
+            else rssiHistory.joinToString(",") { it.rssi.toString() }
+
+    /** Reports [UNKNOWN] for a signal never seen on this link, rather than an age from epoch. */
+    private fun age(sinceMs: Long?, nowMs: Long): Long =
+            if (sinceMs == null) UNKNOWN.toLong() else nowMs - sinceMs
+
+    private const val UNKNOWN = -1
+}

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

@@ -537,6 +537,9 @@ class MentraLive : SGCManager() {
     // cannot signal a restart - a CHANGED (or newly appearing) sid is the restart signal.
     // Null = no sid observed this BLE session (legacy glasses, or none seen yet).
     private var glassesSessionId: String? = null
+    // Last `glasses_ready.streamControlVersion`. Survives BluetoothSdkModule remounts
+    // so a new MentraBluetoothSdk can seed StreamSessionState without another ready.
+    private var streamControlVersion = 0
     // True once a glasses_ready completed on THIS physical BLE session; resets only with
     // the physical connection (never on heartbeat readiness flaps), so a first-seen sid
     // after an upgrade OTA is always detected as a restart.
@@ -1673,6 +1676,7 @@ class MentraLive : SGCManager() {
         connectedDevice = null
         glassesReady = false
         glassesSessionId = null
+        streamControlVersion = 0
         readinessCompletedThisBleSession = false
         glassesReadyReceived = false
         ctkdInitiatedThisGattSession = false
@@ -1947,6 +1951,7 @@ class MentraLive : SGCManager() {
         connectedDevice = null
         glassesReady = false
         glassesSessionId = null
+        streamControlVersion = 0
         readinessCompletedThisBleSession = false
         glassesReadyReceived = false
         ctkdInitiatedThisGattSession = false
@@ -2328,6 +2333,8 @@ class MentraLive : SGCManager() {
                             // Discover services
                             gatt.discoverServices()
 
+                            GlassesLinkDiagnostics.onSessionStart()
+
                             // Do NOT reset reconnectAttempts here — ephemeral GATT CONNECTED
                             // followed by status 19 was zeroing the counter every ~1s and
                             // preventing exponential backoff. Reset at ble_chars_ready instead.
@@ -2340,6 +2347,13 @@ class MentraLive : SGCManager() {
                             Bridge.log(
                                     "LIVE: 🔌 ⚠️ Disconnected from GATT server - Will attempt reconnection"
                             )
+                            Bridge.log(
+                                    "LIVE: " +
+                                            GlassesLinkDiagnostics.summary(
+                                                    "gatt_disconnected",
+                                                    status
+                                            )
+                            )
                             endPairingTiming(
                                     "gatt_disconnected",
                                     "queueSize=${sendQueue.size}"
@@ -2350,6 +2364,7 @@ class MentraLive : SGCManager() {
                             connectedDevice = null
                             glassesReady = false // Reset ready state on disconnect
                             glassesSessionId = null // Fresh BLE session starts with no sid known
+                            streamControlVersion = 0
                             readinessCompletedThisBleSession = false
 
                             // Reset audio pairing flags
@@ -2401,6 +2416,9 @@ class MentraLive : SGCManager() {
                                         status +
                                         ") - Will retry reconnection"
                         )
+                        Bridge.log(
+                                "LIVE: " + GlassesLinkDiagnostics.summary("gatt_error", status)
+                        )
                         endPairingTiming(
                                 "gatt_error",
                                 "status=$status queueSize=${sendQueue.size}"
@@ -2409,6 +2427,7 @@ class MentraLive : SGCManager() {
                         isConnecting = false
                         glassesReady = false
                         glassesSessionId = null
+                        streamControlVersion = 0
                         readinessCompletedThisBleSession = false
                         glassesReadyReceived = false
                         audioConnected = false
@@ -3970,6 +3989,7 @@ class MentraLive : SGCManager() {
             Log.d(TAG, "LIVE: Got some JSON from glasses: " + json.toString())
         }
         BleTraceLogger.logJson("glasses_to_phone", "sdk_ble_event", json, null)
+        GlassesLinkDiagnostics.recordInbound()
 
         if (MessageChunker.isChunkedMessage(json)) {
             processChunkedJsonMessage(json)
@@ -4571,6 +4591,7 @@ class MentraLive : SGCManager() {
                 // already runs this full remote-reset flow, so recording (not re-triggering)
                 // is correct here; version_info detection covers the restart case.
                 glassesSessionId = json.optString("sid", "").takeIf { it.isNotEmpty() }
+                streamControlVersion = json.optInt("streamControlVersion", 0)
                 Bridge.sendTypedMessage(
                         "wifi_protocol_session_ready",
                         mapOf("sid" to (glassesSessionId ?: "")),
@@ -4578,7 +4599,7 @@ class MentraLive : SGCManager() {
                 readinessCompletedThisBleSession = true
                 Bridge.sendTypedMessage("stream_control_ready", mapOf(
                     "sid" to json.optString("sid", ""),
-                    "streamControlVersion" to json.optInt("streamControlVersion", 0),
+                    "streamControlVersion" to streamControlVersion,
                 ))
 
                 // Set the ready flag to stop any future readiness checks
@@ -5519,6 +5540,7 @@ class MentraLive : SGCManager() {
                 glassesReady = false
                 glassesReadyReceived = false
                 glassesSessionId = null
+                streamControlVersion = 0
                 readinessCompletedThisBleSession = false
             }
             "sr_adota" -> {
@@ -6138,6 +6160,7 @@ class MentraLive : SGCManager() {
         val now = System.currentTimeMillis()
         DeviceStore.apply("glasses", "signalStrength", rssi)
         DeviceStore.apply("glasses", "signalStrengthUpdatedAt", now)
+        GlassesLinkDiagnostics.recordRssi(rssi, now)
         Bridge.log("LIVE: 📶 RSSI: " + rssi + " dBm")
     }
 
@@ -6821,6 +6844,19 @@ class MentraLive : SGCManager() {
         sendJson(json, true)
     }
 
+    override fun replayStreamControlReady() {
+        val sid = glassesSessionId ?: return
+        if (streamControlVersion != 1) return
+        Bridge.log("LIVE: Replaying stream_control_ready sid=$sid version=$streamControlVersion")
+        Bridge.sendTypedMessage(
+            "stream_control_ready",
+            mapOf(
+                "sid" to sid,
+                "streamControlVersion" to streamControlVersion,
+            ),
+        )
+    }
+
     override fun startStream(message: MutableMap<String, Any>) {
         Bridge.log("LIVE: Starting RTMP stream")
 

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

@@ -54,6 +54,11 @@ abstract class SGCManager {
     abstract fun requestPhoto(request: PhotoRequest)
     abstract fun startStream(message: MutableMap<String, Any>)
     abstract fun stopStream()
+    /**
+     * Re-advertise glasses-owned stream control after the phone SDK remounts.
+     * Mentra Live overrides this; other devices stay on the no-op.
+     */
+    open fun replayStreamControlReady() {}
     abstract fun sendStreamKeepAlive(message: MutableMap<String, Any>)
     abstract fun startVideoRecording(requestId: String, save: Boolean, sound: Boolean)
     open fun queryVideoRecordingStatus(requestId: String) {

package/android/src/test/java/com/mentra/bluetoothsdk/GlassesLinkDiagnosticsTest.kt

@@ -0,0 +1,79 @@
+package com.mentra.bluetoothsdk
+
+import com.mentra.bluetoothsdk.sgcs.GlassesLinkDiagnostics
+import org.junit.Assert.assertTrue
+import org.junit.Before
+import org.junit.Test
+
+class GlassesLinkDiagnosticsTest {
+
+    @Before
+    fun resetSession() {
+        GlassesLinkDiagnostics.onSessionStart(nowMs = 0L)
+    }
+
+    @Test
+    fun `summary separates a fading link from an abrupt drop`() {
+        // Walking out of range: RSSI decays, then the glasses go quiet before GATT notices.
+        GlassesLinkDiagnostics.recordRssi(-62, nowMs = 1_000L)
+        GlassesLinkDiagnostics.recordRssi(-78, nowMs = 2_000L)
+        GlassesLinkDiagnostics.recordRssi(-92, nowMs = 3_000L)
+        GlassesLinkDiagnostics.recordInbound(nowMs = 3_200L)
+        GlassesLinkDiagnostics.recordMicPacket(nowMs = 3_400L)
+
+        val summary =
+                GlassesLinkDiagnostics.summary(
+                        reason = "gatt_error",
+                        status = 8,
+                        streamActive = true,
+                        nowMs = 12_000L
+                )
+
+        assertTrue(summary.startsWith("LINK_DEATH "))
+        assertTrue(summary.contains("reason=gatt_error"))
+        assertTrue(summary.contains("status=8"))
+        assertTrue(summary.contains("sessionMs=12000"))
+        assertTrue(summary.contains("msSinceInbound=8800"))
+        assertTrue(summary.contains("msSinceMicPacket=8600"))
+        assertTrue(summary.contains("lastRssi=-92"))
+        assertTrue(summary.contains("minRssi=-92"))
+        assertTrue(summary.contains("rssiTrend=-62,-78,-92"))
+        assertTrue(summary.contains("streamActive=true"))
+    }
+
+    @Test
+    fun `summary marks never-seen signals rather than reporting a bogus age`() {
+        val summary = GlassesLinkDiagnostics.summary(reason = "gatt_disconnected", nowMs = 5_000L)
+
+        assertTrue(summary.contains("msSinceInbound=-1"))
+        assertTrue(summary.contains("msSinceMicPacket=-1"))
+        assertTrue(summary.contains("lastRssi=-1"))
+        assertTrue(summary.contains("rssiTrend=none"))
+        assertTrue(!summary.contains("status="))
+        assertTrue(!summary.contains("streamActive="))
+    }
+
+    @Test
+    fun `rssi history is bounded and keeps the newest samples`() {
+        repeat(30) { i -> GlassesLinkDiagnostics.recordRssi(-40 - i, nowMs = i.toLong()) }
+
+        val summary = GlassesLinkDiagnostics.summary(reason = "gatt_error", nowMs = 100L)
+
+        assertTrue(summary.contains("lastRssi=-69"))
+        assertTrue(summary.contains("minRssi=-69"))
+        assertTrue(summary.contains("rssiTrend=-58,-59,-60,-61,-62,-63,-64,-65,-66,-67,-68,-69"))
+    }
+
+    @Test
+    fun `a new session forgets the previous link`() {
+        GlassesLinkDiagnostics.recordRssi(-91, nowMs = 1_000L)
+        GlassesLinkDiagnostics.recordInbound(nowMs = 1_000L)
+
+        GlassesLinkDiagnostics.onSessionStart(nowMs = 2_000L)
+        val summary = GlassesLinkDiagnostics.summary(reason = "gatt_error", nowMs = 2_500L)
+
+        assertTrue(summary.contains("sessionMs=500"))
+        assertTrue(summary.contains("rssiTrend=none"))
+        assertTrue(summary.contains("msSinceInbound=-1"))
+    }
+}

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.0",
-    "releaseIdentity": "3.2.0-dev.261",
-    "releaseSetId": "mentra-3.2.0-dev.261",
-    "sourceCommit": "ebd405ff0f311035faccac6e19b0a5a38b3a1483",
-    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.261.json",
-    "otaManifestSha256": "e9d88a258f276ee9ddc5396e9c5745f91f924449b802248e6d37dfe9bb8bb3ee"
+    "releaseIdentity": "3.2.0-dev.262",
+    "releaseSetId": "mentra-3.2.0-dev.262",
+    "sourceCommit": "545ed70c7afa46ca09b895d2dcd651b45510dbb5",
+    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.262.json",
+    "otaManifestSha256": "d1c4e63ae2c1cd8de479d4bbc57219d2b85e904c26a491441265f5182220125f"
 });
 //# 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,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,wHAAwH;IAC1I,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.0\",\n  \"releaseIdentity\": \"3.2.0-dev.261\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.261\",\n  \"sourceCommit\": \"ebd405ff0f311035faccac6e19b0a5a38b3a1483\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.261.json\",\n  \"otaManifestSha256\": \"e9d88a258f276ee9ddc5396e9c5745f91f924449b802248e6d37dfe9bb8bb3ee\"\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,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,wHAAwH;IAC1I,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.0\",\n  \"releaseIdentity\": \"3.2.0-dev.262\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.262\",\n  \"sourceCommit\": \"545ed70c7afa46ca09b895d2dcd651b45510dbb5\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.262.json\",\n  \"otaManifestSha256\": \"d1c4e63ae2c1cd8de479d4bbc57219d2b85e904c26a491441265f5182220125f\"\n})\n"]}

package/ios/BluetoothSdkModule.swift

@@ -2,6 +2,16 @@ import CryptoKit
 import ExpoModulesCore
 import Foundation
 
+/// Carry the SDK's own error code across the Expo bridge.
+///
+/// `BluetoothSdkError` is a plain `Error`, not an Expo `Exception`, so `Promise.reject`
+/// wraps it in `UnexpectedException` and every code JS branches on arrives as
+/// `ERR_UNEXPECTED`. Android keeps the code because `DecoratedException` forwards
+/// `cause.code`; this is the iOS half of that guarantee.
+private func codedBridgeError(_ error: BluetoothSdkError) -> Exception {
+    Exception(name: error.code, description: error.message, code: error.code)
+}
+
 public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
     private var sdk: MentraBluetoothSDK?
 
@@ -344,9 +354,16 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             return try await sdk.forgetWifiNetwork(ssid: ssid).values
         }
 
+        // The host retries a hotspot command that a Wi-Fi protocol session refresh
+        // cancelled, and branches on the code to tell that apart from a real failure,
+        // so this one has to reach JS with its code intact.
         AsyncFunction("setHotspotState") { (enabled: Bool) in
             let sdk = await MainActor.run { self.bluetoothSdk() }
-            return try await sdk.setHotspotState(enabled: enabled).values
+            do {
+                return try await sdk.setHotspotState(enabled: enabled).values
+            } catch let error as BluetoothSdkError {
+                throw codedBridgeError(error)
+            }
         }
 
         AsyncFunction("setWifiAdbState") { (enabled: Bool) in

package/ios/Source/BluetoothSdkDefaults.swift

@@ -11,7 +11,7 @@ enum BluetoothSdkDefaults {
     static let voiceActivityDetectionEnabled = false
     static let loudnessGateEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.0-dev.261"
+    private static let swiftPackageSdkVersion = "3.2.0-dev.262"
     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.0"
-    static let releaseIdentity = "3.2.0-dev.261"
-    static let releaseSetId = "mentra-3.2.0-dev.261"
-    static let sourceCommit = "ebd405ff0f311035faccac6e19b0a5a38b3a1483"
-    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.261.json"
-    static let otaManifestSha256 = "e9d88a258f276ee9ddc5396e9c5745f91f924449b802248e6d37dfe9bb8bb3ee"
+    static let releaseIdentity = "3.2.0-dev.262"
+    static let releaseSetId = "mentra-3.2.0-dev.262"
+    static let sourceCommit = "545ed70c7afa46ca09b895d2dcd651b45510dbb5"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.262.json"
+    static let otaManifestSha256 = "d1c4e63ae2c1cd8de479d4bbc57219d2b85e904c26a491441265f5182220125f"
 }

package/ios/Source/MentraBluetoothSDK.swift

@@ -328,6 +328,7 @@ public final class MentraBluetoothSDK {
                 }
             }
         }
+        DeviceManager.shared.sgc?.replayStreamControlReady()
         storeListenerId = DeviceStore.shared.store.addListener { [weak self] category, changes in
             Task { @MainActor [weak self] in
                 self?.dispatchStoreUpdate(category, changes)

package/ios/Source/sgcs/MentraLive.swift

@@ -1056,6 +1056,7 @@ extension MentraLive: CBCentralManagerDelegate {
             self.fullyBooted = false
             self.connected = false
             self.glassesSessionId = nil // Fresh BLE session starts with no sid known
+            self.streamControlVersion = 0
             self.readinessCompletedThisBleSession = false
             self.updateConnectionState(ConnTypes.DISCONNECTED)
             self.rgbLedAuthorityClaimed = false
@@ -1702,6 +1703,9 @@ class MentraLive: NSObject, SGCManager {
     /// cannot signal a restart - a CHANGED (or newly appearing) sid is the restart signal.
     /// Nil = no sid observed this BLE session (legacy glasses, or none seen yet).
     private var glassesSessionId: String?
+    /// Last `glasses_ready.streamControlVersion`. Survives SDK remounts so a new
+    /// MentraBluetoothSDK can seed StreamSessionState without another ready.
+    private var streamControlVersion = 0
     // True once a glasses_ready completed on THIS physical BLE session. Unlike
     // fullyBooted, this never flaps on sr_hrt ready=0 heartbeats — it only resets with
     // the physical connection — so a first-seen sid after an upgrade OTA cannot be
@@ -1845,6 +1849,7 @@ class MentraLive: NSObject, SGCManager {
         connected = false
         fullyBooted = false
         glassesSessionId = nil
+        streamControlVersion = 0
         readinessCompletedThisBleSession = false
         rgbLedAuthorityClaimed = false
         stopAllTimers()
@@ -2152,6 +2157,15 @@ class MentraLive: NSObject, SGCManager {
         )
     }
 
+    func replayStreamControlReady() {
+        guard let sid = glassesSessionId, streamControlVersion == 1 else { return }
+        Bridge.log("LIVE: Replaying stream_control_ready sid=\(sid) version=\(streamControlVersion)")
+        Bridge.sendTypedMessage("stream_control_ready", body: [
+            "sid": sid,
+            "streamControlVersion": streamControlVersion,
+        ])
+    }
+
     func startStream(_ message: [String: Any]) {
         Bridge.log("Starting stream")
         var json = message
@@ -2522,6 +2536,7 @@ class MentraLive: NSObject, SGCManager {
             connected = false
             fullyBooted = false
             glassesSessionId = nil
+            streamControlVersion = 0
             readinessCompletedThisBleSession = false
             readinessCompletedThisBleSession = false // Fresh BLE session starts with no sid known
             readinessCompletedThisBleSession = false
@@ -2801,6 +2816,7 @@ class MentraLive: NSObject, SGCManager {
             // already runs this full remote-reset flow, so recording (not re-triggering)
             // is correct here; version_info detection covers the restart case.
             glassesSessionId = (json["sid"] as? String).flatMap { $0.isEmpty ? nil : $0 }
+            streamControlVersion = json["streamControlVersion"] as? Int ?? 0
             Bridge.sendTypedMessage(
                 "wifi_protocol_session_ready",
                 body: ["sid": glassesSessionId ?? ""]
@@ -2808,7 +2824,7 @@ class MentraLive: NSObject, SGCManager {
             readinessCompletedThisBleSession = true
             Bridge.sendTypedMessage("stream_control_ready", body: [
                 "sid": json["sid"] as? String ?? "",
-                "streamControlVersion": json["streamControlVersion"] as? Int ?? 0,
+                "streamControlVersion": streamControlVersion,
             ])
             handleGlassesReady()
 
@@ -5653,6 +5669,7 @@ class MentraLive: NSObject, SGCManager {
         fullyBooted = false
         connected = false
         glassesSessionId = nil
+        streamControlVersion = 0
 
         Bridge.log("LIVE: 🔄 Starting glasses SOC readiness check loop")
 

package/ios/Source/sgcs/SGCManager.swift

@@ -66,6 +66,8 @@ protocol SGCManager {
     func requestPhoto(_ request: PhotoRequest)
     func startStream(_ message: [String: Any])
     func stopStream()
+    /// Re-advertise glasses-owned stream control after the phone SDK remounts.
+    func replayStreamControlReady()
     func sendStreamKeepAlive(_ message: [String: Any])
     func startVideoRecording(requestId: String, save: Bool, sound: Bool)
     func queryVideoRecordingStatus(requestId: String)
@@ -238,6 +240,8 @@ extension SGCManager {
         false
     }
 
+    func replayStreamControlReady() {}
+
     @discardableResult func requestSavedWifiNetworks(requestId _: String, sid _: String) -> Bool {
         false
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.2.0-dev.261",
+  "version": "3.2.0-dev.262",
   "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.0-dev.261"
+    "@mentra/cloud-protocol": "3.2.0-dev.262"
   },
   "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.0",
-  "releaseIdentity": "3.2.0-dev.261",
-  "releaseSetId": "mentra-3.2.0-dev.261",
-  "sourceCommit": "ebd405ff0f311035faccac6e19b0a5a38b3a1483",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.261.json",
-  "otaManifestSha256": "e9d88a258f276ee9ddc5396e9c5745f91f924449b802248e6d37dfe9bb8bb3ee"
+  "releaseIdentity": "3.2.0-dev.262",
+  "releaseSetId": "mentra-3.2.0-dev.262",
+  "sourceCommit": "545ed70c7afa46ca09b895d2dcd651b45510dbb5",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.262.json",
+  "otaManifestSha256": "d1c4e63ae2c1cd8de479d4bbc57219d2b85e904c26a491441265f5182220125f"
 })