@mentra/bluetooth-sdk 3.2.1-dev.314 → 3.3.0-beta.942

package/build/ota-transport/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ota-transport/index.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,wBAAwB,GAAG;IAAC,MAAM,IAAI,IAAI,CAAA;CAAC,CAAA;AAEvD,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AAErD,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe;uBACT,OAAO;oBACF,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,yBAAyB,CAAC;yBAKtE,MAAM,OACZ,MAAM,UACH,MAAM,WACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QACzB,MAAM,GAAG,IAAI,aACR,MAAM,KAChB,OAAO,CAAC,uBAAuB,CAAC;0BAKtB,MAAM,OACZ,MAAM,eACE,MAAM,WACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,uBACV,MAAM,iBACZ,MAAM,KACpB,OAAO,CAAC,6BAA6B,CAAC;wBAIf,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAI1B,OAAO,CAAC,IAAI,CAAC;mCAIJ,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,KAAG,wBAAwB;8BAIhF,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,KAAG,wBAAwB;EAI9F,CAAA;AAEF,qFAAqF;AACrF,eAAO,MAAM,SAAS;0BAEJ,MAAM,iBACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAC9B,MAAM,GAAG,IAAI,KACnB,OAAO,CAAC,eAAe,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC;kCACO,MAAM,aAAa,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;+BAE9C,MAAM,eAAe,MAAM,KAAG,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAC,CAAC;2CAErE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,KAAG,wBAAwB;EAE9G,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ota-transport/index.ts"],"names":[],"mappings":"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"}

package/build/ota-transport/index.js

@@ -11,6 +11,8 @@ import MentraOtaServer from "../ota-server";
  */
 export const otaLocalNetwork = Object.freeze({
     isAvailable: () => MentraLocalNetwork != null,
+    /** Synchronous local observation; no network I/O, route changes or network identities. */
+    getNetworkDiagnostics: () => MentraLocalNetwork?.getNetworkDiagnostics() ?? null,
     connect: async (ssid, password) => {
         if (!MentraLocalNetwork)
             throw new Error("Scoped local networking is not available in this native build");

package/build/ota-transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ota-transport/index.ts"],"names":[],"mappings":"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","sourcesContent":["// This public adapter is the package-owned boundary over its native implementation.\n// eslint-disable-next-line no-restricted-imports\nimport MentraLocalNetwork from \"../_private/MentraLocalNetworkModule\"\n// eslint-disable-next-line no-restricted-imports\nimport MentraOtaServer from \"../ota-server\"\n\nexport type OtaTransportSubscription = {remove(): void}\n\nexport type OtaLocalNetworkConnection = {\n  connected: boolean\n  ssid: string\n  localAddress?: string\n}\n\nexport type OtaLocalNetworkLostEvent = {ssid: string}\n\nexport type OtaLocalNetworkResponse = {\n  status: number\n  headers: Record<string, string>\n  bodyBase64: string\n}\n\nexport type OtaLocalNetworkDownloadResult = {\n  statusCode: number\n  bytesWritten: number\n  headers: Record<string, string>\n}\n\nexport type OtaLocalNetworkDownloadProgress = {\n  requestId: string\n  bytesWritten: number\n  contentLength: number\n  statusCode?: number\n  headers?: Record<string, string>\n}\n\nexport type OtaArtifactDownloadProgress = {\n  destination: string\n  bytesWritten: number\n  contentLength: number\n}\n\nexport type OtaServerResult = {\n  baseUrl: string\n  host: string\n  manifestUrl: string\n  port: number\n}\n\n/**\n * Scoped networking for traffic that must stay on a Mentra Live hotspot while\n * the phone's default route remains on cellular or another Wi-Fi network.\n *\n * The module is optional because iOS uses its system Wi-Fi join flow instead.\n */\nexport const otaLocalNetwork = Object.freeze({\n  isAvailable: (): boolean => MentraLocalNetwork != null,\n  connect: async (ssid: string, password: string): Promise<OtaLocalNetworkConnection> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.connect(ssid, password)\n  },\n  request: async (\n    requestId: string,\n    url: string,\n    method: string,\n    headers: Record<string, string>,\n    body: string | null,\n    timeoutMs: number,\n  ): Promise<OtaLocalNetworkResponse> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.request(requestId, url, method, headers, body, timeoutMs)\n  },\n  download: async (\n    requestId: string,\n    url: string,\n    destination: string,\n    headers: Record<string, string>,\n    connectionTimeoutMs: number,\n    readTimeoutMs: number,\n  ): Promise<OtaLocalNetworkDownloadResult> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.download(requestId, url, destination, headers, connectionTimeoutMs, readTimeoutMs)\n  },\n  cancel: async (requestId: string): Promise<void> => {\n    if (!MentraLocalNetwork) return\n    await MentraLocalNetwork.cancel(requestId)\n  },\n  disconnect: async (): Promise<void> => {\n    if (!MentraLocalNetwork) return\n    await MentraLocalNetwork.disconnect()\n  },\n  onDownloadProgress: (listener: (event: OtaLocalNetworkDownloadProgress) => void): OtaTransportSubscription => {\n    if (!MentraLocalNetwork) return {remove() {}}\n    return MentraLocalNetwork.addListener(\"downloadProgress\", listener)\n  },\n  onNetworkLost: (listener: (event: OtaLocalNetworkLostEvent) => void): OtaTransportSubscription => {\n    if (!MentraLocalNetwork) return {remove() {}}\n    return MentraLocalNetwork.addListener(\"networkLost\", listener)\n  },\n})\n\n/** Native HTTP server and artifact downloader used by the Engine OTA coordinator. */\nexport const otaServer = Object.freeze({\n  start: (\n    manifestJson: string,\n    artifactPaths: Record<string, string>,\n    host?: string | null,\n  ): Promise<OtaServerResult> => MentraOtaServer.startOtaServer(manifestJson, artifactPaths, host),\n  stop: (): Promise<void> => MentraOtaServer.stopOtaServer(),\n  waitForWifiAddress: (gateway: string, timeoutMs: number): Promise<string> =>\n    MentraOtaServer.waitForWifiAddress(gateway, timeoutMs),\n  downloadArtifact: (source: string, destination: string): Promise<{statusCode: number; bytesWritten: number}> =>\n    MentraOtaServer.downloadArtifact(source, destination),\n  onArtifactDownloadProgress: (listener: (event: OtaArtifactDownloadProgress) => void): OtaTransportSubscription =>\n    MentraOtaServer.addListener(\"artifactDownloadProgress\", listener),\n})\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ota-transport/index.ts"],"names":[],"mappings":"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","sourcesContent":["// This public adapter is the package-owned boundary over its native implementation.\n// eslint-disable-next-line no-restricted-imports\nimport MentraLocalNetwork, {type NetworkDiagnostics} from \"../_private/MentraLocalNetworkModule\"\n// eslint-disable-next-line no-restricted-imports\nimport MentraOtaServer from \"../ota-server\"\n\n// eslint-disable-next-line no-restricted-imports\nexport type {\n  NetworkCapabilitiesDiagnostic,\n  NetworkDiagnostics,\n  NetworkObservation,\n} from \"../_private/MentraLocalNetworkModule\"\n\nexport type OtaTransportSubscription = {remove(): void}\n\nexport type OtaLocalNetworkConnection = {\n  connected: boolean\n  ssid: string\n  localAddress?: string\n}\n\nexport type OtaLocalNetworkLostEvent = {ssid: string}\n\nexport type OtaLocalNetworkResponse = {\n  status: number\n  headers: Record<string, string>\n  bodyBase64: string\n}\n\nexport type OtaLocalNetworkDownloadResult = {\n  statusCode: number\n  bytesWritten: number\n  headers: Record<string, string>\n}\n\nexport type OtaLocalNetworkDownloadProgress = {\n  requestId: string\n  bytesWritten: number\n  contentLength: number\n  statusCode?: number\n  headers?: Record<string, string>\n}\n\nexport type OtaArtifactDownloadProgress = {\n  destination: string\n  bytesWritten: number\n  contentLength: number\n}\n\nexport type OtaServerResult = {\n  baseUrl: string\n  host: string\n  manifestUrl: string\n  port: number\n}\n\n/**\n * Scoped networking for traffic that must stay on a Mentra Live hotspot while\n * the phone's default route remains on cellular or another Wi-Fi network.\n *\n * The module is optional because iOS uses its system Wi-Fi join flow instead.\n */\nexport const otaLocalNetwork = Object.freeze({\n  isAvailable: (): boolean => MentraLocalNetwork != null,\n  /** Synchronous local observation; no network I/O, route changes or network identities. */\n  getNetworkDiagnostics: (): NetworkDiagnostics | null => MentraLocalNetwork?.getNetworkDiagnostics() ?? null,\n  connect: async (ssid: string, password: string): Promise<OtaLocalNetworkConnection> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.connect(ssid, password)\n  },\n  request: async (\n    requestId: string,\n    url: string,\n    method: string,\n    headers: Record<string, string>,\n    body: string | null,\n    timeoutMs: number,\n  ): Promise<OtaLocalNetworkResponse> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.request(requestId, url, method, headers, body, timeoutMs)\n  },\n  download: async (\n    requestId: string,\n    url: string,\n    destination: string,\n    headers: Record<string, string>,\n    connectionTimeoutMs: number,\n    readTimeoutMs: number,\n  ): Promise<OtaLocalNetworkDownloadResult> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.download(requestId, url, destination, headers, connectionTimeoutMs, readTimeoutMs)\n  },\n  cancel: async (requestId: string): Promise<void> => {\n    if (!MentraLocalNetwork) return\n    await MentraLocalNetwork.cancel(requestId)\n  },\n  disconnect: async (): Promise<void> => {\n    if (!MentraLocalNetwork) return\n    await MentraLocalNetwork.disconnect()\n  },\n  onDownloadProgress: (listener: (event: OtaLocalNetworkDownloadProgress) => void): OtaTransportSubscription => {\n    if (!MentraLocalNetwork) return {remove() {}}\n    return MentraLocalNetwork.addListener(\"downloadProgress\", listener)\n  },\n  onNetworkLost: (listener: (event: OtaLocalNetworkLostEvent) => void): OtaTransportSubscription => {\n    if (!MentraLocalNetwork) return {remove() {}}\n    return MentraLocalNetwork.addListener(\"networkLost\", listener)\n  },\n})\n\n/** Native HTTP server and artifact downloader used by the Engine OTA coordinator. */\nexport const otaServer = Object.freeze({\n  start: (\n    manifestJson: string,\n    artifactPaths: Record<string, string>,\n    host?: string | null,\n  ): Promise<OtaServerResult> => MentraOtaServer.startOtaServer(manifestJson, artifactPaths, host),\n  stop: (): Promise<void> => MentraOtaServer.stopOtaServer(),\n  waitForWifiAddress: (gateway: string, timeoutMs: number): Promise<string> =>\n    MentraOtaServer.waitForWifiAddress(gateway, timeoutMs),\n  downloadArtifact: (source: string, destination: string): Promise<{statusCode: number; bytesWritten: number}> =>\n    MentraOtaServer.downloadArtifact(source, destination),\n  onArtifactDownloadProgress: (listener: (event: OtaArtifactDownloadProgress) => void): OtaTransportSubscription =>\n    MentraOtaServer.addListener(\"artifactDownloadProgress\", listener),\n})\n"]}

package/ios/BluetoothSdkModule.swift

@@ -12,6 +12,10 @@ private func codedBridgeError(_ error: BluetoothSdkError) -> Exception {
     Exception(name: error.code, description: error.message, code: error.code)
 }
 
+/// Offline model archives take tens of seconds to extract. Android runs this on Dispatchers.IO;
+/// on Expo's shared default queue it would hold every other module's AsyncFunction behind it.
+private let modelExtractionQueue = DispatchQueue(label: "com.mentra.model-extraction", qos: .utility)
+
 public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
     private var sdk: MentraBluetoothSDK?
 
@@ -23,6 +27,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             "glasses_status",
             "bluetooth_status",
             "log",
+            "sdk_update_notice",
             "device_discovered",
             "default_device_changed",
             // Individual event handlers
@@ -90,7 +95,6 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             "send_command_to_ble",
             "receive_command_from_ble",
             "miniapp_selected",
-            "captions_tester_incident",
             "extraction_progress"
         )
 
@@ -226,6 +230,10 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             }
         }
 
+        AsyncFunction("unpair") {
+            try await DeviceManager.shared.unpair()
+        }
+
         AsyncFunction("forgetController") {
             await MainActor.run {
                 DeviceManager.shared.forgetController()
@@ -361,8 +369,8 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
         // MARK: - Incident Reporting
 
         AsyncFunction("sendIncidentId") { (incidentId: String, apiBaseUrl: String?) in
-            await MainActor.run {
-                self.bluetoothSdk().sendIncidentId(incidentId, apiBaseUrl: apiBaseUrl)
+            try await MainActor.run {
+                try self.bluetoothSdk().sendIncidentId(incidentId, apiBaseUrl: apiBaseUrl)
             }
         }
 
@@ -465,6 +473,11 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
             try await sdk.setLoudnessGateEnabled(enabled)
         }
 
+        AsyncFunction("setAutoPowerOffEnabled") { (enabled: Bool) in
+            let sdk = await MainActor.run { self.bluetoothSdk() }
+            try await sdk.setAutoPowerOffEnabled(enabled)
+        }
+
         AsyncFunction("setPhotoCaptureDefaults") { (params: [String: Any]) in
             let sdk = await MainActor.run { self.bluetoothSdk() }
             return try await sdk.setPhotoCaptureDefaults(PhotoCaptureDefaults.from(params: params)).values
@@ -836,7 +849,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
 
         AsyncFunction("extractTarBz2") { (sourcePath: String, destinationPath: String) -> Bool in
             return STTTools.extractTarBz2(sourcePath: sourcePath, destinationPath: destinationPath)
-        }
+        }.runOnQueue(modelExtractionQueue)
 
         // MARK: - TTS Model Management
 

package/ios/MentraBluetoothSDK.podspec

@@ -38,13 +38,14 @@ Pod::Spec.new do |s|
   }
 
   # iOS frameworks required by Bluetooth SDK
-  ios_frameworks = ['AVFoundation', 'CoreBluetooth', 'UIKit', 'CoreGraphics']
+  ios_frameworks = ['AVFoundation', 'CoreBluetooth', 'UIKit', 'CoreGraphics', 'ImageIO']
   ios_frameworks << 'Network' if include_expo_adapter
   s.ios.frameworks = ios_frameworks
   s.osx.frameworks = ['AVFoundation', 'CoreBluetooth', 'CoreAudio', 'AudioToolbox', 'ImageIO', 'JavaScriptCore', 'Network']
 
   # System libraries required by MentraOS
-  s.ios.library = 'bz2'
+  s.ios.libraries = 'bz2', 'z'
+  s.osx.library = 'z'
 
   # Vendored frameworks
   s.ios.vendored_frameworks = 'Packages/SherpaOnnx/sherpa-onnx.xcframework'

package/ios/Source/BluetoothBackgroundMode.swift

@@ -0,0 +1,32 @@
+import Foundation
+
+/// Whether the host app lets iOS keep the glasses link working while the app is suspended.
+///
+/// The SDK keeps a pending reconnection open after the glasses drop the link (for example while
+/// their Bluetooth chip restarts during a software update). iOS completes it, and delivers BLE
+/// events, only to apps that declare the `bluetooth-central` background mode. A Swift package
+/// cannot declare it for the app, so the SDK checks it and warns instead.
+enum BluetoothBackgroundMode {
+    static let requiredMode = "bluetooth-central"
+
+    /// Platform-independent plist check, so tests exercise it on every host.
+    static func declaresBluetoothCentral(_ infoDictionary: [String: Any]?) -> Bool {
+        guard let modes = infoDictionary?["UIBackgroundModes"] as? [String] else { return false }
+        return modes.contains(requiredMode)
+    }
+
+    static func isDeclared(in infoDictionary: [String: Any]?) -> Bool {
+        #if os(iOS)
+            return declaresBluetoothCentral(infoDictionary)
+        #else
+            // macOS apps are not suspended the same way and have no background modes.
+            return true
+        #endif
+    }
+
+    static let missingWarning =
+        "MentraBluetoothSDK: WARNING Info.plist is missing UIBackgroundModes `bluetooth-central`. "
+            + "While the phone is locked or the app is in the background, iOS will not reconnect to "
+            + "the glasses after a link drop (for example during a software update) until the app "
+            + "is opened. See https://docs.mentraglass.com/bluetooth-sdk/ios#background-operation"
+}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -9,9 +9,14 @@ enum BluetoothSdkDefaults {
     }
 
     static let voiceActivityDetectionEnabled = false
-    static let loudnessGateEnabled = false
+    static let loudnessGateEnabled = true
+
+    /// Must stay true. The firmware defaults auto power-off on, and we re-push
+    /// every Bluetooth setting on connect, so a false default here would
+    /// silently disable it on every pair the app touches.
+    static let autoPowerOffEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.1-dev.314"
+    private static let swiftPackageSdkVersion = "3.3.0-beta.942"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/Bridge.swift

@@ -335,8 +335,21 @@ class Bridge {
     }
 
     /// Wear state from sr_wrst, or from a wear transition on the glasses.
-    static func sendWearState(worn: Bool) {
-        Bridge.sendTypedMessage("wear_state", body: ["worn": worn])
+    static func sendWearState(
+        worn: Bool,
+        elapsedMs: Int? = nil,
+        timeoutMs: Int? = nil,
+        enabled: Bool? = nil,
+        armed: Bool? = nil,
+        inhibited: Bool? = nil
+    ) {
+        var body: [String: Any] = ["worn": worn]
+        if let elapsedMs { body["elapsedMs"] = elapsedMs }
+        if let timeoutMs { body["timeoutMs"] = timeoutMs }
+        if let enabled { body["enabled"] = enabled }
+        if let armed { body["armed"] = armed }
+        if let inhibited { body["inhibited"] = inhibited }
+        Bridge.sendTypedMessage("wear_state", body: body)
     }
 
     /// Wear vote config the glasses report as in force, from sr_weartun.

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 }
@@ -1512,13 +1518,16 @@ struct ViewState {
         sgc?.requestSavedWifiNetworks(requestId: requestId, sid: sid) ?? false
     }
 
-    func sendIncidentId(_ incidentId: String, apiBaseUrl: String? = nil) {
+    func sendIncidentId(_ incidentId: String, apiBaseUrl: String? = nil) throws {
+        guard let driver = sgc else {
+            throw BluetoothSdkError(code: "glasses_not_connected", message: "Cannot request incident logs because glasses are not connected.")
+        }
         Bridge.log("MAN: Sending incidentId to glasses for log upload: \(incidentId)")
-        sgc?.sendIncidentId(incidentId, apiBaseUrl: apiBaseUrl)
+        try driver.sendIncidentId(incidentId, apiBaseUrl: apiBaseUrl)
     }
 
     func sendWifiCredentials(_ ssid: String, _ password: String) {
-        Bridge.log("MAN: Sending wifi credentials: \(ssid) \(password)")
+        Bridge.log("MAN: Sending wifi credentials: \(ssid)")
         sgc?.sendWifiCredentials(ssid, password)
     }
 
@@ -1738,6 +1747,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 +1955,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 +2002,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 +2090,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.