@mentra/bluetooth-sdk 0.1.21-beta.3 → 3.1.0-dev.10

package/scripts/verify-release-package.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import {readFileSync} from "node:fs"
+import path from "node:path"
+
+function option(name) {
+  const index = process.argv.indexOf(`--${name}`)
+  if (index < 0 || !process.argv[index + 1]) throw new Error(`Missing --${name}`)
+  return process.argv[index + 1]
+}
+
+const packageRoot = path.resolve(option("package-root"))
+const releaseIdentity = option("release-identity")
+const otaManifestUrl = option("ota-manifest-url")
+const otaManifestSha256 = option("ota-manifest-sha256")
+const packageJson = JSON.parse(readFileSync(path.join(packageRoot, "package.json"), "utf8"))
+if (packageJson.version !== releaseIdentity) {
+  throw new Error(`Packed SDK version ${JSON.stringify(packageJson.version)} does not match ${releaseIdentity}`)
+}
+
+const files = [
+  "src/generated/releaseMetadata.ts",
+  "build/generated/releaseMetadata.js",
+  "android/src/main/java/com/mentra/bluetoothsdk/GeneratedReleaseMetadata.kt",
+  "ios/Source/GeneratedReleaseMetadata.swift",
+]
+for (const relativePath of files) {
+  const contents = readFileSync(path.join(packageRoot, relativePath), "utf8")
+  if (!contents.includes(otaManifestUrl)) throw new Error(`${relativePath} does not contain the OTA manifest URL`)
+  if (!contents.includes(otaManifestSha256))
+    throw new Error(`${relativePath} does not contain the OTA manifest SHA-256`)
+  if (!contents.includes(releaseIdentity)) throw new Error(`${relativePath} does not contain the release identity`)
+}
+
+console.log(`Verified packed Bluetooth SDK ${releaseIdentity} metadata across JavaScript, Android, and iOS`)

package/scripts/write-release-metadata.mjs

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+import {mkdirSync, writeFileSync} from "node:fs"
+import path from "node:path"
+import {fileURLToPath} from "node:url"
+
+const STABLE_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/
+const RELEASE_IDENTITY_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(?:dev|beta)\.[1-9]\d*)?$/
+const COMMIT_PATTERN = /^[0-9a-f]{40}$/
+const SHA256_PATTERN = /^[0-9a-f]{64}$/
+
+function validateHttpsUrl(value) {
+  let url
+  try {
+    url = new URL(value)
+  } catch {
+    throw new Error(`OTA manifest URL is invalid: ${JSON.stringify(value)}`)
+  }
+  if (url.protocol !== "https:" || url.username || url.password || url.hash) {
+    throw new Error("OTA manifest URL must be credential-free HTTPS without a fragment")
+  }
+  return url.toString()
+}
+
+export function validateReleaseMetadata(input) {
+  if (!STABLE_VERSION_PATTERN.test(input.familyBaseVersion)) {
+    throw new Error("familyBaseVersion must be a plain X.Y.Z version")
+  }
+  if (!RELEASE_IDENTITY_PATTERN.test(input.releaseIdentity)) {
+    throw new Error("releaseIdentity must be X.Y.Z, X.Y.Z-dev.N, or X.Y.Z-beta.N")
+  }
+  if (
+    input.releaseIdentity !== input.familyBaseVersion &&
+    !input.releaseIdentity.startsWith(`${input.familyBaseVersion}-`)
+  ) {
+    throw new Error("releaseIdentity does not belong to familyBaseVersion")
+  }
+  if (input.releaseSetId !== `mentra-${input.releaseIdentity}`) {
+    throw new Error("releaseSetId must be mentra-<releaseIdentity>")
+  }
+  if (!COMMIT_PATTERN.test(input.sourceCommit)) throw new Error("sourceCommit must be a full lowercase Git SHA")
+  if (!SHA256_PATTERN.test(input.otaManifestSha256)) {
+    throw new Error("otaManifestSha256 must be a lowercase SHA-256 digest")
+  }
+  return {
+    schemaVersion: 1,
+    familyBaseVersion: input.familyBaseVersion,
+    releaseIdentity: input.releaseIdentity,
+    releaseSetId: input.releaseSetId,
+    sourceCommit: input.sourceCommit,
+    otaManifestUrl: validateHttpsUrl(input.otaManifestUrl),
+    otaManifestSha256: input.otaManifestSha256,
+  }
+}
+
+function swiftString(value) {
+  return JSON.stringify(value)
+}
+
+export function renderReleaseMetadata(input) {
+  const metadata = validateReleaseMetadata(input)
+  const typescript = [
+    "/** Generated by release CI. Do not edit in a release checkout. */",
+    "export interface BluetoothSdkReleaseMetadata {",
+    "  schemaVersion: 1",
+    "  familyBaseVersion: string | null",
+    "  releaseIdentity: string | null",
+    "  releaseSetId: string | null",
+    "  sourceCommit: string | null",
+    "  otaManifestUrl: string | null",
+    "  otaManifestSha256: string | null",
+    "}",
+    "",
+    `export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze(${JSON.stringify(
+      metadata,
+      null,
+      2,
+    )})`,
+    "",
+  ].join("\n")
+  const kotlin = [
+    "package com.mentra.bluetoothsdk",
+    "",
+    "/** Generated by release CI. Do not edit in a release checkout. */",
+    "internal object GeneratedReleaseMetadata {",
+    `    const val FAMILY_BASE_VERSION: String = ${JSON.stringify(metadata.familyBaseVersion)}`,
+    `    const val RELEASE_IDENTITY: String = ${JSON.stringify(metadata.releaseIdentity)}`,
+    `    const val RELEASE_SET_ID: String = ${JSON.stringify(metadata.releaseSetId)}`,
+    `    const val SOURCE_COMMIT: String = ${JSON.stringify(metadata.sourceCommit)}`,
+    `    const val OTA_MANIFEST_URL: String = ${JSON.stringify(metadata.otaManifestUrl)}`,
+    `    const val OTA_MANIFEST_SHA256: String = ${JSON.stringify(metadata.otaManifestSha256)}`,
+    "}",
+    "",
+  ].join("\n")
+  const swift = [
+    "import Foundation",
+    "",
+    "/// Generated by release CI. Do not edit in a release checkout.",
+    "enum GeneratedReleaseMetadata {",
+    `    static let familyBaseVersion = ${swiftString(metadata.familyBaseVersion)}`,
+    `    static let releaseIdentity = ${swiftString(metadata.releaseIdentity)}`,
+    `    static let releaseSetId = ${swiftString(metadata.releaseSetId)}`,
+    `    static let sourceCommit = ${swiftString(metadata.sourceCommit)}`,
+    `    static let otaManifestUrl = ${swiftString(metadata.otaManifestUrl)}`,
+    `    static let otaManifestSha256 = ${swiftString(metadata.otaManifestSha256)}`,
+    "}",
+    "",
+  ].join("\n")
+  return {metadata, typescript, kotlin, swift}
+}
+
+function parseArgs(args) {
+  const values = {}
+  for (let index = 0; index < args.length; index += 2) {
+    const option = args[index]
+    const value = args[index + 1]
+    if (!option?.startsWith("--") || value === undefined) throw new Error("Expected --name value pairs")
+    values[option.slice(2)] = value
+  }
+  return values
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2))
+  const required = [
+    "family-base-version",
+    "release-identity",
+    "release-set-id",
+    "source-commit",
+    "ota-manifest-url",
+    "ota-manifest-sha256",
+  ]
+  for (const field of required) if (!args[field]) throw new Error(`Missing --${field}`)
+  const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..")
+  const rendered = renderReleaseMetadata({
+    familyBaseVersion: args["family-base-version"],
+    releaseIdentity: args["release-identity"],
+    releaseSetId: args["release-set-id"],
+    sourceCommit: args["source-commit"],
+    otaManifestUrl: args["ota-manifest-url"],
+    otaManifestSha256: args["ota-manifest-sha256"],
+  })
+  const outputs = {
+    typescript: path.join(packageRoot, "src/generated/releaseMetadata.ts"),
+    kotlin: path.join(packageRoot, "android/src/main/java/com/mentra/bluetoothsdk/GeneratedReleaseMetadata.kt"),
+    swift: path.join(packageRoot, "ios/Source/GeneratedReleaseMetadata.swift"),
+  }
+  for (const [target, file] of Object.entries(outputs)) {
+    mkdirSync(path.dirname(file), {recursive: true})
+    writeFileSync(file, rendered[target])
+  }
+  console.log(`Wrote Bluetooth SDK release metadata for ${rendered.metadata.releaseSetId}`)
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) main()

package/scripts/write-release-metadata.test.mjs

@@ -0,0 +1,29 @@
+import assert from "node:assert/strict"
+import test from "node:test"
+
+import {renderReleaseMetadata, validateReleaseMetadata} from "./write-release-metadata.mjs"
+
+const input = {
+  familyBaseVersion: "3.1.0",
+  releaseIdentity: "3.1.0-beta.57",
+  releaseSetId: "mentra-3.1.0-beta.57",
+  sourceCommit: "a".repeat(40),
+  otaManifestUrl:
+    "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-3.1.0-beta.57/mentra-live-ota-3.1.0-beta.57.json",
+  otaManifestSha256: "b".repeat(64),
+}
+
+test("renders identical immutable metadata for TypeScript, Kotlin, and Swift", () => {
+  const rendered = renderReleaseMetadata(input)
+  for (const contents of [rendered.typescript, rendered.kotlin, rendered.swift]) {
+    assert.match(contents, /3\.1\.0-beta\.57/)
+    assert.match(contents, /mentra-live-ota-3\.1\.0-beta\.57\.json/)
+    assert.match(contents, new RegExp("b".repeat(64)))
+  }
+})
+
+test("rejects mutable or cross-family release metadata", () => {
+  assert.throws(() => validateReleaseMetadata({...input, releaseIdentity: "3.2.0-beta.57"}), /does not belong/)
+  assert.throws(() => validateReleaseMetadata({...input, otaManifestUrl: "http://example.com/version.json"}), /HTTPS/)
+  assert.throws(() => validateReleaseMetadata({...input, otaManifestSha256: "short"}), /SHA-256/)
+})

package/src/BluetoothSdk.types.ts

@@ -155,6 +155,8 @@ export type VersionInfoResult = {
   systemTimeMs?: number
   otaVersionUrl: string
   appVersion: string
+  /** Phone-served hotspot OTA protocol version; 0 means unsupported/legacy glasses. */
+  hotspotOtaVersion: number
 }
 
 export type VersionInfoEvent = VersionInfoResult & {
@@ -648,6 +650,23 @@ export type PairFailureEvent = {
   error: string
 }
 
+export type PairingInfoEvent = {
+  had_previous_bond: boolean
+  pairing_code?: string
+  classic_bond_ready?: boolean
+  secure_pairing_capable?: boolean
+  protocol_version?: number
+}
+
+export type EnteringPairingModeEvent = {
+  window_ms: number
+  reason?: string
+}
+
+export type OwnerReplacedEvent = {
+  reason: string
+}
+
 export type AudioPairingNeededEvent = {
   type: "audio_pairing_needed"
   deviceName: string
@@ -701,6 +720,17 @@ export type MicLc3Event = {
   voiceActivityDetectionEnabled: boolean
 }
 
+/** Native glasses-microphone diagnostics emitted when the SDK detects a transport or decode issue. */
+export type MicHealthEvent = {
+  type: "mic_health"
+  reason: "sequence_gap" | "decode_failure"
+  sequenceGapEvents: number
+  decodeFailures: number
+  lastLc3ReceivedAt?: number
+  lastPcmProducedAt?: number
+  timestamp: number
+}
+
 export type StreamStatusLifecycleState = "initializing" | "streaming" | "stopping" | "stopped"
 export type StreamStatusReconnectState = "reconnecting" | "reconnected" | "reconnect_failed"
 export type StreamStatusState = StreamStatusLifecycleState | StreamStatusReconnectState | "error"
@@ -895,6 +925,9 @@ export type BluetoothSdkModuleEvents = {
   rgb_led_control_response: (event: RgbLedControlResponseEvent) => void
   settings_ack: (event: SettingsAckEvent) => void
   pair_failure: (event: PairFailureEvent) => void
+  pairing_info: (event: PairingInfoEvent) => void
+  entering_pairing_mode: (event: EnteringPairingModeEvent) => void
+  owner_replaced: (event: OwnerReplacedEvent) => void
   audio_pairing_needed: (event: AudioPairingNeededEvent) => void
   audio_connected: (event: AudioConnectedEvent) => void
   audio_disconnected: (event: AudioDisconnectedEvent) => void
@@ -903,6 +936,7 @@ export type BluetoothSdkModuleEvents = {
   ws_bin: (event: WsBinEvent) => void
   mic_pcm: (event: MicPcmEvent) => void
   mic_lc3: (event: MicLc3Event) => void
+  mic_health: (event: MicHealthEvent) => void
   stream_status: (event: StreamStatusEvent) => void
   keep_alive_ack: (event: KeepAliveAckEvent) => void
   mtk_update_complete: (event: MtkUpdateCompleteEvent) => void
@@ -999,11 +1033,15 @@ export type BluetoothSdkEventMap = {
   rgb_led_control_response: RgbLedControlResponseEvent
   settings_ack: SettingsAckEvent
   pair_failure: PairFailureEvent
+  pairing_info: PairingInfoEvent
+  entering_pairing_mode: EnteringPairingModeEvent
+  owner_replaced: OwnerReplacedEvent
   audio_pairing_needed: AudioPairingNeededEvent
   audio_connected: AudioConnectedEvent
   audio_disconnected: AudioDisconnectedEvent
   mic_pcm: MicPcmEvent
   mic_lc3: MicLc3Event
+  mic_health: MicHealthEvent
   stream_status: StreamStatusEvent
   ota_start_ack: OtaStartAckEvent
   ota_status: OtaStatusEvent
@@ -1056,6 +1094,8 @@ export interface BluetoothSdkPublicModule {
   sendWifiCredentials(ssid: string, password: string): Promise<WifiStatusChangeEvent>
   forgetWifiNetwork(ssid: string): Promise<WifiStatusChangeEvent>
   setHotspotState(enabled: boolean): Promise<HotspotStatusChangeEvent>
+  /** Enable or disable Wi-Fi ADB on Mentra Live (no-op on other devices). */
+  setWifiAdbState(enabled: boolean): Promise<void>
 
   setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
@@ -1110,6 +1150,8 @@ export interface BluetoothSdkPublicModule {
     webhookUrl?: string,
     authToken?: string,
   ): Promise<VideoRecordingStoppedStatusEvent>
+  /** Query the glasses for the current recording state and elapsed duration. */
+  queryVideoRecordingStatus(requestId: string): Promise<VideoRecordingStatusEvent>
 
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
   stopStream(): Promise<StreamStatusEvent>
@@ -1131,14 +1173,27 @@ export interface BluetoothSdkPublicModule {
   ): Promise<RgbLedControlSuccessResponseEvent>
 
   requestVersionInfo(): Promise<VersionInfoResult>
+  /**
+   * Select the OTA manifest used by subsequent update checks and installs.
+   * The URL may point at Mentra's hosted manifest or any customer-controlled HTTP(S) server.
+   */
+  setOtaVersionUrl(otaVersionUrl: string): void
+  /** Return the configured or release-embedded OTA manifest URL. Rejects when a source build is unconfigured. */
+  getOtaVersionUrl(): string
   /** Fetch the configured OTA manifest and return whether any ASG/BES/MTK update is available. */
   checkForOtaUpdate(): Promise<boolean>
-  /** Start the OTA flow with the same configured manifest URL used by checkForOtaUpdate(). */
-  startOtaUpdate(): Promise<OtaStartAckEvent>
+  /** Start OTA from the configured or explicitly supplied manifest URL. */
+  startOtaUpdate(otaVersionUrl?: string | null): Promise<OtaStartAckEvent>
   startAr99OtaFromFile(path: string): Promise<boolean>
   cancelAr99Ota(): Promise<void>
   sendAr99FactoryReset(): Promise<void>
-  buildAr99OtaSignature(secret: string, appName: string, currentVersion: string, serialNumber: string, nonce: string): string
+  buildAr99OtaSignature(
+    secret: string,
+    appName: string,
+    currentVersion: string,
+    serialNumber: string,
+    nonce: string,
+  ): string
 
   // // stt commands (MOVE TO CRUST)
   // setSttModelDetails(path: string, languageCode: string): Promise<void>
@@ -1201,6 +1256,8 @@ export interface OtaUpdateInfo {
   updates: string[] // ["apk", "mtk", "bes"]
   totalSize: number
   cacheReady?: boolean
+  /** Exact BES target selected from the OTA manifest, when a BES step is pending. */
+  besVersion?: string
   /** True when the APK step installs an older build than the glasses currently run (exact-pin manifests only). */
   isDowngrade?: boolean
 }
@@ -1231,6 +1288,7 @@ export interface GlassesStatus {
   besFirmwareVersion: string
   mtkFirmwareVersion: string
   bluetoothMacAddress: string
+  wifiMacAddress: string
   leftMacAddress: string
   rightMacAddress: string
   buildNumber: string
@@ -1238,6 +1296,8 @@ export interface GlassesStatus {
   systemTimeMs?: number
   otaVersionUrl: string
   appVersion: string
+  /** Phone-served hotspot OTA protocol version; 0 means unsupported/legacy glasses. */
+  hotspotOtaVersion: number
   bluetoothName: string
   serialNumber: string
   style: string
@@ -1301,6 +1361,12 @@ export interface Device {
    * appear in a later scan update when the platform reports RSSI metadata.
    */
   rssi?: number
+  /** Mentra Live: unit is currently in pairing mode (adv flag). */
+  pairingMode?: boolean
+  /** Mentra Live: four-character hex spoken pairing code when available. */
+  pairingCode?: string
+  /** Mentra Live: advertisement carries the secure-pairing capability trailer. */
+  securePairingCapable?: boolean
 }
 
 export interface ConnectOptions {

package/src/_internal.ts

@@ -11,4 +11,6 @@ export type {BluetoothSdkInternalModule} from "./_private/BluetoothSdkModule"
 export * from "./BluetoothSdk.types"
 export {default as MentraLocalNetwork} from "./_private/MentraLocalNetworkModule"
 export * from "./_private/MentraLocalNetworkModule"
+export {default as MentraOtaServer} from "./ota-server"
+export * from "./ota-server/MentraOtaServer.types"
 export {BLUETOOTH_SDK_VERSION, sdkPinnedOtaManifestUrl} from "./_private/sdkOtaManifest"

package/src/_private/BluetoothSdkModule.ts

@@ -44,6 +44,7 @@ import {
   VideoRecordingStartedStatusEvent,
   VideoRecordingSettings,
   VideoRecordingStoppedStatusEvent,
+  VideoRecordingStatusEvent,
   VersionInfoResult,
   WarmUpCameraParams,
   WifiSearchResult,
@@ -117,6 +118,8 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
   sendWifiCredentials(ssid: string, password: string): Promise<WifiStatusChangeEvent>
   forgetWifiNetwork(ssid: string): Promise<WifiStatusChangeEvent>
   setHotspotState(enabled: boolean): Promise<HotspotStatusChangeEvent>
+  /** Enable or disable Wi-Fi ADB on Mentra Live (no-op on other devices). */
+  setWifiAdbState(enabled: boolean): Promise<void>
   /** Set the glasses system clock when phone detects clock skew (Mentra Live and G2). */
   setSystemTime(timestampMs: number): Promise<void>
   /** Logs current WiFi frequency (MHz) and 5 GHz band to Android logcat. */
@@ -179,6 +182,7 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
     webhookUrl?: string,
     authToken?: string,
   ): Promise<VideoRecordingStoppedStatusEvent>
+  queryVideoRecordingStatus(requestId: string): Promise<VideoRecordingStatusEvent>
 
   // Stream Commands
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
@@ -293,7 +297,7 @@ const CAMERA_ROI_POSITION_VALUES: Record<CameraRoiPosition, CameraFovSetting["ro
 }
 
 // Named presets are a convenience layer over the numeric {fov, roiPosition} API.
-// The default is the full sensor; "standard" preserves the historical 102� crop.
+// The default is the full sensor; "standard" preserves the historical 102° crop.
 const CAMERA_FOV_PRESETS: Record<CameraFovPreset, CameraFovSetting> = {
   narrow: {fov: 82, roiPosition: 0},
   standard: {fov: 102, roiPosition: 0},
@@ -649,7 +653,3 @@ NativeBluetoothSdkModule.warmUpCamera = function (params: WarmUpCameraParams) {
 
 export default NativeBluetoothSdkModule
 export const BluetoothSdk = NativeBluetoothSdkModule as BluetoothSdkInternalModule
-
-
-
-

package/src/_private/MentraLocalNetworkModule.ts

@@ -26,7 +26,7 @@ type LocalNetworkEvents = {
 }
 
 declare class MentraLocalNetworkNativeModule extends NativeModule<LocalNetworkEvents> {
-  connect(ssid: string, password: string): Promise<{connected: boolean; ssid: string}>
+  connect(ssid: string, password: string): Promise<{connected: boolean; ssid: string; localAddress?: string}>
   request(
     requestId: string,
     url: string,

package/src/_private/sdkOtaManifest.ts

@@ -1,17 +1,9 @@
 /**
- * SDK-pinned OTA manifest URL derivation.
- *
- * Each Bluetooth SDK release publishes an immutable manifest
- * (`bluetooth-sdk-<version>-version.json`) pinning the exact ASG artifact paired with that SDK
- * version. The URL is derived from this package's own version — the version is frozen into the
- * published artifact, so this is equivalent to baking the URL at release time while keeping the
- * manifest itself replaceable as an operational escape hatch (asset moves, CDN migration).
- *
- * Mirrors the native derivation in `OtaManifestDefaults.defaultOtaVersionUrl()` (Kotlin) /
- * `BluetoothSdkDefaults` (Swift).
+ * Release CI embeds one immutable OTA manifest URL into every SDK distribution.
+ * Source builds remain unpinned and must opt in through the debug configuration API.
  */
 
-const SDK_OTA_RELEASE_BASE_URL = "https://github.com/Mentra-Community/MentraOS/releases/download/bluetooth-sdk-ota"
+import {BLUETOOTH_SDK_RELEASE_METADATA} from "../generated/releaseMetadata"
 
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const packageJson = require("../../package.json") as {version?: string}
@@ -20,12 +12,8 @@ const packageJson = require("../../package.json") as {version?: string}
 export const BLUETOOTH_SDK_VERSION: string = (packageJson.version ?? "").trim()
 
 /**
- * The immutable manifest URL pinning the ASG artifact paired with this SDK version, or null when
- * the package version is unavailable (malformed workspace state).
+ * The immutable manifest URL embedded by release CI, or null for an unpinned source build.
  */
 export function sdkPinnedOtaManifestUrl(): string | null {
-  if (!BLUETOOTH_SDK_VERSION) {
-    return null
-  }
-  return `${SDK_OTA_RELEASE_BASE_URL}/bluetooth-sdk-${BLUETOOTH_SDK_VERSION}-version.json`
+  return BLUETOOTH_SDK_RELEASE_METADATA.otaManifestUrl
 }

package/src/generated/releaseMetadata.ts

@@ -0,0 +1,20 @@
+/** Generated by release CI. Do not edit in a release checkout. */
+export interface BluetoothSdkReleaseMetadata {
+  schemaVersion: 1
+  familyBaseVersion: string | null
+  releaseIdentity: string | null
+  releaseSetId: string | null
+  sourceCommit: string | null
+  otaManifestUrl: string | null
+  otaManifestSha256: string | null
+}
+
+export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({
+  "schemaVersion": 1,
+  "familyBaseVersion": "3.1.0",
+  "releaseIdentity": "3.1.0-dev.10",
+  "releaseSetId": "mentra-3.1.0-dev.10",
+  "sourceCommit": "64cf83b23a71e70261571a5f4401d1a7538f1852",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.10/mentra-live-ota-3.1.0-dev.10.json",
+  "otaManifestSha256": "214d92c8894033eaab276e668cb553c79990005d3330d23aaf499a514dc08cff"
+})

package/src/index.ts

@@ -36,11 +36,15 @@ const PUBLIC_EVENT_NAMES = new Set<BluetoothSdkEventName>([
   "rgb_led_control_response",
   "settings_ack",
   "pair_failure",
+  "pairing_info",
+  "entering_pairing_mode",
+  "owner_replaced",
   "audio_pairing_needed",
   "audio_connected",
   "audio_disconnected",
   "mic_pcm",
   "mic_lc3",
+  "mic_health",
   "stream_status",
   "ota_start_ack",
   "ota_status",
@@ -56,8 +60,8 @@ const addListener: BluetoothSdkPublicModule["addListener"] = (eventName, listene
   return PrivateBluetoothSdkModule.addListener(eventName, listener as BluetoothSdkEventListener<BluetoothSdkEventName>)
 }
 
-const startOtaUpdate: BluetoothSdkPublicModule["startOtaUpdate"] = () => {
-  return PrivateBluetoothSdkModule.startOtaUpdate()
+const startOtaUpdate: BluetoothSdkPublicModule["startOtaUpdate"] = (otaVersionUrl) => {
+  return PrivateBluetoothSdkModule.startOtaUpdate(otaVersionUrl)
 }
 
 const bindPublicMethod = <K extends keyof BluetoothSdkPublicModule>(name: K): BluetoothSdkPublicModule[K] => {
@@ -95,6 +99,7 @@ export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   sendWifiCredentials: bindPublicMethod("sendWifiCredentials"),
   forgetWifiNetwork: bindPublicMethod("forgetWifiNetwork"),
   setHotspotState: bindPublicMethod("setHotspotState"),
+  setWifiAdbState: bindPublicMethod("setWifiAdbState"),
   setGalleryModeEnabled: bindPublicMethod("setGalleryModeEnabled"),
   setVoiceActivityDetectionEnabled: bindPublicMethod("setVoiceActivityDetectionEnabled"),
   setLoudnessGateEnabled: bindPublicMethod("setLoudnessGateEnabled"),
@@ -125,6 +130,7 @@ export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   stopCameraWarmUp: bindPublicMethod("stopCameraWarmUp"),
   startVideoRecording: bindPublicMethod("startVideoRecording"),
   stopVideoRecording: bindPublicMethod("stopVideoRecording"),
+  queryVideoRecordingStatus: bindPublicMethod("queryVideoRecordingStatus"),
   startStream: bindPublicMethod("startStream"),
   stopStream: bindPublicMethod("stopStream"),
   setMicState: bindPublicMethod("setMicState"),
@@ -134,6 +140,8 @@ export const BluetoothSdk: BluetoothSdkPublicModule = Object.freeze({
   setGlassesMediaVolume: bindPublicMethod("setGlassesMediaVolume"),
   rgbLedControl: bindPublicMethod("rgbLedControl"),
   requestVersionInfo: bindPublicMethod("requestVersionInfo"),
+  setOtaVersionUrl: bindPublicMethod("setOtaVersionUrl"),
+  getOtaVersionUrl: bindPublicMethod("getOtaVersionUrl"),
   checkForOtaUpdate: bindPublicMethod("checkForOtaUpdate"),
   startOtaUpdate,
   startAr99OtaFromFile: bindPublicMethod("startAr99OtaFromFile"),
@@ -204,17 +212,26 @@ export type {
   HotspotErrorEvent,
   HotspotStatus,
   HotspotStatusChangeEvent,
+  KeepAliveAckEvent,
   LocalTranscriptionEvent,
   LogEvent,
   MicLc3Event,
+  MicHealthEvent,
   MicMode,
   MicPcmEvent,
   MicPreference,
   OtaStartAckEvent,
+  OtaProgress,
+  OtaProgressStatus,
+  OtaStage,
   OtaStatus,
   OtaStatusEvent,
   OtaQueryResult,
+  OtaUpdateInfo,
   PairFailureEvent,
+  PairingInfoEvent,
+  EnteringPairingModeEvent,
+  OwnerReplacedEvent,
   PhotoCaptureMetadata,
   PhotoResolvedConfig,
   PhotoCompression,

package/src/ota-server/MentraOtaServer.types.ts

@@ -0,0 +1,10 @@
+export type OtaServerResult = {
+  baseUrl: string
+  host: string
+  manifestUrl: string
+  port: number
+}
+
+export type MentraOtaServerModuleEvents = {
+  artifactDownloadProgress: (event: {destination: string; bytesWritten: number; contentLength: number}) => void
+}

package/src/ota-server/MentraOtaServerModule.ts

@@ -0,0 +1,23 @@
+import {NativeModule, requireNativeModule} from "expo"
+
+import type {MentraOtaServerModuleEvents, OtaServerResult} from "./MentraOtaServer.types"
+
+declare class MentraOtaServerModule extends NativeModule<MentraOtaServerModuleEvents> {
+  /**
+   * Serve `manifestJson` at /version.json and `artifactPaths` (sha256 -> local file path)
+   * at /artifacts/<sha256>. Pass `host` when the caller knows the authoritative local
+   * address (e.g. from the scoped hotspot network); omit to fall back to interface
+   * scanning. Returns the URLs to hand to the glasses via ota_start.
+   */
+  startOtaServer(
+    manifestJson: string,
+    artifactPaths: Record<string, string>,
+    host?: string | null,
+  ): Promise<OtaServerResult>
+  stopOtaServer(): Promise<void>
+  /** Wait for iPhone Wi-Fi (`en0`) to acquire an address on the glasses gateway subnet. */
+  waitForWifiAddress(gateway: string, timeoutMs: number): Promise<string>
+  downloadArtifact(source: string, destination: string): Promise<{statusCode: number; bytesWritten: number}>
+}
+
+export default requireNativeModule<MentraOtaServerModule>("MentraOtaServer")

package/src/ota-server/MentraOtaServerModule.web.ts

@@ -0,0 +1,17 @@
+import {NativeModule, registerWebModule} from "expo"
+
+import type {MentraOtaServerModuleEvents, OtaServerResult} from "./MentraOtaServer.types"
+
+class MentraOtaServerModule extends NativeModule<MentraOtaServerModuleEvents> {
+  async startOtaServer(): Promise<OtaServerResult> {
+    throw new Error("The OTA server is only available in native apps.")
+  }
+
+  async stopOtaServer(): Promise<void> {}
+
+  async waitForWifiAddress(): Promise<string> {
+    throw new Error("The OTA server is only available in native apps.")
+  }
+}
+
+export default registerWebModule(MentraOtaServerModule, "MentraOtaServer")

package/src/ota-server/index.ts

@@ -0,0 +1,2 @@
+export {default} from "./MentraOtaServerModule"
+export * from "./MentraOtaServer.types"