@mentra/bluetooth-sdk 0.1.21-beta.5 → 3.1.0-dev.7

package/ios/MentraPhotoReceiverModule.swift

@@ -32,7 +32,7 @@ public class MentraPhotoReceiverModule: Module {
     receiverLock.lock()
     defer { receiverLock.unlock() }
 
-    guard let host = bestLocalIPv4Address() else {
+    guard let host = LocalIPv4.bestLocalIPv4Address() else {
       throw PhotoReceiverError("No Wi-Fi/LAN IPv4 address found for this phone.")
     }
 
@@ -104,66 +104,6 @@ public class MentraPhotoReceiverModule: Module {
     ])
   }
 
-  private func bestLocalIPv4Address() -> String? {
-    var interfaces: UnsafeMutablePointer<ifaddrs>?
-    guard getifaddrs(&interfaces) == 0, let first = interfaces else {
-      return nil
-    }
-    defer { freeifaddrs(interfaces) }
-
-    var preferredPrivate: String?
-    var preferred: String?
-    var privateFallback: String?
-    var fallback: String?
-    var cursor: UnsafeMutablePointer<ifaddrs>? = first
-    while let current = cursor {
-      defer { cursor = current.pointee.ifa_next }
-      let interface = current.pointee
-      guard let addressPointer = interface.ifa_addr,
-            addressPointer.pointee.sa_family == UInt8(AF_INET) else {
-        continue
-      }
-
-      let name = String(cString: interface.ifa_name)
-      let flags = interface.ifa_flags
-      guard (flags & UInt32(IFF_UP)) != 0,
-            (flags & UInt32(IFF_LOOPBACK)) == 0 else {
-        continue
-      }
-
-      var address = addressPointer.pointee
-      var hostname = [CChar](repeating: 0, count: Int(NI_MAXHOST))
-      let result = getnameinfo(
-        &address,
-        socklen_t(address.sa_len),
-        &hostname,
-        socklen_t(hostname.count),
-        nil,
-        0,
-        NI_NUMERICHOST
-      )
-      guard result == 0 else {
-        continue
-      }
-
-      let ip = String(cString: hostname)
-      guard ip != "127.0.0.1", !isLinkLocalIPv4(ip) else {
-        continue
-      }
-      if isPreferredLocalInterface(name), isPrivateIPv4(ip) {
-        preferredPrivate = preferredPrivate ?? ip
-      } else if isPreferredLocalInterface(name) {
-        preferred = preferred ?? ip
-      } else if isPrivateIPv4(ip) {
-        privateFallback = privateFallback ?? ip
-      } else {
-        fallback = fallback ?? ip
-      }
-    }
-
-    return preferredPrivate ?? preferred ?? privateFallback ?? fallback
-  }
-
   private func receiverResult(uploadUrl: String, host: String, port: UInt16) -> [String: Any] {
     [
       "uploadUrl": uploadUrl,
@@ -172,26 +112,6 @@ public class MentraPhotoReceiverModule: Module {
     ]
   }
 
-  private func isPreferredLocalInterface(_ name: String) -> Bool {
-    name == "en0" ||
-      name.hasPrefix("bridge") ||
-      name.hasPrefix("ap") ||
-      name.hasPrefix("awdl") ||
-      name.hasPrefix("llw")
-  }
-
-  private func isPrivateIPv4(_ ip: String) -> Bool {
-    if ip.hasPrefix("192.168.") || ip.hasPrefix("10.") {
-      return true
-    }
-    let parts = ip.split(separator: ".").compactMap { Int($0) }
-    return parts.count == 4 && parts[0] == 172 && (16...31).contains(parts[1])
-  }
-
-  private func isLinkLocalIPv4(_ ip: String) -> Bool {
-    ip.hasPrefix("169.254.")
-  }
-
   private let photoPorts = [8787, 8788, 8789, 8790]
 }
 

package/ios/Source/BluetoothSdkDefaults.swift

@@ -3,12 +3,15 @@ import Foundation
 /// Defaults for the public Bluetooth SDK surface.
 enum BluetoothSdkDefaults {
     static var sdkVersion: String? {
+        // Release exports replace the source placeholder; Expo builds stamp the host Info.plist.
         normalizedSdkVersion(swiftPackageSdkVersion)
+            ?? normalizedSdkVersion(Bundle.main.object(forInfoDictionaryKey: infoSdkVersionKey) as? String)
     }
 
     static let voiceActivityDetectionEnabled = false
     static let loudnessGateEnabled = true
-    private static let swiftPackageSdkVersion = "0.1.21-beta.5"
+    private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
+    private static let swiftPackageSdkVersion = "3.1.0-dev.7"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/Bridge.swift

@@ -98,6 +98,27 @@ class Bridge {
         Bridge.sendTypedMessage("pair_failure", body: data)
     }
 
+    static func sendPairingInfo(
+        hadPreviousBond: Bool,
+        transferId: String? = nil,
+        pairingCode: String? = nil,
+        classicBondReady: Bool = false,
+        securePairingCapable: Bool = true,
+        protocolVersion: Int = 1,
+        binding: String? = nil
+    ) {
+        var body: [String: Any] = [
+            "had_previous_bond": hadPreviousBond,
+            "classic_bond_ready": classicBondReady,
+            "secure_pairing_capable": securePairingCapable,
+            "protocol_version": protocolVersion,
+        ]
+        if let transferId { body["transfer_id"] = transferId }
+        if let pairingCode { body["pairing_code"] = pairingCode }
+        if let binding { body["binding"] = binding }
+        Bridge.sendTypedMessage("pairing_info", body: body)
+    }
+
     @MainActor
     static func sendMicPcm(_ data: Data) {
         Bridge.sendTypedMessage("mic_pcm", body: micPcmEventBody(data))
@@ -108,6 +129,14 @@ class Bridge {
         Bridge.sendTypedMessage("mic_lc3", body: micLc3EventBody(data))
     }
 
+    @MainActor
+    static func sendMicHealth(_ health: MicHealth, reason: String) {
+        var body = health.dictionary
+        body["reason"] = reason
+        body["timestamp"] = Int64(Date().timeIntervalSince1970 * 1000)
+        Bridge.sendTypedMessage("mic_health", body: body)
+    }
+
     @MainActor
     private static func micPcmEventBody(_ data: Data) -> [String: Any] {
         let voiceActivityDetectionEnabled =
@@ -178,7 +207,10 @@ class Bridge {
         _ deviceName: String,
         deviceAddress: String = "",
         rssi: Int? = nil,
-        projectName: String? = nil
+        projectName: String? = nil,
+        pairingMode: Bool? = nil,
+        pairingCode: String? = nil,
+        securePairingCapable: Bool? = nil
     ) {
         Task {
             await MainActor.run {
@@ -200,6 +232,15 @@ class Bridge {
                 if let rssi {
                     newResult["rssi"] = rssi
                 }
+                if let pairingMode {
+                    newResult["pairingMode"] = pairingMode
+                }
+                if let pairingCode, !pairingCode.isEmpty {
+                    newResult["pairingCode"] = pairingCode
+                }
+                if let securePairingCapable {
+                    newResult["securePairingCapable"] = securePairingCapable
+                }
                 // Keep the public searchResults array stable as glasses are added or removed.
                 // Duplicate discoveries refresh their existing row; only new glasses append.
                 let uniqueResults = mergeStableSearchResults(
@@ -340,6 +381,11 @@ class Bridge {
         if let systemTimeMs = intValue(values["systemTimeMs"]) ?? intValue(values["system_time_ms"]) {
             body["systemTimeMs"] = systemTimeMs
         }
+        if let hotspotOtaVersion = intValue(values["hotspotOtaVersion"])
+            ?? intValue(values["hotspot_ota_version"])
+        {
+            body["hotspotOtaVersion"] = hotspotOtaVersion
+        }
         Bridge.sendTypedMessage("version_info", body: body)
     }
 
@@ -617,5 +663,3 @@ class Bridge {
 
 
 
-
-

package/ios/Source/DeviceManager.swift

@@ -123,6 +123,16 @@ struct ViewState {
         set { DeviceStore.shared.apply("bluetooth", "pending_wearable", newValue) }
     }
 
+    private var pendingDeviceName: String {
+        get { DeviceStore.shared.get("bluetooth", "pending_device_name") as? String ?? "" }
+        set { DeviceStore.shared.apply("bluetooth", "pending_device_name", newValue) }
+    }
+
+    private var pendingDeviceAddress: String {
+        get { DeviceStore.shared.get("bluetooth", "pending_device_address") as? String ?? "" }
+        set { DeviceStore.shared.apply("bluetooth", "pending_device_address", newValue) }
+    }
+
     private var deviceName: String {
         get { DeviceStore.shared.get("bluetooth", "device_name") as? String ?? "" }
         set { DeviceStore.shared.apply("bluetooth", "device_name", newValue) }
@@ -241,6 +251,8 @@ struct ViewState {
     }
 
     private var lastSystemTimeSyncConnectionKey = ""
+    private var pendingSystemTimeSync: DispatchWorkItem?
+    private var systemTimeSyncGeneration = 0
 
     private var systemMicUnavailable: Bool {
         get { DeviceStore.shared.get("bluetooth", "systemMicUnavailable") as? Bool ?? false }
@@ -294,6 +306,11 @@ struct ViewState {
     /// Last time we received an LC3 frame from the glasses (used by the mic
     /// inactivity watchdog).
     private var lastLc3Event: Date?
+    private var sequenceGapEvents: Int64 = 0
+    private var decodeFailures: Int64 = 0
+    private var lastLc3ReceivedAt: Int64?
+    private var lastPcmProducedAt: Int64?
+    private var lastLc3Sequence: Int?
     private var micReinitTimer: Timer?
 
     /// STT:
@@ -396,29 +413,87 @@ struct ViewState {
      * Decodes the glasses LC3 to PCM, then forwards to handlePcm for processing.
      * This matches Android behavior - glasses forward raw LC3, DeviceManager handles encoding.
      */
-    func handleGlassesMicData(_ lc3Data: Data, _ frameSize: Int = 20) {
-        lastLc3Event = Date()
+    func handleGlassesMicData(_ lc3Data: Data, _ frameSize: Int = 20, sequenceNumber: Int? = nil) {
+        recordLc3Packet(sequenceNumber: sequenceNumber)
         guard let lc3Converter = lc3Converter else {
             Bridge.log("MAN: LC3 converter not initialized")
+            recordMicDecodeFailure()
             return
         }
 
         guard lc3Data.count > 2 else {
             Bridge.log("MAN: Received invalid LC3 data size: \(lc3Data.count)")
+            recordMicDecodeFailure()
             return
         }
 
         let pcmData = lc3Converter.decode(lc3Data, frameSize: frameSize) as Data
         guard pcmData.count > 0 else {
             Bridge.log("MAN: Failed to decode glasses LC3 audio")
+            recordMicDecodeFailure()
             return
         }
         // Forward to handlePcm which handles SDK audio events and encoding.
+        lastPcmProducedAt = nowMs()
         handlePcm(pcmData)
     }
 
     func reportGlassesAudioActivity() {
         lastLc3Event = Date()
+        lastPcmProducedAt = nowMs()
+    }
+
+    private func micHealth() -> MicHealth {
+        MicHealth(
+            sequenceGapEvents: sequenceGapEvents,
+            decodeFailures: decodeFailures,
+            lastLc3ReceivedAt: lastLc3ReceivedAt,
+            lastPcmProducedAt: lastPcmProducedAt
+        )
+    }
+
+    func resetMicSequenceBaseline() {
+        lastLc3Sequence = nil
+    }
+
+    private func nowMs() -> Int64 {
+        Int64(Date().timeIntervalSince1970 * 1000)
+    }
+
+    private func resetMicHealth() {
+        sequenceGapEvents = 0
+        decodeFailures = 0
+        lastLc3ReceivedAt = nil
+        lastPcmProducedAt = nil
+        lastLc3Sequence = nil
+        lastLc3Event = nil
+    }
+
+    private func recordLc3Packet(sequenceNumber: Int?) {
+        let receivedAt = nowMs()
+        lastLc3ReceivedAt = receivedAt
+        lastLc3Event = Date()
+        var hasGap = false
+        if let sequenceNumber {
+            let normalized = sequenceNumber & 0xFF
+            if let previous = lastLc3Sequence {
+                let expected = (previous + 1) & 0xFF
+                if normalized != expected {
+                    hasGap = true
+                    sequenceGapEvents += 1
+                    Bridge.log("MAN: LC3 packet sequence mismatch. Expected: \(expected), Got: \(normalized)")
+                }
+            }
+            lastLc3Sequence = normalized
+        }
+        if hasGap {
+            Bridge.sendMicHealth(micHealth(), reason: "sequence_gap")
+        }
+    }
+
+    private func recordMicDecodeFailure() {
+        decodeFailures += 1
+        Bridge.sendMicHealth(micHealth(), reason: "decode_failure")
     }
 
     func handlePcm(_ pcmData: Data) {
@@ -613,7 +688,7 @@ struct ViewState {
             Bridge.log("MAN: Manager already initialized, cleaning up previous sgc")
             sgc?.cleanup()
             sgc = nil
-            lastSystemTimeSyncConnectionKey = ""
+            resetSystemTimeSync()
         }
 
         if sgc != nil {
@@ -929,7 +1004,16 @@ struct ViewState {
             return
         }
         Bridge.log("MAN: handleDeviceReady(): \(sgc.type)")
+        resetMicHealth()
 
+        if !pendingDeviceName.isEmpty {
+            deviceName = pendingDeviceName
+        }
+        if !pendingDeviceAddress.isEmpty {
+            deviceAddress = pendingDeviceAddress
+        }
+        pendingDeviceName = ""
+        pendingDeviceAddress = ""
         pendingWearable = ""
         defaultWearable = sgc.type
         searching = false
@@ -994,9 +1078,30 @@ struct ViewState {
         }
 
         lastSystemTimeSyncConnectionKey = connectionKey
-        let timestampMs = Int64(Date().timeIntervalSince1970 * 1000)
-        Bridge.log("MAN: Syncing glasses system time once for connection: \(timestampMs)")
-        sgc.sendSetSystemTime(timestampMs)
+        pendingSystemTimeSync?.cancel()
+        systemTimeSyncGeneration += 1
+        let generation = systemTimeSyncGeneration
+        let sync = DispatchWorkItem { [weak self] in
+            guard let self,
+                  self.lastSystemTimeSyncConnectionKey == connectionKey,
+                  self.systemTimeSyncGeneration == generation
+            else {
+                return
+            }
+            self.pendingSystemTimeSync = nil
+            let timestampMs = Int64(Date().timeIntervalSince1970 * 1000)
+            Bridge.log("MAN: Syncing glasses system time once for connection: \(timestampMs)")
+            sgc.sendSetSystemTime(timestampMs)
+        }
+        pendingSystemTimeSync = sync
+        DispatchQueue.main.asyncAfter(deadline: .now() + 3, execute: sync)
+    }
+
+    private func resetSystemTimeSync() {
+        pendingSystemTimeSync?.cancel()
+        pendingSystemTimeSync = nil
+        systemTimeSyncGeneration += 1
+        lastSystemTimeSyncConnectionKey = ""
     }
 
     func handleControllerReady() {
@@ -1043,7 +1148,8 @@ struct ViewState {
 
     func handleDeviceDisconnected() {
         Bridge.log("MAN: Device disconnected")
-        lastSystemTimeSyncConnectionKey = ""
+        resetSystemTimeSync()
+        resetMicHealth()
         DeviceStore.shared.apply("glasses", "headUp", false)
         DeviceStore.shared.apply("glasses", "voiceActivityDetectionEnabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
         // shouldSendBootingMessage = true  // Reset for next first connect
@@ -1327,6 +1433,11 @@ struct ViewState {
         sgc?.sendHotspotState(enabled)
     }
 
+    func setWifiAdbState(_ enabled: Bool) {
+        Bridge.log("MAN: 🔧 Setting glasses Wi-Fi ADB state: \(enabled)")
+        sgc?.sendWifiAdbState(enabled)
+    }
+
     func setSystemTime(_ timestampMs: Int64) {
         Bridge.log("MAN: Setting glasses system time: \(timestampMs)")
         sgc?.sendSetSystemTime(timestampMs)
@@ -1506,6 +1617,11 @@ struct ViewState {
         )
     }
 
+    func queryVideoRecordingStatus(_ requestId: String) {
+        Bridge.log("MAN: Querying video recording status: requestId=\(requestId)")
+        sgc?.queryVideoRecordingStatus(requestId: requestId)
+    }
+
     func stopVideoRecording(_ requestId: String, _ webhookUrl: String?, _ authToken: String?) {
         Bridge.log(
             "MAN: onStopVideoRecording: requestId=\(requestId), webhook=\((webhookUrl?.isEmpty ?? true) ? "none" : "set")"
@@ -1626,6 +1742,10 @@ struct ViewState {
             return
         }
         initSGC(defaultWearable)
+        if let live = sgc as? MentraLive, live.isPairingYieldActive() {
+            Bridge.log("MAN: connectDefault skipped — Mentra Live pairing yield active")
+            return
+        }
         searching = true
         sgc?.connectById(reconnectTarget)
         connectDefaultController()
@@ -1675,10 +1795,10 @@ struct ViewState {
             disconnect()
             try? await Task.sleep(nanoseconds: 100 * 1_000_000) // 100ms
             self.searching = true
-            self.deviceName = name
+            self.pendingDeviceName = name
 
             initSGC(self.pendingWearable)
-            sgc?.connectById(self.deviceName)
+            sgc?.connectById(name)
         }
     }
 
@@ -1710,7 +1830,8 @@ struct ViewState {
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
-        lastSystemTimeSyncConnectionKey = ""
+        resetSystemTimeSync()
+        resetMicHealth()
         searching = false
         micEnabled = false
         updateMicState()
@@ -1721,6 +1842,7 @@ struct ViewState {
         // previously connected pair can never be reported for the next connection.
         DeviceStore.shared.apply("glasses", "serialNumber", "")
         DeviceStore.shared.apply("glasses", "bluetoothMacAddress", "")
+        DeviceStore.shared.apply("glasses", "wifiMacAddress", "")
         DeviceStore.shared.apply("glasses", "leftMacAddress", "")
         DeviceStore.shared.apply("glasses", "rightMacAddress", "")
         DeviceStore.shared.apply("glasses", "macAddress", "")
@@ -1752,6 +1874,9 @@ struct ViewState {
         defaultWearable = ""
         deviceName = ""
         deviceAddress = ""
+        pendingDeviceName = ""
+        pendingDeviceAddress = ""
+        pendingWearable = ""
         Bridge.saveSetting("default_wearable", "")
         Bridge.saveSetting("device_name", "")
         Bridge.saveSetting("device_address", "")

package/ios/Source/DeviceStore.swift

@@ -27,6 +27,7 @@ class DeviceStore {
         store.set("glasses", "connectionState", ConnTypes.DISCONNECTED)
         store.set("glasses", "deviceModel", "")
         store.set("glasses", "firmwareVersion", "")
+        store.set("glasses", "hotspotOtaVersion", 0)
         store.set("glasses", "micEnabled", false)
         store.set("glasses", "voiceActivityDetectionEnabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
         store.set("glasses", "bluetoothClassicConnected", false)
@@ -36,6 +37,7 @@ class DeviceStore {
         store.set("glasses", "caseBatteryLevel", -1)
         store.set("glasses", "headUp", false)
         store.set("glasses", "bluetoothMacAddress", "")
+        store.set("glasses", "wifiMacAddress", "")
         store.set("glasses", "leftMacAddress", "")
         store.set("glasses", "rightMacAddress", "")
         store.set("glasses", "serialNumber", "")

package/ios/Source/GeneratedReleaseMetadata.swift

@@ -0,0 +1,11 @@
+import Foundation
+
+/// Generated by release CI. Do not edit in a release checkout.
+enum GeneratedReleaseMetadata {
+    static let familyBaseVersion = "3.1.0"
+    static let releaseIdentity = "3.1.0-dev.7"
+    static let releaseSetId = "mentra-3.1.0-dev.7"
+    static let sourceCommit = "872697a6395c31d30ec75d64f039eaa763dcbb51"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.7/mentra-live-ota-3.1.0-dev.7.json"
+    static let otaManifestSha256 = "8fbea7589345658dc5dffcb394229ffc5c52fbe75352acb8f6827d83290ce750"
+}

package/ios/Source/MentraBluetoothSDK.swift

@@ -309,6 +309,8 @@ public final class MentraBluetoothSDK {
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "device_name", device.name)
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "device_address", device.identifier ?? "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "project_name", device.projectName ?? "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
         finishDefaultDeviceApply(generation: generation)
     }
 
@@ -320,6 +322,8 @@ public final class MentraBluetoothSDK {
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "device_name", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "device_address", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "project_name", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
         finishDefaultDeviceApply(generation: generation)
     }
 
@@ -394,6 +398,9 @@ public final class MentraBluetoothSDK {
         }
         if options.saveAsDefault && !isController {
             setDefaultDevice(device)
+        } else if !isController {
+            DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", device.name)
+            DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", device.identifier ?? "")
         }
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_wearable", device.model.deviceType)
         DeviceManager.shared.connectByName(device.name)
@@ -418,6 +425,8 @@ public final class MentraBluetoothSDK {
 
     public func cancelConnectionAttempt() {
         clearBluetoothRestoreIntent()
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
         DeviceManager.shared.disconnect()
     }
 
@@ -428,6 +437,8 @@ public final class MentraBluetoothSDK {
 
     public func disconnect() {
         clearBluetoothRestoreIntent()
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
         DeviceManager.shared.disconnect()
     }
 
@@ -890,6 +901,13 @@ public final class MentraBluetoothSDK {
         }
     }
 
+    /// Fire-and-forget Mentra Live Wi-Fi ADB toggle. Glasses do not ack this
+    /// command, so there is no pending-response wait (unlike hotspot / Wi-Fi forget).
+    public func setWifiAdbState(enabled: Bool) async throws {
+        try requireGlassesConnected(operation: "toggle Wi-Fi ADB")
+        DeviceManager.shared.setWifiAdbState(enabled)
+    }
+
     func setSystemTime(timestampMs: Int64) {
         DeviceManager.shared.setSystemTime(timestampMs)
     }
@@ -1141,6 +1159,36 @@ public final class MentraBluetoothSDK {
         }
     }
 
+    public func queryVideoRecordingStatus(requestId: String) async throws -> VideoRecordingStatusEvent {
+        guard !requestId.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {
+            throw BluetoothSdkError(
+                code: "missing_request_id",
+                message: "requestId is required to query video recording status."
+            )
+        }
+        try requireGlassesConnected(operation: "query video recording status")
+        let pending = PendingResponse<VideoRecordingStatusEvent>(operation: "query video recording status \(requestId)")
+        guard pendingVideoRecordingRequests[requestId] == nil else {
+            throw BluetoothSdkError(
+                code: "request_in_flight",
+                message: "A video recording command is already waiting for requestId \(requestId)."
+            )
+        }
+        pendingVideoRecordingRequests[requestId] = PendingVideoRecordingRequest(
+            expectedStatus: "recording_status",
+            pending: pending
+        )
+        DeviceManager.shared.queryVideoRecordingStatus(requestId)
+        do {
+            let event = try await pending.wait()
+            pendingVideoRecordingRequests.removeValue(forKey: requestId)
+            return event
+        } catch {
+            pendingVideoRecordingRequests.removeValue(forKey: requestId)
+            throw error
+        }
+    }
+
     public func requestVersionInfo() async throws -> VersionInfoResult {
         guard pendingVersionInfo == nil else {
             throw BluetoothSdkError(
@@ -1165,11 +1213,13 @@ public final class MentraBluetoothSDK {
         }
     }
 
-    func setOtaVersionUrl(_ otaVersionUrl: String) throws {
+    /// Select the HTTP(S) manifest used by subsequent OTA checks and installs.
+    public func setOtaVersionUrl(_ otaVersionUrl: String) throws {
         configuredOtaVersionUrl = try OtaManifestChecker.normalizeHttpUrl(otaVersionUrl)
     }
 
-    func getOtaVersionUrl() throws -> String {
+    /// Return the configured OTA manifest, or this SDK release's default manifest.
+    public func getOtaVersionUrl() throws -> String {
         try configuredOtaVersionUrl ?? OtaManifestDefaults.defaultOtaVersionUrl()
     }
 
@@ -2057,6 +2107,8 @@ private func dispatchDiscoveredDevices(_ rawSearchResults: Any?) {
             if !event.lc3.isEmpty {
                 delegate?.mentraBluetoothSDK(self, didReceiveMicLc3: event)
             }
+        case "mic_health":
+            delegate?.mentraBluetoothSDK(self, didReceive: .micHealth(MicHealthEvent(values: data)))
         case "local_transcription":
             let event = LocalTranscriptionEvent(
                 text: data["text"] as? String ?? "",
@@ -2105,6 +2157,10 @@ private func dispatchDiscoveredDevices(_ rawSearchResults: Any?) {
             let event = GalleryStatusEvent(values: data)
             pendingGalleryStatus?.resolve(event)
             delegate?.mentraBluetoothSDK(self, didReceive: .raw(name: "gallery_status", values: event.values))
+        case "pairing_info":
+            delegate?.mentraBluetoothSDK(self, didReceive: .raw(name: "pairing_info", values: data))
+        case "entering_pairing_mode", "owner_replaced":
+            delegate?.mentraBluetoothSDK(self, didReceive: .raw(name: eventName, values: data))
         case "photo_response":
             let event = PhotoResponseEvent(values: data)
             handlePhotoResponseForRequests(event)
@@ -2147,7 +2203,13 @@ private func dispatchDiscoveredDevices(_ rawSearchResults: Any?) {
             var resultValues = data
             resultValues["type"] = "ota_status"
             pendingOtaQuery?.resolve(OtaQueryResult(values: resultValues))
-            delegate?.mentraBluetoothSDK(self, didReceive: .otaStatus(OtaStatusEvent(values: resultValues)))
+            let event = OtaStatusEvent(values: resultValues)
+            if let errorCode = otaStartRejectionErrorCode(event) {
+                pendingOtaStart?.reject(
+                    BluetoothSdkError(code: errorCode, message: "Glasses rejected OTA start: \(errorCode)")
+                )
+            }
+            delegate?.mentraBluetoothSDK(self, didReceive: .otaStatus(event))
         case "settings_ack":
             let event = SettingsAckEvent(values: data)
             handleSettingsAckForRequests(event)
@@ -2172,6 +2234,12 @@ private func dispatchDiscoveredDevices(_ rawSearchResults: Any?) {
     }
 }
 
-
-
-
+/// OTA status messages are not request-correlated, so only known pre-ack failures settle a start.
+private func otaStartRejectionErrorCode(_ event: OtaStatusEvent) -> String? {
+    guard event.status.lowercased() == "failed",
+          event.errorMessage?.lowercased() == "battery_low"
+    else {
+        return nil
+    }
+    return "battery_low"
+}