@mentra/bluetooth-sdk 3.2.0-dev.125 → 3.2.0-dev.136

package/README.md

@@ -8,7 +8,8 @@ The package includes:
 - React hooks under `@mentra/bluetooth-sdk/react` for common scan,
   connection, status, and event lifecycles.
 - Native Android code published as `com.mentraglass:bluetooth-sdk`.
-- Native iOS code available as the `MentraBluetoothSDK` Swift package.
+- Native iOS and macOS code available as the `MentraBluetoothSDK` Swift package.
+- Native macOS Expo Modules adapter for `react-native-macos` hosts.
 - An Expo config plugin that wires the native dependencies into generated Android and iOS projects.
 
 Use a development build or production native build. Expo Go cannot load this package because the SDK contains native code.
@@ -19,6 +20,9 @@ Use a development build or production native build. Expo Go cannot load this pac
 - Expo `49+` when using Expo.
 - Android min SDK `28+`.
 - iOS deployment target `15.1+`.
+- Native macOS deployment target `13+`. The Starter Kit's separate
+  `react-native-macos` host requires macOS `14+` and a matching React Native / Expo
+  Modules toolchain; the iOS/Android config plugin does not generate a Mac host.
 - A physical phone for real Bluetooth testing.
 - Bluetooth permissions, plus Android location permission where BLE scanning requires it.
 
@@ -407,10 +411,6 @@ automatically.
 
 OTA requires Mentra Live glasses firmware that supports the ASG OTA protocol and network access from the glasses. During install, normal BLE traffic can be interrupted and the glasses may restart; keep the app connected and avoid sending unrelated commands until `ota_status.status` is `complete` or `failed`.
 
-For release selection, bundle verification, analytics opt-out, internal server
-requirements, and disconnected validation, see the
-[air-gapped deployment guide](https://docs.mentraglass.com/bluetooth-sdk/air-gapped-deployment).
-
 Mentra Live also rejects `ota_start` before acknowledgement when its known battery level is below 5%, emitting a failed `ota_status` with `error_message: "battery_low"`. Unknown battery state remains fail-open, so apps should keep their own (typically stricter) user-facing battery policy.
 
 ## Photo Upload
@@ -526,13 +526,15 @@ project, not the local Gradle entrypoint. The check script prepares
 `mobile/android` and uses its Gradle wrapper with `-PmentraPublicSdk=true`,
 matching the CI release workflow's public SDK dependency mode.
 
-For bare native iOS apps, use the public SwiftPM repository:
+For bare native iOS or macOS apps, use the public SwiftPM repository:
 
 ```text
 https://github.com/Mentra-Community/mentra-bluetooth-sdk-ios.git
 ```
 
-Select version `0.1.20`, then add the `MentraBluetoothSDK` product to your app target.
+Select a coordinated SDK version that includes your target platform, then add
+the `MentraBluetoothSDK` product to your app target. Native macOS support is new
+on `dev`; use the local source override until a supporting release is published.
 
 For local SDK development, add this package folder directly in Xcode:
 
@@ -542,6 +544,14 @@ For local SDK development, add this package folder directly in Xcode:
 
 The core Swift package intentionally excludes optional local STT, Nex/SwiftProtobuf, Vuzix/Ultralite, and tar.bz2 extraction code paths.
 
+Native Mac hosts need Bluetooth and local-network usage descriptions, and
+sandbox entitlements for Bluetooth and outbound networking. Add microphone
+permission/audio-input capability for host microphone capture and network-server
+capability for local SDK servers. macOS uses CoreAudio instead of
+`AVAudioSession`; it does not provide iOS background modes or ANCS relay. See
+[the macOS integration guide](../../../mintlify-docs/bluetooth-sdk/macos.mdx)
+and the Starter Kit's `examples/macos` and `examples/react-native-macos` hosts.
+
 Maintainers publishing the public SwiftPM mirror should follow
 [RELEASING_IOS_SPM.md](./RELEASING_IOS_SPM.md).
 

package/android/src/main/java/com/mentra/bluetoothsdk/GeneratedReleaseMetadata.kt

@@ -3,9 +3,9 @@ package com.mentra.bluetoothsdk
 /** Generated by release CI. Do not edit in a release checkout. */
 internal object GeneratedReleaseMetadata {
     const val FAMILY_BASE_VERSION: String = "3.2.0"
-    const val RELEASE_IDENTITY: String = "3.2.0-dev.125"
-    const val RELEASE_SET_ID: String = "mentra-3.2.0-dev.125"
-    const val SOURCE_COMMIT: String = "5ae6d6bf777ef7343c4c7d16d6145404d619e2de"
-    const val OTA_MANIFEST_URL: String = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.125.json"
-    const val OTA_MANIFEST_SHA256: String = "78851cf939b81f514854ffec083a089c1f41616934decfc843971bdd8037d820"
+    const val RELEASE_IDENTITY: String = "3.2.0-dev.136"
+    const val RELEASE_SET_ID: String = "mentra-3.2.0-dev.136"
+    const val SOURCE_COMMIT: String = "9d3e676966ad4633e1a4438a716f9c6601c5a24a"
+    const val OTA_MANIFEST_URL: String = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.136.json"
+    const val OTA_MANIFEST_SHA256: String = "1d258b8f4c011ddc1f1eb1ab3c86d9b059da5ed5da1e5218d60875867e570134"
 }

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.0",
-    "releaseIdentity": "3.2.0-dev.125",
-    "releaseSetId": "mentra-3.2.0-dev.125",
-    "sourceCommit": "5ae6d6bf777ef7343c4c7d16d6145404d619e2de",
-    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.125.json",
-    "otaManifestSha256": "78851cf939b81f514854ffec083a089c1f41616934decfc843971bdd8037d820"
+    "releaseIdentity": "3.2.0-dev.136",
+    "releaseSetId": "mentra-3.2.0-dev.136",
+    "sourceCommit": "9d3e676966ad4633e1a4438a716f9c6601c5a24a",
+    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.136.json",
+    "otaManifestSha256": "1d258b8f4c011ddc1f1eb1ab3c86d9b059da5ed5da1e5218d60875867e570134"
 });
 //# sourceMappingURL=releaseMetadata.js.map

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,wHAAwH;IAC1I,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.0\",\n  \"releaseIdentity\": \"3.2.0-dev.125\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.125\",\n  \"sourceCommit\": \"5ae6d6bf777ef7343c4c7d16d6145404d619e2de\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.125.json\",\n  \"otaManifestSha256\": \"78851cf939b81f514854ffec083a089c1f41616934decfc843971bdd8037d820\"\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,wHAAwH;IAC1I,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.0\",\n  \"releaseIdentity\": \"3.2.0-dev.136\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.136\",\n  \"sourceCommit\": \"9d3e676966ad4633e1a4438a716f9c6601c5a24a\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.136.json\",\n  \"otaManifestSha256\": \"1d258b8f4c011ddc1f1eb1ab3c86d9b059da5ed5da1e5218d60875867e570134\"\n})\n"]}

package/ios/BluetoothSdkModule.swift

@@ -695,6 +695,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
 
         // MARK: - STT Model Management
 
+        #if !os(macOS)
         AsyncFunction("setSttModelDetails") { (path: String, languageCode: String) in
             STTTools.setSttModelDetails(path, languageCode)
         }
@@ -747,6 +748,7 @@ public class BluetoothSdkModule: Module, MentraBluetoothSDKDelegate {
                 speed: speed
             )
         }
+        #endif
     }
 
     @MainActor
@@ -936,4 +938,3 @@ private extension ConnectOptions {
 
 
 
-

package/ios/MentraBluetoothSDK.podspec

@@ -12,7 +12,8 @@ Pod::Spec.new do |s|
   s.author         = package['author']
   s.homepage       = package['homepage']
   s.platforms      = {
-    :ios => '15.1'
+    :ios => '15.1',
+    :osx => '13.0'
   }
   s.swift_version  = '5.9'
   s.source         = {
@@ -23,10 +24,10 @@ Pod::Spec.new do |s|
 
   # External dependencies required by Bluetooth SDK native code
   s.dependency 'ExpoModulesCore' if include_expo_adapter
-  s.dependency 'SWCompression', '~> 4.8.0'
-  s.dependency 'SwiftProtobuf', '~> 1.0'
-  s.dependency 'onnxruntime-objc', '1.18.0'
-  s.dependency 'UltraliteSDK'
+  s.ios.dependency 'SWCompression', '~> 4.8.0'
+  s.ios.dependency 'SwiftProtobuf', '~> 1.0'
+  s.ios.dependency 'onnxruntime-objc', '1.18.0'
+  s.ios.dependency 'UltraliteSDK'
 
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {
@@ -39,13 +40,14 @@ Pod::Spec.new do |s|
   # iOS frameworks required by Bluetooth SDK
   ios_frameworks = ['AVFoundation', 'CoreBluetooth', 'UIKit', 'CoreGraphics']
   ios_frameworks << 'Network' if include_expo_adapter
-  s.frameworks = ios_frameworks
+  s.ios.frameworks = ios_frameworks
+  s.osx.frameworks = ['AVFoundation', 'CoreBluetooth', 'CoreAudio', 'AudioToolbox', 'ImageIO', 'JavaScriptCore', 'Network']
 
   # System libraries required by MentraOS
-  s.library = 'bz2'
+  s.ios.library = 'bz2'
 
   # Vendored frameworks
-  s.vendored_frameworks = 'Packages/SherpaOnnx/sherpa-onnx.xcframework'
+  s.ios.vendored_frameworks = 'Packages/SherpaOnnx/sherpa-onnx.xcframework'
 
   s.resource_bundles = {
     'BluetoothSDKPrivacy' => ['Source/PrivacyInfo.xcprivacy']
@@ -60,7 +62,7 @@ Pod::Spec.new do |s|
     "Packages/SherpaOnnx/sherpa-onnx.xcframework/Headers/**/*.{h,hpp}",
     "Packages/libbz2/shim.h"
   ]
-  native_source_files.concat([
+  adapter_source_files = [
     "BluetoothSdkModule.swift",
     "LocalPhotoUploadServer.swift",
     "MentraPhotoReceiverModule.swift",
@@ -68,8 +70,24 @@ Pod::Spec.new do |s|
     "LocalOtaServer.swift",
     "BackgroundOtaArtifactDownloader.swift",
     "MentraOtaServerModule.swift"
-  ]) if include_expo_adapter
-  s.source_files = native_source_files
+  ]
+  native_source_files.concat(adapter_source_files) if include_expo_adapter
+  s.ios.source_files = native_source_files
+  s.osx.source_files = [
+    'Source/**/*.{h,m,mm,swift,hpp,cpp,c}',
+    'Packages/CoreObjC/**/*.{h,m,mm,hpp,cpp,c}'
+  ] + (include_expo_adapter ? adapter_source_files : [])
+  s.osx.exclude_files = [
+    'Source/Bridging-Header.h',
+    'Source/sgcs/Mach1.swift',
+    'Source/sgcs/MentraNex.swift',
+    'Source/sgcs/mentraos_ble.pb.swift',
+    'Source/stt/**/*',
+    'Source/tts/**/*',
+    'Source/utils/TarBz2Extractor.swift',
+    'Source/BridgeModule.{h,m}',
+    'Source/Bridge.m'
+  ]
 
   # Explicitly mark C++ headers and internal headers as private to prevent exposure in public interface
   s.private_header_files = [

package/ios/Source/BluetoothSdkDefaults.swift

@@ -11,7 +11,7 @@ enum BluetoothSdkDefaults {
     static let voiceActivityDetectionEnabled = false
     static let loudnessGateEnabled = true
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.0-dev.125"
+    private static let swiftPackageSdkVersion = "3.2.0-dev.136"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/DeviceManager.swift

@@ -9,7 +9,12 @@ import AVFoundation
 import Combine
 import CoreBluetooth
 import Foundation
+#if os(macOS)
+import CoreAudio
+#endif
+#if canImport(UIKit)
 import UIKit
+#endif
 #if SWIFT_PACKAGE
 import MentraBluetoothSDKCoreObjC
 #endif
@@ -43,6 +48,9 @@ struct ViewState {
     // MARK: - Unique (iOS)
 
     private var cancellables = Set<AnyCancellable>()
+    #if os(macOS)
+    private var audioRouteObserver: MacAudioRouteObserver?
+    #endif
     var sendStateWorkItem: DispatchWorkItem?
     let sendStateQueue = DispatchQueue(label: "sendStateQueue", qos: .userInitiated)
 
@@ -51,6 +59,7 @@ struct ViewState {
      * Attempts to automatically activate Mentra Live as the system audio device
      * If not paired yet, prompts user to pair in Settings
      */
+    #if !os(macOS)
     func setupAudioPairing(deviceName _: String) {
         // Don't configure audio session - PhoneMic.swift handles that
         // Just check if audio session supports Bluetooth (informational only)
@@ -83,6 +92,7 @@ struct ViewState {
             // Not found in availableInputs - not paired yet
 
             // Start monitoring for when user pairs manually
+            #if !os(macOS)
             AudioSessionMonitor.startMonitoring(devicePattern: audioDevicePattern) {
                 [weak self] (connected: Bool, _: String?) in
                 guard let self = self else { return }
@@ -96,9 +106,12 @@ struct ViewState {
                     self.glassesBluetoothClassicConnected = false
                 }
             }
+            #endif
         }
     }
 
+    #endif
+
     // MARK: - End Unique
 
     // MARK: - Properties
@@ -314,7 +327,7 @@ struct ViewState {
     private var micReinitTimer: Timer?
 
     /// STT:
-    #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+    #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
     private var transcriber: SherpaOnnxTranscriber?
     #endif
 
@@ -351,7 +364,7 @@ struct ViewState {
         // MemoryMonitor.start()
 
         // Initialize SherpaOnnx Transcriber
-        #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+        #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
@@ -500,7 +513,7 @@ struct ViewState {
         handleSendingPcm(pcmData)
 
         // Send PCM to local transcriber.
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         if shouldSendTranscript || localSttFallbackActive {
             transcriber?.acceptAudio(pcm16le: pcmData)
         }
@@ -517,11 +530,13 @@ struct ViewState {
 
         var phoneMicUnavailable = systemMicUnavailable
 
+        #if !os(macOS)
         let appState = UIApplication.shared.applicationState
         if appState == .background {
             // Bridge.log("App is in background - onboard mic unavailable to start!")
             phoneMicUnavailable = true
         }
+        #endif
 
         if micEnabled {
             for micMode in micRanking {
@@ -710,12 +725,12 @@ struct ViewState {
         } else if wearable.contains(DeviceTypes.FRAME) {
             // sgc = FrameManager()
         }
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_NEX
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_NEX)
         if sgc == nil && wearable.contains(DeviceTypes.NEX) {
             sgc = MentraNexSGC.getInstance()
         }
 #endif
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_VUZIX
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_VUZIX)
         if sgc == nil {
             if wearable.contains(DeviceTypes.MACH1) {
                 sgc = Mach1()
@@ -927,6 +942,10 @@ struct ViewState {
             return
         }
 
+        #if os(macOS)
+        glassesBluetoothClassicConnected = AudioSessionMonitor.isAudioDeviceConnected(devicePattern: audioDevicePattern)
+        otherBtConnected = AudioSessionMonitor.isOtherAudioDeviceConnected(devicePattern: audioDevicePattern)
+        #else
         // check if the device disconnected:
         let isConnected = AudioSessionMonitor.isAudioDeviceConnected(
             devicePattern: audioDevicePattern
@@ -948,17 +967,15 @@ struct ViewState {
 
         let isPaired = AudioSessionMonitor.isDevicePaired(devicePattern: audioDevicePattern)
         if isPaired {
-            let session = AVAudioSession.sharedInstance()
-            let deviceName = session.availableInputs?.first(where: {
-                $0.portName.localizedCaseInsensitiveContains(audioDevicePattern)
-            })?.portName
-            Bridge.log("MAN: Successfully detected newly paired device '\(deviceName)'")
+            Bridge.log("MAN: Successfully detected newly paired device '\(audioDevicePattern)'")
             glassesBluetoothClassicConnected = true
         } else {
             glassesBluetoothClassicConnected = false
         }
+        #endif
     }
 
+    #if !os(macOS)
     func onRouteChange(
         reason: AVAudioSession.RouteChangeReason, availableInputs: [AVAudioSessionPortDescription]
     ) {
@@ -980,6 +997,7 @@ struct ViewState {
 
         updateMicState()
     }
+    #endif
 
     func onInterruption(began: Bool) {
         Bridge.log("MAN: Interruption: \(began)")
@@ -988,7 +1006,7 @@ struct ViewState {
     }
 
     func restartTranscriber() {
-        #if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+        #if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         Bridge.log("MAN: Restarting SherpaOnnxTranscriber via command")
         transcriber?.restart()
         #else
@@ -1054,6 +1072,16 @@ struct ViewState {
         }
 
         // check current audio device:
+        #if os(macOS)
+        audioRouteObserver = MacAudioRouteObserver(selectors: [kAudioHardwarePropertyDevices,
+            kAudioHardwarePropertyDefaultInputDevice, kAudioHardwarePropertyDefaultOutputDevice]) { [weak self] in
+            Task { @MainActor in
+                guard let self, self.audioRouteObserver != nil else { return }
+                self.checkCurrentAudioDevice()
+                self.updateMicState()
+            }
+        }
+        #endif
         checkCurrentAudioDevice()
 
         // save the default_wearable now that we're connected:
@@ -1146,6 +1174,9 @@ struct ViewState {
 
     func handleDeviceDisconnected() {
         Bridge.log("MAN: Device disconnected")
+        #if os(macOS)
+        audioRouteObserver = nil
+        #endif
         resetSystemTimeSync()
         resetMicHealth()
         DeviceStore.shared.apply("glasses", "headUp", false)
@@ -1825,6 +1856,11 @@ struct ViewState {
     }
 
     func disconnect(clearPendingConnection: Bool = true) {
+        #if os(macOS)
+        audioRouteObserver = nil
+        glassesBluetoothClassicConnected = false
+        otherBtConnected = false
+        #endif
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
@@ -1932,8 +1968,12 @@ struct ViewState {
     }
 
     func cleanup() {
+        #if os(macOS)
+        audioRouteObserver = nil
+        PhoneMic.shared.cleanup()
+        #endif
         // Clean up transcriber resources
-#if !SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT
+#if !os(macOS) && (!SWIFT_PACKAGE || MENTRA_FEATURE_LOCAL_STT)
         transcriber?.shutdown()
         transcriber = nil
 #endif

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.0"
-    static let releaseIdentity = "3.2.0-dev.125"
-    static let releaseSetId = "mentra-3.2.0-dev.125"
-    static let sourceCommit = "5ae6d6bf777ef7343c4c7d16d6145404d619e2de"
-    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.125.json"
-    static let otaManifestSha256 = "78851cf939b81f514854ffec083a089c1f41616934decfc843971bdd8037d820"
+    static let releaseIdentity = "3.2.0-dev.136"
+    static let releaseSetId = "mentra-3.2.0-dev.136"
+    static let sourceCommit = "9d3e676966ad4633e1a4438a716f9c6601c5a24a"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.136.json"
+    static let otaManifestSha256 = "1d258b8f4c011ddc1f1eb1ab3c86d9b059da5ed5da1e5218d60875867e570134"
 }

package/ios/Source/audio/PcmStreamPlayer.swift

@@ -261,6 +261,17 @@ final class PcmStreamPlayer: @unchecked Sendable {
 
     private func installAudioSessionObservers() {
         let center = NotificationCenter.default
+        #if os(macOS)
+        observers.append(center.addObserver(
+            forName: .AVAudioEngineConfigurationChange, object: engine, queue: nil
+        ) { [weak self] _ in
+            self?.stateQueue.async {
+                // A device change invalidates scheduled buffers. Reject pending writes/close
+                // instead of leaving callers waiting for callbacks that cannot arrive.
+                self?.fail(PcmStreamError.native("Audio device changed; reopen the PCM stream"))
+            }
+        })
+        #else
         observers.append(
             center.addObserver(
                 forName: AVAudioSession.interruptionNotification,
@@ -294,6 +305,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
                 }
             }
         )
+        #endif
     }
 
     private func removeAudioSessionObservers() {
@@ -301,6 +313,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
         observers.removeAll()
     }
 
+    #if !os(macOS)
     private func handleInterruption(_ notification: Notification) {
         guard
             let raw = notification.userInfo?[AVAudioSessionInterruptionTypeKey] as? UInt,
@@ -321,6 +334,7 @@ final class PcmStreamPlayer: @unchecked Sendable {
             break
         }
     }
+    #endif
 }
 
 /// Process-wide registry matching the Android PCM stream bridge contract.

package/ios/Source/internal/BleTraceLogger.swift

@@ -1,6 +1,8 @@
 import Foundation
 import os.log
+#if canImport(UIKit)
 import UIKit
+#endif
 
 enum BleTraceLogger {
     private static let log = OSLog(subsystem: "com.mentra.bluetoothsdk", category: "MentraBleTrace")
@@ -66,9 +68,14 @@ enum BleTraceLogger {
             "event": event,
             "component": component,
             "pid": ProcessInfo.processInfo.processIdentifier,
-            "model": UIDevice.current.model,
-            "systemVersion": UIDevice.current.systemVersion,
         ]
+        #if os(macOS)
+        payload["model"] = "Mac"
+        payload["systemVersion"] = ProcessInfo.processInfo.operatingSystemVersionString
+        #else
+        payload["model"] = UIDevice.current.model
+        payload["systemVersion"] = UIDevice.current.systemVersion
+        #endif
         for (key, value) in extra {
             payload[key] = value
         }

package/ios/Source/internal/BluetoothSdkAnalytics.swift

@@ -8,7 +8,11 @@ public struct BluetoothSdkAnalyticsConfiguration {
 
     public init(enabled: Bool = true) {
         self.enabled = enabled
+        #if os(macOS)
+        surface = "macos"
+        #else
         surface = "ios"
+        #endif
     }
 
     var isReady: Bool {
@@ -141,14 +145,19 @@ final class BluetoothSdkAnalytics {
     }
 
     private func baseProperties(configuration: BluetoothSdkAnalyticsConfiguration) -> [String: Any] {
+        #if os(macOS)
+        let platform = "macos"
+        #else
+        let platform = "ios"
+        #endif
         var properties: [String: Any] = [
             "$process_person_profile": false,
             "event_source": "mentra_bluetooth_sdk",
-            "sdk_platform": "ios",
+            "sdk_platform": platform,
             "sdk_surface": configuration.surface,
             "app_identifier": Bundle.main.bundleIdentifier ?? "",
             "app_bundle_identifier": Bundle.main.bundleIdentifier ?? "",
-            "os_platform": "ios",
+            "os_platform": platform,
             "os_version": ProcessInfo.processInfo.operatingSystemVersionString,
         ]
         if let sdkVersion = BluetoothSdkDefaults.sdkVersion {

package/ios/Source/services/MacAudioDevices.swift

@@ -0,0 +1,96 @@
+#if os(macOS)
+    import CoreAudio
+    import Foundation
+
+    struct MacAudioDevice {
+        let id: AudioDeviceID
+        let name: String
+        let transport: UInt32
+        let hasInput: Bool
+
+        var isBluetooth: Bool {
+            transport == kAudioDeviceTransportTypeBluetooth || transport == kAudioDeviceTransportTypeBluetoothLE
+        }
+
+        static func input(for mode: String, devices: [MacAudioDevice], defaultInput: AudioDeviceID?) -> AudioDeviceID? {
+            let inputs = devices.filter(\.hasInput)
+            switch mode {
+            case MicTypes.PHONE_INTERNAL:
+                let builtIn = inputs.filter { $0.transport == kAudioDeviceTransportTypeBuiltIn }
+                return builtIn.first { $0.id == defaultInput }?.id ?? builtIn.map(\.id).min()
+            case MicTypes.BLUETOOTH, MicTypes.BLUETOOTH_CLASSIC:
+                // Respect the user's Sound settings; never pick an arbitrary nearby headset.
+                return inputs.first { $0.id == defaultInput && $0.isBluetooth }?.id
+            default:
+                return nil
+            }
+        }
+
+        static var available: [MacAudioDevice] {
+            var address = address(kAudioHardwarePropertyDevices)
+            var size: UInt32 = 0
+            guard AudioObjectGetPropertyDataSize(AudioObjectID(kAudioObjectSystemObject), &address, 0, nil, &size) == noErr
+            else { return [] }
+            var ids = [AudioDeviceID](repeating: 0, count: Int(size) / MemoryLayout<AudioDeviceID>.size)
+            guard AudioObjectGetPropertyData(AudioObjectID(kAudioObjectSystemObject), &address, 0, nil, &size, &ids) == noErr
+            else { return [] }
+            return ids.compactMap { id in
+                var nameAddress = self.address(kAudioObjectPropertyName)
+                var name: Unmanaged<CFString>?
+                var nameSize = UInt32(MemoryLayout<Unmanaged<CFString>?>.size)
+                guard AudioObjectGetPropertyData(id, &nameAddress, 0, nil, &nameSize, &name) == noErr
+                else { return nil }
+                guard let name = name?.takeRetainedValue() else { return nil }
+                var inputAddress = self.address(kAudioDevicePropertyStreams, scope: kAudioObjectPropertyScopeInput)
+                var inputSize: UInt32 = 0
+                let hasInput = AudioObjectGetPropertyDataSize(id, &inputAddress, 0, nil, &inputSize) == noErr && inputSize > 0
+                return MacAudioDevice(id: id, name: name as String,
+                                      transport: value(id, kAudioDevicePropertyTransportType) ?? 0, hasInput: hasInput)
+            }
+        }
+
+        static var defaultInput: AudioDeviceID? {
+            value(AudioObjectID(kAudioObjectSystemObject), kAudioHardwarePropertyDefaultInputDevice)
+        }
+
+        static var defaultOutput: AudioDeviceID? {
+            value(AudioObjectID(kAudioObjectSystemObject), kAudioHardwarePropertyDefaultOutputDevice)
+        }
+
+        static func value(_ object: AudioObjectID, _ selector: AudioObjectPropertySelector) -> UInt32? {
+            var address = address(selector)
+            var value: UInt32 = 0
+            var size = UInt32(MemoryLayout<UInt32>.size)
+            return AudioObjectGetPropertyData(object, &address, 0, nil, &size, &value) == noErr ? value : nil
+        }
+
+        static func address(_ selector: AudioObjectPropertySelector,
+                            scope: AudioObjectPropertyScope = kAudioObjectPropertyScopeGlobal) -> AudioObjectPropertyAddress
+        {
+            AudioObjectPropertyAddress(mSelector: selector, mScope: scope, mElement: kAudioObjectPropertyElementMain)
+        }
+    }
+
+    /// Observe route changes without selecting a system-wide audio device.
+    final class MacAudioRouteObserver {
+        private let listener: AudioObjectPropertyListenerBlock
+        private var selectors: [AudioObjectPropertySelector] = []
+
+        init(selectors: [AudioObjectPropertySelector], onChange: @escaping () -> Void) {
+            listener = { _, _ in onChange() }
+            for selector in selectors {
+                var address = MacAudioDevice.address(selector)
+                if AudioObjectAddPropertyListenerBlock(AudioObjectID(kAudioObjectSystemObject), &address, .main, listener) == noErr {
+                    self.selectors.append(selector)
+                }
+            }
+        }
+
+        deinit {
+            for selector in selectors {
+                var address = MacAudioDevice.address(selector)
+                AudioObjectRemovePropertyListenerBlock(AudioObjectID(kAudioObjectSystemObject), &address, .main, listener)
+            }
+        }
+    }
+#endif

package/ios/Source/services/MacPhoneMic.swift

@@ -0,0 +1,138 @@
+#if os(macOS)
+    import AudioUnit
+    import AVFoundation
+    import CoreAudio
+    import Foundation
+
+    @MainActor
+    final class PhoneMic {
+        static let shared = PhoneMic()
+        private var engine: AVAudioEngine?
+        private var configurationObserver: NSObjectProtocol?
+        private var routeObserver: MacAudioRouteObserver?
+        private var currentMode = ""
+        private var activeDevice: AudioDeviceID?
+        var isRecording: Bool {
+            engine?.isRunning == true
+        }
+
+        func checkPermissions() -> Bool {
+            AVCaptureDevice.authorizationStatus(for: .audio) == .authorized
+        }
+
+        func requestPermissions() async -> Bool {
+            checkPermissions()
+        }
+
+        func getAvailableInputDevices() -> [String: String] {
+            Dictionary(uniqueKeysWithValues: MacAudioDevice.available.filter(\.hasInput).map { (String($0.id), $0.name) })
+        }
+
+        func isRecordingWithMode(_ mode: String) -> Bool {
+            isRecording && currentMode == mode
+        }
+
+        func startMode(_ mode: String) -> Bool {
+            if isRecordingWithMode(mode) { return true }
+            guard !isRecording, checkPermissions() else { return false }
+            guard let device = MacAudioDevice.input(for: mode, devices: MacAudioDevice.available,
+                                                    defaultInput: MacAudioDevice.defaultInput) else { return false }
+            return start(device: device, mode: mode)
+        }
+
+        func startRecording() -> Bool {
+            startMode(MicTypes.PHONE_INTERNAL)
+        }
+
+        private func start(device: AudioDeviceID, mode: String) -> Bool {
+            let engine = AVAudioEngine()
+            let input = engine.inputNode
+            guard let unit = input.audioUnit else { return false }
+            var device = device
+            guard AudioUnitSetProperty(unit, kAudioOutputUnitProperty_CurrentDevice, kAudioUnitScope_Global,
+                                       0, &device, UInt32(MemoryLayout<AudioDeviceID>.size)) == noErr
+            else { return false }
+            let format = input.outputFormat(forBus: 0)
+            guard format.sampleRate > 0, format.channelCount > 0,
+                  let output = AVAudioFormat(commonFormat: .pcmFormatInt16, sampleRate: 16000, channels: 1, interleaved: false),
+                  let converter = AVAudioConverter(from: format, to: output)
+            else { return false }
+            input.installTap(onBus: 0, bufferSize: 1024, format: format) { [weak self, weak engine] buffer, _ in
+                let capacity = AVAudioFrameCount(ceil(Double(buffer.frameLength) * output.sampleRate / format.sampleRate))
+                guard let converted = AVAudioPCMBuffer(pcmFormat: output, frameCapacity: capacity) else { return }
+                var supplied = false
+                var error: NSError?
+                let result = converter.convert(to: converted, error: &error) { _, status in
+                    guard !supplied else { status.pointee = .noDataNow; return nil }
+                    supplied = true
+                    status.pointee = .haveData
+                    return buffer
+                }
+                guard result != .error, error == nil, converted.frameLength > 0,
+                      let samples = converted.int16ChannelData?[0] else { return }
+                let pcm = Data(bytes: samples, count: Int(converted.frameLength) * MemoryLayout<Int16>.size)
+                Task { @MainActor [weak self, weak engine] in
+                    guard let engine, self?.engine === engine else { return }
+                    DeviceManager.shared.handlePcm(pcm)
+                }
+            }
+            do {
+                try engine.start()
+            } catch {
+                input.removeTap(onBus: 0)
+                Bridge.log("MIC: macOS input failed: \(error.localizedDescription)")
+                return false
+            }
+            self.engine = engine
+            activeDevice = device
+            currentMode = mode
+            routeObserver = MacAudioRouteObserver(selectors: [kAudioHardwarePropertyDevices, kAudioHardwarePropertyDefaultInputDevice]) { [weak self, weak engine] in
+                Task { @MainActor in
+                    guard let self, let engine, self.engine === engine else { return }
+                    let desired = MacAudioDevice.input(for: self.currentMode, devices: MacAudioDevice.available,
+                                                       defaultInput: MacAudioDevice.defaultInput)
+                    guard desired != self.activeDevice else { return }
+                    self.stopRecording()
+                    DeviceManager.shared.updateMicState()
+                }
+            }
+            configurationObserver = NotificationCenter.default.addObserver(
+                forName: .AVAudioEngineConfigurationChange, object: engine, queue: .main
+            ) { [weak self, weak engine] _ in
+                Task { @MainActor in
+                    guard let engine, self?.engine === engine else { return }
+                    self?.stopRecording()
+                    DeviceManager.shared.updateMicState()
+                }
+            }
+            return true
+        }
+
+        func getActiveInputDevice() -> String? {
+            MacAudioDevice.available.first(where: { $0.id == activeDevice })?.name
+        }
+
+        func stopMode(_ mode: String) -> Bool {
+            guard currentMode == mode else { return false }
+            stopRecording()
+            return true
+        }
+
+        func stopRecording() {
+            routeObserver = nil
+            if let configurationObserver {
+                NotificationCenter.default.removeObserver(configurationObserver)
+            }
+            configurationObserver = nil
+            engine?.inputNode.removeTap(onBus: 0)
+            engine?.stop()
+            engine = nil
+            currentMode = ""
+            activeDevice = nil
+        }
+
+        func cleanup() {
+            stopRecording()
+        }
+    }
+#endif

package/ios/Source/services/PhoneMic.swift

@@ -5,6 +5,7 @@
 //  Created on 3/8/25.
 //
 
+#if !os(macOS)
 import AVFoundation
 import Combine
 import Foundation
@@ -661,3 +662,4 @@ class PhoneMic {
         stopRecording()
     }
 }
+#endif

package/ios/Source/sgcs/G1.swift

@@ -8,7 +8,7 @@
 import Combine
 import CoreBluetooth
 import Foundation
-import UIKit
+import CoreGraphics
 
 extension Data {
     func chunked(into size: Int) -> [Data] {
@@ -1822,7 +1822,7 @@ extension G1 {
     /// Mirrors G2.convertToG2Bmp() for local miniapp bitmap display support.
     /// G1 uses 1-bit monochrome BMP at 640x400 (576x135 active area).
     func convertToG1Bmp(_ imageData: Data, width: Int = 576, height: Int = 135) -> Data? {
-        guard let image = UIImage(data: imageData), let cgImage = image.cgImage else {
+        guard let image = SdkImage(data: imageData), let cgImage = image.cgImage else {
             Bridge.log("G1: convertToG1Bmp - could not decode image")
             return nil
         }

package/ios/Source/sgcs/G2.swift

@@ -9,7 +9,7 @@
 import Combine
 import CoreBluetooth
 import Foundation
-import UIKit
+import CoreGraphics
 
 /// Keep a low-rate, non-audio EvenHub sensor stream active so iOS continues receiving BLE
 /// notifications while the Mentra App is backgrounded. The samples stay internal unless IMU was
@@ -2565,7 +2565,7 @@ class G2: NSObject, SGCManager {
     /// (aspect-fit, centered on black) — the front half of `convertToG2Bmp`,
     /// exposed for the tiler which encodes per-tile BMPs from one render.
     private func renderG2Grayscale(_ data: Data, targetWidth: Int, targetHeight: Int) -> Data? {
-        guard let image = UIImage(data: data), let cgImage = image.cgImage else { return nil }
+        guard let image = SdkImage(data: data), let cgImage = image.cgImage else { return nil }
         let scale = min(
             Double(targetWidth) / Double(cgImage.width), Double(targetHeight) / Double(cgImage.height)
         )
@@ -3101,7 +3101,7 @@ class G2: NSObject, SGCManager {
     /// Scale source image to fit within containerWidth x containerHeight (maintaining aspect ratio),
     /// centered on a black background. Output BMP always matches container dimensions exactly.
     private func convertToG2Bmp(_ data: Data, containerWidth: Int, containerHeight: Int) -> Data? {
-        guard let image = UIImage(data: data), let cgImage = image.cgImage else {
+        guard let image = SdkImage(data: data), let cgImage = image.cgImage else {
             Bridge.log("G2: convertToG2Bmp - could not decode image")
             return nil
         }

package/ios/Source/sgcs/MentraLive.swift

@@ -16,7 +16,6 @@ import Combine
 import CoreBluetooth
 import Foundation
 import ImageIO
-import UIKit
 
 // MARK: - Supporting Types
 
@@ -355,11 +354,11 @@ class BlePhotoUploadService {
     }
 
     /**
-     * Decode image data (AVIF or JPEG) to UIImage.
+     * Decode image data (AVIF or JPEG).
      * AVIF arriving from glasses has a TIFF EXIF block appended to {@code mdat}; iOS ImageIO
      * rejects those bytes the same way Android does. Strip the Exif tail before decoding.
      */
-    private static func decodeImage(imageData: Data) -> UIImage? {
+    private static func decodeImage(imageData: Data) -> SdkImage? {
         let isAvif = isAvifData(imageData)
         var decodeData = imageData
         if isAvif && containsExifMarker(in: imageData) {
@@ -372,13 +371,13 @@ class BlePhotoUploadService {
             }
         }
 
-        if let image = UIImage(data: decodeData) {
+        if let image = SdkImage(data: decodeData) {
             return image
         }
 
         if isAvif {
-            if #available(iOS 16.0, *) {
-                return UIImage(data: decodeData)
+            if #available(iOS 16.0, macOS 13.0, *) {
+                return SdkImage(data: decodeData)
             } else {
                 Bridge.log("\(TAG): AVIF decoding not supported on iOS < 16")
                 return nil
@@ -1022,6 +1021,7 @@ extension MentraLive: CBCentralManagerDelegate {
         }
     }
 
+    #if !os(macOS)
     nonisolated func centralManager(
         _: CBCentralManager, didUpdateANCSAuthorizationFor peripheral: CBPeripheral
     ) {
@@ -1033,6 +1033,7 @@ extension MentraLive: CBCentralManagerDelegate {
             self.enableAncsRelayIfAuthorized()
         }
     }
+    #endif
 
     nonisolated func centralManager(
         _: CBCentralManager, didDisconnectPeripheral peripheral: CBPeripheral, error: Error?
@@ -2443,6 +2444,9 @@ class MentraLive: NSObject, SGCManager {
         // Set connection timeout
         startConnectionTimeout()
 
+        #if os(macOS)
+        centralManager?.connect(peripheral, options: nil)
+        #else
         // ANCS is hosted by iOS and is only exposed to authorized accessories.
         // Requiring it at connect time lets the system complete that authorization
         // flow before the glasses subscribe to the ANCS characteristics.
@@ -2450,12 +2454,14 @@ class MentraLive: NSObject, SGCManager {
             peripheral,
             options: [CBConnectPeripheralOptionRequiresANCS: true]
         )
+        #endif
     }
 
     /// Opt the firmware into ANCS only after iOS has authorized this accessory.
     /// Old firmware safely ignores the command, while new firmware stays inert
     /// for old mobile clients that never send it.
     private func enableAncsRelayIfAuthorized() {
+        #if !os(macOS)
         guard !ancsRelayEnableRequested,
               let peripheral = connectedPeripheral,
               txCharacteristic != nil,
@@ -2473,6 +2479,7 @@ class MentraLive: NSObject, SGCManager {
             ancsRelayEnableRequested = true
             Bridge.log("LIVE: Requested ANCS relay from compatible firmware")
         }
+        #endif
     }
 
     private func handleReconnection() {

package/ios/Source/sgcs/Nimo.swift

@@ -10,7 +10,7 @@ import AVFoundation
 import Compression
 import CoreBluetooth
 import Foundation
-import UIKit
+import CoreGraphics
 
 // MARK: - Nimo BLE Constants
 
@@ -846,7 +846,7 @@ class Nimo: NSObject, SGCManager {
         let targetHeight = NimoProtocol.NAV_LARGE_MAP_HEIGHT
         Bridge.log("NIMO: displayBitmap → nav large map (navAppEntered=\(navAppEntered))")
         guard let imageData = Data(base64Encoded: base64ImageData),
-              let image = UIImage(data: imageData)
+              let image = SdkImage(data: imageData)
         else {
             Bridge.log("NIMO: displayBitmap — could not decode image")
             return false
@@ -1640,7 +1640,7 @@ class Nimo: NSObject, SGCManager {
     // MARK: - Bitmap Helpers
 
     /// Aspect-fit the image into `width`x`height` on black, then convert to L8 grayscale.
-    private func bitmapToGrayscale(_ image: UIImage, width: Int, height: Int) -> Data? {
+    private func bitmapToGrayscale(_ image: SdkImage, width: Int, height: Int) -> Data? {
         guard let cgImage = image.cgImage else { return nil }
         let colorSpace = CGColorSpaceCreateDeviceGray()
         guard let context = CGContext(

package/ios/Source/utils/AudioSessionMonitor.swift

@@ -6,6 +6,7 @@
 //  Used to detect when Mentra Live glasses are paired/connected for audio
 //
 
+#if !os(macOS)
 import AVFoundation
 import Foundation
 import UIKit
@@ -281,3 +282,4 @@ class AudioSessionMonitor {
         }
     }
 }
+#endif

package/ios/Source/utils/JSCExperiment.swift

@@ -102,7 +102,7 @@ private func jlog(_ message: String) {
             ctx.name = "MentraJS: \(id)"
             // Inspectable in dev builds only. iOS 16.4+ guarded.
             #if DEBUG
-                if #available(iOS 16.4, *) {
+                if #available(iOS 16.4, macOS 13.3, *) {
                     ctx.isInspectable = true
                 }
             #endif

package/ios/Source/utils/MacAudioSessionMonitor.swift

@@ -0,0 +1,18 @@
+#if os(macOS)
+    import Foundation
+
+    enum AudioSessionMonitor {
+        static func isAudioDeviceConnected(devicePattern: String) -> Bool {
+            MacAudioDevice.available.contains {
+                $0.isBluetooth && $0.name.localizedCaseInsensitiveContains(devicePattern)
+            }
+        }
+
+        static func isOtherAudioDeviceConnected(devicePattern: String) -> Bool {
+            let output = MacAudioDevice.defaultOutput
+            return MacAudioDevice.available.contains {
+                $0.id == output && $0.isBluetooth && !$0.name.localizedCaseInsensitiveContains(devicePattern)
+            }
+        }
+    }
+#endif

package/ios/Source/utils/PhoneAudioMonitor.swift

@@ -50,9 +50,15 @@ class PhoneAudioMonitor {
 
     /// Check if any audio is currently playing on the device (including our own app)
     func isPlaying() -> Bool {
+        #if os(macOS)
+        // macOS has no AVAudioSession audio-focus contract. Explicit SDK playback
+        // is tracked; other applications retain independent system audio routes.
+        return ownAppAudioPlaying
+        #else
         let session = AVAudioSession.sharedInstance()
         // Combine: other apps playing OR our own app playing
         return session.isOtherAudioPlaying || ownAppAudioPlaying
+        #endif
     }
 
     func isOwnAppAudioPlaying() -> Bool {
@@ -88,6 +94,7 @@ class PhoneAudioMonitor {
             "PhoneAudioMonitor: Starting audio playback monitoring (initial state: \(lastKnownState ? "playing" : "not playing"))"
         )
 
+        #if !os(macOS)
         // Register for silenceSecondaryAudioHint notification
         // This is fired when other apps start/stop playing audio
         NotificationCenter.default.addObserver(
@@ -108,6 +115,7 @@ class PhoneAudioMonitor {
         // Start polling as a fallback mechanism
         // Some audio sources might not trigger notifications reliably
         startPolling()
+        #endif
     }
 
     /// Stop monitoring for phone audio playback changes
@@ -119,6 +127,7 @@ class PhoneAudioMonitor {
 
         Bridge.log("PhoneAudioMonitor: Stopping audio playback monitoring")
 
+        #if !os(macOS)
         NotificationCenter.default.removeObserver(
             self,
             name: AVAudioSession.silenceSecondaryAudioHintNotification,
@@ -132,11 +141,13 @@ class PhoneAudioMonitor {
         )
 
         stopPolling()
+        #endif
 
         listener = nil
         isMonitoring = false
     }
 
+    #if !os(macOS)
     /// Handle silenceSecondaryAudioHint notification
     @objc private func handleSilenceSecondaryAudioHint(_ notification: Notification) {
         guard let userInfo = notification.userInfo,
@@ -191,6 +202,8 @@ class PhoneAudioMonitor {
         }
     }
 
+    #endif
+
     /// Start polling isOtherAudioPlaying as a fallback mechanism
     private func startPolling() {
         pollingTimer = Timer.scheduledTimer(

package/ios/Source/utils/SdkImage.swift

@@ -0,0 +1,37 @@
+import Foundation
+import ImageIO
+import UniformTypeIdentifiers
+
+/// Decode upright pixels once, so bitmap rendering and JPEG encoding agree on both Apple platforms.
+struct SdkImage {
+    let cgImage: CGImage?
+    var size: CGSize {
+        CGSize(width: cgImage?.width ?? 0, height: cgImage?.height ?? 0)
+    }
+
+    init?(data: Data) {
+        guard let source = CGImageSourceCreateWithData(data as CFData, nil),
+              let properties = CGImageSourceCopyPropertiesAtIndex(source, 0, nil) as? [CFString: Any],
+              let width = properties[kCGImagePropertyPixelWidth] as? Int,
+              let height = properties[kCGImagePropertyPixelHeight] as? Int,
+              let image = CGImageSourceCreateThumbnailAtIndex(source, 0, [
+                  kCGImageSourceCreateThumbnailFromImageAlways: true,
+                  kCGImageSourceCreateThumbnailWithTransform: true,
+                  kCGImageSourceThumbnailMaxPixelSize: max(width, height),
+              ] as CFDictionary)
+        else { return nil }
+        cgImage = image
+    }
+
+    func jpegData(compressionQuality: CGFloat) -> Data? {
+        guard let cgImage else { return nil }
+        let data = NSMutableData()
+        guard let destination = CGImageDestinationCreateWithData(data, UTType.jpeg.identifier as CFString, 1, nil)
+        else { return nil }
+        CGImageDestinationAddImage(destination, cgImage, [
+            kCGImageDestinationLossyCompressionQuality: compressionQuality,
+            kCGImagePropertyOrientation: 1,
+        ] as CFDictionary)
+        return CGImageDestinationFinalize(destination) ? data as Data : nil
+    }
+}

package/ios/Tests/MacAudioDevicesTests.swift

@@ -0,0 +1,32 @@
+#if os(macOS)
+    import CoreAudio
+    @testable import MentraBluetoothSDK
+    import XCTest
+
+    final class MacAudioDevicesTests: XCTestCase {
+        private let devices = [
+            MacAudioDevice(id: 1, name: "Internal", transport: kAudioDeviceTransportTypeBuiltIn, hasInput: true),
+            MacAudioDevice(id: 2, name: "Headset A", transport: kAudioDeviceTransportTypeBluetooth, hasInput: true),
+            MacAudioDevice(id: 3, name: "Headset B", transport: kAudioDeviceTransportTypeBluetoothLE, hasInput: true),
+            MacAudioDevice(id: 4, name: "Speakers", transport: kAudioDeviceTransportTypeBluetooth, hasInput: false),
+        ]
+
+        func testBluetoothUsesSelectedInputRegardlessOfEnumerationOrder() {
+            for mode in [MicTypes.BLUETOOTH, MicTypes.BLUETOOTH_CLASSIC] {
+                for inputs in [devices, devices.reversed()] {
+                    XCTAssertEqual(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 3), 3)
+                    XCTAssertEqual(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 2), 2)
+                    XCTAssertNil(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 1))
+                    XCTAssertNil(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: 4))
+                    XCTAssertNil(MacAudioDevice.input(for: mode, devices: inputs, defaultInput: nil))
+                }
+            }
+        }
+
+        func testInternalModeNeverFallsBackToBluetooth() {
+            XCTAssertEqual(MacAudioDevice.input(for: MicTypes.PHONE_INTERNAL, devices: devices, defaultInput: 3), 1)
+            XCTAssertNil(MacAudioDevice.input(for: MicTypes.PHONE_INTERNAL, devices: Array(devices.dropFirst()), defaultInput: 3))
+            XCTAssertNil(MacAudioDevice.input(for: "invalid", devices: devices, defaultInput: 1))
+        }
+    }
+#endif

package/ios/Tests/SdkImageTests.swift

@@ -0,0 +1,53 @@
+import CoreGraphics
+import ImageIO
+@testable import MentraBluetoothSDK
+import UniformTypeIdentifiers
+import XCTest
+
+final class SdkImageTests: XCTestCase {
+    func testInvalidImageIsRejected() {
+        XCTAssertNil(SdkImage(data: Data("not an image".utf8)))
+    }
+
+    func testAllExifOrientationsProduceUprightPixelsAndJpegs() throws {
+        // Six asymmetric tiles distinguish rotations from reflections.
+        let pixels: [UInt8] = [10, 50, 90, 130, 170, 210]
+        let raster = (0 ..< 32).flatMap { y in (0 ..< 48).map { x in pixels[(y / 16) * 3 + x / 16] } }
+        let provider = try XCTUnwrap(CGDataProvider(data: Data(raster) as CFData))
+        let image = try XCTUnwrap(CGImage(width: 48, height: 32, bitsPerComponent: 8, bitsPerPixel: 8,
+                                          bytesPerRow: 48, space: CGColorSpaceCreateDeviceGray(), bitmapInfo: [],
+                                          provider: provider, decode: nil, shouldInterpolate: false, intent: .defaultIntent))
+        let expected: [[UInt8]] = [
+            [10, 50, 90, 130, 170, 210], [90, 50, 10, 210, 170, 130],
+            [210, 170, 130, 90, 50, 10], [130, 170, 210, 10, 50, 90],
+            [10, 130, 50, 170, 90, 210], [130, 10, 170, 50, 210, 90],
+            [210, 90, 170, 50, 130, 10], [90, 210, 50, 170, 10, 130],
+        ]
+        for orientation in 1 ... 8 {
+            let data = NSMutableData()
+            let destination = try XCTUnwrap(CGImageDestinationCreateWithData(data, UTType.tiff.identifier as CFString, 1, nil))
+            CGImageDestinationAddImage(destination, image, [kCGImagePropertyOrientation: orientation] as CFDictionary)
+            XCTAssertTrue(CGImageDestinationFinalize(destination))
+
+            let decoded = try XCTUnwrap(SdkImage(data: data as Data))
+            let width = orientation < 5 ? 48 : 32
+            let height = orientation < 5 ? 32 : 48
+            XCTAssertEqual(decoded.size, CGSize(width: width, height: height))
+            let context = try XCTUnwrap(CGContext(data: nil, width: width, height: height, bitsPerComponent: 8,
+                                                  bytesPerRow: width, space: CGColorSpaceCreateDeviceGray(), bitmapInfo: 0))
+            try context.draw(XCTUnwrap(decoded.cgImage), in: CGRect(x: 0, y: 0, width: width, height: height))
+            let bytes = try XCTUnwrap(context.data).assumingMemoryBound(to: UInt8.self)
+            let actual = stride(from: 8, to: height, by: 16).flatMap { y in
+                stride(from: 8, to: width, by: 16).map { x in bytes[y * context.bytesPerRow + x] }
+            }
+            XCTAssertEqual(actual, expected[orientation - 1], "EXIF \(orientation)")
+
+            let jpeg = try XCTUnwrap(decoded.jpegData(compressionQuality: 1))
+            let source = try XCTUnwrap(CGImageSourceCreateWithData(jpeg as CFData, nil))
+            let properties = try XCTUnwrap(CGImageSourceCopyPropertiesAtIndex(source, 0, nil) as? [CFString: Any])
+            XCTAssertEqual(CGImageSourceGetType(source), UTType.jpeg.identifier as CFString)
+            XCTAssertEqual(properties[kCGImagePropertyOrientation] as? Int ?? 1, 1)
+            XCTAssertEqual(try XCTUnwrap(SdkImage(data: jpeg)).size, decoded.size)
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.2.0-dev.125",
+  "version": "3.2.0-dev.136",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface BluetoothSdkReleaseMetadata {
 export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.2.0",
-  "releaseIdentity": "3.2.0-dev.125",
-  "releaseSetId": "mentra-3.2.0-dev.125",
-  "sourceCommit": "5ae6d6bf777ef7343c4c7d16d6145404d619e2de",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.125.json",
-  "otaManifestSha256": "78851cf939b81f514854ffec083a089c1f41616934decfc843971bdd8037d820"
+  "releaseIdentity": "3.2.0-dev.136",
+  "releaseSetId": "mentra-3.2.0-dev.136",
+  "sourceCommit": "9d3e676966ad4633e1a4438a716f9c6601c5a24a",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.136.json",
+  "otaManifestSha256": "1d258b8f4c011ddc1f1eb1ab3c86d9b059da5ed5da1e5218d60875867e570134"
 })