@mentra/bluetooth-sdk 3.2.0-dev.203 → 3.2.0-dev.206

package/ios/Source/streaming/StreamModels.swift

@@ -629,6 +629,10 @@ public enum StreamStatus: CustomStringConvertible, Equatable {
 public struct StreamStatusEvent: CustomStringConvertible {
     public let status: StreamStatus
     public let stats: StreamLiveStats?
+    public private(set) var processSessionId: String?
+    public private(set) var revision: Int?
+    public private(set) var terminal: Bool?
+    public private(set) var errorDetails: String?
     /// True when the glasses will retry the failed publisher themselves
     /// (emitting side lands in PR #3488); absent on older firmware and on
     /// events not parsed from a glasses status map. Carried here instead of
@@ -644,6 +648,10 @@ public struct StreamStatusEvent: CustomStringConvertible {
         status = StreamStatus(values: values)
         stats = StreamLiveStats(values: values["stats"] as? [String: Any])
         willRetry = boolValue(values, "willRetry")
+        processSessionId = stringValue(values, "sid")
+        revision = optionalIntValue(values, "revision")
+        terminal = boolValue(values, "terminal")
+        errorDetails = stringValue(values, "errorDetails")
     }
 
     public var state: StreamState {
@@ -661,6 +669,10 @@ public struct StreamStatusEvent: CustomStringConvertible {
     public var values: [String: Any] {
         var values = status.values
         values["type"] = "stream_status"
+        if let processSessionId { values["sid"] = processSessionId }
+        if let revision { values["revision"] = revision }
+        if let terminal { values["terminal"] = terminal }
+        if let errorDetails { values["errorDetails"] = errorDetails }
         if let stats {
             values["stats"] = stats.values
         }

package/ios/Source/streaming/StreamSessionState.swift

@@ -0,0 +1,29 @@
+import Foundation
+
+/// Observes glasses-owned streaming; delivery gaps never imply publisher failure.
+final class StreamSessionState {
+    private(set) var processSessionId: String?
+    private(set) var currentStreamId: String?
+    private(set) var supported = false
+    private var revision: Int = -1
+
+    func ready(sessionId: String?, controlVersion: Int?) {
+        supported = controlVersion == 1 && !(sessionId ?? "").isEmpty
+        if processSessionId != sessionId {
+            currentStreamId = nil
+            revision = -1
+        }
+        processSessionId = sessionId
+    }
+
+    func accept(_ values: [String: Any]) -> Bool {
+        guard supported,
+              let sid = values["sid"] as? String, sid == processSessionId,
+              let incomingRevision = values["revision"] as? Int,
+              incomingRevision >= revision
+        else { return false }
+        revision = incomingRevision
+        currentStreamId = values["terminal"] as? Bool == true ? nil : values["streamId"] as? String
+        return true
+    }
+}

package/ios/Tests/StreamControllerProbeTests.swift

@@ -0,0 +1,27 @@
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class StreamControllerProbeTests: XCTestCase {
+    private func probe() -> [String: Any] {
+        ["protocolVersion": 1, "controllerId": StreamControllerProbe.controllerId,
+         "streamId": "stream", "probeId": "nonce"]
+    }
+
+    func testAnswersCurrentProcessChallengeWithoutJsOrTimer() {
+        let response = StreamControllerProbe.response(probe())
+        XCTAssertEqual(response?["type"] as? String, "stream_controller_response")
+        XCTAssertEqual(response?["probeId"] as? String, "nonce")
+        XCTAssertEqual(response?["streamId"] as? String, "stream")
+    }
+
+    func testRejectsPreviousProcessAndMalformedChallenges() {
+        for (key, value) in [("controllerId", "previous-process" as Any),
+                             ("protocolVersion", 2), ("protocolVersion", true),
+                             ("probeId", ""), ("streamId", "")]
+        {
+            var input = probe()
+            input[key] = value
+            XCTAssertNil(StreamControllerProbe.response(input))
+        }
+    }
+}

package/ios/Tests/StreamSessionStateTests.swift

@@ -0,0 +1,38 @@
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class StreamSessionStateTests: XCTestCase {
+    func testReadinessRequiresKnownProtocolAndProcessIdentity() {
+        let state = StreamSessionState()
+        state.ready(sessionId: "asg", controlVersion: nil)
+        XCTAssertFalse(state.supported)
+        state.ready(sessionId: "asg", controlVersion: 2)
+        XCTAssertFalse(state.supported)
+        state.ready(sessionId: "", controlVersion: 1)
+        XCTAssertFalse(state.supported)
+        state.ready(sessionId: "asg", controlVersion: 1)
+        XCTAssertTrue(state.supported)
+    }
+
+    func testReconnectionReconcilesTerminalStateWithoutHeartbeatTimeouts() {
+        let state = StreamSessionState()
+        state.ready(sessionId: "asg", controlVersion: 1)
+        XCTAssertTrue(state.accept(["sid": "asg", "revision": 1, "streamId": "stream", "terminal": false]))
+        state.ready(sessionId: "asg", controlVersion: 1)
+        XCTAssertEqual(state.currentStreamId, "stream")
+        XCTAssertTrue(state.accept(["sid": "asg", "revision": 3, "streamId": "stream", "terminal": true]))
+        XCTAssertNil(state.currentStreamId)
+        XCTAssertFalse(state.accept(["sid": "asg", "revision": 2, "streamId": "stream", "terminal": false]))
+        XCTAssertNil(state.currentStreamId)
+    }
+
+    func testProcessRestartRejectsOldStatusAndAcceptsNewStoppedSnapshot() {
+        let state = StreamSessionState()
+        state.ready(sessionId: "old", controlVersion: 1)
+        XCTAssertTrue(state.accept(["sid": "old", "revision": 8, "streamId": "stream", "terminal": false]))
+        state.ready(sessionId: "new", controlVersion: 1)
+        XCTAssertFalse(state.accept(["sid": "old", "revision": 9, "streamId": "stream", "terminal": false]))
+        XCTAssertTrue(state.accept(["sid": "new", "revision": 0, "terminal": true]))
+        XCTAssertNil(state.currentStreamId)
+    }
+}

package/package.json

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

package/src/BluetoothSdk.types.ts

@@ -864,6 +864,11 @@ export type StreamLiveStats = {
 type StreamStatusCommon = {
   type: "stream_status"
   streamId?: string
+  /** ASG process identity and monotonic revision for reconnect reconciliation. */
+  sid?: string
+  revision?: number
+  terminal?: boolean
+  errorDetails?: string
   timestamp?: number
   resolvedConfig?: StreamResolvedConfig
   stats?: StreamLiveStats
@@ -898,7 +903,7 @@ export type StreamStatusEvent =
     })
   | (StreamStatusCommon & {
       kind: "snapshot"
-      status: "streaming" | "reconnecting" | "stopped"
+      status: StreamStatusState
       streaming: boolean
       reconnecting: boolean
       attempt?: number

package/src/_private/BluetoothSdkModule.ts

@@ -46,7 +46,6 @@ import {
   ScanModelOptions,
   ScanOptions,
   SettingsAckSuccessEvent,
-  StreamKeepAliveRequest,
   StreamStartRequest,
   StreamStatusEvent,
   VideoRecordingStartedStatusEvent,
@@ -205,9 +204,7 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
 
   // Stream Commands
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
-  startExternallyManagedStream(params: StreamStartRequest): Promise<StreamStatusEvent>
   stopStream(): Promise<StreamStatusEvent>
-  sendExternallyManagedStreamKeepAlive(params: StreamKeepAliveRequest): Promise<void>
 
   // Microphone Commands
   setMicState(enabled: boolean, useGlassesMic?: boolean, sendTranscript?: boolean, sendLc3Data?: boolean): Promise<void>

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.203",
-  "releaseSetId": "mentra-3.2.0-dev.203",
-  "sourceCommit": "7eb4deefff27d498c2b4562d628607f399aa1f40",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.203.json",
-  "otaManifestSha256": "0ae026238c8e70970be4e181cc1ae73dd905418292edebddb610012f4f0a9b6f"
+  "releaseIdentity": "3.2.0-dev.206",
+  "releaseSetId": "mentra-3.2.0-dev.206",
+  "sourceCommit": "3c22b92a5a53ce608c087503417ca5b3d16cc926",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.206.json",
+  "otaManifestSha256": "7bc5e09f2757b2c11da58c93459bb0a554f406dd0ae5b50b58db28b64b92c838"
 })