@mentra/bluetooth-sdk 0.1.8 → 0.1.10

package/ios/Source/BluetoothSdkDefaults.swift

@@ -0,0 +1,6 @@
+import Foundation
+
+/// Defaults for the public Bluetooth SDK surface.
+enum BluetoothSdkDefaults {
+    static let voiceActivityDetectionEnabled = false
+}

package/ios/Source/Bridge.swift

@@ -10,7 +10,7 @@ import Foundation
 /// Bridge for Bluetooth SDK communication between Expo modules and native iOS code
 /// Has commands for the Bluetooth SDK to use to send messages to JavaScript
 class Bridge {
-    private static let micSampleRate = 16_000
+    private static let micSampleRate = 16000
     private static let pcmBitsPerSample = 16
     private static let micChannels = 1
     private static let lc3FrameDurationMs = 10
@@ -67,6 +67,16 @@ class Bridge {
         Bridge.sendTypedMessage("log", body: data)
     }
 
+    /// Report tar.bz2 extraction progress to JavaScript.
+    static func sendExtractionProgress(percentage: Int, bytesRead: Int64, totalBytes: Int64) {
+        let body: [String: Any] = [
+            "percentage": percentage,
+            "bytesRead": bytesRead,
+            "totalBytes": totalBytes,
+        ]
+        Bridge.sendTypedMessage("extraction_progress", body: body)
+    }
+
     static func sendHeadUp(_ isUp: Bool) {
         let data = ["up": isUp]
         Bridge.sendTypedMessage("head_up", body: data)
@@ -90,7 +100,8 @@ class Bridge {
     @MainActor
     private static func micPcmEventBody(_ data: Data) -> [String: Any] {
         let voiceActivityDetectionEnabled =
-            DeviceStore.shared.get("glasses", "voiceActivityDetectionEnabled") as? Bool ?? true
+            DeviceStore.shared.get("glasses", "voiceActivityDetectionEnabled") as? Bool
+                ?? BluetoothSdkDefaults.voiceActivityDetectionEnabled
         return [
             "pcm": data,
             "sampleRate": micSampleRate,
@@ -104,7 +115,8 @@ class Bridge {
     @MainActor
     private static func micLc3EventBody(_ data: Data) -> [String: Any] {
         let voiceActivityDetectionEnabled =
-            DeviceStore.shared.get("glasses", "voiceActivityDetectionEnabled") as? Bool ?? true
+            DeviceStore.shared.get("glasses", "voiceActivityDetectionEnabled") as? Bool
+                ?? BluetoothSdkDefaults.voiceActivityDetectionEnabled
         let frameSizeBytes = DeviceStore.shared.get("bluetooth", "lc3_frame_size") as? Int ?? defaultLc3FrameSizeBytes
         return [
             "lc3": data,
@@ -269,6 +281,35 @@ class Bridge {
         Bridge.sendTypedMessage("rgb_led_control_response", body: body)
     }
 
+    static func sendSettingsAck(_ values: [String: Any]) {
+        var body = values
+        body["type"] = "settings_ack"
+        Bridge.sendTypedMessage("settings_ack", body: body)
+    }
+
+    static func sendVideoRecordingStatus(_ values: [String: Any]) {
+        var body = values
+        body["type"] = "video_recording_status"
+        Bridge.sendTypedMessage("video_recording_status", body: body)
+    }
+
+    static func sendVersionInfo(_ values: [String: Any]) {
+        var body: [String: Any] = [
+            "type": "version_info",
+            "androidVersion": stringValue(values, "androidVersion", "android_version") ?? "",
+            "firmwareVersion": stringValue(values, "firmwareVersion", "firmware_version") ?? "",
+            "besFirmwareVersion": stringValue(values, "besFirmwareVersion", "bes_fw_version") ?? "",
+            "mtkFirmwareVersion": stringValue(values, "mtkFirmwareVersion", "mtk_fw_version") ?? "",
+            "buildNumber": stringValue(values, "buildNumber", "build_number") ?? "",
+            "otaVersionUrl": stringValue(values, "otaVersionUrl", "ota_version_url") ?? "",
+            "appVersion": stringValue(values, "appVersion", "app_version") ?? "",
+        ]
+        if let systemTimeMs = intValue(values["systemTimeMs"]) ?? intValue(values["system_time_ms"]) {
+            body["systemTimeMs"] = systemTimeMs
+        }
+        Bridge.sendTypedMessage("version_info", body: body)
+    }
+
     static func sendPhotoError(requestId: String, errorCode: String, errorMessage: String) {
         let timestamp = Int(Date().timeIntervalSince1970 * 1000)
         var event: [String: Any] = [
@@ -284,26 +325,16 @@ class Bridge {
             event["errorMessage"] = errorMessage
         }
         Bridge.sendTypedMessage("photo_response", body: event)
-
-        var status: [String: Any] = [
-            "type": "photo_status",
-            "status": "failed",
-            "requestId": requestId,
-            "timestamp": timestamp,
-        ]
-        if !errorCode.isEmpty {
-            status["errorCode"] = errorCode
-        }
-        if !errorMessage.isEmpty {
-            status["errorMessage"] = errorMessage
-        }
-        Bridge.sendTypedMessage("photo_status", body: status)
     }
 
     static func sendPhotoStatus(_ status: [String: Any]) {
         Bridge.sendTypedMessage("photo_status", body: status)
     }
 
+    static func sendPhotoResponse(_ response: [String: Any]) {
+        Bridge.sendTypedMessage("photo_response", body: response)
+    }
+
     static func sendMiniappSelected(packageName: String) {
         let event: [String: Any] = [
             "packageName": packageName,
@@ -349,7 +380,7 @@ class Bridge {
         Bridge.sendTypedMessage("wifi_status_change", body: status.values)
     }
 
-    static func updateWifiScanResults(_ networks: [[String: Any]]) {
+    static func updateWifiScanResults(_ networks: [[String: Any]], scanComplete: Bool) {
         Task {
             await MainActor.run {
                 var storedNetworks: [[String: Any]] =
@@ -363,6 +394,10 @@ class Bridge {
                     }
                 }
                 DeviceStore.shared.apply("bluetooth", "wifiScanResults", storedNetworks)
+                Bridge.sendTypedMessage(
+                    "wifi_scan_result",
+                    body: ["networks": storedNetworks, "scanComplete": scanComplete]
+                )
             }
         }
     }
@@ -408,7 +443,8 @@ class Bridge {
         stepPercent: Int,
         overallPercent: Int,
         status: String,
-        errorMessage: String?
+        errorMessage: String?,
+        glassesTimeMs: Int64? = nil
     ) {
         var eventBody: [String: Any] = [
             "session_id": sessionId,
@@ -423,6 +459,9 @@ class Bridge {
         if let error = errorMessage {
             eventBody["error_message"] = error
         }
+        if let glassesTimeMs, glassesTimeMs > 0 {
+            eventBody["glasses_time_ms"] = glassesTimeMs
+        }
         Bridge.sendTypedMessage("ota_status", body: eventBody)
     }
 

package/ios/Source/DeviceManager.swift

@@ -10,6 +10,9 @@ import Combine
 import CoreBluetooth
 import Foundation
 import UIKit
+#if SWIFT_PACKAGE
+import MentraBluetoothSDKCoreObjC
+#endif
 
 struct ViewState {
     var topText: String
@@ -19,6 +22,11 @@ struct ViewState {
     var text: String
     var data: String?
     var animationData: [String: Any]?
+    // Optional bitmap_view container position/size (used by G2; ignored by others)
+    var bmpX: Int32?
+    var bmpY: Int32?
+    var bmpWidth: Int32?
+    var bmpHeight: Int32?
 }
 
 @MainActor
@@ -167,6 +175,14 @@ struct ViewState {
         set { DeviceStore.shared.apply("bluetooth", "sensing_enabled", newValue) }
     }
 
+    /// Phone-side VAD gating switch. Default is OFF (VAD runs) so that the
+    /// coordinator can drive per-utterance offline/online STT switching from
+    /// `vad_status` events. Set to `true` only as an emergency kill-switch.
+    private var bypassVad: Bool {
+        get { DeviceStore.shared.get("bluetooth", "bypass_vad") as? Bool ?? false }
+        set { DeviceStore.shared.apply("bluetooth", "bypass_vad", newValue) }
+    }
+
     private var offlineCaptionsRunning: Bool {
         get { DeviceStore.shared.get("bluetooth", "offline_captions_running") as? Bool ?? false }
         set { DeviceStore.shared.apply("bluetooth", "offline_captions_running", newValue) }
@@ -225,6 +241,7 @@ struct ViewState {
         get { DeviceStore.shared.get("bluetooth", "shouldSendBootingMessage") as? Bool ?? true }
         set { DeviceStore.shared.apply("bluetooth", "shouldSendBootingMessage", newValue) }
     }
+    private var lastSystemTimeSyncConnectionKey = ""
 
     private var systemMicUnavailable: Bool {
         get { DeviceStore.shared.get("bluetooth", "systemMicUnavailable") as? Bool ?? false }
@@ -281,7 +298,9 @@ struct ViewState {
     private var micReinitTimer: Timer?
 
     /// STT:
+    #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
     private var transcriber: SherpaOnnxTranscriber?
+    #endif
 
     var viewStates: [ViewState] = [
         ViewState(
@@ -310,6 +329,7 @@ struct ViewState {
         // MemoryMonitor.start()
 
         // Initialize SherpaOnnx Transcriber
+        #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
         if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
            let window = windowScene.windows.first,
            let rootViewController = window.rootViewController
@@ -324,6 +344,7 @@ struct ViewState {
             transcriber.initialize()
             Bridge.log("SherpaOnnxTranscriber fully initialized")
         }
+        #endif
 
         // Initialize persistent LC3 converter for unified audio encoding
         lc3Converter = PcmConverter()
@@ -395,9 +416,11 @@ struct ViewState {
         handleSendingPcm(pcmData)
 
         // Send PCM to local transcriber.
+#if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
         if shouldSendTranscript || offlineCaptionsRunning || localSttFallbackActive {
             transcriber?.acceptAudio(pcm16le: pcmData)
         }
+#endif
     }
 
     func updateMicState() {
@@ -581,6 +604,7 @@ struct ViewState {
             Bridge.log("MAN: Manager already initialized, cleaning up previous sgc")
             sgc?.cleanup()
             sgc = nil
+            lastSystemTimeSyncConnectionKey = ""
         }
 
         if sgc != nil {
@@ -595,14 +619,24 @@ struct ViewState {
             sgc = G2()
         } else if wearable.contains(DeviceTypes.LIVE) {
             sgc = MentraLive()
-        } else if wearable.contains(DeviceTypes.MACH1) {
-            sgc = Mach1()
-        } else if wearable.contains(DeviceTypes.Z100) {
-            sgc = Mach1() // Z100 uses same hardware/SDK as Mach1
-            sgc?.type = DeviceTypes.Z100 // Override type to Z100
         } else if wearable.contains(DeviceTypes.FRAME) {
             // sgc = FrameManager()
         }
+#if !SWIFT_PACKAGE || MENTRA_FEATURE_NEX
+        if sgc == nil && wearable.contains(DeviceTypes.NEX) {
+            sgc = MentraNexSGC.getInstance()
+        }
+#endif
+#if !SWIFT_PACKAGE || MENTRA_FEATURE_VUZIX
+        if sgc == nil {
+            if wearable.contains(DeviceTypes.MACH1) {
+                sgc = Mach1()
+            } else if wearable.contains(DeviceTypes.Z100) {
+                sgc = Mach1() // Z100 uses same hardware/SDK as Mach1
+                sgc?.type = DeviceTypes.Z100 // Override type to Z100
+            }
+        }
+#endif
         // update device model:
         DeviceStore.shared.apply("glasses", "deviceModel", sgc?.type ?? "")
     }
@@ -672,7 +706,13 @@ struct ViewState {
                     return
                 }
                 Bridge.log("MAN: Processing bitmap_view with base64 data, length: \(data.count)")
-                await sgc?.displayBitmap(base64ImageData: data)
+                await sgc?.displayBitmap(
+                    base64ImageData: data,
+                    x: currentViewState.bmpX,
+                    y: currentViewState.bmpY,
+                    width: currentViewState.bmpWidth,
+                    height: currentViewState.bmpHeight
+                )
             case "clear_view":
                 sgc?.clearDisplay()
             default:
@@ -827,8 +867,12 @@ struct ViewState {
     }
 
     func restartTranscriber() {
+        #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
         Bridge.log("MAN: Restarting SherpaOnnxTranscriber via command")
         transcriber?.restart()
+        #else
+        Bridge.log("MAN: Local STT is not included in this SwiftPM build")
+        #endif
     }
 
     // MARK: - connection state management
@@ -844,6 +888,9 @@ struct ViewState {
         defaultWearable = sgc.type
         searching = false
 
+        let connectionKey = "\(sgc.type):\(deviceName)"
+        syncSystemTimeOnceForConnection(sgc, connectionKey: connectionKey)
+
         // Show welcome message on first connect for all display glasses
         if shouldSendBootingMessage {
             Task {
@@ -875,12 +922,31 @@ struct ViewState {
 
         // Re-apply display height after reconnection
         let h = DeviceStore.shared.get("bluetooth", "dashboard_height") as? Int ?? 4
+#if !SWIFT_PACKAGE || MENTRA_FEATURE_NEX
         let d = NexDashboardDisplayWire.clampDepthFromStore(
             DeviceStore.shared.get("bluetooth", "dashboard_depth")
         )
+#else
+        let rawDepth = DeviceStore.shared.get("bluetooth", "dashboard_depth") as? Int ?? 1
+        let d = min(max(rawDepth, 1), 4)
+#endif
         sgc.setDashboardPosition(h, d)
     }
 
+    private func syncSystemTimeOnceForConnection(_ sgc: SGCManager, connectionKey: String) {
+        if sgc.type.contains(DeviceTypes.SIMULATED) {
+            return
+        }
+        if connectionKey == lastSystemTimeSyncConnectionKey {
+            return
+        }
+
+        lastSystemTimeSyncConnectionKey = connectionKey
+        let timestampMs = Int64(Date().timeIntervalSince1970 * 1000)
+        Bridge.log("MAN: Syncing glasses system time once for connection: \(timestampMs)")
+        sgc.sendSetSystemTime(timestampMs)
+    }
+
     func handleControllerReady() {
         guard let controller else {
             Bridge.log("MAN: Controller is nil, returning")
@@ -925,8 +991,9 @@ struct ViewState {
 
     func handleDeviceDisconnected() {
         Bridge.log("MAN: Device disconnected")
+        lastSystemTimeSyncConnectionKey = ""
         DeviceStore.shared.apply("glasses", "headUp", false)
-        DeviceStore.shared.apply("glasses", "voiceActivityDetectionEnabled", true)
+        DeviceStore.shared.apply("glasses", "voiceActivityDetectionEnabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
         // shouldSendBootingMessage = true  // Reset for next first connect
     }
 
@@ -964,6 +1031,12 @@ struct ViewState {
         var title = layout["title"] as? String ?? " "
         var data = layout["data"] as? String ?? ""
 
+        // Optional bitmap_view container position/size (forwarded to the SGC; used by G2).
+        let bmpX = (layout["x"] as? NSNumber).map { $0.int32Value }
+        let bmpY = (layout["y"] as? NSNumber).map { $0.int32Value }
+        let bmpWidth = (layout["width"] as? NSNumber).map { $0.int32Value }
+        let bmpHeight = (layout["height"] as? NSNumber).map { $0.int32Value }
+
         text = parsePlaceholders(text)
         topText = parsePlaceholders(topText)
         bottomText = parsePlaceholders(bottomText)
@@ -971,7 +1044,8 @@ struct ViewState {
 
         var newViewState = ViewState(
             topText: topText, bottomText: bottomText, title: title, layoutType: layoutType,
-            text: text, data: data, animationData: nil
+            text: text, data: data, animationData: nil,
+            bmpX: bmpX, bmpY: bmpY, bmpWidth: bmpWidth, bmpHeight: bmpHeight
         )
 
         if layoutType == "bitmap_animation" {
@@ -1021,13 +1095,17 @@ struct ViewState {
         sgc?.showDashboard()
     }
 
+    func showNotificationsPanel() {
+        sgc?.showNotificationsPanel()
+    }
+
     func ping() {
         sgc?.ping()
     }
 
     func dbg1() {
-        sgc?.disconnectController()
-        connectDefaultController()
+        // sgc?.disconnectController()
+        // connectDefaultController()
     }
 
     func dbg2() {}
@@ -1075,6 +1153,11 @@ struct ViewState {
         sgc?.sendHotspotState(enabled)
     }
 
+    func setSystemTime(_ timestampMs: Int64) {
+        Bridge.log("MAN: Setting glasses system time: \(timestampMs)")
+        sgc?.sendSetSystemTime(timestampMs)
+    }
+
     func queryGalleryStatus() {
         Bridge.log("MAN: 📸 Querying gallery status from glasses")
         sgc?.queryGalleryStatus()
@@ -1093,6 +1176,42 @@ struct ViewState {
         (sgc as? MentraLive)?.sendOtaQueryStatus()
     }
 
+    private func liveSgc() throws -> MentraLive {
+        guard let live = sgc as? MentraLive else {
+            throw BluetoothError(code: "unsupported_device", message: "This command requires Mentra Live glasses.")
+        }
+        return live
+    }
+
+    func sendGalleryMode(requestId: String, enabled: Bool) throws {
+        try liveSgc().sendGalleryMode(requestId: requestId, active: enabled)
+    }
+
+    func sendButtonPhotoSettings(requestId: String, size: String) throws {
+        try liveSgc().sendButtonPhotoSettings(requestId: requestId, size: size)
+    }
+
+    func sendButtonVideoRecordingSettings(requestId: String, width: Int, height: Int, fps: Int) throws {
+        try liveSgc().sendButtonVideoRecordingSettings(requestId: requestId, width: width, height: height, fps: fps)
+    }
+
+    func sendButtonCameraLedSetting(requestId: String, enabled: Bool) throws {
+        try liveSgc().sendButtonCameraLedSetting(requestId: requestId, enabled: enabled)
+    }
+
+    func sendButtonMaxRecordingTime(requestId: String, minutes: Int) throws {
+        try liveSgc().sendButtonMaxRecordingTime(requestId: requestId, minutes: minutes)
+    }
+
+    func sendCameraFovSetting(requestId: String, fov: Int, roiPosition: Int) throws {
+        try liveSgc().sendCameraFovSetting(requestId: requestId, fov: fov, roiPosition: roiPosition)
+    }
+
+    func retryOtaVersionCheck() {
+        Bridge.log("MAN: ⏰ Retrying glasses OTA version check after clock sync")
+        (sgc as? MentraLive)?.sendOtaRetryVersionCheck()
+    }
+
     /// Request version info from glasses.
     /// Glasses will respond with version_info message containing build number, firmware version, etc.
     func requestVersionInfo() {
@@ -1114,11 +1233,17 @@ struct ViewState {
         sgc?.sendReboot()
     }
 
-    func startVideoRecording(_ requestId: String, _ save: Bool, _ sound: Bool) {
+    func startVideoRecording(
+        _ requestId: String, _ save: Bool, _ sound: Bool, _ width: Int = 0, _ height: Int = 0,
+        _ fps: Int = 0
+    ) {
         Bridge.log(
-            "MAN: onStartVideoRecording: requestId=\(requestId), save=\(save), flash=true, sound=\(sound)"
+            "MAN: onStartVideoRecording: requestId=\(requestId), save=\(save), flash=true, sound=\(sound), resolution=\(width)x\(height)@\(fps)fps"
+        )
+        sgc?.startVideoRecording(
+            requestId: requestId, save: save, flash: true, sound: sound, width: width, height: height,
+            fps: fps
         )
-        sgc?.startVideoRecording(requestId: requestId, save: save, flash: true, sound: sound)
     }
 
     func stopVideoRecording(_ requestId: String) {
@@ -1195,13 +1320,17 @@ struct ViewState {
         _ authToken: String?,
         _ compress: String?,
         _ flash: Bool,
+        _ save: Bool,
         _ sound: Bool,
         exposureTimeNs: Double? = nil,
         iso: Int? = nil
     ) {
-        let manualIso = exposureTimeNs != nil ? iso.flatMap { $0 > 0 ? $0 : nil } : nil
+        // Only honor manual exposure when it is a usable value; manual ISO is a one-shot
+        // companion to manual exposure and must be dropped when exposure is invalid.
+        let manualExposureNs = exposureTimeNs.flatMap { $0.isFinite && $0 > 0 ? $0 : nil }
+        let manualIso = manualExposureNs != nil ? iso.flatMap { $0 > 0 ? $0 : nil } : nil
         Bridge.log(
-            "MAN: PHOTO PIPELINE [4/6] DeviceManager.requestPhoto requestId=\(requestId) appId=\(appId) webhookUrl=\(webhookUrl ?? "nil") size=\(size) compress=\(compress ?? "none") flash=\(flash) sound=\(sound) exposureTimeNs=\(exposureTimeNs.map { String($0) } ?? "nil") iso=\(manualIso.map { String($0) } ?? "auto") sgc=\(sgc != nil ? String(describing: type(of: sgc!)) : "null")"
+            "MAN: PHOTO PIPELINE [4/6] DeviceManager.requestPhoto requestId=\(requestId) appId=\(appId) webhookUrl=\(webhookUrl ?? "nil") size=\(size) compress=\(compress ?? "none") flash=\(flash) save=\(save) sound=\(sound) exposureTimeNs=\(manualExposureNs.map { String($0) } ?? "nil") iso=\(manualIso.map { String($0) } ?? "auto") sgc=\(sgc != nil ? String(describing: type(of: sgc!)) : "null")"
         )
         guard let sgc else {
             Bridge.log(
@@ -1211,7 +1340,7 @@ struct ViewState {
         }
         sgc.requestPhoto(
             requestId, appId: appId, size: size, webhookUrl: webhookUrl, authToken: authToken,
-            compress: compress, flash: flash, sound: sound, exposureTimeNs: exposureTimeNs, iso: manualIso
+            compress: compress, flash: flash, save: save, sound: sound, exposureTimeNs: manualExposureNs, iso: manualIso
         )
     }
 
@@ -1309,6 +1438,7 @@ struct ViewState {
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
+        lastSystemTimeSyncConnectionKey = ""
         searching = false
         micEnabled = false
         updateMicState()
@@ -1317,7 +1447,7 @@ struct ViewState {
         DeviceStore.shared.apply("glasses", "deviceModel", "")
         DeviceStore.shared.apply("glasses", "fullyBooted", false)
         DeviceStore.shared.apply("glasses", "connected", false)
-        DeviceStore.shared.apply("glasses", "voiceActivityDetectionEnabled", true)
+        DeviceStore.shared.apply("glasses", "voiceActivityDetectionEnabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
         // disconnect the controller as well:
         searchingController = false
         DeviceStore.shared.apply("glasses", "controllerConnected", false)
@@ -1392,8 +1522,10 @@ struct ViewState {
 
     func cleanup() {
         // Clean up transcriber resources
+#if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
         transcriber?.shutdown()
         transcriber = nil
+#endif
 
         // Clean up LC3 converter
         lc3Converter = nil

package/ios/Source/DeviceStore.swift

@@ -28,7 +28,7 @@ class DeviceStore {
         store.set("glasses", "deviceModel", "")
         store.set("glasses", "firmwareVersion", "")
         store.set("glasses", "micEnabled", false)
-        store.set("glasses", "voiceActivityDetectionEnabled", true)
+        store.set("glasses", "voiceActivityDetectionEnabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
         store.set("glasses", "bluetoothClassicConnected", false)
         store.set("glasses", "caseRemoved", true)
         store.set("glasses", "caseOpen", true)
@@ -86,7 +86,9 @@ class DeviceStore {
         store.set("bluetooth", "head_up_angle", 30)
         store.set("bluetooth", "contextual_dashboard", true)
         store.set("bluetooth", "gallery_mode", true)
-        store.set("bluetooth", "voice_activity_detection_enabled", true)
+        store.set("bluetooth", "voice_activity_detection_enabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
+        // Mentra Nex feature flag (off by default; toggled from Nex Developer Settings):
+        store.set("bluetooth", "nex_chinese_captions", false)
         store.set("bluetooth", "screen_disabled", false)
         store.set("bluetooth", "button_photo_size", "medium")
         store.set("bluetooth", "button_camera_led", true)
@@ -134,16 +136,16 @@ class DeviceStore {
     /// Apply changes with side effects
     func apply(_ category: String, _ key: String, _ value: Any) {
         let oldValue = store.get(category, key)
+        let storeWouldSkipSet = store.wouldSkipSet(category, key, value)
         store.set(category, key, value)
+        if storeWouldSkipSet {
+            return
+        }
 
         // Trigger hardware updates based on setting changes
         switch (category, key) {
         case ("glasses", "fullyBooted"):
             Bridge.log("STORE: Glasses fullyBooted changed to \(value)")
-            // skip if the value is the same as the old value:
-            if let ready = value as? Bool, ready == oldValue as? Bool {
-                return
-            }
             if let ready = value as? Bool {
                 if ready {
                     DeviceManager.shared.handleDeviceReady()
@@ -220,6 +222,14 @@ class DeviceStore {
                 DeviceManager.shared.sgc?.setDashboardMenu(items)
             }
 
+        case ("bluetooth", "calendar_events"), ("core", "calendar_events"):
+            if let items = value as? [[String: Any]] {
+                DeviceManager.shared.sgc?.sendCalendarEvents(items)
+            }
+
+        case ("bluetooth", "metric_system"), ("bluetooth", "twelve_hour_time"):
+            DeviceManager.shared.sgc?.sendDashboardDisplaySettings()
+
         case ("bluetooth", "gallery_mode"):
             DeviceManager.shared.sgc?.sendGalleryMode()