@mentra/bluetooth-sdk 3.3.0-dev.788 → 3.3.0-dev.791

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.3.0"
-    const val RELEASE_IDENTITY: String = "3.3.0-dev.788"
-    const val RELEASE_SET_ID: String = "mentra-3.3.0-dev.788"
-    const val SOURCE_COMMIT: String = "557a9faa3f9c43bee85ab7cc3509e4770a000c22"
-    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.788.json"
-    const val OTA_MANIFEST_SHA256: String = "a7fe57f5a3cb130c5615133b733fd46b880e6367ce07a283750cc7bf83d2415a"
+    const val RELEASE_IDENTITY: String = "3.3.0-dev.791"
+    const val RELEASE_SET_ID: String = "mentra-3.3.0-dev.791"
+    const val SOURCE_COMMIT: String = "97e2f51340fbd1ff1b1d0e5711910fcc306a4459"
+    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.791.json"
+    const val OTA_MANIFEST_SHA256: String = "716e6e1fa00d8a3ec71e09d2e69e7e6920555ef4f0cb9ee8d21befb734819b50"
 }

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.3.0",
-    "releaseIdentity": "3.3.0-dev.788",
-    "releaseSetId": "mentra-3.3.0-dev.788",
-    "sourceCommit": "557a9faa3f9c43bee85ab7cc3509e4770a000c22",
-    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.788.json",
-    "otaManifestSha256": "a7fe57f5a3cb130c5615133b733fd46b880e6367ce07a283750cc7bf83d2415a"
+    "releaseIdentity": "3.3.0-dev.791",
+    "releaseSetId": "mentra-3.3.0-dev.791",
+    "sourceCommit": "97e2f51340fbd1ff1b1d0e5711910fcc306a4459",
+    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.791.json",
+    "otaManifestSha256": "716e6e1fa00d8a3ec71e09d2e69e7e6920555ef4f0cb9ee8d21befb734819b50"
 });
 //# 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,iIAAiI;IACnJ,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.3.0\",\n  \"releaseIdentity\": \"3.3.0-dev.788\",\n  \"releaseSetId\": \"mentra-3.3.0-dev.788\",\n  \"sourceCommit\": \"557a9faa3f9c43bee85ab7cc3509e4770a000c22\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.788.json\",\n  \"otaManifestSha256\": \"a7fe57f5a3cb130c5615133b733fd46b880e6367ce07a283750cc7bf83d2415a\"\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,iIAAiI;IACnJ,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.3.0\",\n  \"releaseIdentity\": \"3.3.0-dev.791\",\n  \"releaseSetId\": \"mentra-3.3.0-dev.791\",\n  \"sourceCommit\": \"97e2f51340fbd1ff1b1d0e5711910fcc306a4459\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.791.json\",\n  \"otaManifestSha256\": \"716e6e1fa00d8a3ec71e09d2e69e7e6920555ef4f0cb9ee8d21befb734819b50\"\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.3.0-dev.788"
+    private static let swiftPackageSdkVersion = "3.3.0-dev.791"
     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.3.0"
-    static let releaseIdentity = "3.3.0-dev.788"
-    static let releaseSetId = "mentra-3.3.0-dev.788"
-    static let sourceCommit = "557a9faa3f9c43bee85ab7cc3509e4770a000c22"
-    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.788.json"
-    static let otaManifestSha256 = "a7fe57f5a3cb130c5615133b733fd46b880e6367ce07a283750cc7bf83d2415a"
+    static let releaseIdentity = "3.3.0-dev.791"
+    static let releaseSetId = "mentra-3.3.0-dev.791"
+    static let sourceCommit = "97e2f51340fbd1ff1b1d0e5711910fcc306a4459"
+    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.791.json"
+    static let otaManifestSha256 = "716e6e1fa00d8a3ec71e09d2e69e7e6920555ef4f0cb9ee8d21befb734819b50"
 }

package/ios/Source/sgcs/MentraLive.swift

@@ -923,7 +923,7 @@ extension MentraLive: CBCentralManagerDelegate {
             self.isConnecting = false
 
             self.connectedPeripheral = nil
-            self.fullyBooted = false
+            self.clearPhysicalReadiness()
             self.connected = false
             self.glassesSessionId = nil // Fresh BLE session starts with no sid known
             self.streamControlVersion = 0
@@ -1617,6 +1617,16 @@ class MentraLive: NSObject, SGCManager {
         set { DeviceStore.shared.apply("glasses", "connected", newValue) }
     }
 
+    private func clearPhysicalReadiness() {
+        let readinessWasPending = connected && !fullyBooted
+        fullyBooted = false
+        if readinessWasPending {
+            // Logical ASG readiness already emitted false without disconnecting.
+            // The real disconnect must still perform the cleanup apply deduplicates.
+            DeviceManager.shared.handleDeviceDisconnected()
+        }
+    }
+
     // Queue Management
     private let commandQueue = CommandQueue()
     private let bluetoothQueue = DispatchQueue(label: "MentraLiveBluetooth", qos: .userInitiated)
@@ -1744,8 +1754,8 @@ class MentraLive: NSObject, SGCManager {
         // Publish disconnect immediately for Phone A UI. didDisconnectPeripheral may lag
         // or race with cancelPeripheralConnection; do not wait on it for stand-down.
         isConnecting = false
+        clearPhysicalReadiness()
         connected = false
-        fullyBooted = false
         glassesSessionId = nil
         streamControlVersion = 0
         readinessCompletedThisBleSession = false
@@ -2523,8 +2533,8 @@ class MentraLive: NSObject, SGCManager {
             Bridge.log("LIVE: Maximum reconnection attempts reached (\(MAX_RECONNECT_ATTEMPTS))")
             reconnectAttempts = 0
             updateConnectionState(ConnTypes.DISCONNECTED)
+            clearPhysicalReadiness()
             connected = false
-            fullyBooted = false
             glassesSessionId = nil
             streamControlVersion = 0
             readinessCompletedThisBleSession = false
@@ -3138,6 +3148,11 @@ class MentraLive: NSObject, SGCManager {
             if type.hasPrefix("version_info") {
                 Bridge.log("LIVE: Received \(type)")
 
+                // A new process can report its build before glasses_ready resets the
+                // wire epoch. Publish its pending readiness before those version fields
+                // can complete OTA and trigger the next request.
+                handleGlassesSessionId(json)
+
                 // Extract all fields from JSON (except "type")
                 var fields: [String: Any] = [:]
                 fields["version_info_type"] = type
@@ -3210,7 +3225,6 @@ class MentraLive: NSObject, SGCManager {
                 // running them per chunk is safe.
                 parsePeerWireCaps(json)
                 maybeSendWireHandshake()
-                handleGlassesSessionId(json)
 
                 Bridge.sendVersionInfo(fields, responseChunk: type)
             } else {
@@ -5737,7 +5751,7 @@ class MentraLive: NSObject, SGCManager {
         stopReadinessCheckLoop()
 
         readinessCheckCounter = 0
-        fullyBooted = false
+        clearPhysicalReadiness()
         connected = false
         glassesSessionId = nil
         streamControlVersion = 0
@@ -6018,8 +6032,8 @@ class MentraLive: NSObject, SGCManager {
             centralManager?.cancelPeripheralConnection(peripheral)
         }
 
+        clearPhysicalReadiness()
         DeviceStore.shared.apply("glasses", "connected", false)
-        DeviceStore.shared.apply("glasses", "fullyBooted", false)
         DeviceStore.shared.apply("glasses", "wifiConnected", false)
         DeviceStore.shared.apply("glasses", "wifiSsid", "")
         DeviceStore.shared.apply("glasses", "wifiLocalIp", "")
@@ -6156,8 +6170,8 @@ extension MentraLive {
     /// pre-sid build) or differing from the recorded one = restart; same sid = no action.
     /// A restart is a LOGICAL session reset: send phone_ready immediately (bypassing the
     /// sr_hrt heartbeat's stale-readiness suppression); the returning glasses_ready runs
-    /// the full existing remote-wire-reset flow. fullyBooted is deliberately untouched -
-    /// the physical link never dropped, so the connection UI must not flap.
+    /// the full existing remote-wire-reset flow. Keep the physical connection intact,
+    /// but mark readiness pending until that new wire epoch has been established.
     private func handleGlassesSessionId(_ json: [String: Any]) {
         guard let sid = json["sid"] as? String, !sid.isEmpty else { return }
         let previous = glassesSessionId
@@ -6172,6 +6186,9 @@ extension MentraLive {
             "LIVE: 🔁 Glasses session changed (\(previous ?? "<pre-sid build>") -> \(sid)) - " +
                 "asg restarted under a live link, re-running readiness"
         )
+        // Emit the existing connected-but-not-ready status without invoking the
+        // physical-disconnect side effects of DeviceStore.apply(fullyBooted: false).
+        DeviceStore.shared.set("glasses", "fullyBooted", false)
         sendPhoneReady(reason: "glasses session changed")
         Bridge.sendTypedMessage(
             "glasses_session_changed",

package/ios/Tests/MentraLiveSessionReadinessTests.swift

@@ -0,0 +1,163 @@
+@testable import MentraBluetoothSDK
+import XCTest
+
+@MainActor
+private final class SessionReadinessTransport: MentraLive {
+    var commands: [[String: Any]] = []
+
+    override func sendJson(_ jsonOriginal: [String: Any], wakeUp: Bool, requireAck: Bool) {
+        commands.append(jsonOriginal)
+    }
+}
+
+@MainActor
+final class MentraLiveSessionReadinessTests: XCTestCase {
+    func testChangedSessionPublishesPendingReadinessBeforeItsBuildAndRecoversAtGlassesReady() throws {
+        let store = DeviceStore.shared.store
+        let saved = ["bluetooth", "glasses"].map { ($0, store.getCategory($0)) }
+        let previous = DeviceManager.shared.sgc
+        let transport = SessionReadinessTransport()
+        let sdk = MentraBluetoothSDK()
+        DeviceManager.shared.sgc = transport
+        var observations: [(key: String, ready: Bool, connected: Bool)] = []
+        let listener = store.addListener { category, changed in
+            guard category == "glasses" else { return }
+            for key in changed.keys where key == "fullyBooted" || key == "buildNumber" {
+                observations.append((key, sdk.glassesStatus.fullyBooted, sdk.glassesStatus.connected))
+            }
+        }
+        var sessionEvents: [Bool] = []
+        let sink = Bridge.addEventSink { event, body in
+            if event == "glasses_session_changed" {
+                sessionEvents.append(sdk.glassesStatus.fullyBooted)
+            }
+        }
+        defer {
+            store.removeListener(listener)
+            Bridge.removeEventSink(sink)
+            sdk.invalidate()
+            transport.cleanup()
+            DeviceManager.shared.sgc = previous
+            for (category, values) in saved {
+                for key in store.getCategory(category).keys where values[key] == nil {
+                    store.remove(category, key)
+                }
+                for (key, value) in values { store.set(category, key, value) }
+            }
+        }
+
+        func receive(_ value: [String: Any]) throws {
+            try transport.processReceivedData(JSONSerialization.data(withJSONObject: value))
+        }
+        try receive(["type": "glasses_ready", "sid": "original"])
+        observations.removeAll()
+        transport.commands.removeAll()
+
+        // The physical BLE link remains live across APK replacement. Its first
+        // version chunk can prove the target build before remote wire readiness.
+        try receive(["type": "version_info_1", "sid": "replacement", "build_number": "302010070"])
+        XCTAssertEqual(observations.map(\.key), ["fullyBooted", "buildNumber"])
+        XCTAssertTrue(observations.allSatisfy { !$0.ready && $0.connected })
+        XCTAssertEqual(sessionEvents, [false])
+        XCTAssertEqual(transport.commands.compactMap { $0["type"] as? String }, ["phone_ready"])
+
+        // Another chunk from the same pending process must not restart readiness.
+        try receive(["type": "version_info_3", "sid": "replacement"])
+        XCTAssertEqual(sessionEvents, [false])
+        XCTAssertFalse(sdk.glassesStatus.fullyBooted)
+
+        try receive(["type": "glasses_ready", "sid": "replacement"])
+        XCTAssertTrue(sdk.glassesStatus.connected)
+        XCTAssertTrue(sdk.glassesStatus.fullyBooted)
+        XCTAssertEqual(observations.last?.key, "fullyBooted")
+        XCTAssertEqual(observations.last?.ready, true)
+        XCTAssertEqual(transport.commands.filter { $0["type"] as? String == "request_version" }.count, 1)
+
+        observations.removeAll()
+        try receive(["type": "version_info_1", "sid": "replacement", "build_number": "302010070"])
+        XCTAssertTrue(sdk.glassesStatus.fullyBooted)
+        XCTAssertFalse(observations.contains { $0.key == "fullyBooted" })
+        XCTAssertEqual(sessionEvents, [false])
+
+        // A physical teardown before the next logical restart becomes ready must
+        // still run disconnect cleanup, even though readiness is already false.
+        try receive(["type": "version_info_1", "sid": "third", "build_number": "303000267"])
+        store.set("glasses", "headUp", true)
+        store.set("glasses", "voiceActivityDetectionEnabled", !BluetoothSdkDefaults.voiceActivityDetectionEnabled)
+        XCTAssertFalse(sdk.glassesStatus.fullyBooted)
+        XCTAssertTrue(sdk.glassesStatus.connected)
+        transport.cleanup()
+        XCTAssertFalse(sdk.glassesStatus.connected)
+        XCTAssertEqual(store.get("glasses", "headUp") as? Bool, false)
+        XCTAssertEqual(store.get("glasses", "voiceActivityDetectionEnabled") as? Bool,
+                       BluetoothSdkDefaults.voiceActivityDetectionEnabled)
+    }
+
+    func testPairingYieldDuringPendingReadinessCleansUpAndReclaimsAfterItsWindow() async throws {
+        let store = DeviceStore.shared.store
+        let saved = ["bluetooth", "glasses"].map { ($0, store.getCategory($0)) }
+        let previous = DeviceManager.shared.sgc
+        let transport = SessionReadinessTransport()
+        let sdk = MentraBluetoothSDK()
+        DeviceManager.shared.sgc = transport
+        defer {
+            sdk.invalidate()
+            transport.cleanup()
+            DeviceManager.shared.sgc = previous
+            for (category, values) in saved {
+                for key in store.getCategory(category).keys where values[key] == nil {
+                    store.remove(category, key)
+                }
+                for (key, value) in values { store.set(category, key, value) }
+            }
+        }
+
+        func receive(_ value: [String: Any]) throws {
+            try transport.processReceivedData(JSONSerialization.data(withJSONObject: value))
+        }
+        try receive(["type": "glasses_ready", "sid": "original"])
+        try receive(["type": "version_info_1", "sid": "replacement", "build_number": "302010070"])
+        XCTAssertTrue(sdk.glassesStatus.connected)
+        XCTAssertFalse(sdk.glassesStatus.fullyBooted)
+        store.set("glasses", "headUp", true)
+        store.set("glasses", "voiceActivityDetectionEnabled", !BluetoothSdkDefaults.voiceActivityDetectionEnabled)
+
+        try receive(["type": "entering_pairing_mode", "window_ms": 5000])
+        XCTAssertTrue(transport.isPairingYieldActive())
+        XCTAssertFalse(sdk.glassesStatus.connected)
+        XCTAssertFalse(sdk.glassesStatus.fullyBooted)
+        XCTAssertEqual(store.get("glasses", "headUp") as? Bool, false)
+        XCTAssertEqual(store.get("glasses", "voiceActivityDetectionEnabled") as? Bool,
+                       BluetoothSdkDefaults.voiceActivityDetectionEnabled)
+
+        // Readiness queued on the relinquished GATT must not close the yield.
+        try receive(["type": "glasses_ready", "sid": "replacement"])
+        XCTAssertTrue(transport.isPairingYieldActive())
+        XCTAssertFalse(sdk.glassesStatus.fullyBooted)
+
+        // Let the existing minimum yield expire, then accept a fresh readiness.
+        try await Task.sleep(nanoseconds: 5_100_000_000)
+        XCTAssertFalse(transport.isPairingYieldActive())
+        try receive(["type": "glasses_ready", "sid": "reclaimed"])
+        XCTAssertTrue(sdk.glassesStatus.connected)
+        XCTAssertTrue(sdk.glassesStatus.fullyBooted)
+    }
+
+    func testInitialVersionChunkDoesNotStartAnExtraReadinessExchange() throws {
+        let store = DeviceStore.shared.store
+        let saved = store.getCategory("glasses")
+        let transport = SessionReadinessTransport()
+        defer {
+            transport.cleanup()
+            for key in store.getCategory("glasses").keys where saved[key] == nil { store.remove("glasses", key) }
+            for (key, value) in saved { store.set("glasses", key, value) }
+        }
+        store.set("glasses", "fullyBooted", false)
+        try transport.processReceivedData(JSONSerialization.data(withJSONObject: [
+            "type": "version_info_1", "sid": "initial", "build_number": "303000267",
+        ]))
+        XCTAssertTrue(transport.commands.isEmpty)
+        XCTAssertEqual(store.get("glasses", "buildNumber") as? String, "303000267")
+        XCTAssertEqual(store.get("glasses", "fullyBooted") as? Bool, false)
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.3.0-dev.788",
+  "version": "3.3.0-dev.791",
   "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.3.0-dev.788"
+    "@mentra/cloud-protocol": "3.3.0-dev.791"
   },
   "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.3.0",
-  "releaseIdentity": "3.3.0-dev.788",
-  "releaseSetId": "mentra-3.3.0-dev.788",
-  "sourceCommit": "557a9faa3f9c43bee85ab7cc3509e4770a000c22",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.788.json",
-  "otaManifestSha256": "a7fe57f5a3cb130c5615133b733fd46b880e6367ce07a283750cc7bf83d2415a"
+  "releaseIdentity": "3.3.0-dev.791",
+  "releaseSetId": "mentra-3.3.0-dev.791",
+  "sourceCommit": "97e2f51340fbd1ff1b1d0e5711910fcc306a4459",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.791.json",
+  "otaManifestSha256": "716e6e1fa00d8a3ec71e09d2e69e7e6920555ef4f0cb9ee8d21befb734819b50"
 })