@mentra/bluetooth-sdk 0.1.11 → 0.1.13

package/ios/Source/internal/BluetoothSdkAnalytics.swift

@@ -0,0 +1,160 @@
+import Foundation
+
+public struct BluetoothSdkAnalyticsConfiguration {
+    public static let disabled = BluetoothSdkAnalyticsConfiguration(enabled: false)
+
+    public let enabled: Bool
+    let surface: String
+
+    public init(enabled: Bool = true) {
+        self.enabled = enabled
+        surface = "ios"
+    }
+
+    var isReady: Bool {
+        enabled
+    }
+
+    func withSurface(_ surface: String) -> BluetoothSdkAnalyticsConfiguration {
+        BluetoothSdkAnalyticsConfiguration(
+            enabled: enabled,
+            surface: surface
+        )
+    }
+
+    private init(
+        enabled: Bool,
+        surface: String
+    ) {
+        self.enabled = enabled
+        self.surface = surface
+    }
+}
+
+final class BluetoothSdkAnalytics {
+    private static let defaultPostHogApiKey = "phc_FCweXVAxVgU7wZK4Fk3okOx4RmyNqVHJf62YpZSfJt5"
+    private static let defaultPostHogHost = "https://us.i.posthog.com"
+    private let stateQueue = DispatchQueue(label: "com.mentra.bluetoothsdk.analytics.state")
+    private let transportQueue = DispatchQueue(label: "com.mentra.bluetoothsdk.analytics.transport")
+    private let configuration: BluetoothSdkAnalyticsConfiguration
+    private var startedCaptured = false
+    private var lastConnected = false
+
+    init(configuration: BluetoothSdkAnalyticsConfiguration) {
+        self.configuration = configuration.resolvedForApp()
+    }
+
+    func initializeGlassesStatus(_ status: GlassesStatus) {
+        stateQueue.sync {
+            lastConnected = status.analyticsConnected
+        }
+    }
+
+    func captureStarted() {
+        stateQueue.sync {
+            captureStartedLocked()
+        }
+    }
+
+    private func captureStartedLocked() {
+        guard !startedCaptured, configuration.isReady else { return }
+        startedCaptured = true
+        capture(
+            event: "bluetooth_sdk_started",
+            properties: ["event_kind": "sdk_started"],
+            configuration: configuration
+        )
+    }
+
+    func observeGlassesStatus(_ status: GlassesStatus) {
+        stateQueue.sync {
+            let isConnected = status.analyticsConnected
+            let wasConnected = lastConnected
+            lastConnected = isConnected
+            guard configuration.isReady else { return }
+            if isConnected, !wasConnected {
+                var properties: [String: Any] = [
+                    "event_kind": "glasses_connected",
+                    "fully_booted": status.fullyBooted,
+                ]
+                if !status.deviceModel.isEmpty {
+                    properties["glasses_model"] = status.deviceModel
+                }
+                capture(event: "bluetooth_sdk_glasses_connected", properties: properties, configuration: configuration)
+            }
+        }
+    }
+
+    private func capture(
+        event: String,
+        properties: [String: Any],
+        configuration activeConfiguration: BluetoothSdkAnalyticsConfiguration
+    ) {
+        guard activeConfiguration.isReady else { return }
+
+        transportQueue.async {
+            let payload: [String: Any] = [
+                "api_key": Self.defaultPostHogApiKey,
+                "event": event,
+                "distinct_id": self.distinctId(),
+                "properties": self.baseProperties(configuration: activeConfiguration).merging(properties) { _, new in new },
+            ]
+            guard let body = try? JSONSerialization.data(withJSONObject: payload) else { return }
+            guard let captureURL = self.captureURL() else { return }
+            var request = URLRequest(url: captureURL)
+            request.httpMethod = "POST"
+            request.timeoutInterval = 4
+            request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+            request.httpBody = body
+            URLSession.shared.dataTask(with: request).resume()
+        }
+    }
+
+    private func baseProperties(configuration: BluetoothSdkAnalyticsConfiguration) -> [String: Any] {
+        var properties: [String: Any] = [
+            "$process_person_profile": false,
+            "event_source": "mentra_bluetooth_sdk",
+            "sdk_platform": "ios",
+            "sdk_surface": configuration.surface,
+            "app_bundle_identifier": Bundle.main.bundleIdentifier ?? "",
+            "os_platform": "ios",
+            "os_version": ProcessInfo.processInfo.operatingSystemVersionString,
+        ]
+        if let sdkVersion = BluetoothSdkDefaults.sdkVersion {
+            properties["sdk_version"] = sdkVersion
+        }
+        return properties
+    }
+
+    private func distinctId() -> String {
+        let key = "mentra_bluetooth_sdk_analytics_distinct_id"
+        if let existing = UserDefaults.standard.string(forKey: key), !existing.isEmpty {
+            return existing
+        }
+        let generated = "mentra-bt-sdk-\(UUID().uuidString)"
+        UserDefaults.standard.set(generated, forKey: key)
+        return generated
+    }
+
+    private func captureURL() -> URL? {
+        let normalized = Self.defaultPostHogHost.trimmingCharacters(in: .whitespacesAndNewlines).trimmingCharacters(in: CharacterSet(charactersIn: "/"))
+        return URL(string: "\(normalized)/i/v0/e/")
+    }
+}
+
+private extension GlassesStatus {
+    var analyticsConnected: Bool {
+        connectionState.isConnected || connected || fullyBooted
+    }
+}
+
+private extension BluetoothSdkAnalyticsConfiguration {
+    func resolvedForApp() -> BluetoothSdkAnalyticsConfiguration {
+        let disabledByApp = Bundle.main.object(forInfoDictionaryKey: "MentraBluetoothSdkAnalyticsDisabled") as? Bool == true
+
+        return BluetoothSdkAnalyticsConfiguration(
+            enabled: enabled && !disabledByApp,
+            surface: surface
+        )
+    }
+}

package/ios/Source/sgcs/G1.swift

@@ -276,10 +276,7 @@ class G1: NSObject, SGCManager {
 
     func sendButtonMaxRecordingTime(_: Int) {}
 
-    func requestPhoto(
-        _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, save _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?
-    ) {}
+    func requestPhoto(_: PhotoRequest) {}
 
     func startStream(_: [String: Any]) {}
 
@@ -317,7 +314,7 @@ class G1: NSObject, SGCManager {
 
     func queryGalleryStatus() {}
 
-    func sendOtaStart() {}
+    func sendOtaStart(otaVersionUrl: String?) {}
     func sendOtaQueryStatus() {}
 
     func ping() {}
@@ -786,6 +783,10 @@ class G1: NSObject, SGCManager {
         //    }
     }
 
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
+
     func sendTextWall(_ text: String) async {
         let chunks = textHelper.createTextWallChunks(text)
         queueChunks(chunks, sleepAfterMs: 10)

package/ios/Source/sgcs/G2.swift

@@ -1534,7 +1534,6 @@ class G2: NSObject, SGCManager {
     /// Fixed pool of container IDs the page protocol expects.
     private let imageContainerIDPool: [Int32] = [10, 11, 12, 13]
     private let textContainerIDPool: [Int32] = [1, 2, 3, 4, 5, 6]
-    /// Default container seeded into every fresh page: 100x100 in the top-left.
     private static let defaultImgContainer = (
         x: Int32(188), y: Int32(44), width: Int32(200), height: Int32(100)
     )
@@ -1927,7 +1926,7 @@ class G2: NSObject, SGCManager {
     // MARK: - SGCManager: Display Control
 
     func sendTextWall(_ text: String) async {
-        await sendText(
+        await sendTextAt(
             text,
             x: G2.defaultTextContainer.x,
             y: G2.defaultTextContainer.y,
@@ -1940,7 +1939,13 @@ class G2: NSObject, SGCManager {
         )
     }
 
-    func sendText(
+    // Protocol witness for SGCManager.sendText — G2 renders a simple string as a
+    // default-positioned text wall. The positioned variant is `sendTextAt`.
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
+
+    func sendTextAt(
         _ text: String, x: Int32? = nil, y: Int32? = nil, width: Int32? = nil, height: Int32? = nil,
         borderWidth: Int32? = nil, borderColor: Int32? = nil, borderRadius: Int32? = nil,
         paddingLength: Int32? = nil
@@ -1983,7 +1988,7 @@ class G2: NSObject, SGCManager {
             let msg = EvenHubProto.updateTextMessage(
                 containerID: container.id,
                 contentOffset: 0,
-                contentLength: Int32(text.utf8.count),
+                contentLength: Int32(container.content.utf8.count),
                 content: container.content
             )
             queueEvenHubCommand(msg)
@@ -2011,10 +2016,10 @@ class G2: NSObject, SGCManager {
         // Don't shutdown the EvenHub page — that kills audio streaming too.
         // Instead, just clear the text content by sending a space.
 
-        if !pageCreated {
-            Bridge.log("G2: clearDisplay() - page not created")
-            createPageWithContainers()
-        }
+        // if !pageCreated {
+        //     Bridge.log("G2: clearDisplay() - page not created")
+        //     createPageWithContainers()
+        // }
 
         // reset the content of all text containers to empty:
         for i in textContainers.indices {
@@ -2024,10 +2029,7 @@ class G2: NSObject, SGCManager {
             imageContainers[i].bmpData = Data()
         }
         // shutdown the page and then recreate the containers without the content:
-        let msg = EvenHubProto.shutdownMessage()
-        sendEvenHubCommand(msg)
-        createPageWithContainers()
-        restartMicIfAlreadyEnabled()
+        Task { await rebuildPage() }
     }
 
     /// Send BMP data to an image container via fragmented updateImageRawData
@@ -2207,6 +2209,9 @@ class G2: NSObject, SGCManager {
         //     )
         //     sendEvenHubCommand(msg)
         // }
+        
+        try? await Task.sleep(nanoseconds: 300_000_000)  // 300ms to settle
+        restartMicIfAlreadyEnabled()
     }
 
     /// Upscale BMP pixel data by 2x (200x100 → 400x200) using nearest-neighbor
@@ -2766,6 +2771,7 @@ class G2: NSObject, SGCManager {
     func disconnect() {
         Bridge.log("G2: disconnect()")
         isDisconnecting = true
+        clearDisplay()
         cancelPairingTimeout()
         stopHeartbeats()
         Task { await reconnectionManager.stop() }
@@ -3140,11 +3146,7 @@ class G2: NSObject, SGCManager {
 
     // MARK: - SGCManager: Camera & Media (not supported on G2)
 
-    func requestPhoto(
-        _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, save _: Bool, sound _: Bool, exposureTimeNs _: Double?,
-        iso _: Int?
-    ) {}
+    func requestPhoto(_: PhotoRequest) {}
     func startVideoRecording(requestId _: String, save _: Bool, flash _: Bool, sound _: Bool) {}
     func startStream(_: [String: Any]) {}
     func stopStream() {}
@@ -3163,7 +3165,7 @@ class G2: NSObject, SGCManager {
     func sendWifiCredentials(_: String, _: String) {}
     func forgetWifiNetwork(_: String) {}
     func sendHotspotState(_: Bool) {}
-    func sendOtaStart() {}
+    func sendOtaStart(otaVersionUrl: String?) {}
     func sendOtaQueryStatus() {}
 
     // MARK: - SGCManager: User Context

package/ios/Source/sgcs/Mach1.swift

@@ -15,10 +15,7 @@ import UltraliteSDK
 class Mach1: UltraliteBaseViewController, SGCManager {
     func sendIncidentId(_: String, apiBaseUrl _: String?) {}
 
-    func requestPhoto(
-        _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, save _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?
-    ) {}
+    func requestPhoto(_: PhotoRequest) {}
 
     func sendGalleryMode() {}
 
@@ -26,7 +23,7 @@ class Mach1: UltraliteBaseViewController, SGCManager {
 
     var connectionState: String = ConnTypes.DISCONNECTED
 
-    func sendOtaStart() {}
+    func sendOtaStart(otaVersionUrl: String?) {}
     func sendOtaQueryStatus() {}
 
     func sendJson(_: [String: Any], wakeUp _: Bool, requireAck _: Bool) {}
@@ -325,6 +322,10 @@ class Mach1: UltraliteBaseViewController, SGCManager {
         UltraliteManager.shared.stopScan()
     }
 
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
+
     func sendTextWall(_ text: String) async {
         //    displayTextWall(text)
         guard let device = UltraliteManager.shared.currentDevice else {

package/ios/Source/sgcs/MentraLive.swift

@@ -1234,6 +1234,9 @@ class MentraLive: NSObject, SGCManager {
     func getBatteryStatus() {}
     func setBrightness(_: Int, autoMode _: Bool) {}
     func clearDisplay() {}
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
     func sendTextWall(_: String) async {}
     func ping() {
         Bridge.log("LIVE: ping()")
@@ -1611,18 +1614,15 @@ class MentraLive: NSObject, SGCManager {
         }
     }
 
-    func requestPhoto(
-        _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, save: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
-    ) {
+    func requestPhoto(_ request: PhotoRequest) {
         Bridge.log(
-            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(requestId) appId=\(appId) flash=\(flash) save=\(save) sound=\(sound) iso=\(iso.map { String($0) } ?? "auto")"
+            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(request.requestId) appId=\(request.appId) flash=\(request.flash) save=\(request.save) sound=\(request.sound) iso=\(request.iso.map { String($0) } ?? "auto") aeDivisor=\(request.aeExposureDivisor.map { String($0) } ?? "nil")"
         )
 
         var json: [String: Any] = [
             "type": "take_photo",
-            "requestId": requestId,
-            "appId": appId,
+            "requestId": request.requestId,
+            "appId": request.appId,
         ]
 
         // Always generate BLE ID for potential fallback
@@ -1631,15 +1631,15 @@ class MentraLive: NSObject, SGCManager {
         json["bleImgId"] = bleImgId
         json["transferMethod"] = "auto"
 
-        if let webhookUrl, !webhookUrl.isEmpty {
+        if let webhookUrl = request.webhookUrl, !webhookUrl.isEmpty {
             json["webhookUrl"] = webhookUrl
 
             var transfer = BlePhotoTransfer(
-                bleImgId: bleImgId, requestId: requestId, webhookUrl: webhookUrl
+                bleImgId: bleImgId, requestId: request.requestId, webhookUrl: webhookUrl
             )
 
             // Store authToken for BLE transfer if provided
-            if let authToken, !authToken.isEmpty {
+            if let authToken = request.authToken, !authToken.isEmpty {
                 transfer.authToken = authToken
             }
 
@@ -1647,32 +1647,28 @@ class MentraLive: NSObject, SGCManager {
         }
 
         // Add authToken to JSON if provided
-        if let authToken, !authToken.isEmpty {
+        if let authToken = request.authToken, !authToken.isEmpty {
             json["authToken"] = authToken
         }
 
-        // propagate size (default to medium if invalid)
-        if let size, ["small", "medium", "large", "full"].contains(size) {
-            json["size"] = size
-        } else {
-            json["size"] = "medium"
-        }
-
-        // Add compress parameter
-        json["compress"] = compress ?? "none"
+        let allowedSizes = ["low", "medium", "high", "max"]
+        let size = request.size.rawValue
+        json["size"] = allowedSizes.contains(size) ? size : "medium"
 
-        json["flash"] = flash
-        json["save"] = save
-        json["sound"] = sound
+        json["compress"] = request.compress?.rawValue ?? "none"
+        json["flash"] = request.flash
+        json["save"] = request.save
+        json["sound"] = request.sound
 
-        if let e = exposureTimeNs, e.isFinite, e > 0, e <= Double(Int64.max) {
-            Bridge.log("LIVE: Using manual exposure time for photo request \(requestId): \(Int64(e)) ns")
+        if let e = request.exposureTimeNs, e.isFinite, e > 0, e <= Double(Int64.max) {
+            Bridge.log("LIVE: Using manual exposure time for photo request \(request.requestId): \(Int64(e)) ns")
             json["exposureTimeNs"] = Int64(e)
         }
-        if let iso, iso > 0 {
-            Bridge.log("LIVE: Using manual ISO for photo request \(requestId): ISO \(iso)")
+        if let iso = request.iso, iso > 0 {
+            Bridge.log("LIVE: Using manual ISO for photo request \(request.requestId): ISO \(iso)")
             json["iso"] = iso
         }
+        request.appendScanFields(to: &json)
 
         Bridge.log("LIVE: PHOTO PIPELINE [5b/6] take_photo JSON ready bleImgId=\(bleImgId) transferMethod=auto")
         Bridge.log("LIVE: PHOTO PIPELINE [6/6] Dispatching take_photo to sendJson()")
@@ -2171,6 +2167,9 @@ class MentraLive: NSObject, SGCManager {
         case "video_recording_status":
             emitVideoRecordingStatus(json)
 
+        case "media_success", "media_error":
+            Bridge.sendMediaUploadEvent(type: type, values: json)
+
         case "photo_status":
             emitPhotoStatus(json)
 
@@ -2880,13 +2879,17 @@ class MentraLive: NSObject, SGCManager {
     /// Send OTA start command to glasses.
     /// Called when user approves an update (onboarding or background mode).
     /// Triggers glasses to begin download and installation.
-    func sendOtaStart() {
+    func sendOtaStart(otaVersionUrl: String?) {
         Bridge.log("LIVE: 📱 Sending ota_start command to glasses")
 
-        let json: [String: Any] = [
+        var json: [String: Any] = [
             "type": "ota_start",
             "timestamp": Int(Date().timeIntervalSince1970 * 1000),
         ]
+        if let otaVersionUrl = otaVersionUrl?.trimmingCharacters(in: .whitespacesAndNewlines),
+           !otaVersionUrl.isEmpty {
+            json["ota_version_url"] = otaVersionUrl
+        }
 
         sendJson(json, wakeUp: true)
     }
@@ -5194,12 +5197,73 @@ extension MentraLive {
     }
 
     func sendButtonPhotoSettings() {
-        let size = DeviceStore.shared.get("bluetooth", "button_photo_size") as! String
-        sendButtonPhotoSettings(requestId: nil, size: size)
+        let size = DeviceStore.shared.get("bluetooth", "button_photo_size") as? String
+        let mfnr = DeviceStore.shared.get("bluetooth", "button_photo_mfnr") as? Bool
+        let zsl = DeviceStore.shared.get("bluetooth", "button_photo_zsl") as? Bool
+        let noiseReduction = DeviceStore.shared.get("bluetooth", "button_photo_noise_reduction") as? Bool
+        let edgeEnhancement = DeviceStore.shared.get("bluetooth", "button_photo_edge_enhancement") as? Bool
+        let ispDigitalGain = DeviceStore.shared.get("bluetooth", "button_photo_isp_digital_gain") as? Int
+        let ispAnalogGain = DeviceStore.shared.get("bluetooth", "button_photo_isp_analog_gain") as? String
+        let aeExposureDivisor = DeviceStore.shared.get("bluetooth", "button_photo_ae_exposure_divisor") as? Int
+        let isoCap = DeviceStore.shared.get("bluetooth", "button_photo_iso_cap") as? Int
+        let compressStr = DeviceStore.shared.get("bluetooth", "button_photo_compress") as? String
+        let sound = DeviceStore.shared.get("bluetooth", "button_photo_sound") as? Bool
+
+        let settings = ButtonPhotoSettings(
+            size: ButtonPhotoSize(normalizedRawValue: size ?? "medium"),
+            mfnr: mfnr,
+            zsl: zsl,
+            noiseReduction: noiseReduction,
+            edgeEnhancement: edgeEnhancement,
+            ispDigitalGain: ispDigitalGain,
+            ispAnalogGain: ispAnalogGain,
+            aeExposureDivisor: aeExposureDivisor,
+            isoCap: isoCap,
+            compress: compressStr,
+            sound: sound,
+            resetCaptureTuning: false
+        )
+
+        sendButtonPhotoSettings(requestId: nil, settings: settings)
     }
 
     func sendButtonPhotoSettings(requestId: String?, size: String) {
-        Bridge.log("Sending button photo setting: \(size)")
+        sendButtonPhotoSettings(requestId: requestId, settings: ButtonPhotoSettings(size: ButtonPhotoSize(normalizedRawValue: size)))
+    }
+
+    func sendButtonPhotoSettings(requestId: String?, settings: ButtonPhotoSettings) {
+        var details = settings.size.map { "size=\($0.rawValue)" } ?? "size=unchanged"
+        if let mfnr = settings.mfnr {
+            details += ", mfnr=\(mfnr)"
+        }
+        if let zsl = settings.zsl {
+            details += ", zsl=\(zsl)"
+        }
+        if let noiseReduction = settings.noiseReduction {
+            details += ", noiseReduction=\(noiseReduction)"
+        }
+        if let edgeEnhancement = settings.edgeEnhancement {
+            details += ", edgeEnhancement=\(edgeEnhancement)"
+        }
+        if let ispDigitalGain = settings.ispDigitalGain {
+            details += ", ispDigitalGain=\(ispDigitalGain)"
+        }
+        if let ispAnalogGain = settings.ispAnalogGain {
+            details += ", ispAnalogGain=\(ispAnalogGain)"
+        }
+        if let aeExposureDivisor = settings.aeExposureDivisor {
+            details += ", aeExposureDivisor=\(aeExposureDivisor)"
+        }
+        if let isoCap = settings.isoCap {
+            details += ", isoCap=\(isoCap)"
+        }
+        if let compress = settings.compress {
+            details += ", compress=\(compress)"
+        }
+        if let sound = settings.sound {
+            details += ", sound=\(sound)"
+        }
+        Bridge.log("Sending button photo setting: \(details)")
 
         guard connectionState == ConnTypes.CONNECTED else {
             Bridge.log("Cannot send button photo settings - not connected")
@@ -5208,11 +5272,46 @@ extension MentraLive {
 
         var json: [String: Any] = [
             "type": "button_photo_setting",
-            "size": size,
         ]
+        if let size = settings.size {
+            json["size"] = size.rawValue
+        }
         if let requestId, !requestId.isEmpty {
             json["request_id"] = requestId
         }
+        if let mfnr = settings.mfnr {
+            json["mfnr"] = mfnr
+        }
+        if let zsl = settings.zsl {
+            json["zsl"] = zsl
+        }
+        if let noiseReduction = settings.noiseReduction {
+            json["noiseReduction"] = noiseReduction
+        }
+        if let edgeEnhancement = settings.edgeEnhancement {
+            json["edgeEnhancement"] = edgeEnhancement
+        }
+        if let ispDigitalGain = settings.ispDigitalGain {
+            json["ispDigitalGain"] = ispDigitalGain
+        }
+        if let ispAnalogGain = settings.ispAnalogGain, !ispAnalogGain.isEmpty {
+            json["ispAnalogGain"] = ispAnalogGain
+        }
+        if let aeExposureDivisor = settings.aeExposureDivisor, aeExposureDivisor > 1 {
+            json["aeExposureDivisor"] = aeExposureDivisor
+        }
+        if let isoCap = settings.isoCap, isoCap > 0 {
+            json["isoCap"] = isoCap
+        }
+        if let compress = settings.compress, !compress.isEmpty {
+            json["compress"] = compress
+        }
+        if let sound = settings.sound {
+            json["sound"] = sound
+        }
+        if settings.resetCaptureTuning == true {
+            json["resetCaptureTuning"] = true
+        }
         sendJson(json, wakeUp: true)
     }
 
@@ -5269,7 +5368,8 @@ extension MentraLive {
 
     func startVideoRecording(requestId: String, save: Bool, flash: Bool, sound: Bool) {
         startVideoRecording(
-            requestId: requestId, save: save, flash: flash, sound: sound, width: 0, height: 0, fps: 0
+            requestId: requestId, save: save, flash: flash, sound: sound, width: 0, height: 0, fps: 0,
+            maxRecordingTimeMinutes: 0
         )
     }
 
@@ -5280,10 +5380,11 @@ extension MentraLive {
     }
 
     func startVideoRecording(
-        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int
+        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int,
+        maxRecordingTimeMinutes: Int
     ) {
         Bridge.log(
-            "Starting video recording on glasses: requestId=\(requestId), save=\(save), flash=\(flash), sound=\(sound), resolution=\(width)x\(height)@\(fps)fps"
+            "Starting video recording on glasses: requestId=\(requestId), save=\(save), flash=\(flash), sound=\(sound), resolution=\(width)x\(height)@\(fps)fps, maxRecordingTimeMinutes=\(maxRecordingTimeMinutes)"
         )
 
         guard connectionState == ConnTypes.CONNECTED else {
@@ -5299,6 +5400,11 @@ extension MentraLive {
             "sound": sound,
         ]
 
+        // Auto-stop timer; only sent when set (> 0). 0 = record until stopped.
+        if maxRecordingTimeMinutes > 0 {
+            json["maxRecordingTimeMinutes"] = maxRecordingTimeMinutes
+        }
+
         // Add video settings when any field is overridden. Each field is sent
         // only when > 0; the glasses merge the missing fields onto their saved
         // button-video defaults, so a partial override (e.g. fps-only) still
@@ -5314,17 +5420,31 @@ extension MentraLive {
     }
 
     func stopVideoRecording(requestId: String) {
-        Bridge.log("Stopping video recording on glasses: requestId=\(requestId)")
+        stopVideoRecording(requestId: requestId, webhookUrl: nil, authToken: nil)
+    }
+
+    func stopVideoRecording(requestId: String, webhookUrl: String?, authToken: String?) {
+        Bridge.log(
+            "Stopping video recording on glasses: requestId=\(requestId), webhook=\((webhookUrl?.isEmpty ?? true) ? "none" : "set")"
+        )
 
         guard connectionState == ConnTypes.CONNECTED else {
             Bridge.log("Cannot stop video recording - not connected")
             return
         }
 
-        let json: [String: Any] = [
+        var json: [String: Any] = [
             "type": "stop_video_recording",
             "requestId": requestId,
         ]
+        // Webhook upload target, supplied at stop so the token is fresh.
+        // Only sent when present; empty webhook = keep video on device.
+        if let webhookUrl, !webhookUrl.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+            json["webhookUrl"] = webhookUrl
+        }
+        if let authToken, !authToken.isEmpty {
+            json["authToken"] = authToken
+        }
         sendJson(json)
     }
 }

package/ios/Source/sgcs/MentraNex.swift

@@ -51,10 +51,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         }
     }
 
-    func requestPhoto(
-        _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, save _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?
-    ) {}
+    func requestPhoto(_: PhotoRequest) {}
 
     func startStream(_: [String: Any]) {}
 
@@ -81,6 +78,10 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         updateGlassesAutoBrightness(autoMode)
     }
 
+    func sendText(_ text: String) async {
+        await sendTextWall(text)
+    }
+
     func sendDoubleTextWall(_ top: String, _ bottom: String) async {
         await sendTextWall("\(top)\n\(bottom)")
     }
@@ -178,7 +179,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
     func sendHotspotState(_: Bool) {}
 
-    func sendOtaStart() {}
+    func sendOtaStart(otaVersionUrl: String?) {}
     func sendOtaQueryStatus() {}
 
     func sendUserEmailToGlasses(_: String) {}