@glassly/bluetooth-sdk 0.1.0-dev.99 → 0.2.8-dev.445

package/ios/Source/sgcs/MentraNex.swift

@@ -129,8 +129,8 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         canvasElements.firstIndex(where: { $0.key == key })
     }
 
-    private func sendCanvasCommand(_ configure: (inout Glassly_Ble_PhoneToGlasses) -> Void) {
-        var msg = Glassly_Ble_PhoneToGlasses()
+    private func sendCanvasCommand(_ configure: (inout NexPhoneToGlasses) -> Void) {
+        var msg = NexPhoneToGlasses()
         configure(&msg)
         guard let data = try? msg.serializedData() else { return }
         queueDataWithOptimalChunking(data, packetType: PACKET_TYPE_PROTOBUF, waitTimeMs: 10)
@@ -735,7 +735,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         guard packetData.count > 1 else { return }
         let payload = packetData.subdata(in: 1 ..< packetData.count)
         let commandName: String
-        if let phoneToGlasses = try? Glassly_Ble_PhoneToGlasses(serializedData: payload) {
+        if let phoneToGlasses = try? NexPhoneToGlasses(serializedData: payload) {
             commandName = String(describing: phoneToGlasses.payload)
         } else {
             commandName = "UNKNOWN"
@@ -1257,7 +1257,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         // during continuous speech) and each Bridge.log costs the JS thread.
         // Bridge.log("NEX: Displaying text wall: '\(sanitizedText)'")
 
-        let displayText = Glassly_Ble_DisplayText.with {
+        let displayText = NexDisplayText.with {
             $0.text = sanitizedText
             $0.size = 48
             $0.x = 20
@@ -1265,7 +1265,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
             $0.color = 10000
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.displayText = displayText
         }
 
@@ -1354,7 +1354,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
         Bridge.log("NEX: Displaying scrolling text: '\(text)'")
 
-        let displayScrollingText = Glassly_Ble_DisplayScrollingText.with {
+        let displayScrollingText = NexDisplayScrollingText.with {
             $0.text = text
             $0.size = 48
             $0.x = 20
@@ -1368,7 +1368,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
             $0.lineSpacing = 2
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.displayScrollingText = displayScrollingText
         }
 
@@ -1412,7 +1412,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         let totalChunks = Int(ceil(Double(bmpData.count) / Double(bmpChunkSize)))
 
         // Send display image command first
-        let displayImage = Glassly_Ble_DisplayImage.with {
+        let displayImage = NexDisplayImage.with {
             $0.streamID = streamId
             $0.totalChunks = UInt32(totalChunks)
             $0.x = 0
@@ -1422,7 +1422,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
             $0.encoding = "raw"
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.msgID = "img_start_1"
             $0.displayImage = displayImage
         }
@@ -1615,7 +1615,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         if !canvasElements.isEmpty || currentLayoutId != nil {
             canvasElements.removeAll()
             currentLayoutId = nil
-            sendCanvasCommand { $0.canvasClear = Glassly_Ble_CanvasClear() }
+            sendCanvasCommand { $0.canvasClear = NexCanvasClear() }
         }
 
         // Drop any pending/resendable text wall so a stale caption can't
@@ -1626,9 +1626,9 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         textWallResendsRemaining = 0
         textWallLock.unlock()
 
-        let clearDisplay = Glassly_Ble_ClearDisplay()
+        let clearDisplay = NexClearDisplay()
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.msgID = "clear_disp_001"
             $0.clearDisplay_p = clearDisplay
         }
@@ -1675,11 +1675,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         }
         Bridge.log("NEX: Setting brightness to wire value \(validBrightness)")
 
-        let brightnessConfig = Glassly_Ble_BrightnessConfig.with {
+        let brightnessConfig = NexBrightnessConfig.with {
             $0.value = UInt32(validBrightness)
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.brightness = brightnessConfig
         }
 
@@ -1695,11 +1695,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
         Bridge.log("NEX: Setting auto brightness to \(enabled)")
 
-        let autoBrightnessConfig = Glassly_Ble_AutoBrightnessConfig.with {
+        let autoBrightnessConfig = NexAutoBrightnessConfig.with {
             $0.enabled = enabled
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.autoBrightness = autoBrightnessConfig
         }
 
@@ -1717,11 +1717,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         let validAngle = max(0, min(60, angle))
         Bridge.log("NEX: Setting head-up angle to \(validAngle) degrees")
 
-        let headUpAngleConfig = Glassly_Ble_HeadUpAngleConfig.with {
+        let headUpAngleConfig = NexHeadUpAngleConfig.with {
             $0.angle = UInt32(validAngle)
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.headUpAngle = headUpAngleConfig
         }
 
@@ -1739,11 +1739,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         let validHeight = max(0, min(8, height))
         Bridge.log("NEX: Setting display height to \(validHeight)")
 
-        let displayHeightConfig = Glassly_Ble_DisplayHeightConfig.with {
+        let displayHeightConfig = NexDisplayHeightConfig.with {
             $0.height = UInt32(validHeight)
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.displayHeight = displayHeightConfig
         }
 
@@ -1760,11 +1760,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         let tier = NexDashboardDisplayWire.depthToWireTier(depth)
         Bridge.log("NEX: Setting display distance tier \(tier) in distance_cm field (dashboard depth \(depth))")
 
-        let displayDistanceConfig = Glassly_Ble_DisplayDistanceConfig.with {
+        let displayDistanceConfig = NexDisplayDistanceConfig.with {
             $0.distanceCm = tier
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.displayDistance = displayDistanceConfig
         }
 
@@ -1782,11 +1782,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
             return
         }
 
-        let vadConfig = Glassly_Ble_VadEnabledConfig.with {
+        let vadConfig = NexVadEnabledConfig.with {
             $0.enabled = enabled
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.vadEnabled = vadConfig
         }
 
@@ -1806,11 +1806,11 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
         Bridge.log("NEX: Setting microphone enabled: \(enabled)")
 
-        let micStateConfig = Glassly_Ble_MicStateConfig.with {
+        let micStateConfig = NexMicStateConfig.with {
             $0.enabled = enabled
         }
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.micState = micStateConfig
         }
 
@@ -1844,9 +1844,9 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
         Bridge.log("NEX: Querying battery status")
 
-        let batteryStateRequest = Glassly_Ble_BatteryStateRequest()
+        let batteryStateRequest = NexBatteryStateRequest()
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.batteryState = batteryStateRequest
         }
 
@@ -1862,9 +1862,9 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
         Bridge.log("NEX: Querying glasses information")
 
-        let glassesInfoRequest = Glassly_Ble_GlassesInfoRequest()
+        let glassesInfoRequest = NexGlassesInfoRequest()
 
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
+        let phoneToGlasses = NexPhoneToGlasses.with {
             $0.glassesInfo = glassesInfoRequest
         }
 
@@ -1978,7 +1978,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
     private func processProtobufData(_ protobufData: Data) {
         do {
-            let glassesToPhone = try Glassly_Ble_GlassesToPhone(serializedData: protobufData)
+            let glassesToPhone = try NexGlassesToPhone(serializedData: protobufData)
             // No per-message log: String(describing: payload) stringifies the whole
             // protobuf and every Bridge.log costs the JS thread.
             // Bridge.log("NEX: Processing protobuf payload case: \(glassesToPhone.payload)")
@@ -2067,7 +2067,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
     // MARK: - Protobuf Event Handlers
 
-    private func handleBatteryStatusProtobuf(_ batteryStatus: Glassly_Ble_BatteryStatus) {
+    private func handleBatteryStatusProtobuf(_ batteryStatus: NexBatteryStatus) {
         let level = Int(batteryStatus.level)
         let isCharging = batteryStatus.charging
 
@@ -2078,7 +2078,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         DeviceStore.shared.apply("glasses", "charging", isCharging)
     }
 
-    private func handleChargingStateProtobuf(_ chargingState: Glassly_Ble_ChargingState) {
+    private func handleChargingStateProtobuf(_ chargingState: NexChargingState) {
         let chargingState = chargingState.state == .charging
 
         Bridge.log("NEX: 🔌 Charging State: \(chargingState ? "CHARGING" : "NOT_CHARGING")")
@@ -2087,7 +2087,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         DeviceStore.shared.apply("glasses", "charging", chargingState)
     }
 
-    private func handleDeviceInfoProtobuf(_ deviceInfo: Glassly_Ble_DeviceInfo) {
+    private func handleDeviceInfoProtobuf(_ deviceInfo: NexDeviceInfo) {
         Bridge.log("NEX: 📱 Device Info: \(deviceInfo)")
 
         // Update @Published properties (G1-compatible approach)
@@ -2095,7 +2095,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         DeviceStore.shared.apply("glasses", "deviceHardwareModel", deviceInfo.hwModel)
     }
 
-    private func handleHeadPositionProtobuf(_ headPosition: Glassly_Ble_HeadPosition) {
+    private func handleHeadPositionProtobuf(_ headPosition: NexHeadPosition) {
         let angle = Int(headPosition.angle)
 
         Bridge.log("NEX: 📐 Head Position - Angle: \(angle)°")
@@ -2104,7 +2104,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         headUpAngle = angle
     }
 
-    private func handleHeadUpAngleResponseProtobuf(_ response: Glassly_Ble_HeadUpAngleResponse) {
+    private func handleHeadUpAngleResponseProtobuf(_ response: NexHeadUpAngleResponse) {
         let success = response.success
 
         Bridge.log("NEX: 📐 Head Up Angle Set Response - Success: \(success)")
@@ -2119,7 +2119,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         emitEvent("HeadUpAngleResponseEvent", body: eventBody)
     }
 
-    private func handleVadEventProtobuf(_ vadEvent: Glassly_Ble_VadEvent) {
+    private func handleVadEventProtobuf(_ vadEvent: NexVadEvent) {
         let vadActiveState = vadEvent.state == .active
 
         Bridge.log("NEX: 🎤 VAD Event - Voice Activity: \(vadActiveState)")
@@ -2130,7 +2130,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
     }
 
     private func handleImageTransferCompleteProtobuf(
-        _ transferComplete: Glassly_Ble_ImageTransferComplete
+        _ transferComplete: NexImageTransferComplete
     ) {
         let status = transferComplete.status
         let missingChunks = transferComplete.missingChunks
@@ -2178,7 +2178,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         }
     }
 
-    private func handleImuDataProtobuf(_ imuData: Glassly_Ble_ImuData) {
+    private func handleImuDataProtobuf(_ imuData: NexImuData) {
         Bridge.log("NEX: 📊 IMU Data: \(imuData)")
 
         // Update @Published properties (G1-compatible approach)
@@ -2187,7 +2187,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         magnetometer = [imuData.mag.x, imuData.mag.y, imuData.mag.z]
     }
 
-    private func handleButtonEventProtobuf(_ buttonEvent: Glassly_Ble_ButtonEvent) {
+    private func handleButtonEventProtobuf(_ buttonEvent: NexButtonEvent) {
         let buttonNumber = Int(buttonEvent.button.rawValue)
         let buttonState = buttonEvent.state
 
@@ -2198,7 +2198,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         lastButtonState = "\(buttonState.rawValue)"
     }
 
-    private func handleHeadGestureProtobuf(_ headGesture: Glassly_Ble_HeadGesture) {
+    private func handleHeadGestureProtobuf(_ headGesture: NexHeadGesture) {
         let gestureType = headGesture.gesture
 
         Bridge.log("NEX: 👤 Head Gesture: \(gestureType)")
@@ -2450,7 +2450,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
         let eventBody: [String: Any] = [
             "protobuf_schema_version": [
                 "schema_version": 1, // Default version
-                "build_info": "Schema v1 | glassly_ble.proto",
+                "build_info": "Schema v1 | nex_ble.proto",
                 "device_model": "Mentra Display",
             ],
         ]
@@ -2487,8 +2487,8 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
     }
 
     private func sendDisconnectRequest() {
-        let phoneToGlasses = Glassly_Ble_PhoneToGlasses.with {
-            $0.disconnect = Glassly_Ble_DisconnectRequest()
+        let phoneToGlasses = NexPhoneToGlasses.with {
+            $0.disconnect = NexDisconnectRequest()
         }
         guard let protobufData = try? phoneToGlasses.serializedData() else {
             Bridge.log("NEX: ⚠️ Failed to serialize DisconnectRequest")

package/ios/Source/sgcs/SGCManager.swift

@@ -5,7 +5,7 @@ import Foundation
 /// against the previous frame sent to this device.
 struct SceneElement: Sendable {
     let id: String
-    let type: String // "text" | "rect" | "image"
+    let type: String // "text" | "rect" | "image" | "circle" | "arc" | "pie" | "line" | "triangle" | "quad" | "bezier"
     let x: Int32
     let y: Int32
     let w: Int32
@@ -20,11 +20,35 @@ struct SceneElement: Sendable {
     /// height (grid text); anything else is the default proportional face.
     let font: String
     let fontSize: Int32
+    /// Shapes: solid fill instead of an outline.
+    let fill: Bool
+    /// Gray level 0..15, or -1 for the default (brightest).
+    let color: Int32
+    /// Point shapes: x0, y0, x1, y1, … in canvas pixels.
+    let points: [Int32]
+    let startDeg: Int32
+    let endDeg: Int32
+    /// Transition duration in ms (0 = none) and easing name.
+    let transitionMs: Int32
+    let easing: String
+    let path: [UInt8]
+    let pathScale: Int32
+    let fillRule: Int32
+    let rotationQ8: Int32
+    let pivotX: Int32?
+    let pivotY: Int32?
+    /// Stereo disparity in canvas px: drawn at x+depth on the left lens and
+    /// x-depth on the right, so positive values float in front of the frame.
+    let depth: Int32
 
     init(
         id: String, type: String, x: Int32, y: Int32, w: Int32, h: Int32, text: String?, data: String?,
         border: Int32, radius: Int32, change: String, contentHash: String,
-        font: String = "default", fontSize: Int32 = 0
+        font: String = "default", fontSize: Int32 = 0,
+        fill: Bool = false, color: Int32 = -1, points: [Int32] = [], startDeg: Int32 = 0, endDeg: Int32 = 0,
+        transitionMs: Int32 = 0, easing: String = "ease",
+        path: [UInt8] = [], pathScale: Int32 = 256, fillRule: Int32 = 0,
+        rotationQ8: Int32 = 0, pivotX: Int32? = nil, pivotY: Int32? = nil, depth: Int32 = 0
     ) {
         self.id = id
         self.type = type
@@ -40,15 +64,45 @@ struct SceneElement: Sendable {
         self.contentHash = contentHash
         self.font = font
         self.fontSize = fontSize
+        self.fill = fill
+        self.color = color
+        self.points = points
+        self.startDeg = startDeg
+        self.endDeg = endDeg
+        self.transitionMs = transitionMs
+        self.easing = easing
+        self.path = path
+        self.pathScale = pathScale
+        self.fillRule = fillRule
+        self.rotationQ8 = rotationQ8
+        self.pivotX = pivotX
+        self.pivotY = pivotY
+        self.depth = depth
     }
 
     func with(change: String) -> SceneElement {
         SceneElement(
             id: id, type: type, x: x, y: y, w: w, h: h, text: text, data: data,
             border: border, radius: radius, change: change, contentHash: contentHash,
-            font: font, fontSize: fontSize
+            font: font, fontSize: fontSize, fill: fill, color: color, points: points,
+            startDeg: startDeg, endDeg: endDeg, transitionMs: transitionMs, easing: easing,
+            path: path, pathScale: pathScale, fillRule: fillRule, rotationQ8: rotationQ8, pivotX: pivotX, pivotY: pivotY,
+            depth: depth
         )
     }
+
+    /// The same element placed at the canvas origin (for standalone rasterization).
+    func atOrigin() -> SceneElement {
+        SceneElement(
+            id: id, type: type, x: 0, y: 0, w: w, h: h, text: text, data: data,
+            border: border, radius: radius, change: change, contentHash: contentHash,
+            font: font, fontSize: fontSize, fill: fill, color: color, points: points,
+            startDeg: startDeg, endDeg: endDeg, transitionMs: transitionMs, easing: easing,
+            path: path, pathScale: pathScale, fillRule: fillRule, rotationQ8: rotationQ8, pivotX: pivotX, pivotY: pivotY,
+            depth: depth
+        )
+    }
+
 }
 
 /// A whole scene from the host pipeline — the full frame plus per-element
@@ -67,11 +121,15 @@ struct SceneFrame: Sendable {
     let removed: [String]
     let canvasWidth: Int32
     let canvasHeight: Int32
+    /// Host frame number, reported back in `scene_frame_presented` once the
+    /// device has the frame. 0 = native-originated (legacy sugar), never reported.
+    let seq: Int
 
     init(
         appId: String, epoch: Int, replay: Bool, elements: [SceneElement], removed: [String],
         canvasWidth: Int32 = SceneFrame.defaultCanvasWidth,
-        canvasHeight: Int32 = SceneFrame.defaultCanvasHeight
+        canvasHeight: Int32 = SceneFrame.defaultCanvasHeight,
+        seq: Int = 0
     ) {
         self.appId = appId
         self.epoch = epoch
@@ -80,15 +138,35 @@ struct SceneFrame: Sendable {
         self.removed = removed
         self.canvasWidth = canvasWidth > 0 ? canvasWidth : SceneFrame.defaultCanvasWidth
         self.canvasHeight = canvasHeight > 0 ? canvasHeight : SceneFrame.defaultCanvasHeight
+        self.seq = seq
     }
 
     func asReplay() -> SceneFrame {
         SceneFrame(
             appId: appId, epoch: epoch, replay: true,
             elements: elements.map { $0.with(change: "created") }, removed: removed,
-            canvasWidth: canvasWidth, canvasHeight: canvasHeight
+            canvasWidth: canvasWidth, canvasHeight: canvasHeight, seq: seq
         )
     }
+
+    /// Tell the host this frame's content is on the glasses (or why it isn't).
+    func reportPresented(_ presented: Bool, reason: String? = nil) {
+        presentTag?.report(presented, reason: reason)
+    }
+
+    /// What a queued transfer must report once it lands; nil for native-originated frames.
+    var presentTag: PresentTag? {
+        seq > 0 ? PresentTag(seq: seq, appId: appId) : nil
+    }
+
+    struct PresentTag: Sendable {
+        let seq: Int
+        let appId: String
+
+        func report(_ presented: Bool, reason: String? = nil) {
+            Bridge.sendSceneFramePresented(seq: seq, appId: appId, presented: presented, reason: reason)
+        }
+    }
 }
 
 @MainActor
@@ -187,6 +265,9 @@ protocol SGCManager {
     /// True while the glasses' own modal nav UI owns the display — DeviceManager
     /// suppresses normal display traffic until exit.
     var navigationModeActive: Bool { get }
+    /// True when the driver renders scenes itself with link-driven last-wins
+    /// coalescing; DeviceManager then skips the display pacer.
+    var supportsCfwSceneRendering: Bool { get }
     func enterNavigationMode()
     /// `arrived` shows the device's "navigation complete" screen before exiting.
     func exitNavigationMode(arrived: Bool)
@@ -208,6 +289,9 @@ protocol SGCManager {
     /// Live cfw_scene_renderer switch (only the G2 CFW has one): swap the
     /// on-glass surface between the CFW carrier and a blank stock page.
     func cfwSceneRendererToggled(_ enabled: Bool) async
+    /// Live cfw_fast_ble switch (G2 Glassly CFW revision 26+): ask the lenses
+    /// for the 7.5 ms fast connection profile, or return them to stock.
+    func cfwFastBleToggled(_ enabled: Bool) async
 
     // MARK: - Dashboard Menu
 
@@ -221,12 +305,13 @@ protocol SGCManager {
 
     func sendCalendarEvents(_ events: [[String: Any]])
 
-    // MARK: - Phone Notifications (on-glass ANCS display options + app filter)
+    // MARK: - Phone Notifications
 
-    /// Push NotificationControl from the DeviceStore `notification_ctrl` dict.
-    func sendNotificationCtrl()
-    /// Push the ANCS app allowlist from the DeviceStore `notification_filter` dict.
-    func sendNotificationFilter()
+    /// Apply glasses-neutral notification behaviour to the connected firmware.
+    func setGlassesNotificationConfig(_ config: GlassesNotificationConfig) throws
+    func glassesNotificationStatus() -> GlassesNotificationStatus
+    /// Hand one notification to glasses that present content themselves.
+    func uploadPhoneNotification(_ upload: PhoneNotificationUpload) throws
 
     // MARK: - Dashboard Display Settings
 
@@ -262,6 +347,8 @@ protocol SGCManager {
     func ping()
     func dbg1()
     func dbg2()
+    func dbg3()
+    func dbg4()
 
     // MARK: - Network Management
 
@@ -310,6 +397,10 @@ extension SGCManager {
     /// Default: no-op. Only G2 distinguishes stock from Glassly CFW firmware.
     func awaitFirmwareClassification() async {}
 
+    /// Default: no-op debug hooks; only G2 wires them.
+    func dbg3() {}
+    func dbg4() {}
+
     /// Default: no-op. Only G2 renders positioned text containers; other glasses ignore it.
     func sendPositionedText(
         _: String, x _: Int32, y _: Int32, width _: Int32, height _: Int32,
@@ -404,6 +495,8 @@ extension SGCManager {
         for id in frame.removed where !paintedIds.contains(id) {
             await removeLayoutElement(id, layoutId: frame.appId)
         }
+        // No device ack on this path: the awaited verbs above cover the sends.
+        frame.reportPresented(true)
     }
 
     // MARK: - Video recording (default: ignore custom settings, use saved defaults)
@@ -437,6 +530,12 @@ extension SGCManager {
 
     func cfwSceneRendererToggled(_: Bool) async {}
 
+    func cfwFastBleToggled(_: Bool) async {}
+
+    var supportsCfwSceneRendering: Bool {
+        false
+    }
+
     // MARK: - Native navigation defaults (only G2 has a glasses-side nav UI)
 
     var navigationModeActive: Bool {
@@ -476,11 +575,19 @@ extension SGCManager {
 
     func sendCalendarEvents(_: [[String: Any]]) {}
 
-    // MARK: - Phone Notifications (default no-op — only G2 filters ANCS on-glass)
+    // MARK: - Phone Notifications (default unsupported — only G2 has a notification surface)
 
-    func sendNotificationCtrl() {}
+    func setGlassesNotificationConfig(_: GlassesNotificationConfig) throws {
+        throw GlassesNotificationError.unsupported
+    }
 
-    func sendNotificationFilter() {}
+    func glassesNotificationStatus() -> GlassesNotificationStatus {
+        .unsupported
+    }
+
+    func uploadPhoneNotification(_: PhoneNotificationUpload) throws {
+        throw GlassesNotificationError.unsupported
+    }
 
     // MARK: - Dashboard Display Settings (default no-op — only G2 supports this)