@mentra/bluetooth-sdk 3.2.1-dev.314 → 3.2.1

package/ios/Source/DeviceManager.swift

@@ -318,9 +318,9 @@ struct ViewState {
     var lc3Converter: PcmConverter?
     /// Audio output format - defaults to LC3 for bandwidth savings
     private var audioOutputFormat: AudioOutputFormat = .lc3
-    /// Last time we received an LC3 frame from the glasses (used by the mic
-    /// inactivity watchdog).
-    private var lastLc3Event: Date?
+    private var micWatchdog = GlassesMicWatchdog()
+    // Injectable monotonic clock so recovery deadlines can be tested without sleeping.
+    var micWatchdogNow: () -> TimeInterval = { ProcessInfo.processInfo.systemUptime }
     private var sequenceGapEvents: Int64 = 0
     private var decodeFailures: Int64 = 0
     private var lastLc3ReceivedAt: Int64?
@@ -330,7 +330,7 @@ struct ViewState {
 
     /// STT:
     #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
-    private var transcriber: SherpaOnnxTranscriber?
+    private let transcriber = SherpaOnnxTranscriber()
     #endif
 
     var viewStates: [ViewState] = [
@@ -383,24 +383,6 @@ struct ViewState {
         // Start memory monitoring (logs every 30s to help detect leaks)
         // MemoryMonitor.start()
 
-        // Initialize SherpaOnnx Transcriber
-        #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
-        if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
-           let window = windowScene.windows.first,
-           let rootViewController = window.rootViewController
-        {
-            transcriber = SherpaOnnxTranscriber(context: rootViewController)
-        } else {
-            Bridge.log("Failed to create SherpaOnnxTranscriber - no root view controller found")
-        }
-
-        // Initialize the transcriber
-        if let transcriber = transcriber {
-            transcriber.initialize()
-            Bridge.log("SherpaOnnxTranscriber fully initialized")
-        }
-        #endif
-
         // Initialize persistent LC3 converter for unified audio encoding
         lc3Converter = PcmConverter()
         Bridge.log("LC3 converter initialized for unified audio encoding")
@@ -472,10 +454,17 @@ struct ViewState {
     }
 
     func reportGlassesAudioActivity() {
-        lastLc3Event = Date()
+        micWatchdog.receivedAudio(at: micWatchdogNow())
         lastPcmProducedAt = nowMs()
     }
 
+    /// Decoded glasses audio must update recovery health; phone PCM must not.
+    func handleGlassesPcm(_ pcmData: Data) {
+        guard !pcmData.isEmpty else { return }
+        reportGlassesAudioActivity()
+        handlePcm(pcmData)
+    }
+
     private func micHealth() -> MicHealth {
         MicHealth(
             sequenceGapEvents: sequenceGapEvents,
@@ -499,13 +488,13 @@ struct ViewState {
         lastLc3ReceivedAt = nil
         lastPcmProducedAt = nil
         lastLc3Sequence = nil
-        lastLc3Event = nil
+        micWatchdog = GlassesMicWatchdog()
     }
 
     private func recordLc3Packet(sequenceNumber: Int?) {
         let receivedAt = nowMs()
         lastLc3ReceivedAt = receivedAt
-        lastLc3Event = Date()
+        micWatchdog.receivedAudio(at: micWatchdogNow())
         var hasGap = false
         if let sequenceNumber {
             let normalized = sequenceNumber & 0xFF
@@ -535,7 +524,7 @@ struct ViewState {
         // Send PCM to local transcriber.
 #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         if shouldSendTranscript || localSttFallbackActive {
-            transcriber?.acceptAudio(pcm16le: pcmData)
+            transcriber.acceptAudio(pcm16le: pcmData)
         }
 #endif
     }
@@ -605,6 +594,7 @@ struct ViewState {
         }
 
         currentMic = micUsed
+        updateGlassesMicExpectation()
 
         // log if no mic was found:
         if micUsed == "" && micEnabled {
@@ -723,6 +713,7 @@ struct ViewState {
             Bridge.log("MAN: Manager already initialized, cleaning up previous sgc")
             sgc?.cleanup()
             sgc = nil
+            DeviceStore.shared.apply("glasses", "micEnabled", false)
             resetSystemTimeSync()
         }
 
@@ -902,27 +893,20 @@ struct ViewState {
         return result
     }
 
-    private func checkAndReinitGlassesMic() {
-        // if the glasses mic is marked as enabled (and the glasses are connected), but our last known lc3 event is from > 5 seconds ago, reinitialize the mic:
-        let glassesMicEnabled = DeviceStore.shared.get("glasses", "micEnabled") as? Bool ?? false
-        let glassesConnected = DeviceStore.shared.get("glasses", "connected") as? Bool ?? false
-        if !glassesMicEnabled || !glassesConnected {
-            return
-        }
-
-        if sgc?.isMicSuspendedForAudio == true {
-            Bridge.log("MAN: Glasses mic intentionally suspended for phone audio; skipping mic recovery")
-            return
-        }
-
-        if PhoneAudioMonitor.getInstance().isOwnAppAudioPlaying() {
-            Bridge.log("MAN: Mentra audio is playing; skipping glasses mic recovery")
-            return
-        }
+    private func updateGlassesMicExpectation() {
+        // Demand/route and device readiness decide whether audio is expected. The
+        // shared micEnabled flag alone is not evidence of a running hardware stream.
+        let expected = micEnabled && currentMic == MicTypes.GLASSES_CUSTOM
+            && sgc?.fullyBooted == true && sgc?.hasMic == true
+            && sgc?.isMicSuspendedForAudio != true
+            && !PhoneAudioMonitor.getInstance().isOwnAppAudioPlaying()
+        micWatchdog.expectAudio(expected, at: micWatchdogNow())
+    }
 
-        let timeSinceLastLc3Event = Date().timeIntervalSince(lastLc3Event ?? Date())
-        if timeSinceLastLc3Event > 5 {
-            Bridge.log("MAN: No audio activity in the last 5 seconds from glasses, reinitializing glasses mic")
+    func checkAndReinitGlassesMic() {
+        updateGlassesMicExpectation()
+        if micWatchdog.shouldRetry(at: micWatchdogNow()) {
+            Bridge.log("MAN: Expected glasses audio missing for 5 seconds; retrying mic start")
             sgc?.setMicEnabled(true)
         }
     }
@@ -982,7 +966,7 @@ struct ViewState {
     func restartTranscriber() {
         #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         Bridge.log("MAN: Restarting SherpaOnnxTranscriber via command")
-        transcriber?.restart()
+        transcriber.restart()
         #else
         Bridge.log("MAN: Local STT is not included in this SwiftPM build")
         #endif
@@ -998,12 +982,16 @@ struct ViewState {
         Bridge.log("MAN: handleDeviceReady(): \(sgc.type)")
         resetMicHealth()
 
+        // A new identity must never inherit the previous glasses' address when
+        // pairing supplied only a name. Same-device reconnects retain their cache.
+        let identityChanged = !pendingDeviceName.isEmpty &&
+            (pendingDeviceName != deviceName || sgc.type != defaultWearable)
+        if identityChanged || !pendingDeviceAddress.isEmpty {
+            deviceAddress = pendingDeviceAddress
+        }
         if !pendingDeviceName.isEmpty {
             deviceName = pendingDeviceName
         }
-        if !pendingDeviceAddress.isEmpty {
-            deviceAddress = pendingDeviceAddress
-        }
         clearPendingConnection()
         defaultWearable = sgc.type
         searching = false
@@ -1020,18 +1008,22 @@ struct ViewState {
             let h = DeviceStore.shared.get("bluetooth", "dashboard_height") as? Int ?? 4
             // Fall back to the canonical default (2), matching DeviceStore, not 1.
             let rawDepth = DeviceStore.shared.get("bluetooth", "dashboard_depth") as? Int ?? 2
-            let d = min(max(rawDepth, 1), 4)
+            let d = sgc.type == DeviceTypes.NIMO ? min(max(rawDepth, 0), 10) : min(max(rawDepth, 1), 4)
             sgc.setDashboardPosition(h, d)
         }
 
-        // Show welcome message on first connect for all display glasses
+        // Preserve the connected-edge scene replay on full-frame adapters.
         if shouldSendBootingMessage {
-            Task {
-                await sgc.sendTextWall("// MentraOS Connected")
-                try? await Task.sleep(nanoseconds: 3_000_000_000) // 1 second
-                sgc.clearDisplay()
-            }
             shouldSendBootingMessage = false
+            if sgc.showConnectionConfirmation {
+                Task {
+                    guard (self.sgc as AnyObject?) === (sgc as AnyObject) else { return }
+                    await sgc.sendTextWall("// MentraOS Connected")
+                    try? await Task.sleep(nanoseconds: 3_000_000_000)
+                    guard (self.sgc as AnyObject?) === (sgc as AnyObject) else { return }
+                    sgc.clearDisplay()
+                }
+            }
         }
 
         // Call device-specific setup handlers
@@ -1058,6 +1050,11 @@ struct ViewState {
         #endif
         checkCurrentAudioDevice()
 
+        // Disconnect clears micEnabled but preserves the consumers' audio requests.
+        // Recompute demand before selecting a microphone; unchanged requests are
+        // deduplicated by DeviceStore.apply().
+        setMicState()
+
         // save the default_wearable now that we're connected:
         Bridge.saveSetting("default_wearable", defaultWearable)
         Bridge.saveSetting("device_name", deviceName)
@@ -1214,7 +1211,9 @@ struct ViewState {
                 self.dashboardSceneCleanupPending = false
                 let elementIds = Array(self.pendingDashboardSceneElementIds)
                 self.pendingDashboardSceneElementIds.removeAll()
-                await self.sgc?.clearSceneElements(elementIds)
+                if self.sgc?.sceneHandoffRequiresClear == true {
+                    await self.sgc?.clearSceneElements(elementIds)
+                }
             }
             self.dashboardSceneCleanupTask = nil
         }
@@ -1261,7 +1260,7 @@ struct ViewState {
             if stateIndex == 1, dashboardSceneCleanupDeferred {
                 dashboardSceneCleanupPending = true
                 pendingDashboardSceneElementIds.formUnion(prevFrame.elements.map(\.id))
-            } else if layoutType != "clear_view" {
+            } else if layoutType != "clear_view", shouldClearSceneHandoff(stateIndex) {
                 let ids = prevFrame.elements.map(\.id)
                 Task { [weak self] in
                     await self?.sgc?.clearSceneElements(ids)
@@ -1355,7 +1354,7 @@ struct ViewState {
             // on G2 - no page rebuild).
             let prevLegacyType = viewStates[stateIndex].layoutType
             let cleanupDeferred = stateIndex == 1 && dashboardSceneCleanupDeferred
-            if !cleanupDeferred,
+            if !cleanupDeferred, shouldClearSceneHandoff(stateIndex),
                !prevLegacyType.isEmpty,
                prevLegacyType != "clear_view",
                prevLegacyType != "scene"
@@ -1371,7 +1370,7 @@ struct ViewState {
             if stateIndex == 1, dashboardSceneCleanupDeferred {
                 dashboardSceneCleanupPending = true
                 pendingDashboardSceneElementIds.formUnion(prevFrame.elements.map(\.id))
-            } else {
+            } else if shouldClearSceneHandoff(stateIndex) {
                 let ids = prevFrame.elements.map(\.id)
                 Task { [weak self] in
                     await self?.sgc?.clearSceneElements(ids)
@@ -1395,6 +1394,13 @@ struct ViewState {
         }
     }
 
+    private func shouldClearSceneHandoff(_ stateIndex: Int) -> Bool {
+        let visibleIndex = headUp && contextualDashboard ? 1 : 0
+        guard let sgc else { return false }
+        return stateIndex == visibleIndex && !screenDisabled && sgc.fullyBooted
+            && !sgc.type.contains(DeviceTypes.SIMULATED) && sgc.sceneHandoffRequiresClear
+    }
+
     /// Guarded scene dispatch - mirrors sendCurrentState's send conditions.
     private func dispatchSceneFrame(_ frame: SceneFrame, stateIndex: Int) {
         if screenDisabled { return }
@@ -1738,6 +1744,9 @@ struct ViewState {
     func setMicState() {
         let willSendPcm = shouldSendPcm || shouldSendLc3
         let willSendTranscript = shouldSendTranscript || localSttFallbackActive
+        #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
+        transcriber.setActive(willSendTranscript)
+        #endif
         micEnabled = willSendPcm || willSendTranscript
         updateMicState()
     }
@@ -1943,6 +1952,9 @@ struct ViewState {
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
+        // This cache belongs to the discarded connection. Keep consumer demand,
+        // but require a new mic-enable command when replacement glasses are ready.
+        DeviceStore.shared.apply("glasses", "micEnabled", false)
         resetSystemTimeSync()
         resetMicHealth()
         searching = false
@@ -1987,6 +1999,28 @@ struct ViewState {
         controller = nil // Clear the controller reference after disconnect
     }
 
+    private var unpairInProgress = false
+
+    /// Explicit user Unpair, separate from passive pairing cleanup and logout.
+    func unpair() async throws {
+        guard !unpairInProgress else {
+            throw NSError(domain: "NimoUnpair", code: 1,
+                          userInfo: [NSLocalizedDescriptionKey: "Unpair already in progress"])
+        }
+        unpairInProgress = true
+        defer { unpairInProgress = false }
+        if let nimo = sgc as? Nimo {
+            _ = await withCheckedContinuation { (continuation: CheckedContinuation<Bool, Never>) in
+                nimo.resetForUnpair { continuation.resume(returning: $0) }
+            }
+            guard (sgc as? Nimo) === nimo else {
+                throw NSError(domain: "NimoUnpair", code: 2,
+                              userInfo: [NSLocalizedDescriptionKey: "Glasses changed during Unpair"])
+            }
+        }
+        forget()
+    }
+
     func forget() {
         Bridge.log("MAN: Forgetting smart glasses")
         // Call forget first to stop timers/handlers/reconnect logic
@@ -2053,8 +2087,7 @@ struct ViewState {
         #endif
         // Clean up transcriber resources
 #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
-        transcriber?.shutdown()
-        transcriber = nil
+        transcriber.shutdown()
 #endif
 
         // Clean up LC3 converter

package/ios/Source/DeviceStore.swift

@@ -94,6 +94,7 @@ class DeviceStore {
         store.set("bluetooth", "gallery_mode", true)
         store.set("bluetooth", "voice_activity_detection_enabled", BluetoothSdkDefaults.voiceActivityDetectionEnabled)
         store.set("bluetooth", "loudness_gate_enabled", BluetoothSdkDefaults.loudnessGateEnabled)
+        store.set("bluetooth", "auto_power_off_enabled", BluetoothSdkDefaults.autoPowerOffEnabled)
         // 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)
@@ -191,14 +192,25 @@ class DeviceStore {
 
         // BLUETOOTH:
 
+        case ("bluetooth", "contextual_dashboard"):
+            if value is Bool {
+                Task { @MainActor in
+                    if self.store.get("glasses", "headUp") as? Bool == true {
+                        DeviceManager.shared.sendCurrentState()
+                    }
+                }
+            }
+
         case ("bluetooth", "brightness"):
             let b = value as? Int ?? 50
             let auto = store.get("bluetooth", "auto_brightness") as? Bool ?? true
             Task {
-                DeviceManager.shared.sgc?.setBrightness(b, autoMode: auto)
-                await DeviceManager.shared.sgc?.sendTextWall("Set brightness to \(b)%")
+                guard let device = DeviceManager.shared.sgc else { return }
+                device.setBrightness(b, autoMode: auto)
+                guard device.showBrightnessConfirmation else { return }
+                await device.sendTextWall("Set brightness to \(b)%")
                 try? await Task.sleep(nanoseconds: 800_000_000) // 0.8 seconds
-                DeviceManager.shared.sgc?.clearDisplay()
+                if (DeviceManager.shared.sgc as AnyObject?) === (device as AnyObject) { device.clearDisplay() }
             }
 
         case ("bluetooth", "auto_brightness"):
@@ -206,13 +218,14 @@ class DeviceStore {
             let auto = value as? Bool ?? true
             let autoBrightnessChanged = (oldValue as? Bool) != auto
             Task {
-                DeviceManager.shared.sgc?.setBrightness(b, autoMode: auto)
-                if autoBrightnessChanged {
-                    await DeviceManager.shared.sgc?.sendTextWall(
+                guard let device = DeviceManager.shared.sgc else { return }
+                device.setBrightness(b, autoMode: auto)
+                if autoBrightnessChanged, device.showBrightnessConfirmation {
+                    await device.sendTextWall(
                         auto ? "Enabled auto brightness" : "Disabled auto brightness"
                     )
                     try? await Task.sleep(nanoseconds: 800_000_000) // 0.8 seconds
-                    DeviceManager.shared.sgc?.clearDisplay()
+                    if (DeviceManager.shared.sgc as AnyObject?) === (device as AnyObject) { device.clearDisplay() }
                 }
             }
 
@@ -254,6 +267,12 @@ class DeviceStore {
         case ("bluetooth", "loudness_gate_enabled"):
             DeviceManager.shared.sgc?.sendLoudnessGateSetting()
 
+        case ("bluetooth", "auto_power_off_enabled"):
+            Bridge.log(
+                "DeviceStore: auto_power_off_enabled changed to \(String(describing: value)) — sending cs_swit type 11"
+            )
+            DeviceManager.shared.sgc?.sendAutoPowerOffSetting()
+
         // Deliberately has no seeded default: the key starts absent so that a
         // session where the engine has not authorized tuning can only ever
         // send a reset.

package/ios/Source/GeneratedChangelogCatalog.swift

@@ -2,8 +2,8 @@ import Foundation
 
 /// Generated from /changelogs. Do not edit directly.
 let generatedReleaseChangelogs: [ReleaseChangelog] = [
-    ReleaseChangelog(version: "3.2.1", markdown: "This release is under active development. User-facing changes will be documented as they land."),
-    ReleaseChangelog(version: "3.2.0", markdown: "This release is under active development. User-facing changes will be documented as they land.\n\n- Breaking Bluetooth SDK change: `forgetWifiNetwork(ssid)` now returns `WifiForgetResult` instead of `WifiStatusChangeEvent`. Migrate status-only consumers to the semantic `outcome`; the requested network remains `ssid`, while optional post-command connectivity is reported by `connected`, `currentSsid`, and `localIp`."),
+    ReleaseChangelog(version: "3.2.1", markdown: "- **Livestreamer:** \"Stream Here\" now works without a Wi-Fi network. Improved stream startup and connection reliability.\n- **Photos and gallery:** More reliable photo capture and gallery syncing.\n- **Mentra AI:** Reliability improvements and bug fixes.\n- **Miniapps:** Smoother transitions, with back buttons and gestures that take you to the previous screen inside a miniapp.\n- **Pairing and connections:** Improved G1 pairing and G2 background reconnection.\n- **Glasses updates:** Fixed repeated update checks and improved recovery after interrupted updates.\n- **Mentra Maps:** Bug fixes.\n- **NIMO:** Improved text and map layouts.\n- **Self-hosting:** Connect the Mentra App to your own self-hosted Mentra backend."),
+    ReleaseChangelog(version: "3.2.0", markdown: "- Improved glasses connectivity and Wi-Fi setup."),
     ReleaseChangelog(version: "3.1.1", markdown: "- Improved Google login on iOS.\n- Pairing no longer requires phone microphone access."),
     ReleaseChangelog(version: "3.1.0", markdown: "**Mentra App and glasses**\n\n- Improved glasses pairing and reconnection, including on iPad.\n- Improved Android background reliability for captions and miniapps.\n- Added Xingyi AR99 support.\n- More reliable photo and video capture, with improved shutter sounds and privacy-light timing. Taking photos no longer interrupts your running miniapp.\n- Added video thumbnails and smoother gallery browsing.\n- Easier Mentra Live updates through your phone, with clearer progress and better recovery from interruptions.\n\n**Miniapp updates**\n\n- **Mentra AI:** Control whether photos are included with questions. Improved visual answers and connected-app follow-ups.\n- **Captions:** Added offline transcription settings and top/bottom positioning on supported displays.\n- **Translation:** Restored all 60 languages.\n- **Mentra Maps:** Clearer directions on G1/G2, less display flickering, and improved Android offline routing.\n- **Livestreamer:** More video-quality controls and custom streaming options, plus improved startup and sharing.\n- **Merge:** Tap to expand an insight; swipe down or back to dismiss it.\n- **Mentra Notes:** Smoother back navigation.\n- **Recorder:** Fixed audio sharing."),
 ]

package/ios/Source/GeneratedReleaseMetadata.swift

@@ -3,9 +3,9 @@ import Foundation
 /// Generated by release CI. Do not edit in a release checkout.
 enum GeneratedReleaseMetadata {
     static let familyBaseVersion = "3.2.1"
-    static let releaseIdentity = "3.2.1-dev.314"
-    static let releaseSetId = "mentra-3.2.1-dev.314"
-    static let sourceCommit = "00ab17c37df5902fbdb1a5824a41288b6850acc5"
-    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.314.json"
-    static let otaManifestSha256 = "1062c560fcced026e5b43245e84cdd5febfd603f3ad19fbebef8fac455ba21d6"
+    static let releaseIdentity = "3.2.1"
+    static let releaseSetId = "mentra-3.2.1"
+    static let sourceCommit = "be56e1456c69f681985642f376ed3d397ec022cc"
+    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.578.json"
+    static let otaManifestSha256 = "21af62269e29fd2ee6b9737745a895694bc221672b191d80795057b5a832f400"
 }

package/ios/Source/MentraBluetoothSDK.swift

@@ -299,8 +299,22 @@ public final class MentraBluetoothSDK {
     private let wifiSessionCapabilities = WifiSessionCapabilities()
     private var configuredOtaVersionUrl: String?
 
+    /// Whether the app declares the `bluetooth-central` background mode. When false on iOS, the
+    /// glasses stay disconnected after a link drop until the user opens the app, so a software
+    /// update started on a locked phone stalls. Always true on macOS.
+    public static var supportsBackgroundReconnect: Bool {
+        BluetoothBackgroundMode.isDeclared(in: Bundle.main.infoDictionary)
+    }
+
+    private static var didWarnMissingBackgroundMode = false
+
     public init(configuration: MentraBluetoothSDKConfiguration = .default) {
         self.configuration = configuration
+        // Once per process: apps may create the SDK more than once.
+        if !Self.didWarnMissingBackgroundMode, !Self.supportsBackgroundReconnect {
+            Self.didWarnMissingBackgroundMode = true
+            Bridge.log(BluetoothBackgroundMode.missingWarning)
+        }
         analytics = BluetoothSdkAnalytics(configuration: configuration.analytics)
         bluetoothAvailabilityListenerId = BluetoothAvailability.shared.addStateListener { [weak self] state in
             Task { @MainActor [weak self] in
@@ -688,6 +702,10 @@ public final class MentraBluetoothSDK {
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "loudness_gate_enabled", enabled)
     }
 
+    public func setAutoPowerOffEnabled(_ enabled: Bool) async throws {
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "auto_power_off_enabled", enabled)
+    }
+
     @available(*, deprecated, message: "Sticky action-button photo presets are deprecated. Prefer per-request requestPhoto(...) options (e.g. mode .text for text sensor size/crop, or explicit per-shot fields). This method still works but will be removed in a future release.")
     public func setPhotoCaptureDefaults(_ settings: PhotoCaptureDefaults) async throws -> SettingsAckEvent {
         try await performSettingsCommand(

package/ios/Source/audio/GlassesMicWatchdog.swift

@@ -0,0 +1,33 @@
+import Foundation
+
+/// Tracks expected audio separately from observed audio. All times use a monotonic clock.
+struct GlassesMicWatchdog {
+    private var expectedSince: TimeInterval?
+    private var lastActivity: TimeInterval?
+    private var lastRetry: TimeInterval?
+    private let timeout: TimeInterval = 5
+
+    mutating func expectAudio(_ expected: Bool, at now: TimeInterval) {
+        guard expected else {
+            self = GlassesMicWatchdog()
+            return
+        }
+        if expectedSince == nil {
+            expectedSince = now
+        }
+    }
+
+    mutating func receivedAudio(at now: TimeInterval) {
+        guard expectedSince != nil else { return }
+        lastActivity = now
+    }
+
+    mutating func shouldRetry(at now: TimeInterval) -> Bool {
+        guard let expectedSince else { return false }
+        let lastProgress = max(expectedSince, lastActivity ?? expectedSince, lastRetry ?? expectedSince)
+        guard now - lastProgress >= timeout else { return false }
+        // Rate-limit retries even when the device never produces its first packet.
+        lastRetry = now
+        return true
+    }
+}

package/ios/Source/requests/DisplayRequests.swift

@@ -1,7 +1,7 @@
 import Foundation
 
 enum DashboardContentFormatter {
-    static let statusHeader = "$TIME12$ $DATE$ $GBATT$ $CONNECTION_STATUS$"
+    static let statusHeader = "$TIME12$ $DATE$ $GBATT$"
 
     static func template(for content: String) -> String {
         content.isEmpty ? statusHeader : statusHeader + "\n\n" + content

package/ios/Source/requests/VersionInfoResponseAccumulator.swift

@@ -7,7 +7,7 @@ enum VersionInfoAccumulatorOutcome {
     case complete(VersionInfoResult)
 }
 
-/// One request, explicit modern completion, or the deployed legacy chunk-3 terminal boundary.
+/// One request, explicit modern completion, or the legacy firmware's terminal chunk.
 final class VersionInfoResponseAccumulator {
     static let responseChunkKey = "_responseChunk"
     static let responseRequestIdKey = "_responseRequestId"
@@ -23,6 +23,7 @@ final class VersionInfoResponseAccumulator {
     private var count: Int?
     private var sid: String?
     private var legacyStarted = false
+    private var legacyTwoChunkResponse = false
     private var completed = false
 
     init(expectedRequestId: String) {
@@ -63,10 +64,19 @@ final class VersionInfoResponseAccumulator {
         case "version_info_1":
             values.removeAll()
             legacyStarted = true
+            legacyTwoChunkResponse = event["buildNumber"] as? String == "27"
             merge(event)
         case "version_info_2":
             guard legacyStarted else { return .ignored }
+            // Factory ASG27 sends only chunks 1 and 2. Its second chunk carries the
+            // OTA URL and legacy firmware version; ASG31+ moves firmware to chunk 3.
             merge(event)
+            if legacyTwoChunkResponse, values["buildNumber"] as? String == "27",
+               let otaUrl = event["otaVersionUrl"] as? String,
+               !otaUrl.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
+            {
+                return finish()
+            }
         case "version_info_3":
             guard legacyStarted else { return .ignored }
             merge(event)

package/ios/Source/sgcs/Ar99.swift

@@ -1850,8 +1850,7 @@ final class Ar99: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SGCM
     private func ensureOpusDecoder() {
         guard opusDecoder == nil else { return }
         opusDecoder = Ar99OpusPcmDecoder { pcm in
-            DeviceManager.shared.reportGlassesAudioActivity()
-            DeviceManager.shared.handlePcm(pcm)
+            DeviceManager.shared.handleGlassesPcm(pcm)
         }
         if opusDecoder == nil {
             Bridge.log("AR99: system Opus decoder unavailable")