@mentra/bluetooth-sdk 3.2.1-beta.455 → 3.2.1-beta.464

package/build/BluetoothSdk.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"BluetoothSdk.types.js","sourceRoot":"","sources":["../src/BluetoothSdk.types.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,MAAM,wCAAwC,GAAG,KAAK,CAAA;AAwB7D,MAAM,UAAU,kCAAkC,CAChD,MAA+B;IAE/B,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAA+B;IAC5E,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,MAAM,CAAC,WAAW,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA+B;IAC3E,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,KAAK,KAAK,YAAY,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAA;AACnG,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,UAAU,EAAE,EAAC,KAAK,EAAE,cAAc,EAAC;QACnC,OAAO,EAAE,EAAC,KAAK,EAAE,UAAU,EAAC;QAC5B,6BAA6B,EAAE,wCAAwC;QACvE,IAAI,EAAE,EAAC,KAAK,EAAE,cAAc,EAAC;KAC9B,CAAA;AACH,CAAC;AA2BD,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACtD,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,CAAA;AACrC,CAAC;AAkFD,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,CAAA;AACnC,CAAC;AAoeD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,EAAE,EAAE,mBAAmB;IACvB,EAAE,EAAE,mBAAmB;IACvB,UAAU,EAAE,aAAa;IACzB,SAAS,EAAE,gBAAgB;IAC3B,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,iBAAiB;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,mBAAmB;CACf,CAAA;AAWV,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAA;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAA","sourcesContent":["import type {PhotoCompression} from \"@mentra/cloud-protocol/photo-compression\"\nexport type {PhotoCompression} from \"@mentra/cloud-protocol/photo-compression\"\n\n// Bluetooth SDK Event Types\nexport type GlassesNotReadyEvent = {\n  type: \"glasses_not_ready\"\n  message: string\n}\n\n// NOTE: unlike most events below, the native module does NOT include a `type`\n// field on the button_press payload 闂?it sends only {buttonId, pressType,\n// timestamp} (see BluetoothSdkModule on both iOS and Android). Consumers must\n// filter on `pressType` / the \"button_press\" listener name, never `event.type`.\nexport type ButtonPressEvent = {\n  buttonId: string\n  pressType: \"long\" | \"short\"\n  timestamp: number\n}\n\nexport type TouchEvent = {\n  type: \"touch_event\"\n  deviceModel: DeviceModel\n  gestureName: string\n  timestamp: number\n}\n\nexport type AccelEvent = {\n  type: \"accel_event\"\n  x: number\n  y: number\n  z: number\n  timestamp: number\n}\n\nexport type HeadUpEvent = {\n  up: boolean\n}\n\nexport type VoiceActivityDetectionStatusEvent = {\n  type: \"voice_activity_detection_status\"\n  voiceActivityDetectionEnabled: boolean\n}\n\nexport const DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED = false\n\nexport type SpeakingStatusEvent = {\n  type: \"speaking_status\"\n  speaking: boolean\n  timestamp: number\n}\n\nexport type BatteryStatusEvent = {\n  type: \"battery_status\"\n  level: number\n  charging: boolean\n  timestamp: number\n}\n\nexport type GlassesConnectionStatus =\n  | {state: \"disconnected\"}\n  | {state: \"scanning\"}\n  | {state: \"connecting\"}\n  | {state: \"bonding\"}\n  | {state: \"connected\"; fullyBooted: boolean}\n\nexport type ConnectedGlassesConnectionStatus = Extract<GlassesConnectionStatus, {state: \"connected\"}>\n\nexport function isConnectedGlassesConnectionStatus(\n  status: GlassesConnectionStatus,\n): status is ConnectedGlassesConnectionStatus {\n  return status.state === \"connected\"\n}\n\nexport function isReadyGlassesConnectionStatus(status: GlassesConnectionStatus): boolean {\n  return status.state === \"connected\" && status.fullyBooted\n}\n\nexport function isBusyGlassesConnectionStatus(status: GlassesConnectionStatus): boolean {\n  return status.state === \"scanning\" || status.state === \"connecting\" || status.state === \"bonding\"\n}\n\nexport function createDisconnectedGlassesStatus(): Partial<GlassesStatus> {\n  return {\n    connection: {state: \"disconnected\"},\n    hotspot: {state: \"disabled\"},\n    voiceActivityDetectionEnabled: DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,\n    wifi: {state: \"disconnected\"},\n  }\n}\n\n/** K900 `sr_getvol` response (Mentra Live glasses media step volume 0闂?5). */\nexport type GlassesMediaVolumeGetResult = {\n  level: number\n  statusCode: number\n}\n\n/** K900 `sr_vol` acknowledgment. */\nexport type GlassesMediaVolumeSetResult = {\n  statusCode: number\n}\n\nexport type LocalTranscriptionEvent = {\n  text: string\n  isFinal?: boolean\n  transcribeLanguage?: string\n}\n\nexport type LogEvent = {\n  message: string\n}\n\nexport type WifiStatus = {state: \"disconnected\"} | {state: \"connected\"; ssid: string; localIp?: string}\n\nexport type ConnectedWifiStatus = Extract<WifiStatus, {state: \"connected\"}>\n\nexport function isConnectedWifiStatus(status: WifiStatus): status is ConnectedWifiStatus {\n  return status.state === \"connected\"\n}\n\nexport type WifiStatusChangeEvent = WifiStatus & {\n  type: \"wifi_status_change\"\n  /**\n   * Glasses-reported provisioning failure reason when THIS event is the verdict of a\n   * failed connect attempt; absent on routine link-state updates. An attempt property,\n   * not a link property 闂?which is why it lives on the event, not on WifiStatus:\n   * \"connect_timeout\" arrives on a disconnected status (never associated), while\n   * \"connected_to_other_network\" arrives on a *connected* status (the attempt failed\n   * and the glasses ended up on / fell back to a different SSID than requested).\n   * Requires ASG client v40+ 闂?older glasses never send it.\n   */\n  error?: string\n}\n\nexport type WifiForgetOutcome =\n  | \"confirmed\"\n  | \"dispatched\"\n  | \"not_found\"\n  | \"unsupported\"\n  | \"failed\"\n  | \"legacy_unverified\"\n\nexport type WifiForgetResult = {\n  ssid: string\n  outcome: WifiForgetOutcome\n  connected?: boolean\n  currentSsid?: string\n  localIp?: string\n  error?: string\n}\n\nexport type ModernWifiForgetResultEvent = {\n  type: \"wifi_forget_result\"\n  mode: \"modern\"\n  requestId: string\n  sid: string\n  ssid: string\n  protocolVersion: number\n  outcome: Exclude<WifiForgetOutcome, \"legacy_unverified\">\n  connected?: boolean\n  currentSsid?: string\n  localIp?: string\n  error?: string\n}\n\nexport type LegacyWifiForgetResultEvent = {\n  type: \"wifi_forget_result\"\n  mode: \"legacy\"\n  ssid: string\n  dispatched: boolean\n  connected?: boolean\n  currentSsid?: string\n  localIp?: string\n  error?: string\n}\n\nexport type WifiForgetResultEvent = ModernWifiForgetResultEvent | LegacyWifiForgetResultEvent\n\nexport type SavedWifiNetworksOutcome = \"confirmed\" | \"unsupported\" | \"failed\"\n\nexport type SavedWifiNetworksResult = {\n  outcome: SavedWifiNetworksOutcome\n  networks: string[]\n  error?: string\n}\n\nexport type SavedWifiNetworksEvent = {\n  type: \"saved_wifi_networks\"\n  requestId: string\n  sid: string\n  protocolVersion: number\n  outcome: SavedWifiNetworksOutcome\n  networks: string[]\n  error?: string\n}\n\nexport type HotspotStatus = {state: \"disabled\"} | {state: \"enabled\"; ssid: string; password: string; localIp: string}\n\nexport type EnabledHotspotStatus = Extract<HotspotStatus, {state: \"enabled\"}>\n\nexport function isEnabledHotspotStatus(status: HotspotStatus): status is EnabledHotspotStatus {\n  return status.state === \"enabled\"\n}\n\nexport type HotspotStatusChangeEvent = HotspotStatus & {\n  type: \"hotspot_status_change\"\n}\n\nexport type HotspotErrorEvent = {\n  type: \"hotspot_error\"\n  errorMessage: string\n  timestamp: number\n}\n\nexport type VersionInfoResult = {\n  versionInfoType?: string\n  sid?: string\n  androidVersion: string\n  firmwareVersion: string\n  besFirmwareVersion: string\n  mtkFirmwareVersion: string\n  buildNumber: string\n  systemTimeMs?: number\n  otaVersionUrl: string\n  appVersion: string\n  /**\n   * Package the glasses client actually runs as, from `version_info_1`.\n   * `\"com.mentra.asg_client\"` is the stock client; anything else is a sideloaded build (Android\n   * forces a distinct package on any build not signed with Mentra's release key) that coexists\n   * with the stock app and must not be driven by OTA.\n   *\n   * Omitted — not empty — whenever this result carries no identity: either the glasses predate\n   * the field, or the response resolved from a `version_info` chunk that does not carry it (only\n   * chunk 1 does). Omission is what keeps a response from overwriting an identity an earlier\n   * chunk established, so treat `undefined` as \"unknown\", never as \"stock\".\n   */\n  packageName?: string\n  /** Phone-served hotspot OTA protocol version; 0 means unsupported/legacy glasses. */\n  hotspotOtaVersion: number\n  /** Session-correlated WiFi forget result protocol; absent/0 means unsupported. */\n  wifiForgetResultVersion?: number\n  /** Session-correlated saved-network listing protocol; absent/0 means unsupported. */\n  savedWifiNetworksVersion?: number\n}\n\nexport type VersionInfoEvent = VersionInfoResult & {\n  type: \"version_info\"\n}\n\nexport type WifiScanResultEvent = {\n  type: \"wifi_scan_result\"\n  networks: WifiSearchResult[]\n  scanComplete?: boolean\n}\n\nexport type PhotoResponseEvent =\n  | {\n      type: \"photo_response\"\n      state: \"success\"\n      requestId: string\n      uploadUrl: string\n      photoUrl?: string\n      statusUrl?: string\n      contentType?: string\n      fileSizeBytes?: number\n      timestamp: number\n    }\n  | {\n      type: \"photo_response\"\n      state: \"error\"\n      requestId: string\n      timestamp: number\n      errorCode?: string\n      errorMessage: string\n    }\n\nexport type PhotoSuccessResponseEvent = Extract<PhotoResponseEvent, {state: \"success\"}>\n\nexport type PhotoStatusState =\n  | \"accepted\"\n  | \"queued\"\n  | \"configuring\"\n  | \"capturing\"\n  | \"captured\"\n  | \"compressing\"\n  | \"ble_fallback_compression\"\n  | \"uploading\"\n  | \"uploaded\"\n  | \"ready_for_transfer\"\n  | \"transferring\"\n  | \"thumbnail_received\"\n  | \"failed\"\n\nexport type PhotoResolvedConfig = {\n  format?: \"jpeg\" | string\n  width?: number\n  height?: number\n  quality?: number\n  requestedSize?: PhotoSize | string\n  source?: \"sdk\" | \"button\" | string\n  transferMethod?: \"webhook\" | \"ble\" | \"local\" | string\n  compression?: PhotoCompression\n  saveToGallery?: boolean\n  exposureTimeNs?: number\n  iso?: number\n}\n\nexport type PhotoFpsRange = {\n  min?: number\n  max?: number\n}\n\nexport type PhotoRequestedCaptureConfig = {\n  manual?: boolean\n  exposureTimeNs?: number\n  iso?: number\n  frameDurationNs?: number\n  aeMode?: number\n  aeLock?: boolean\n  aeExposureCompensation?: number\n  aeTargetFpsRange?: PhotoFpsRange\n  noiseReductionMode?: number\n  edgeMode?: number\n  afMode?: number\n  zsl?: boolean\n}\n\nexport type PhotoMeteredPreview = {\n  exposureTimeNs?: number\n  iso?: number\n  totalLightProxy?: number\n}\n\nexport type PhotoCaptureMetadata = {\n  manual?: boolean\n  exposureTimeNs?: number\n  iso?: number\n  frameDurationNs?: number\n  aeMode?: number\n  aeState?: number\n  aeStateName?: string\n  noiseReductionMode?: number\n  edgeMode?: number\n  zsl?: boolean\n  sensorTimestampNs?: number\n  totalLightProxy?: number\n  mfnrLikely?: boolean\n  mfnrApplied?: boolean\n  width?: number\n  height?: number\n  noiseReductionWarning?: \"not_implemented\" | string\n  ispDigitalGainWarning?: \"not_implemented\" | string\n  ispAnalogGainWarning?: \"not_implemented\" | string\n  [key: string]: unknown\n}\n\nexport type PhotoStatusEvent = {\n  type: \"photo_status\"\n  requestId: string\n  status: PhotoStatusState | string\n  timestamp: number\n  resolvedConfig?: PhotoResolvedConfig\n  requestedCaptureConfig?: PhotoRequestedCaptureConfig\n  meteredPreview?: PhotoMeteredPreview\n  captureMetadata?: PhotoCaptureMetadata\n  errorCode?: string\n  errorMessage?: string\n  /** Present on thumbnail_received: a JPEG data URI, not the final photo. */\n  thumbnailUrl?: string\n  fileSizeBytes?: number\n}\n\nexport type CameraStatusEvent = {\n  type: \"camera_status\"\n  requestId: string\n  state: \"warming\" | \"ready\" | \"stopped\" | \"error\" | string\n  timestamp: number\n  errorCode?: string\n  errorMessage?: string\n}\n\nexport type VideoRecordingStatusEvent = {\n  type: \"video_recording_status\"\n  requestId?: string\n  success: boolean\n  status: VideoRecordingStatusState\n  details?: string | null\n  timestamp: number\n  data?: {\n    recording?: boolean\n    duration_ms?: number\n    duration_formatted?: string\n    [key: string]: unknown\n  }\n}\n\nexport type VideoRecordingStatusState =\n  | \"recording_started\"\n  | \"recording_status\"\n  | \"already_recording\"\n  | \"recording_stopped\"\n  | \"not_recording\"\n  | \"request_id_mismatch\"\n  | \"service_unavailable\"\n  | \"json_error\"\n  | \"battery_low\"\n  | \"camera_busy\"\n  | \"storage_unavailable\"\n  | \"integrity_failed\"\n  | \"error\"\n\nexport type VideoRecordingStartedStatusEvent = Omit<VideoRecordingStatusEvent, \"success\" | \"status\"> & {\n  success: true\n  status: \"recording_started\"\n}\n\nexport type VideoRecordingStoppedStatusEvent = Omit<VideoRecordingStatusEvent, \"success\" | \"status\"> & {\n  success: true\n  status: \"recording_stopped\"\n}\n\nexport type VideoRecordingSuccessStatusEvent = VideoRecordingStartedStatusEvent | VideoRecordingStoppedStatusEvent\n\nexport type MediaUploadSuccessEvent = {\n  type: \"media_success\"\n  requestId: string\n  mediaUrl: string\n  mediaType: number\n  timestamp: number\n}\n\nexport type MediaUploadErrorEvent = {\n  type: \"media_error\"\n  requestId: string\n  errorMessage: string\n  mediaType: number\n  timestamp: number\n}\n\nexport type MediaUploadEvent = MediaUploadSuccessEvent | MediaUploadErrorEvent\n\nexport type GalleryStatusEvent = {\n  type: \"gallery_status\"\n  photos: number\n  videos: number\n  total: number\n  totalSize?: number\n  hasContent: boolean\n  cameraBusy: boolean\n  cameraBusyReason?: \"video\" | \"stream\" | (string & {})\n}\n\nexport type CompatibleGlassesSearchStopEvent = {\n  type: \"compatible_glasses_search_stop\"\n  deviceModel: DeviceModel\n}\n\nexport type HeartbeatSentEvent = {\n  type: \"heartbeat_sent\"\n  heartbeat_sent: {\n    timestamp: number\n  }\n}\n\nexport type HeartbeatReceivedEvent = {\n  type: \"heartbeat_received\"\n  heartbeat_received: {\n    timestamp: number\n  }\n}\n\nexport type SwipeVolumeStatusEvent = {\n  type: \"swipe_volume_status\"\n  enabled: boolean\n  timestamp: number\n}\n\nexport type SwitchStatusEvent = {\n  type: \"switch_status\"\n  switchType?: number\n  switchValue?: number\n  timestamp: number\n}\n\n/**\n * Mentra Live center-mic gate + ADC gain overrides. Internal SDK surface: this\n * is a super-mode tuning aid, not a public capability.\n *\n * Every field is optional; an omitted field keeps the firmware default. The\n * glasses hold these in RAM only and drop them on disconnect, so the phone\n * re-sends on every connect.\n */\nexport type MicTuning = {\n  /** codec_adc_vol index, 0-15. 15 is +32 dB, the top of the table. */\n  gain?: number\n  /** Gate open / close thresholds, linear RMS on int16 samples. */\n  open?: number\n  close?: number\n  /** Frames of 10 ms. */\n  attack?: number\n  hang?: number\n  /** Thresholds used while the speaker is active or within its hold-off. */\n  sp_open?: number\n  sp_close?: number\n  sp_hold?: number\n}\n\n/**\n * What the glasses report as actually in force, after their own clamping. Use\n * this rather than the requested value when showing applied settings.\n */\nexport type MicTuningStateEvent = MicTuning & {\n  type: \"mic_tuning_state\"\n  /** Tuning revision; increments on every accepted set or reset. */\n  generation: number\n  /** True when any override is in force. */\n  overridden: boolean\n}\n\n/** Live center-mic level. Disposable: samples are dropped under any pressure. */\nexport type MicRmsEvent = {\n  type: \"mic_rms\"\n  rms: number\n  gateOpen: boolean\n  speakerElevated: boolean\n  /** Tuning revision the sample was measured under. */\n  generation: number\n}\n\n/**\n * Mentra Live wear-detection vote. Internal SDK surface: Super Mode only.\n * Values live in RAM on the glasses and reset on disconnect.\n */\nexport type WearTuning = {\n  /** Poll period in milliseconds. Firmware clamp: 50–2000. */\n  interval?: number\n  /** Sliding-window length. Firmware clamp: 3–15. */\n  count?: number\n  /** Votes needed to flip, either direction. Must be > count/2 and ≤ count. */\n  majority?: number\n}\n\n/** Current wear vote from sr_wrst, or an unsolicited wear transition. */\nexport type WearStateEvent = {\n  type: \"wear_state\"\n  worn: boolean\n  /** Unworn countdown, present on firmware that reports it. Milliseconds. */\n  elapsedMs?: number\n  timeoutMs?: number\n  /** cs_swit type 11. Absent on older firmware. */\n  enabled?: boolean\n  /** Countdown is running (glasses are off the face and the feature is on). */\n  armed?: boolean\n  /** Clock is running, but charging, a call, OTA, or factory test is holding shutdown. */\n  inhibited?: boolean\n}\n\n/**\n * What the wear poll loop is actually running. A rejected patch echoes the\n * unchanged values with `accepted: false`.\n */\nexport type WearTuningEvent = WearTuning & {\n  type: \"wear_tuning\"\n  enabled: boolean\n  interval: number\n  count: number\n  majority: number\n  generation: number\n  accepted: boolean\n}\n\nexport type RgbLedControlResponseEvent =\n  | {\n      type: \"rgb_led_control_response\"\n      state: \"success\"\n      requestId: string\n    }\n  | {\n      type: \"rgb_led_control_response\"\n      state: \"error\"\n      requestId: string\n      errorCode: string\n    }\n\nexport type RgbLedControlSuccessResponseEvent = Extract<RgbLedControlResponseEvent, {state: \"success\"}>\n\nexport type SettingsAckStatus = \"applied\" | \"ready\" | \"error\" | \"failed\" | \"failure\" | \"rejected\"\n\nexport type SettingsAckSetting =\n  | \"gallery_server\"\n  | \"gallery_mode\"\n  | \"button_photo\"\n  | \"button_video_recording\"\n  | \"button_max_recording_time\"\n  | \"camera_fov\"\n  | \"camera_fov_override\"\n  | \"camera_tuning\"\n\nexport type SettingsAckEvent = {\n  type: \"settings_ack\"\n  requestId: string\n  setting: SettingsAckSetting\n  status: SettingsAckStatus\n  timestamp: number\n  fov?: number\n  roiPosition?: CameraRoiPositionValue\n  hardwareApplied?: boolean\n  leaseId?: string\n  active?: boolean\n  size?: ButtonPhotoSize | string\n  width?: number\n  height?: number\n  fps?: number\n  enabled?: boolean\n  minutes?: number\n  /** Current site-network listener state; present for gallery_server acknowledgements. */\n  listening?: boolean\n  /** Current HTTP base URL; present for gallery_server only while listening. */\n  url?: string\n  /** ANR enabled flag; present when setting === \"camera_tuning\" */\n  anr?: boolean\n  /** Stock-gain flag; present when setting === \"camera_tuning\" */\n  gain?: boolean\n  errorCode?: string\n  errorMessage?: string\n}\n\nexport type SettingsAckSuccessStatus = Exclude<SettingsAckStatus, \"error\" | \"failed\" | \"failure\" | \"rejected\">\n\nexport type SettingsAckSuccessEvent = Omit<SettingsAckEvent, \"status\"> & {\n  status: SettingsAckSuccessStatus\n}\n\nexport type RgbLedAction = \"on\" | \"off\"\nexport type RgbLedColor = \"red\" | \"green\" | \"blue\" | \"orange\" | \"white\"\nexport type PhotoSize = \"low\" | \"medium\" | \"high\" | \"max\"\nexport type PhotoMode = \"photo\" | \"text\"\nexport type PhotoTransferMethod = \"auto\" | \"direct\" | \"ble\"\nexport type ButtonPhotoSize = \"low\" | \"medium\" | \"high\" | \"max\"\n\n/**\n * @deprecated Sticky action-button photo presets via {@link BluetoothSdkPublicModule.setPhotoCaptureDefaults}\n * are deprecated. Prefer per-request {@link BluetoothSdkPublicModule.requestPhoto} options\n * (e.g. `mode: \"text\"` for text sensor size/crop, or explicit `aeExposureDivisor`) instead of\n * persisting button-photo tuning on the glasses.\n */\nexport type PhotoCaptureDefaults = {\n  size?: PhotoSize\n  /** ZSL preview buffering for physical camera-button photos. */\n  zsl?: boolean\n  /** MFNR still capture for physical camera-button photos. */\n  mfnr?: boolean\n  noiseReduction?: boolean\n  edgeEnhancement?: boolean\n  ispDigitalGain?: number\n  ispAnalogGain?: string\n  aeExposureDivisor?: number\n  isoCap?: number\n  compress?: PhotoCompression\n  sound?: boolean\n  /** When true, clears stored NR/edge/ISP presets on the glasses before applying other fields. */\n  resetCaptureTuning?: boolean\n}\n\nexport type VideoRecordingDefaults = {\n  width: number\n  height: number\n  fps: number\n}\n\n/**\n * Optional per-recording video settings for {@link startVideoRecording}. When\n * omitted, the glasses fall back to their saved video recording defaults. Any\n * field left undefined is omitted from the BLE command (glasses default applies).\n */\nexport interface VideoRecordingSettings {\n  width?: number\n  height?: number\n  fps?: number\n  /**\n   * Optional auto-stop timer in minutes, sent on `start_video_recording`.\n   * `0` (the default) means record until stopped or interrupted\n   * (battery/storage/thermal/error).\n   */\n  maxRecordingTimeMinutes?: number\n}\nexport const DeviceModels = {\n  Simulated: \"Simulated Glasses\",\n  G1: \"Even Realities G1\",\n  G2: \"Even Realities G2\",\n  MentraLive: \"Mentra Live\",\n  MentraNex: \"Mentra Display\",\n  Mach1: \"Mentra Mach1\",\n  Z100: \"Vuzix Z100\",\n  Frame: \"Brilliant Frame\",\n  Nimo: \"NIMO\",\n  Ar99: \"AR99\",\n  R1: \"Even Realities R1\",\n} as const\n\nexport type DeviceModel = (typeof DeviceModels)[keyof typeof DeviceModels]\nexport type ObservableStoreCategory = \"glasses\" | \"bluetooth\" | \"core\"\n\nexport type DashboardMenuItem = {\n  title: string\n  packageName: string\n  values?: Record<string, unknown>\n}\n\nexport const CAMERA_FOV_MIN = 62\nexport const CAMERA_FOV_MAX = 118\nexport const CAMERA_FOV_DEFAULT = CAMERA_FOV_MAX\n\nexport type CameraRoiPosition = \"center\" | \"bottom\" | \"top\"\nexport type CameraRoiPositionValue = 0 | 1 | 2\nexport type CameraFovPreset = \"narrow\" | \"standard\" | \"wide\"\n\nexport type CameraFovRequest =\n  | {\n      fov: number\n      roiPosition?: CameraRoiPosition\n    }\n  | {\n      preset: CameraFovPreset\n    }\n\nexport type CameraFovResult = {\n  requestId: string\n  fov: number\n  roiPosition: CameraRoiPosition\n  timestamp: number\n}\n\nexport type CameraFovOverrideRequest = CameraFovRequest & {\n  /** Phone-owned lease used to make delayed releases safe. */\n  leaseId: string\n  /** Safety TTL; refresh the same lease/configuration to extend without a HAL restart. */\n  ttlMs?: number\n}\n\nexport type CameraFovSetting = {\n  fov: number\n  roiPosition: CameraRoiPositionValue\n}\n\ntype NativeCameraFovSetting = {\n  fov: number\n  roi_position: CameraRoiPositionValue\n}\n\nexport type MicPreference = \"auto\" | \"phone\" | \"glasses\" | \"bluetooth\"\nexport type MicMode = \"phone\" | \"glasses\" | \"bluetoothClassic\" | \"bluetooth\"\n\nexport type PhotoRequestParams = {\n  /**\n   * Send an oriented <=500px, quality-50 JPEG preview before the full photo. Default false.\n   * Enables a 110-second end-to-end native deadline (ordinary requests: 30 seconds).\n   */\n  presend_thumbnail?: boolean\n  requestId?: string\n  appId?: string\n  size: PhotoSize\n  mode?: PhotoMode\n  /** `direct` disables BLE fallback; `ble` skips direct upload and forces phone-relayed transfer. */\n  transferMethod?: PhotoTransferMethod\n  webhookUrl: string | null\n  authToken: string | null\n  compress?: PhotoCompression\n  save?: boolean\n  sound: boolean\n  exposureTimeNs?: number | null\n  /** Sensor ISO for this capture only. Only used when exposureTimeNs enables manual exposure. */\n  iso?: number | null\n  /** After AE convergence, divide metered exposure by this factor (scan mode). */\n  aeExposureDivisor?: number\n  /** Cap ISO after AE metering (scan mode). */\n  isoCap?: number\n  /** Requested on wire; glasses may log not_implemented. */\n  noiseReduction?: boolean\n  edgeEnhancement?: boolean\n  /** ZSL buffering. Forced off for manual/scan stills because fixed sensor controls take priority. */\n  zsl?: boolean\n  /** MFNR still capture. Forced off for manual/scan stills because fixed sensor controls take priority. */\n  mfnr?: boolean\n  ispDigitalGain?: number\n  ispAnalogGain?: string\n}\n\nexport type WarmUpCameraParams = {\n  /** Supply this when the owner needs to call stopCameraWarmUp during teardown. */\n  requestId?: string\n  size: PhotoSize\n  mode?: PhotoMode\n  exposureTimeNs?: number | null\n  /** Ready-state hold; defaults to 15 seconds and is capped at 5 minutes by ASG. */\n  durationMs?: number\n  /** ZSL preview buffering for the warm-up session. */\n  zsl?: boolean\n  /** MFNR still capture for the warm-up session. */\n  mfnr?: boolean\n}\n\nexport type StreamDegradationPreference = \"MAINTAIN_FRAMERATE\" | \"MAINTAIN_RESOLUTION\" | \"BALANCED\" | \"DISABLED\"\n\nexport type StreamVideoConfig = {\n  width?: number\n  height?: number\n  bitrate?: number\n  /** WHIP minimum target in bps; omitted leaves it unset. Clamped to the maximum. */\n  minBitrateBps?: number\n  /** WHIP startup bitrate in bps, clamped to the requested bounds. */\n  initialBitrateBps?: number\n  fps?: number\n  /** WHIP adaptation policy. Omit to keep the glasses' MAINTAIN_FRAMERATE default. */\n  degradationPreference?: StreamDegradationPreference\n}\n\nexport type StreamAudioConfig = {\n  bitrate?: number\n  sampleRate?: number\n  echoCancellation?: boolean\n  noiseSuppression?: boolean\n}\n\n/** ICE overrides for a WHIP stream. Ignored by the RTMP and SRT paths. */\nexport type StreamIceConfig = {\n  /**\n   * STUN server the glasses should use while gathering candidates.\n   *\n   * Omit to keep the default Cloudflare STUN server. Pass an empty string to force host-only\n   * gathering, which is what SoftAP calling needs: the WHIP server runs on the phone across the\n   * glasses' own hotspot, so a server-reflexive candidate is meaningless and there is no route to\n   * a STUN server anyway. A value that is not a `stun:`/`stuns:` URI is ignored and the default is\n   * kept, so a malformed override cannot silently disable ICE.\n   */\n  stun?: string\n}\n\nexport type StreamStartRequest = {\n  type?: \"start_stream\"\n  streamUrl: string\n  streamId?: string\n  sound?: boolean\n  video?: StreamVideoConfig\n  audio?: StreamAudioConfig\n  ice?: StreamIceConfig\n  /** When false, glasses skip mic capture. Defaults to true. */\n  captureAudio?: boolean\n  /**\n   * Correlation id echoed by the glasses in every SOFTAP_TRACE log line, so phone and glasses\n   * logs can be joined despite having unsynchronised clocks.\n   *\n   * TEMPORARY: part of the SoftAP diagnostic trace layer.\n   */\n  traceId?: string\n  authToken?: string\n  telemetry?: boolean\n}\n\nexport type StreamKeepAliveRequest = {\n  type?: \"keep_stream_alive\"\n  streamId: string\n  ackId: string\n}\n\nexport type PairFailureEvent = {\n  type: \"pair_failure\"\n  error: string\n}\n\nexport type PairingInfoEvent = {\n  had_previous_bond: boolean\n  pairing_code?: string\n  classic_bond_ready?: boolean\n  secure_pairing_capable?: boolean\n  protocol_version?: number\n}\n\nexport type EnteringPairingModeEvent = {\n  window_ms: number\n  reason?: string\n}\n\nexport type OwnerReplacedEvent = {\n  reason: string\n}\n\nexport type AudioPairingNeededEvent = {\n  type: \"audio_pairing_needed\"\n  deviceName: string\n}\n\nexport type AudioConnectedEvent = {\n  type: \"audio_connected\"\n  deviceName: string\n}\n\nexport type AudioDisconnectedEvent = {\n  type: \"audio_disconnected\"\n}\n\nexport type SaveSettingEvent = {\n  type: \"save_setting\"\n  key: string\n  value: any\n}\n\nexport type WsTextEvent = {\n  type: \"ws_text\"\n  text: string\n}\n\nexport type WsBinEvent = {\n  type: \"ws_bin\"\n  base64: string\n}\n\nexport type MicPcmEvent = {\n  type: \"mic_pcm\"\n  pcm: ArrayBuffer\n  sampleRate: 16000\n  bitsPerSample: 16\n  channels: 1\n  encoding: \"pcm_s16le\"\n  voiceActivityDetectionEnabled: boolean\n  /**\n   * The microphone this buffer came from (`\"glasses\"`, `\"phone\"`, `\"bluetooth\"`, or `\"\"` when none\n   * is selected). Stamped per frame because the SDK can move the source mid-stream, so a consumer\n   * that told a remote party which microphone it is sending can check rather than assume.\n   */\n  source: string\n}\n\nexport type MicLc3Event = {\n  type: \"mic_lc3\"\n  lc3: ArrayBuffer\n  sampleRate: 16000\n  channels: 1\n  encoding: \"lc3\"\n  frameDurationMs: 10\n  frameSizeBytes: number\n  bitrate: number\n  packetizedFromGlasses: boolean\n  voiceActivityDetectionEnabled: boolean\n}\n\n/** Native glasses-microphone diagnostics emitted when the SDK detects a transport or decode issue. */\nexport type MicHealthEvent = {\n  type: \"mic_health\"\n  reason: \"sequence_gap\" | \"decode_failure\"\n  sequenceGapEvents: number\n  decodeFailures: number\n  lastLc3ReceivedAt?: number\n  lastPcmProducedAt?: number\n  timestamp: number\n}\n\nexport type StreamStatusLifecycleState = \"initializing\" | \"streaming\" | \"stopping\" | \"stopped\"\nexport type StreamStatusReconnectState = \"reconnecting\" | \"reconnected\" | \"reconnect_failed\"\nexport type StreamStatusState = StreamStatusLifecycleState | StreamStatusReconnectState | \"error\"\n\n/** Effective stream settings reported by the glasses after defaults and clamps. */\nexport type StreamResolvedConfig = {\n  transport?: \"rtmp\" | \"srt\" | \"whip\"\n  video?: {\n    /** Encoded output width sent to the stream endpoint. */\n    width: number\n    /** Encoded output height sent to the stream endpoint. */\n    height: number\n    /** Native camera buffer width selected before crop/downscale. */\n    captureWidth?: number\n    /** Native camera buffer height selected before crop/downscale. */\n    captureHeight?: number\n    /** Encoded video bitrate in bits per second. */\n    bitrate: number\n    /** Resolved capture/encode frame rate. */\n    fps: number\n    /** Applied WHIP adaptation policy; absent on older firmware and other transports. */\n    degradationPreference?: StreamDegradationPreference\n  }\n  audio?: {\n    /** Encoded audio bitrate in bits per second. */\n    bitrate?: number\n    /** Audio sample rate in Hz. */\n    sampleRate?: number\n    echoCancellation?: boolean\n    noiseSuppression?: boolean\n  }\n}\n\n/** Live encoder and device telemetry emitted periodically by supported glasses firmware. */\nexport type StreamLiveStats = {\n  /** Current encoded video bitrate in bits per second. */\n  bitrate?: number\n  /** Current encode frame rate. */\n  fps?: number\n  droppedFrames?: number\n  /** Seconds since the stream started. */\n  duration?: number\n  /** Device temperature in 闂佺娅ｉ悡? if the hardware reports it. */\n  temperatureC?: number\n}\n\ntype StreamStatusCommon = {\n  type: \"stream_status\"\n  streamId?: string\n  /** ASG process identity and monotonic revision for reconnect reconciliation. */\n  sid?: string\n  revision?: number\n  terminal?: boolean\n  errorDetails?: string\n  timestamp?: number\n  resolvedConfig?: StreamResolvedConfig\n  stats?: StreamLiveStats\n}\n\nexport type StreamStatusEvent =\n  | (StreamStatusCommon & {\n      kind: \"lifecycle\"\n      status: StreamStatusLifecycleState\n    })\n  | (StreamStatusCommon & {\n      kind: \"reconnect\"\n      status: \"reconnecting\"\n      attempt: number\n      maxAttempts: number\n      reason: string\n    })\n  | (StreamStatusCommon & {\n      kind: \"reconnect\"\n      status: \"reconnected\"\n      attempt: number\n    })\n  | (StreamStatusCommon & {\n      kind: \"reconnect\"\n      status: \"reconnect_failed\"\n      maxAttempts: number\n    })\n  | (StreamStatusCommon & {\n      kind: \"error\"\n      status: \"error\"\n      errorDetails: string\n    })\n  | (StreamStatusCommon & {\n      kind: \"snapshot\"\n      status: StreamStatusState\n      streaming: boolean\n      reconnecting: boolean\n      attempt?: number\n    })\n\nexport type KeepAliveAckEvent = {\n  type: \"keep_alive_ack\"\n  streamId: string\n  ackId: string\n  timestamp?: number\n}\n\nexport type MtkUpdateCompleteEvent = {\n  type: \"mtk_update_complete\"\n  message: string\n  timestamp: number\n}\n\n/**\n * The glasses process restarted while the BES kept the BLE link alive (its `sid`\n * changed, or first appeared after an update from a pre-sid build). There is no\n * physical disconnect for this — treat it as the logical reconnect edge.\n */\nexport type GlassesSessionChangedEvent = {\n  type: \"glasses_session_changed\"\n  previous_sid: string\n  sid: string\n}\n\n/** @deprecated Glasses no longer emit ota_progress; use {@link OtaStatusEvent} and status-store mapping. */\nexport type OtaProgressEvent = {\n  type: \"ota_progress\"\n  stage?: OtaStage\n  status?: OtaProgressStatus\n  progress?: number\n  bytes_downloaded?: number\n  total_bytes?: number\n  current_update?: string\n  error_message?: string\n}\n\nexport type OtaStartAckEvent = {\n  type: \"ota_start_ack\"\n  timestamp: number\n}\nexport type OtaStatusEvent = {\n  type: \"ota_status\"\n  session_id: string\n  total_steps: number\n  current_step: number\n  step_type: \"apk\" | \"mtk\" | \"bes\"\n  phase: \"download\" | \"install\"\n  step_percent: number\n  /** Real bytes received in the current download; absent on older glasses. */\n  bytes_downloaded?: number\n  overall_percent: number\n  status: \"in_progress\" | \"step_complete\" | \"complete\" | \"failed\" | \"idle\"\n  error_message?: string\n}\n\nexport type OtaQueryResult = OtaStatusEvent\n\n/** Nex BLE protobuf trace (NexEventUtils); payload matches native Map keys. */\nexport type BleCommandTraceEvent = {\n  command: string\n  commandText: string\n  timestamp: number\n}\n\nexport type MiniappSelectedEvent = {\n  type: \"miniapp_selected\"\n  packageName: string\n}\n\n// Union type of all native/internal Bluetooth SDK events.\nexport type BluetoothSdkInternalEvent = Parameters<BluetoothSdkModuleEvents[keyof BluetoothSdkModuleEvents]>[0]\n\nexport type BluetoothSdkModuleEvents = {\n  glasses_status: (changed: Partial<GlassesStatus>) => void\n  bluetooth_status: (changed: Partial<BluetoothStatus>) => void\n  log: (event: LogEvent) => void\n  device_discovered: (device: Device) => void\n  default_device_changed: (event: {device?: Device}) => void\n  // Individual event handlers\n  glasses_not_ready: (event: GlassesNotReadyEvent) => void\n  button_press: (event: ButtonPressEvent) => void\n  touch_event: (event: TouchEvent) => void\n  accel_event: (event: AccelEvent) => void\n  head_up: (event: HeadUpEvent) => void\n  voice_activity_detection_status: (event: VoiceActivityDetectionStatusEvent) => void\n  speaking_status: (event: SpeakingStatusEvent) => void\n  battery_status: (event: BatteryStatusEvent) => void\n  local_transcription: (event: LocalTranscriptionEvent) => void\n  native_notification_status: (event: NativeNotificationStatus) => void\n  native_notification_delivery: (event: NativeNotificationDelivery) => void\n  phone_notification: (event: PhoneNotificationEvent) => void\n  phone_notification_dismissed: (event: PhoneNotificationDismissedEvent) => void\n  wifi_status_change: (event: WifiStatusChangeEvent) => void\n  wifi_scan_result: (event: WifiScanResultEvent) => void\n  wifi_forget_result: (event: WifiForgetResultEvent) => void\n  saved_wifi_networks: (event: SavedWifiNetworksEvent) => void\n  hotspot_status_change: (event: HotspotStatusChangeEvent) => void\n  hotspot_error: (event: HotspotErrorEvent) => void\n  photo_response: (event: PhotoResponseEvent) => void\n  photo_status: (event: PhotoStatusEvent) => void\n  camera_status: (event: CameraStatusEvent) => void\n  video_recording_status: (event: VideoRecordingStatusEvent) => void\n  media_success: (event: MediaUploadSuccessEvent) => void\n  media_error: (event: MediaUploadErrorEvent) => void\n  gallery_status: (event: GalleryStatusEvent) => void\n  compatible_glasses_search_stop: (event: CompatibleGlassesSearchStopEvent) => void\n  heartbeat_sent: (event: HeartbeatSentEvent) => void\n  heartbeat_received: (event: HeartbeatReceivedEvent) => void\n  swipe_volume_status: (event: SwipeVolumeStatusEvent) => void\n  switch_status: (event: SwitchStatusEvent) => void\n  mic_tuning_state: (event: MicTuningStateEvent) => void\n  mic_rms: (event: MicRmsEvent) => void\n  wear_state: (event: WearStateEvent) => void\n  wear_tuning: (event: WearTuningEvent) => void\n  rgb_led_control_response: (event: RgbLedControlResponseEvent) => void\n  settings_ack: (event: SettingsAckEvent) => void\n  pair_failure: (event: PairFailureEvent) => void\n  pairing_info: (event: PairingInfoEvent) => void\n  entering_pairing_mode: (event: EnteringPairingModeEvent) => void\n  owner_replaced: (event: OwnerReplacedEvent) => void\n  audio_pairing_needed: (event: AudioPairingNeededEvent) => void\n  audio_connected: (event: AudioConnectedEvent) => void\n  audio_disconnected: (event: AudioDisconnectedEvent) => void\n  save_setting: (event: SaveSettingEvent) => void\n  ws_text: (event: WsTextEvent) => void\n  ws_bin: (event: WsBinEvent) => void\n  mic_pcm: (event: MicPcmEvent) => void\n  mic_lc3: (event: MicLc3Event) => void\n  mic_health: (event: MicHealthEvent) => void\n  stream_status: (event: StreamStatusEvent) => void\n  keep_alive_ack: (event: KeepAliveAckEvent) => void\n  mtk_update_complete: (event: MtkUpdateCompleteEvent) => void\n  glasses_session_changed: (event: GlassesSessionChangedEvent) => void\n  ota_start_ack: (event: OtaStartAckEvent) => void\n  ota_status: (event: OtaStatusEvent) => void\n  ar99_ota_status: (event: Ar99OtaStatusEvent) => void\n  version_info: (event: VersionInfoEvent) => void\n  send_command_to_ble: (event: BleCommandTraceEvent) => void\n  receive_command_from_ble: (event: BleCommandTraceEvent) => void\n  miniapp_selected: (event: MiniappSelectedEvent) => void\n  extraction_progress: (event: ExtractionProgressEvent) => void\n}\n\nexport interface ExtractionProgressEvent {\n  percentage: number\n  bytesRead: number\n  totalBytes: number\n}\n\nexport interface Ar99OtaStatusEvent {\n  type: \"ar99_ota_status\"\n  phase: string\n  progress: number\n  offset: number\n  total: number\n  errorMessage?: string\n  error_message?: string\n}\n\nexport interface PhoneNotificationEvent {\n  notificationId: string\n  app: string\n  title: string\n  content: string\n  priority: string\n  timestamp: number\n  packageName: string\n}\n\nexport interface PhoneNotificationDismissedEvent {\n  notificationId: string\n  notificationKey: string\n  packageName: string\n  timestamp: number\n}\n\n/**\n * Outbound payload for `sendPhoneNotification` — a notification pushed INTO the glasses' own\n * notification centre. The inverse of {@link PhoneNotificationEvent}, which reports\n * notifications the glasses relayed TO the phone (iOS/ANCS). Drivers map these keys onto\n * whatever their firmware expects.\n */\nexport interface NativeNotificationConfig {\n  enabled: boolean\n  autoDisplay: boolean\n  durationSeconds: number\n  doNotDisturb: boolean\n  /** Android package names. iOS rejects nonempty lists; its ANCS filter is firmware-owned. */\n  blockedApps: string[]\n}\n\nexport interface NativeNotificationStatus {\n  supported: boolean\n  source: \"phone\" | \"ancs\" | \"unsupported\"\n  authorization: \"system\" | \"authorized\" | \"not_authorized\" | \"unknown\"\n  /** `submitted` is not a firmware-confirmed acknowledgement. */\n  state: \"unavailable\" | \"disabled\" | \"configuring\" | \"submitted\" | \"needs_reconnect\" | \"failed\"\n  config: NativeNotificationConfig\n  error: string\n}\n\nexport interface NativeNotificationDelivery {\n  notificationId: string\n  status: \"delivered\" | \"failed\" | \"cancelled\" | \"dropped\"\n  reason: string\n}\n\nexport interface NativePhoneNotification {\n  /** Stable id from the phone's notification listener; parsed to an int where firmware needs one. */\n  notificationId: string\n  /** Reverse-DNS package id of the originating app. */\n  packageName: string\n  /** Human app name (e.g. \"Messages\"). */\n  appName: string\n  title: string\n  /** Android `android.subText`. Empty when the listener didn't capture one. */\n  subtitle: string\n  body: string\n  /** Unix ms post time. */\n  timestampMs: number\n  /** Posted or updated. Removal is not supported by the verified protocol. */\n  action: 0\n}\n\nexport type PublicGlassesStatus = Omit<\n  GlassesStatus,\n  \"otaUpdateAvailable\" | \"otaProgress\" | \"otaInProgress\" | \"otaVersionUrl\"\n>\n\nexport type PublicBluetoothStatus = Pick<\n  BluetoothStatus,\n  | \"searching\"\n  | \"searchingController\"\n  | \"systemMicUnavailable\"\n  | \"micRanking\"\n  | \"currentMic\"\n  | \"searchResults\"\n  | \"wifiScanResults\"\n  | \"lastLog\"\n  | \"otherBtConnected\"\n  | \"galleryModeEnabled\"\n>\n\nexport type BluetoothSdkEventMap = {\n  native_notification_status: NativeNotificationStatus\n  native_notification_delivery: NativeNotificationDelivery\n  log: LogEvent\n  device_discovered: Device\n  default_device_changed: {device?: Device}\n  glasses_not_ready: GlassesNotReadyEvent\n  button_press: ButtonPressEvent\n  touch_event: TouchEvent\n  accel_event: AccelEvent\n  head_up: HeadUpEvent\n  voice_activity_detection_status: VoiceActivityDetectionStatusEvent\n  speaking_status: SpeakingStatusEvent\n  battery_status: BatteryStatusEvent\n  local_transcription: LocalTranscriptionEvent\n  wifi_status_change: WifiStatusChangeEvent\n  wifi_scan_result: WifiScanResultEvent\n  wifi_forget_result: WifiForgetResultEvent\n  saved_wifi_networks: SavedWifiNetworksEvent\n  hotspot_status_change: HotspotStatusChangeEvent\n  hotspot_error: HotspotErrorEvent\n  photo_response: PhotoResponseEvent\n  photo_status: PhotoStatusEvent\n  camera_status: CameraStatusEvent\n  video_recording_status: VideoRecordingStatusEvent\n  media_success: MediaUploadSuccessEvent\n  media_error: MediaUploadErrorEvent\n  gallery_status: GalleryStatusEvent\n  compatible_glasses_search_stop: CompatibleGlassesSearchStopEvent\n  swipe_volume_status: SwipeVolumeStatusEvent\n  switch_status: SwitchStatusEvent\n  mic_tuning_state: MicTuningStateEvent\n  mic_rms: MicRmsEvent\n  wear_state: WearStateEvent\n  wear_tuning: WearTuningEvent\n  rgb_led_control_response: RgbLedControlResponseEvent\n  settings_ack: SettingsAckEvent\n  pair_failure: PairFailureEvent\n  pairing_info: PairingInfoEvent\n  entering_pairing_mode: EnteringPairingModeEvent\n  owner_replaced: OwnerReplacedEvent\n  audio_pairing_needed: AudioPairingNeededEvent\n  audio_connected: AudioConnectedEvent\n  audio_disconnected: AudioDisconnectedEvent\n  mic_pcm: MicPcmEvent\n  mic_lc3: MicLc3Event\n  mic_health: MicHealthEvent\n  stream_status: StreamStatusEvent\n  /** Mentra Live MTK updater completed and the glasses are about to restart. */\n  mtk_update_complete: MtkUpdateCompleteEvent\n  /** The ASG process restarted while the BES kept the BLE connection alive. */\n  glasses_session_changed: GlassesSessionChangedEvent\n  ota_start_ack: OtaStartAckEvent\n  ota_status: OtaStatusEvent\n  ar99_ota_status: Ar99OtaStatusEvent\n  version_info: VersionInfoEvent\n  extraction_progress: ExtractionProgressEvent\n}\n\nexport type BluetoothSdkEventName = keyof BluetoothSdkEventMap\n\nexport type BluetoothSdkEventListener<EventName extends BluetoothSdkEventName> = (\n  event: BluetoothSdkEventMap[EventName],\n) => void\n\nexport type BluetoothSdkSubscription = {\n  remove(): void\n}\n\nexport type BluetoothSdkEvent = BluetoothSdkEventMap[BluetoothSdkEventName]\n\nexport interface BluetoothSdkPublicModule {\n  configureNativeNotifications(config: NativeNotificationConfig): Promise<void>\n  getNativeNotificationStatus(): Promise<NativeNotificationStatus>\n  addListener<EventName extends BluetoothSdkEventName>(\n    eventName: EventName,\n    listener: BluetoothSdkEventListener<EventName>,\n  ): BluetoothSdkSubscription\n\n  /** Read an immutable snapshot of the current glasses state. */\n  getGlassesStatus(): Promise<PublicGlassesStatus>\n  /** Read an immutable snapshot of the phone Bluetooth adapter state. */\n  getBluetoothStatus(): Promise<PublicBluetoothStatus>\n  /** Observe immutable glasses-state patches. Returns an unsubscribe function. */\n  subscribeGlassesStatus(listener: (changed: Partial<PublicGlassesStatus>) => void): () => void\n  /** Observe immutable Bluetooth-state patches. Returns an unsubscribe function. */\n  subscribeBluetoothStatus(listener: (changed: Partial<PublicBluetoothStatus>) => void): () => void\n\n  getDefaultDevice(): Promise<Device | null>\n  setDefaultDevice(device: Device | null): Promise<void>\n  clearDefaultDevice(): Promise<void>\n\n  startScan(model: DeviceModel): Promise<void>\n  stopScan(): Promise<void>\n  scan(options: ScanOptions): Promise<Device[]>\n  scan(model: DeviceModel, options?: ScanModelOptions): Promise<Device[]>\n  connect(device: Device, options?: ConnectOptions): Promise<void>\n  connectDefault(options?: ConnectOptions): Promise<void>\n  cancelConnectionAttempt(): Promise<void>\n  disconnect(): Promise<void>\n  forget(): Promise<void>\n\n  displayText(text: string, x?: number, y?: number, size?: number): Promise<void>\n  clearDisplay(): Promise<void>\n  /** Set session-only content below the dashboard status header. Pass an empty string to reset it. */\n  setDashboardContent(content: string): Promise<void>\n  showDashboard(): Promise<void>\n  setDashboardPosition(height: number, depth: number): Promise<void>\n  setHeadUpAngle(angleDegrees: number): Promise<void>\n  setImuEnabled(enabled: boolean): Promise<void>\n  setScreenDisabled(disabled: boolean): Promise<void>\n  /** Keep legacy Mentra Live OTA sessions awake. Modern sessions normally do not require this. */\n  ping(): Promise<void>\n\n  requestWifiScan(): Promise<WifiSearchResult[]>\n  /** List exact WiFi SSIDs from glasses that support reliable saved-network enumeration. */\n  getSavedWifiNetworks(): Promise<SavedWifiNetworksResult>\n  sendWifiCredentials(ssid: string, password: string): Promise<WifiStatusChangeEvent>\n  /** Forget a saved network and return its correlated semantic outcome. */\n  forgetWifiNetwork(ssid: string): Promise<WifiForgetResult>\n  setHotspotState(enabled: boolean): Promise<HotspotStatusChangeEvent>\n  /** Set the glasses clock from the phone after an OTA clock-skew failure. */\n  setSystemTime(timestampMs: number): Promise<void>\n  /** Enable or disable Wi-Fi ADB on Mentra Live (no-op on other devices). */\n  setWifiAdbState(enabled: boolean): Promise<void>\n\n  /**\n   * Persistently enable/disable unauthenticated HTTP gallery access on the glasses' Wi-Fi.\n   * Default off; survives reconnects/restarts until disabled. Only use on trusted networks.\n   * Returns saved enabled state plus current listening/url. No Wi-Fi means listening=false.\n   */\n  setGalleryServerEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>\n  setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>\n  setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>\n  setLoudnessGateEnabled(enabled: boolean): Promise<void>\n  setAutoPowerOffEnabled(enabled: boolean): Promise<void>\n  /**\n   * @deprecated Sticky action-button photo presets are deprecated. Prefer per-request\n   * `requestPhoto(...)` options (e.g. `mode: \"text\"` for text sensor size/crop, or explicit per-shot\n   * fields). Still functional until removed in a future release.\n   */\n  setPhotoCaptureDefaults(settings: PhotoCaptureDefaults): Promise<SettingsAckSuccessEvent>\n  setVideoRecordingDefaults(settings: VideoRecordingDefaults): Promise<SettingsAckSuccessEvent>\n  setMaxVideoRecordingDuration(minutes: number): Promise<SettingsAckSuccessEvent>\n  setCameraFov(request: CameraFovRequest): Promise<CameraFovResult>\n  /** One-way FOV command for legacy ASG clients that do not send settings acknowledgements. */\n  setLegacyCameraFov(request: CameraFovRequest): Promise<CameraFovResult>\n  setCameraFovOverride(request: CameraFovOverrideRequest): Promise<CameraFovResult>\n  releaseCameraFovOverride(leaseId: string): Promise<SettingsAckSuccessEvent>\n  /**\n   * Configure camera HAL tuning (ANR / gain) on Mentra Live glasses.\n   *\n   * The phone sends a {@code camera_tuning_config} BLE command; the glasses relay it as a\n   * {@code camconfig} broadcast to the camera HAL so parameters take effect without a reboot.\n   *\n   * **Scan-mode convention**: call with `(false, false)` when activating scan mode to disable ANR\n   * and pixsmart gain for sharper text/barcode captures. Call with `(true, true)` to restore\n   * defaults when exiting scan mode.\n   *\n   * @param anrOn  `true` = ANR enabled (default), `false` = ANR disabled\n   * @param gainOn `true` = stock gain params (default), `false` = pixsmart gain-off params\n   */\n  setCameraTuningConfig(anrOn: boolean, gainOn: boolean): Promise<SettingsAckSuccessEvent>\n  queryGalleryStatus(): Promise<GalleryStatusEvent>\n  requestPhoto(params: PhotoRequestParams): Promise<PhotoSuccessResponseEvent>\n  warmUpCamera(params: WarmUpCameraParams): Promise<CameraStatusEvent>\n  /** Release one request-owned warm-up. Opening requests reject with camera_warm_up_cancelled. */\n  stopCameraWarmUp(requestId: string): Promise<void>\n  startVideoRecording(\n    requestId: string,\n    save: boolean,\n    sound: boolean,\n    settings?: VideoRecordingSettings,\n  ): Promise<VideoRecordingStartedStatusEvent>\n  /**\n   * Stop the active recording. When {@link webhookUrl} is provided, the glasses\n   * upload the recorded video to it (multipart) using {@link authToken}. These\n   * are supplied at stop time (not start) so the token is fresh when the upload\n   * runs 闂?a recording can last arbitrarily long. An empty/omitted webhook keeps\n   * the video on device (no upload).\n   */\n  stopVideoRecording(\n    requestId: string,\n    webhookUrl?: string,\n    authToken?: string,\n  ): Promise<VideoRecordingStoppedStatusEvent>\n  /** Query the glasses for the current recording state and elapsed duration. */\n  queryVideoRecordingStatus(requestId: string): Promise<VideoRecordingStatusEvent>\n\n  startStream(params: StreamStartRequest): Promise<StreamStatusEvent>\n  stopStream(): Promise<StreamStatusEvent>\n\n  setMicState(enabled: boolean, useGlassesMic?: boolean, sendTranscript?: boolean, sendLc3Data?: boolean): Promise<void>\n  setPreferredMic(preferredMic: MicPreference): Promise<void>\n  setOwnAppAudioPlaying(playing: boolean): Promise<void>\n  getGlassesMediaVolume(): Promise<GlassesMediaVolumeGetResult>\n  setGlassesMediaVolume(level: number): Promise<GlassesMediaVolumeSetResult>\n\n  rgbLedControl(\n    requestId: string,\n    packageName: string | null,\n    action: RgbLedAction,\n    color: RgbLedColor | null,\n    onDurationMs: number,\n    offDurationMs: number,\n    count: number,\n  ): Promise<RgbLedControlSuccessResponseEvent>\n\n  requestVersionInfo(): Promise<VersionInfoResult>\n  /**\n   * Select the OTA manifest used by subsequent update checks and installs.\n   * The URL may point at Mentra's hosted manifest or any customer-controlled HTTP(S) server.\n   */\n  setOtaVersionUrl(otaVersionUrl: string): void\n  /** Return the configured or release-embedded OTA manifest URL. Rejects when a source build is unconfigured. */\n  getOtaVersionUrl(): string\n  /** Fetch the configured OTA manifest and return whether any ASG/BES/MTK update is available. */\n  checkForOtaUpdate(): Promise<boolean>\n  /** Return bundled release changelogs crossed between two coordinated product versions, newest first. */\n  getReleaseChangelogs(fromVersion?: string | null, toVersion?: string | null): ReleaseChangelog[]\n  /** Start OTA from the configured or explicitly supplied manifest URL. */\n  startOtaUpdate(otaVersionUrl?: string | null): Promise<OtaStartAckEvent>\n  /** Query the active OTA session and return the correlated status response. */\n  queryOtaStatus(): Promise<OtaQueryResult>\n  startAr99OtaFromFile(path: string): Promise<boolean>\n  cancelAr99Ota(): Promise<void>\n  sendAr99FactoryReset(): Promise<void>\n  buildAr99OtaSignature(\n    secret: string,\n    appName: string,\n    currentVersion: string,\n    serialNumber: string,\n    nonce: string,\n  ): string\n\n  // // stt commands (MOVE TO CRUST)\n  // setSttModelDetails(path: string, languageCode: string): Promise<void>\n  // getSttModelPath(): Promise<string>\n  // checkSttModelAvailable(): Promise<boolean>\n  // validateSttModel(path: string): Promise<boolean>\n  // extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>\n\n  // // tts commands (MOVE TO CRUST)\n  // setTtsModelDetails(path: string, languageCode: string): Promise<void>\n  // getTtsModelPath(): Promise<string>\n  // getTtsModelLanguage(): Promise<string>\n  // checkTtsModelAvailable(): Promise<boolean>\n  // validateTtsModel(path: string): Promise<boolean>\n  // generateTtsAudio(text: string, path: string, outputPath: string, speakerId: number, speed: number): Promise<boolean>\n\n  // STT Commands (TODO: MOVE TO CRUST)\n  setSttModelDetails(path: string, languageCode: string): Promise<void>\n  getSttModelPath(): Promise<string>\n  checkSttModelAvailable(): Promise<boolean>\n  validateSttModel(path: string): Promise<boolean>\n  extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>\n  restartTranscriber(): Promise<void>\n\n  // TTS Commands (TODO: MOVE TO CRUST)\n  setTtsModelDetails(path: string, languageCode: string): Promise<void>\n  getTtsModelPath(): Promise<string>\n  getTtsModelLanguage(): Promise<string>\n  checkTtsModelAvailable(): Promise<boolean>\n  validateTtsModel(path: string): Promise<boolean>\n  generateTtsAudio(\n    text: string,\n    modelPath: string,\n    outputPath: string,\n    speakerId: number,\n    speed: number,\n  ): Promise<boolean>\n}\n\n// OTA update status types\nexport type OtaStage = \"download\" | \"install\"\nexport type OtaProgressStatus = \"STARTED\" | \"PROGRESS\" | \"FINISHED\" | \"FAILED\"\n\nexport interface OtaStatus {\n  sessionId: string\n  totalSteps: number\n  currentStep: number\n  stepType: \"apk\" | \"mtk\" | \"bes\"\n  phase: \"download\" | \"install\"\n  stepPercent: number\n  /** Real bytes received in the current download; independent of rounded percent. */\n  bytesDownloaded?: number\n  overallPercent: number\n  status: \"in_progress\" | \"step_complete\" | \"complete\" | \"failed\" | \"idle\"\n  error?: string\n}\n\nexport interface OtaUpdateInfo {\n  available: boolean\n  versionCode: number\n  versionName: string\n  updates: string[] // [\"apk\", \"mtk\", \"bes\"]\n  totalSize: number\n  cacheReady?: boolean\n  /** Exact BES target selected from the OTA manifest, when a BES step is pending. */\n  besVersion?: string\n  /** True when the APK step installs an older build than the glasses currently run (exact-pin manifests only). */\n  isDowngrade?: boolean\n}\n\nexport interface ReleaseChangelog {\n  /** Base production version, for example `3.1.0`. */\n  version: string\n  /** Markdown body authored in `/changelogs/<version>.md`. */\n  markdown: string\n}\n\nexport interface OtaProgress {\n  stage: OtaStage\n  status: OtaProgressStatus\n  progress: number\n  bytesDownloaded: number\n  totalBytes: number\n  currentUpdate: string\n  errorMessage?: string\n}\n\nexport interface GlassesStatus {\n  // state:\n  connection: GlassesConnectionStatus\n  micEnabled: boolean\n  voiceActivityDetectionEnabled: boolean\n  bluetoothClassicConnected: boolean\n  signalStrength: number\n  /** Milliseconds since epoch when signalStrength was last refreshed by the phone BLE stack. */\n  signalStrengthUpdatedAt: number\n  // device info\n  deviceModel: string\n  androidVersion: string\n  firmwareVersion: string\n  besFirmwareVersion: string\n  mtkFirmwareVersion: string\n  bluetoothMacAddress: string\n  wifiMacAddress: string\n  leftMacAddress: string\n  rightMacAddress: string\n  buildNumber: string\n  /** Glasses System.currentTimeMillis() from last version_info (clock skew detection). */\n  systemTimeMs?: number\n  otaVersionUrl: string\n  appVersion: string\n  /**\n   * Package the glasses client actually runs as, from `version_info_1`. Empty string on glasses\n   * whose client predates the field. `\"com.mentra.asg_client\"` is the stock client; anything else\n   * is a sideloaded build (Android forces a distinct package on any build not signed with Mentra's\n   * release key) that coexists with the stock app and must not be driven by OTA.\n   */\n  packageName: string\n  /** Phone-served hotspot OTA protocol version; 0 means unsupported/legacy glasses. */\n  hotspotOtaVersion: number\n  bluetoothName: string\n  serialNumber: string\n  style: string\n  color: string\n  // wifi info\n  wifi: WifiStatus\n  // battery info\n  batteryLevel: number\n  charging: boolean\n  caseBatteryLevel: number\n  caseCharging: boolean\n  caseOpen: boolean\n  caseRemoved: boolean\n  // hotspot info\n  hotspot: HotspotStatus\n  // OTA update info\n  otaUpdateAvailable: OtaUpdateInfo | null\n  otaProgress: OtaProgress | null\n  otaInProgress: boolean\n  // ring info\n  controllerConnected: boolean\n  controllerFullyBooted: boolean\n  controllerMacAddress: string\n  controllerBatteryLevel: number\n  controllerSignalStrength: number\n}\n\nexport interface CoreDashboardMenuItem {\n  name: string\n  packageName: string\n  running: boolean\n}\n\nexport interface CalendarEvent {\n  title: string\n  location?: string\n  time: string\n  endDate: number\n}\n\nexport interface CoreSettings {\n  menu_apps: CoreDashboardMenuItem[]\n  calendar_events: CalendarEvent[]\n}\n\nexport interface Device {\n  /**\n   * Stable app-facing key for this scan result, within the limits of the\n   * platform identifier available to the SDK. Do not parse this value; use the\n   * typed model, name, address, projectName, and rssi fields instead.\n   */\n  id: string\n  model: DeviceModel\n  name: string\n  /** Platform address/identifier when available: Android Bluetooth address, iOS CoreBluetooth identifier. */\n  address?: string\n  /** Optional AR99 project discriminator. Supported value: AR99. */\n  projectName?: string\n  /**\n   * Optional scan signal strength. It may be undefined at first discovery and\n   * appear in a later scan update when the platform reports RSSI metadata.\n   */\n  rssi?: number\n  /** Mentra Live: unit is currently in pairing mode (adv flag). */\n  pairingMode?: boolean\n  /** Mentra Live: four-character hex spoken pairing code when available. */\n  pairingCode?: string\n  /** Mentra Live: advertisement carries the secure-pairing capability trailer. */\n  securePairingCapable?: boolean\n}\n\nexport interface ConnectOptions {\n  saveAsDefault?: boolean\n  cancelExistingConnectionAttempt?: boolean\n  /**\n   * iOS Mentra Live only. When true, CoreBluetooth requires ANCS authorization\n   * as part of the connection. Set false when the app does not use notification\n   * relay and must avoid the system ANCS authorization flow. Defaults to true.\n   * Android accepts this option as a no-op.\n   */\n  requiresAncs?: boolean\n}\n\nexport type ScanResultsCallback = (devices: Device[]) => void\n\n/** Advisory for an empty scan. System connection state does not identify an owning app. */\nexport interface ScanDiagnostic {\n  code: string\n  message: string\n}\n\nexport interface ScanOptions {\n  model: DeviceModel\n  /** Defaults to 15000. */\n  timeoutMs?: number\n  /** Alias for `timeoutMs`, useful when mirroring native examples. */\n  timeout?: number\n  /** Called every time the discovered device list changes during the scan. */\n  onResults?: ScanResultsCallback\n  /** Optional non-fatal hint before an empty scan resolves, on Android and iOS. */\n  onDiagnostic?: (diagnostic: ScanDiagnostic) => void\n}\n\nexport type ScanModelOptions = Omit<ScanOptions, \"model\">\n\nexport interface WifiSearchResult {\n  ssid: string\n  requiresPassword: boolean\n  signalStrength: number\n  /** Frequency in MHz (from glasses scan). 5 GHz band is typically 5170闂?825. Omitted if unknown. */\n  frequency?: number\n}\n\nexport interface BluetoothStatus {\n  // state:\n  searching: boolean\n  searchingController: boolean\n  default_wearable?: DeviceModel | \"\"\n  pending_wearable?: DeviceModel | \"\"\n  device_name?: string\n  device_address?: string\n  default_controller?: DeviceModel | \"\"\n  pending_controller?: DeviceModel | \"\"\n  controller_device_name?: string\n  controller_address?: string\n  systemMicUnavailable: boolean\n  micRanking: MicMode[]\n  currentMic: MicMode | \"\" | null\n  /**\n   * Nearby glasses in stable discovery order.\n   * Existing entries keep their array position as details refresh; new glasses append at the end,\n   * and removals should not reorder remaining entries.\n   */\n  searchResults: Device[]\n  wifiScanResults: WifiSearchResult[]\n  lastLog: string[]\n  otherBtConnected: boolean\n  // desired settings the SDK sends to compatible connected glasses:\n  galleryModeEnabled: boolean\n}\n\nexport type BluetoothSettingsUpdate = Partial<{\n  auth_email: string\n  core_token: string\n  sensing_enabled: boolean\n  power_saving_mode: boolean\n  lc3_frame_size: number\n  preferred_mic: MicPreference\n  screen_disabled: boolean\n  contextual_dashboard: boolean\n  head_up_angle: number\n  imu_enabled: boolean\n  brightness: number\n  auto_brightness: boolean\n  dashboard_height: number\n  dashboard_depth: number\n  menu_apps: DashboardMenuItem[] | CoreDashboardMenuItem[] | Array<Record<string, unknown>> | null\n  calendar_events: CalendarEvent[]\n  metric_system: boolean\n  twelve_hour_time: boolean\n  gallery_mode: boolean\n  voice_activity_detection_enabled: boolean\n  loudness_gate_enabled: boolean\n  auto_power_off_enabled: boolean\n  /** Effective mic tuning only. `{}` means \"reset to firmware defaults\". */\n  mic_tuning: MicTuning\n  button_photo_size: ButtonPhotoSize\n  button_video_settings: {width: number; height: number; fps: number}\n  button_video_width: number\n  button_video_height: number\n  button_video_fps: number\n  button_max_recording_time: number\n  camera_fov: NativeCameraFovSetting\n  should_send_pcm: boolean\n  should_send_lc3: boolean\n  should_send_transcript: boolean\n  offline_mode: boolean\n  local_stt_fallback_active: boolean\n  pending_wearable: DeviceModel | \"\"\n  default_wearable: DeviceModel | \"\"\n  device_name: string\n  device_address: string\n  default_controller: DeviceModel | \"\"\n  pending_controller: DeviceModel | \"\"\n  controller_device_name: string\n  controller_address: string\n}>\n"]}
+{"version":3,"file":"BluetoothSdk.types.js","sourceRoot":"","sources":["../src/BluetoothSdk.types.ts"],"names":[],"mappings":"AA2CA,MAAM,CAAC,MAAM,wCAAwC,GAAG,KAAK,CAAA;AAwB7D,MAAM,UAAU,kCAAkC,CAChD,MAA+B;IAE/B,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAA+B;IAC5E,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,MAAM,CAAC,WAAW,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAA+B;IAC3E,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,KAAK,KAAK,YAAY,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAA;AACnG,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,UAAU,EAAE,EAAC,KAAK,EAAE,cAAc,EAAC;QACnC,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,EAAC,KAAK,EAAE,UAAU,EAAC;QAC5B,6BAA6B,EAAE,wCAAwC;QACvE,IAAI,EAAE,EAAC,KAAK,EAAE,cAAc,EAAC;KAC9B,CAAA;AACH,CAAC;AA2BD,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACtD,OAAO,MAAM,CAAC,KAAK,KAAK,WAAW,CAAA;AACrC,CAAC;AAkFD,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS,CAAA;AACnC,CAAC;AAoeD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,EAAE,EAAE,mBAAmB;IACvB,EAAE,EAAE,mBAAmB;IACvB,UAAU,EAAE,aAAa;IACzB,SAAS,EAAE,gBAAgB;IAC3B,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,iBAAiB;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,mBAAmB;CACf,CAAA;AAWV,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAA;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAA","sourcesContent":["import type {PhotoCompression} from \"@mentra/cloud-protocol/photo-compression\"\nexport type {PhotoCompression} from \"@mentra/cloud-protocol/photo-compression\"\n\n// Bluetooth SDK Event Types\nexport type GlassesNotReadyEvent = {\n  type: \"glasses_not_ready\"\n  message: string\n}\n\n// NOTE: unlike most events below, the native module does NOT include a `type`\n// field on the button_press payload 闂?it sends only {buttonId, pressType,\n// timestamp} (see BluetoothSdkModule on both iOS and Android). Consumers must\n// filter on `pressType` / the \"button_press\" listener name, never `event.type`.\nexport type ButtonPressEvent = {\n  buttonId: string\n  pressType: \"long\" | \"short\"\n  timestamp: number\n}\n\nexport type TouchEvent = {\n  type: \"touch_event\"\n  deviceModel: DeviceModel\n  gestureName: string\n  timestamp: number\n}\n\nexport type AccelEvent = {\n  type: \"accel_event\"\n  x: number\n  y: number\n  z: number\n  timestamp: number\n}\n\nexport type HeadUpEvent = {\n  up: boolean\n}\n\nexport type VoiceActivityDetectionStatusEvent = {\n  type: \"voice_activity_detection_status\"\n  voiceActivityDetectionEnabled: boolean\n}\n\nexport const DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED = false\n\nexport type SpeakingStatusEvent = {\n  type: \"speaking_status\"\n  speaking: boolean\n  timestamp: number\n}\n\nexport type BatteryStatusEvent = {\n  type: \"battery_status\"\n  level: number\n  charging: boolean\n  timestamp: number\n}\n\nexport type GlassesConnectionStatus =\n  | {state: \"disconnected\"}\n  | {state: \"scanning\"}\n  | {state: \"connecting\"}\n  | {state: \"bonding\"}\n  | {state: \"connected\"; fullyBooted: boolean}\n\nexport type ConnectedGlassesConnectionStatus = Extract<GlassesConnectionStatus, {state: \"connected\"}>\n\nexport function isConnectedGlassesConnectionStatus(\n  status: GlassesConnectionStatus,\n): status is ConnectedGlassesConnectionStatus {\n  return status.state === \"connected\"\n}\n\nexport function isReadyGlassesConnectionStatus(status: GlassesConnectionStatus): boolean {\n  return status.state === \"connected\" && status.fullyBooted\n}\n\nexport function isBusyGlassesConnectionStatus(status: GlassesConnectionStatus): boolean {\n  return status.state === \"scanning\" || status.state === \"connecting\" || status.state === \"bonding\"\n}\n\nexport function createDisconnectedGlassesStatus(): Partial<GlassesStatus> {\n  return {\n    connection: {state: \"disconnected\"},\n    g2MissingArm: null,\n    hotspot: {state: \"disabled\"},\n    voiceActivityDetectionEnabled: DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,\n    wifi: {state: \"disconnected\"},\n  }\n}\n\n/** K900 `sr_getvol` response (Mentra Live glasses media step volume 0闂?5). */\nexport type GlassesMediaVolumeGetResult = {\n  level: number\n  statusCode: number\n}\n\n/** K900 `sr_vol` acknowledgment. */\nexport type GlassesMediaVolumeSetResult = {\n  statusCode: number\n}\n\nexport type LocalTranscriptionEvent = {\n  text: string\n  isFinal?: boolean\n  transcribeLanguage?: string\n}\n\nexport type LogEvent = {\n  message: string\n}\n\nexport type WifiStatus = {state: \"disconnected\"} | {state: \"connected\"; ssid: string; localIp?: string}\n\nexport type ConnectedWifiStatus = Extract<WifiStatus, {state: \"connected\"}>\n\nexport function isConnectedWifiStatus(status: WifiStatus): status is ConnectedWifiStatus {\n  return status.state === \"connected\"\n}\n\nexport type WifiStatusChangeEvent = WifiStatus & {\n  type: \"wifi_status_change\"\n  /**\n   * Glasses-reported provisioning failure reason when THIS event is the verdict of a\n   * failed connect attempt; absent on routine link-state updates. An attempt property,\n   * not a link property 闂?which is why it lives on the event, not on WifiStatus:\n   * \"connect_timeout\" arrives on a disconnected status (never associated), while\n   * \"connected_to_other_network\" arrives on a *connected* status (the attempt failed\n   * and the glasses ended up on / fell back to a different SSID than requested).\n   * Requires ASG client v40+ 闂?older glasses never send it.\n   */\n  error?: string\n}\n\nexport type WifiForgetOutcome =\n  | \"confirmed\"\n  | \"dispatched\"\n  | \"not_found\"\n  | \"unsupported\"\n  | \"failed\"\n  | \"legacy_unverified\"\n\nexport type WifiForgetResult = {\n  ssid: string\n  outcome: WifiForgetOutcome\n  connected?: boolean\n  currentSsid?: string\n  localIp?: string\n  error?: string\n}\n\nexport type ModernWifiForgetResultEvent = {\n  type: \"wifi_forget_result\"\n  mode: \"modern\"\n  requestId: string\n  sid: string\n  ssid: string\n  protocolVersion: number\n  outcome: Exclude<WifiForgetOutcome, \"legacy_unverified\">\n  connected?: boolean\n  currentSsid?: string\n  localIp?: string\n  error?: string\n}\n\nexport type LegacyWifiForgetResultEvent = {\n  type: \"wifi_forget_result\"\n  mode: \"legacy\"\n  ssid: string\n  dispatched: boolean\n  connected?: boolean\n  currentSsid?: string\n  localIp?: string\n  error?: string\n}\n\nexport type WifiForgetResultEvent = ModernWifiForgetResultEvent | LegacyWifiForgetResultEvent\n\nexport type SavedWifiNetworksOutcome = \"confirmed\" | \"unsupported\" | \"failed\"\n\nexport type SavedWifiNetworksResult = {\n  outcome: SavedWifiNetworksOutcome\n  networks: string[]\n  error?: string\n}\n\nexport type SavedWifiNetworksEvent = {\n  type: \"saved_wifi_networks\"\n  requestId: string\n  sid: string\n  protocolVersion: number\n  outcome: SavedWifiNetworksOutcome\n  networks: string[]\n  error?: string\n}\n\nexport type HotspotStatus = {state: \"disabled\"} | {state: \"enabled\"; ssid: string; password: string; localIp: string}\n\nexport type EnabledHotspotStatus = Extract<HotspotStatus, {state: \"enabled\"}>\n\nexport function isEnabledHotspotStatus(status: HotspotStatus): status is EnabledHotspotStatus {\n  return status.state === \"enabled\"\n}\n\nexport type HotspotStatusChangeEvent = HotspotStatus & {\n  type: \"hotspot_status_change\"\n}\n\nexport type HotspotErrorEvent = {\n  type: \"hotspot_error\"\n  errorMessage: string\n  timestamp: number\n}\n\nexport type VersionInfoResult = {\n  versionInfoType?: string\n  sid?: string\n  androidVersion: string\n  firmwareVersion: string\n  besFirmwareVersion: string\n  mtkFirmwareVersion: string\n  buildNumber: string\n  systemTimeMs?: number\n  otaVersionUrl: string\n  appVersion: string\n  /**\n   * Package the glasses client actually runs as, from `version_info_1`.\n   * `\"com.mentra.asg_client\"` is the stock client; anything else is a sideloaded build (Android\n   * forces a distinct package on any build not signed with Mentra's release key) that coexists\n   * with the stock app and must not be driven by OTA.\n   *\n   * Omitted — not empty — whenever this result carries no identity: either the glasses predate\n   * the field, or the response resolved from a `version_info` chunk that does not carry it (only\n   * chunk 1 does). Omission is what keeps a response from overwriting an identity an earlier\n   * chunk established, so treat `undefined` as \"unknown\", never as \"stock\".\n   */\n  packageName?: string\n  /** Phone-served hotspot OTA protocol version; 0 means unsupported/legacy glasses. */\n  hotspotOtaVersion: number\n  /** Session-correlated WiFi forget result protocol; absent/0 means unsupported. */\n  wifiForgetResultVersion?: number\n  /** Session-correlated saved-network listing protocol; absent/0 means unsupported. */\n  savedWifiNetworksVersion?: number\n}\n\nexport type VersionInfoEvent = VersionInfoResult & {\n  type: \"version_info\"\n}\n\nexport type WifiScanResultEvent = {\n  type: \"wifi_scan_result\"\n  networks: WifiSearchResult[]\n  scanComplete?: boolean\n}\n\nexport type PhotoResponseEvent =\n  | {\n      type: \"photo_response\"\n      state: \"success\"\n      requestId: string\n      uploadUrl: string\n      photoUrl?: string\n      statusUrl?: string\n      contentType?: string\n      fileSizeBytes?: number\n      timestamp: number\n    }\n  | {\n      type: \"photo_response\"\n      state: \"error\"\n      requestId: string\n      timestamp: number\n      errorCode?: string\n      errorMessage: string\n    }\n\nexport type PhotoSuccessResponseEvent = Extract<PhotoResponseEvent, {state: \"success\"}>\n\nexport type PhotoStatusState =\n  | \"accepted\"\n  | \"queued\"\n  | \"configuring\"\n  | \"capturing\"\n  | \"captured\"\n  | \"compressing\"\n  | \"ble_fallback_compression\"\n  | \"uploading\"\n  | \"uploaded\"\n  | \"ready_for_transfer\"\n  | \"transferring\"\n  | \"thumbnail_received\"\n  | \"failed\"\n\nexport type PhotoResolvedConfig = {\n  format?: \"jpeg\" | string\n  width?: number\n  height?: number\n  quality?: number\n  requestedSize?: PhotoSize | string\n  source?: \"sdk\" | \"button\" | string\n  transferMethod?: \"webhook\" | \"ble\" | \"local\" | string\n  compression?: PhotoCompression\n  saveToGallery?: boolean\n  exposureTimeNs?: number\n  iso?: number\n}\n\nexport type PhotoFpsRange = {\n  min?: number\n  max?: number\n}\n\nexport type PhotoRequestedCaptureConfig = {\n  manual?: boolean\n  exposureTimeNs?: number\n  iso?: number\n  frameDurationNs?: number\n  aeMode?: number\n  aeLock?: boolean\n  aeExposureCompensation?: number\n  aeTargetFpsRange?: PhotoFpsRange\n  noiseReductionMode?: number\n  edgeMode?: number\n  afMode?: number\n  zsl?: boolean\n}\n\nexport type PhotoMeteredPreview = {\n  exposureTimeNs?: number\n  iso?: number\n  totalLightProxy?: number\n}\n\nexport type PhotoCaptureMetadata = {\n  manual?: boolean\n  exposureTimeNs?: number\n  iso?: number\n  frameDurationNs?: number\n  aeMode?: number\n  aeState?: number\n  aeStateName?: string\n  noiseReductionMode?: number\n  edgeMode?: number\n  zsl?: boolean\n  sensorTimestampNs?: number\n  totalLightProxy?: number\n  mfnrLikely?: boolean\n  mfnrApplied?: boolean\n  width?: number\n  height?: number\n  noiseReductionWarning?: \"not_implemented\" | string\n  ispDigitalGainWarning?: \"not_implemented\" | string\n  ispAnalogGainWarning?: \"not_implemented\" | string\n  [key: string]: unknown\n}\n\nexport type PhotoStatusEvent = {\n  type: \"photo_status\"\n  requestId: string\n  status: PhotoStatusState | string\n  timestamp: number\n  resolvedConfig?: PhotoResolvedConfig\n  requestedCaptureConfig?: PhotoRequestedCaptureConfig\n  meteredPreview?: PhotoMeteredPreview\n  captureMetadata?: PhotoCaptureMetadata\n  errorCode?: string\n  errorMessage?: string\n  /** Present on thumbnail_received: a JPEG data URI, not the final photo. */\n  thumbnailUrl?: string\n  fileSizeBytes?: number\n}\n\nexport type CameraStatusEvent = {\n  type: \"camera_status\"\n  requestId: string\n  state: \"warming\" | \"ready\" | \"stopped\" | \"error\" | string\n  timestamp: number\n  errorCode?: string\n  errorMessage?: string\n}\n\nexport type VideoRecordingStatusEvent = {\n  type: \"video_recording_status\"\n  requestId?: string\n  success: boolean\n  status: VideoRecordingStatusState\n  details?: string | null\n  timestamp: number\n  data?: {\n    recording?: boolean\n    duration_ms?: number\n    duration_formatted?: string\n    [key: string]: unknown\n  }\n}\n\nexport type VideoRecordingStatusState =\n  | \"recording_started\"\n  | \"recording_status\"\n  | \"already_recording\"\n  | \"recording_stopped\"\n  | \"not_recording\"\n  | \"request_id_mismatch\"\n  | \"service_unavailable\"\n  | \"json_error\"\n  | \"battery_low\"\n  | \"camera_busy\"\n  | \"storage_unavailable\"\n  | \"integrity_failed\"\n  | \"error\"\n\nexport type VideoRecordingStartedStatusEvent = Omit<VideoRecordingStatusEvent, \"success\" | \"status\"> & {\n  success: true\n  status: \"recording_started\"\n}\n\nexport type VideoRecordingStoppedStatusEvent = Omit<VideoRecordingStatusEvent, \"success\" | \"status\"> & {\n  success: true\n  status: \"recording_stopped\"\n}\n\nexport type VideoRecordingSuccessStatusEvent = VideoRecordingStartedStatusEvent | VideoRecordingStoppedStatusEvent\n\nexport type MediaUploadSuccessEvent = {\n  type: \"media_success\"\n  requestId: string\n  mediaUrl: string\n  mediaType: number\n  timestamp: number\n}\n\nexport type MediaUploadErrorEvent = {\n  type: \"media_error\"\n  requestId: string\n  errorMessage: string\n  mediaType: number\n  timestamp: number\n}\n\nexport type MediaUploadEvent = MediaUploadSuccessEvent | MediaUploadErrorEvent\n\nexport type GalleryStatusEvent = {\n  type: \"gallery_status\"\n  photos: number\n  videos: number\n  total: number\n  totalSize?: number\n  hasContent: boolean\n  cameraBusy: boolean\n  cameraBusyReason?: \"video\" | \"stream\" | (string & {})\n}\n\nexport type CompatibleGlassesSearchStopEvent = {\n  type: \"compatible_glasses_search_stop\"\n  deviceModel: DeviceModel\n}\n\nexport type HeartbeatSentEvent = {\n  type: \"heartbeat_sent\"\n  heartbeat_sent: {\n    timestamp: number\n  }\n}\n\nexport type HeartbeatReceivedEvent = {\n  type: \"heartbeat_received\"\n  heartbeat_received: {\n    timestamp: number\n  }\n}\n\nexport type SwipeVolumeStatusEvent = {\n  type: \"swipe_volume_status\"\n  enabled: boolean\n  timestamp: number\n}\n\nexport type SwitchStatusEvent = {\n  type: \"switch_status\"\n  switchType?: number\n  switchValue?: number\n  timestamp: number\n}\n\n/**\n * Mentra Live center-mic gate + ADC gain overrides. Internal SDK surface: this\n * is a super-mode tuning aid, not a public capability.\n *\n * Every field is optional; an omitted field keeps the firmware default. The\n * glasses hold these in RAM only and drop them on disconnect, so the phone\n * re-sends on every connect.\n */\nexport type MicTuning = {\n  /** codec_adc_vol index, 0-15. 15 is +32 dB, the top of the table. */\n  gain?: number\n  /** Gate open / close thresholds, linear RMS on int16 samples. */\n  open?: number\n  close?: number\n  /** Frames of 10 ms. */\n  attack?: number\n  hang?: number\n  /** Thresholds used while the speaker is active or within its hold-off. */\n  sp_open?: number\n  sp_close?: number\n  sp_hold?: number\n}\n\n/**\n * What the glasses report as actually in force, after their own clamping. Use\n * this rather than the requested value when showing applied settings.\n */\nexport type MicTuningStateEvent = MicTuning & {\n  type: \"mic_tuning_state\"\n  /** Tuning revision; increments on every accepted set or reset. */\n  generation: number\n  /** True when any override is in force. */\n  overridden: boolean\n}\n\n/** Live center-mic level. Disposable: samples are dropped under any pressure. */\nexport type MicRmsEvent = {\n  type: \"mic_rms\"\n  rms: number\n  gateOpen: boolean\n  speakerElevated: boolean\n  /** Tuning revision the sample was measured under. */\n  generation: number\n}\n\n/**\n * Mentra Live wear-detection vote. Internal SDK surface: Super Mode only.\n * Values live in RAM on the glasses and reset on disconnect.\n */\nexport type WearTuning = {\n  /** Poll period in milliseconds. Firmware clamp: 50–2000. */\n  interval?: number\n  /** Sliding-window length. Firmware clamp: 3–15. */\n  count?: number\n  /** Votes needed to flip, either direction. Must be > count/2 and ≤ count. */\n  majority?: number\n}\n\n/** Current wear vote from sr_wrst, or an unsolicited wear transition. */\nexport type WearStateEvent = {\n  type: \"wear_state\"\n  worn: boolean\n  /** Unworn countdown, present on firmware that reports it. Milliseconds. */\n  elapsedMs?: number\n  timeoutMs?: number\n  /** cs_swit type 11. Absent on older firmware. */\n  enabled?: boolean\n  /** Countdown is running (glasses are off the face and the feature is on). */\n  armed?: boolean\n  /** Clock is running, but charging, a call, OTA, or factory test is holding shutdown. */\n  inhibited?: boolean\n}\n\n/**\n * What the wear poll loop is actually running. A rejected patch echoes the\n * unchanged values with `accepted: false`.\n */\nexport type WearTuningEvent = WearTuning & {\n  type: \"wear_tuning\"\n  enabled: boolean\n  interval: number\n  count: number\n  majority: number\n  generation: number\n  accepted: boolean\n}\n\nexport type RgbLedControlResponseEvent =\n  | {\n      type: \"rgb_led_control_response\"\n      state: \"success\"\n      requestId: string\n    }\n  | {\n      type: \"rgb_led_control_response\"\n      state: \"error\"\n      requestId: string\n      errorCode: string\n    }\n\nexport type RgbLedControlSuccessResponseEvent = Extract<RgbLedControlResponseEvent, {state: \"success\"}>\n\nexport type SettingsAckStatus = \"applied\" | \"ready\" | \"error\" | \"failed\" | \"failure\" | \"rejected\"\n\nexport type SettingsAckSetting =\n  | \"gallery_server\"\n  | \"gallery_mode\"\n  | \"button_photo\"\n  | \"button_video_recording\"\n  | \"button_max_recording_time\"\n  | \"camera_fov\"\n  | \"camera_fov_override\"\n  | \"camera_tuning\"\n\nexport type SettingsAckEvent = {\n  type: \"settings_ack\"\n  requestId: string\n  setting: SettingsAckSetting\n  status: SettingsAckStatus\n  timestamp: number\n  fov?: number\n  roiPosition?: CameraRoiPositionValue\n  hardwareApplied?: boolean\n  leaseId?: string\n  active?: boolean\n  size?: ButtonPhotoSize | string\n  width?: number\n  height?: number\n  fps?: number\n  enabled?: boolean\n  minutes?: number\n  /** Current site-network listener state; present for gallery_server acknowledgements. */\n  listening?: boolean\n  /** Current HTTP base URL; present for gallery_server only while listening. */\n  url?: string\n  /** ANR enabled flag; present when setting === \"camera_tuning\" */\n  anr?: boolean\n  /** Stock-gain flag; present when setting === \"camera_tuning\" */\n  gain?: boolean\n  errorCode?: string\n  errorMessage?: string\n}\n\nexport type SettingsAckSuccessStatus = Exclude<SettingsAckStatus, \"error\" | \"failed\" | \"failure\" | \"rejected\">\n\nexport type SettingsAckSuccessEvent = Omit<SettingsAckEvent, \"status\"> & {\n  status: SettingsAckSuccessStatus\n}\n\nexport type RgbLedAction = \"on\" | \"off\"\nexport type RgbLedColor = \"red\" | \"green\" | \"blue\" | \"orange\" | \"white\"\nexport type PhotoSize = \"low\" | \"medium\" | \"high\" | \"max\"\nexport type PhotoMode = \"photo\" | \"text\"\nexport type PhotoTransferMethod = \"auto\" | \"direct\" | \"ble\"\nexport type ButtonPhotoSize = \"low\" | \"medium\" | \"high\" | \"max\"\n\n/**\n * @deprecated Sticky action-button photo presets via {@link BluetoothSdkPublicModule.setPhotoCaptureDefaults}\n * are deprecated. Prefer per-request {@link BluetoothSdkPublicModule.requestPhoto} options\n * (e.g. `mode: \"text\"` for text sensor size/crop, or explicit `aeExposureDivisor`) instead of\n * persisting button-photo tuning on the glasses.\n */\nexport type PhotoCaptureDefaults = {\n  size?: PhotoSize\n  /** ZSL preview buffering for physical camera-button photos. */\n  zsl?: boolean\n  /** MFNR still capture for physical camera-button photos. */\n  mfnr?: boolean\n  noiseReduction?: boolean\n  edgeEnhancement?: boolean\n  ispDigitalGain?: number\n  ispAnalogGain?: string\n  aeExposureDivisor?: number\n  isoCap?: number\n  compress?: PhotoCompression\n  sound?: boolean\n  /** When true, clears stored NR/edge/ISP presets on the glasses before applying other fields. */\n  resetCaptureTuning?: boolean\n}\n\nexport type VideoRecordingDefaults = {\n  width: number\n  height: number\n  fps: number\n}\n\n/**\n * Optional per-recording video settings for {@link startVideoRecording}. When\n * omitted, the glasses fall back to their saved video recording defaults. Any\n * field left undefined is omitted from the BLE command (glasses default applies).\n */\nexport interface VideoRecordingSettings {\n  width?: number\n  height?: number\n  fps?: number\n  /**\n   * Optional auto-stop timer in minutes, sent on `start_video_recording`.\n   * `0` (the default) means record until stopped or interrupted\n   * (battery/storage/thermal/error).\n   */\n  maxRecordingTimeMinutes?: number\n}\nexport const DeviceModels = {\n  Simulated: \"Simulated Glasses\",\n  G1: \"Even Realities G1\",\n  G2: \"Even Realities G2\",\n  MentraLive: \"Mentra Live\",\n  MentraNex: \"Mentra Display\",\n  Mach1: \"Mentra Mach1\",\n  Z100: \"Vuzix Z100\",\n  Frame: \"Brilliant Frame\",\n  Nimo: \"NIMO\",\n  Ar99: \"AR99\",\n  R1: \"Even Realities R1\",\n} as const\n\nexport type DeviceModel = (typeof DeviceModels)[keyof typeof DeviceModels]\nexport type ObservableStoreCategory = \"glasses\" | \"bluetooth\" | \"core\"\n\nexport type DashboardMenuItem = {\n  title: string\n  packageName: string\n  values?: Record<string, unknown>\n}\n\nexport const CAMERA_FOV_MIN = 62\nexport const CAMERA_FOV_MAX = 118\nexport const CAMERA_FOV_DEFAULT = CAMERA_FOV_MAX\n\nexport type CameraRoiPosition = \"center\" | \"bottom\" | \"top\"\nexport type CameraRoiPositionValue = 0 | 1 | 2\nexport type CameraFovPreset = \"narrow\" | \"standard\" | \"wide\"\n\nexport type CameraFovRequest =\n  | {\n      fov: number\n      roiPosition?: CameraRoiPosition\n    }\n  | {\n      preset: CameraFovPreset\n    }\n\nexport type CameraFovResult = {\n  requestId: string\n  fov: number\n  roiPosition: CameraRoiPosition\n  timestamp: number\n}\n\nexport type CameraFovOverrideRequest = CameraFovRequest & {\n  /** Phone-owned lease used to make delayed releases safe. */\n  leaseId: string\n  /** Safety TTL; refresh the same lease/configuration to extend without a HAL restart. */\n  ttlMs?: number\n}\n\nexport type CameraFovSetting = {\n  fov: number\n  roiPosition: CameraRoiPositionValue\n}\n\ntype NativeCameraFovSetting = {\n  fov: number\n  roi_position: CameraRoiPositionValue\n}\n\nexport type MicPreference = \"auto\" | \"phone\" | \"glasses\" | \"bluetooth\"\nexport type MicMode = \"phone\" | \"glasses\" | \"bluetoothClassic\" | \"bluetooth\"\n\nexport type PhotoRequestParams = {\n  /**\n   * Send an oriented <=500px, quality-50 JPEG preview before the full photo. Default false.\n   * Enables a 110-second end-to-end native deadline (ordinary requests: 30 seconds).\n   */\n  presend_thumbnail?: boolean\n  requestId?: string\n  appId?: string\n  size: PhotoSize\n  mode?: PhotoMode\n  /** `direct` disables BLE fallback; `ble` skips direct upload and forces phone-relayed transfer. */\n  transferMethod?: PhotoTransferMethod\n  webhookUrl: string | null\n  authToken: string | null\n  compress?: PhotoCompression\n  save?: boolean\n  sound: boolean\n  exposureTimeNs?: number | null\n  /** Sensor ISO for this capture only. Only used when exposureTimeNs enables manual exposure. */\n  iso?: number | null\n  /** After AE convergence, divide metered exposure by this factor (scan mode). */\n  aeExposureDivisor?: number\n  /** Cap ISO after AE metering (scan mode). */\n  isoCap?: number\n  /** Requested on wire; glasses may log not_implemented. */\n  noiseReduction?: boolean\n  edgeEnhancement?: boolean\n  /** ZSL buffering. Forced off for manual/scan stills because fixed sensor controls take priority. */\n  zsl?: boolean\n  /** MFNR still capture. Forced off for manual/scan stills because fixed sensor controls take priority. */\n  mfnr?: boolean\n  ispDigitalGain?: number\n  ispAnalogGain?: string\n}\n\nexport type WarmUpCameraParams = {\n  /** Supply this when the owner needs to call stopCameraWarmUp during teardown. */\n  requestId?: string\n  size: PhotoSize\n  mode?: PhotoMode\n  exposureTimeNs?: number | null\n  /** Ready-state hold; defaults to 15 seconds and is capped at 5 minutes by ASG. */\n  durationMs?: number\n  /** ZSL preview buffering for the warm-up session. */\n  zsl?: boolean\n  /** MFNR still capture for the warm-up session. */\n  mfnr?: boolean\n}\n\nexport type StreamDegradationPreference = \"MAINTAIN_FRAMERATE\" | \"MAINTAIN_RESOLUTION\" | \"BALANCED\" | \"DISABLED\"\n\nexport type StreamVideoConfig = {\n  width?: number\n  height?: number\n  bitrate?: number\n  /** WHIP minimum target in bps; omitted leaves it unset. Clamped to the maximum. */\n  minBitrateBps?: number\n  /** WHIP startup bitrate in bps, clamped to the requested bounds. */\n  initialBitrateBps?: number\n  fps?: number\n  /** WHIP adaptation policy. Omit to keep the glasses' MAINTAIN_FRAMERATE default. */\n  degradationPreference?: StreamDegradationPreference\n}\n\nexport type StreamAudioConfig = {\n  bitrate?: number\n  sampleRate?: number\n  echoCancellation?: boolean\n  noiseSuppression?: boolean\n}\n\n/** ICE overrides for a WHIP stream. Ignored by the RTMP and SRT paths. */\nexport type StreamIceConfig = {\n  /**\n   * STUN server the glasses should use while gathering candidates.\n   *\n   * Omit to keep the default Cloudflare STUN server. Pass an empty string to force host-only\n   * gathering, which is what SoftAP calling needs: the WHIP server runs on the phone across the\n   * glasses' own hotspot, so a server-reflexive candidate is meaningless and there is no route to\n   * a STUN server anyway. A value that is not a `stun:`/`stuns:` URI is ignored and the default is\n   * kept, so a malformed override cannot silently disable ICE.\n   */\n  stun?: string\n}\n\nexport type StreamStartRequest = {\n  type?: \"start_stream\"\n  streamUrl: string\n  streamId?: string\n  sound?: boolean\n  video?: StreamVideoConfig\n  audio?: StreamAudioConfig\n  ice?: StreamIceConfig\n  /** When false, glasses skip mic capture. Defaults to true. */\n  captureAudio?: boolean\n  /**\n   * Correlation id echoed by the glasses in every SOFTAP_TRACE log line, so phone and glasses\n   * logs can be joined despite having unsynchronised clocks.\n   *\n   * TEMPORARY: part of the SoftAP diagnostic trace layer.\n   */\n  traceId?: string\n  authToken?: string\n  telemetry?: boolean\n}\n\nexport type StreamKeepAliveRequest = {\n  type?: \"keep_stream_alive\"\n  streamId: string\n  ackId: string\n}\n\nexport type PairFailureEvent = {\n  type: \"pair_failure\"\n  error: string\n}\n\nexport type PairingInfoEvent = {\n  had_previous_bond: boolean\n  pairing_code?: string\n  classic_bond_ready?: boolean\n  secure_pairing_capable?: boolean\n  protocol_version?: number\n}\n\nexport type EnteringPairingModeEvent = {\n  window_ms: number\n  reason?: string\n}\n\nexport type OwnerReplacedEvent = {\n  reason: string\n}\n\nexport type AudioPairingNeededEvent = {\n  type: \"audio_pairing_needed\"\n  deviceName: string\n}\n\nexport type AudioConnectedEvent = {\n  type: \"audio_connected\"\n  deviceName: string\n}\n\nexport type AudioDisconnectedEvent = {\n  type: \"audio_disconnected\"\n}\n\nexport type SaveSettingEvent = {\n  type: \"save_setting\"\n  key: string\n  value: any\n}\n\nexport type WsTextEvent = {\n  type: \"ws_text\"\n  text: string\n}\n\nexport type WsBinEvent = {\n  type: \"ws_bin\"\n  base64: string\n}\n\nexport type MicPcmEvent = {\n  type: \"mic_pcm\"\n  pcm: ArrayBuffer\n  sampleRate: 16000\n  bitsPerSample: 16\n  channels: 1\n  encoding: \"pcm_s16le\"\n  voiceActivityDetectionEnabled: boolean\n  /**\n   * The microphone this buffer came from (`\"glasses\"`, `\"phone\"`, `\"bluetooth\"`, or `\"\"` when none\n   * is selected). Stamped per frame because the SDK can move the source mid-stream, so a consumer\n   * that told a remote party which microphone it is sending can check rather than assume.\n   */\n  source: string\n}\n\nexport type MicLc3Event = {\n  type: \"mic_lc3\"\n  lc3: ArrayBuffer\n  sampleRate: 16000\n  channels: 1\n  encoding: \"lc3\"\n  frameDurationMs: 10\n  frameSizeBytes: number\n  bitrate: number\n  packetizedFromGlasses: boolean\n  voiceActivityDetectionEnabled: boolean\n}\n\n/** Native glasses-microphone diagnostics emitted when the SDK detects a transport or decode issue. */\nexport type MicHealthEvent = {\n  type: \"mic_health\"\n  reason: \"sequence_gap\" | \"decode_failure\"\n  sequenceGapEvents: number\n  decodeFailures: number\n  lastLc3ReceivedAt?: number\n  lastPcmProducedAt?: number\n  timestamp: number\n}\n\nexport type StreamStatusLifecycleState = \"initializing\" | \"streaming\" | \"stopping\" | \"stopped\"\nexport type StreamStatusReconnectState = \"reconnecting\" | \"reconnected\" | \"reconnect_failed\"\nexport type StreamStatusState = StreamStatusLifecycleState | StreamStatusReconnectState | \"error\"\n\n/** Effective stream settings reported by the glasses after defaults and clamps. */\nexport type StreamResolvedConfig = {\n  transport?: \"rtmp\" | \"srt\" | \"whip\"\n  video?: {\n    /** Encoded output width sent to the stream endpoint. */\n    width: number\n    /** Encoded output height sent to the stream endpoint. */\n    height: number\n    /** Native camera buffer width selected before crop/downscale. */\n    captureWidth?: number\n    /** Native camera buffer height selected before crop/downscale. */\n    captureHeight?: number\n    /** Encoded video bitrate in bits per second. */\n    bitrate: number\n    /** Resolved capture/encode frame rate. */\n    fps: number\n    /** Applied WHIP adaptation policy; absent on older firmware and other transports. */\n    degradationPreference?: StreamDegradationPreference\n  }\n  audio?: {\n    /** Encoded audio bitrate in bits per second. */\n    bitrate?: number\n    /** Audio sample rate in Hz. */\n    sampleRate?: number\n    echoCancellation?: boolean\n    noiseSuppression?: boolean\n  }\n}\n\n/** Live encoder and device telemetry emitted periodically by supported glasses firmware. */\nexport type StreamLiveStats = {\n  /** Current encoded video bitrate in bits per second. */\n  bitrate?: number\n  /** Current encode frame rate. */\n  fps?: number\n  droppedFrames?: number\n  /** Seconds since the stream started. */\n  duration?: number\n  /** Device temperature in 闂佺娅ｉ悡? if the hardware reports it. */\n  temperatureC?: number\n}\n\ntype StreamStatusCommon = {\n  type: \"stream_status\"\n  streamId?: string\n  /** ASG process identity and monotonic revision for reconnect reconciliation. */\n  sid?: string\n  revision?: number\n  terminal?: boolean\n  errorDetails?: string\n  timestamp?: number\n  resolvedConfig?: StreamResolvedConfig\n  stats?: StreamLiveStats\n}\n\nexport type StreamStatusEvent =\n  | (StreamStatusCommon & {\n      kind: \"lifecycle\"\n      status: StreamStatusLifecycleState\n    })\n  | (StreamStatusCommon & {\n      kind: \"reconnect\"\n      status: \"reconnecting\"\n      attempt: number\n      maxAttempts: number\n      reason: string\n    })\n  | (StreamStatusCommon & {\n      kind: \"reconnect\"\n      status: \"reconnected\"\n      attempt: number\n    })\n  | (StreamStatusCommon & {\n      kind: \"reconnect\"\n      status: \"reconnect_failed\"\n      maxAttempts: number\n    })\n  | (StreamStatusCommon & {\n      kind: \"error\"\n      status: \"error\"\n      errorDetails: string\n    })\n  | (StreamStatusCommon & {\n      kind: \"snapshot\"\n      status: StreamStatusState\n      streaming: boolean\n      reconnecting: boolean\n      attempt?: number\n    })\n\nexport type KeepAliveAckEvent = {\n  type: \"keep_alive_ack\"\n  streamId: string\n  ackId: string\n  timestamp?: number\n}\n\nexport type MtkUpdateCompleteEvent = {\n  type: \"mtk_update_complete\"\n  message: string\n  timestamp: number\n}\n\n/**\n * The glasses process restarted while the BES kept the BLE link alive (its `sid`\n * changed, or first appeared after an update from a pre-sid build). There is no\n * physical disconnect for this — treat it as the logical reconnect edge.\n */\nexport type GlassesSessionChangedEvent = {\n  type: \"glasses_session_changed\"\n  previous_sid: string\n  sid: string\n}\n\n/** @deprecated Glasses no longer emit ota_progress; use {@link OtaStatusEvent} and status-store mapping. */\nexport type OtaProgressEvent = {\n  type: \"ota_progress\"\n  stage?: OtaStage\n  status?: OtaProgressStatus\n  progress?: number\n  bytes_downloaded?: number\n  total_bytes?: number\n  current_update?: string\n  error_message?: string\n}\n\nexport type OtaStartAckEvent = {\n  type: \"ota_start_ack\"\n  timestamp: number\n}\nexport type OtaStatusEvent = {\n  type: \"ota_status\"\n  session_id: string\n  total_steps: number\n  current_step: number\n  step_type: \"apk\" | \"mtk\" | \"bes\"\n  phase: \"download\" | \"install\"\n  step_percent: number\n  /** Real bytes received in the current download; absent on older glasses. */\n  bytes_downloaded?: number\n  overall_percent: number\n  status: \"in_progress\" | \"step_complete\" | \"complete\" | \"failed\" | \"idle\"\n  error_message?: string\n}\n\nexport type OtaQueryResult = OtaStatusEvent\n\n/** Nex BLE protobuf trace (NexEventUtils); payload matches native Map keys. */\nexport type BleCommandTraceEvent = {\n  command: string\n  commandText: string\n  timestamp: number\n}\n\nexport type MiniappSelectedEvent = {\n  type: \"miniapp_selected\"\n  packageName: string\n}\n\n// Union type of all native/internal Bluetooth SDK events.\nexport type BluetoothSdkInternalEvent = Parameters<BluetoothSdkModuleEvents[keyof BluetoothSdkModuleEvents]>[0]\n\nexport type BluetoothSdkModuleEvents = {\n  glasses_status: (changed: Partial<GlassesStatus>) => void\n  bluetooth_status: (changed: Partial<BluetoothStatus>) => void\n  log: (event: LogEvent) => void\n  device_discovered: (device: Device) => void\n  default_device_changed: (event: {device?: Device}) => void\n  // Individual event handlers\n  glasses_not_ready: (event: GlassesNotReadyEvent) => void\n  button_press: (event: ButtonPressEvent) => void\n  touch_event: (event: TouchEvent) => void\n  accel_event: (event: AccelEvent) => void\n  head_up: (event: HeadUpEvent) => void\n  voice_activity_detection_status: (event: VoiceActivityDetectionStatusEvent) => void\n  speaking_status: (event: SpeakingStatusEvent) => void\n  battery_status: (event: BatteryStatusEvent) => void\n  local_transcription: (event: LocalTranscriptionEvent) => void\n  native_notification_status: (event: NativeNotificationStatus) => void\n  native_notification_delivery: (event: NativeNotificationDelivery) => void\n  phone_notification: (event: PhoneNotificationEvent) => void\n  phone_notification_dismissed: (event: PhoneNotificationDismissedEvent) => void\n  wifi_status_change: (event: WifiStatusChangeEvent) => void\n  wifi_scan_result: (event: WifiScanResultEvent) => void\n  wifi_forget_result: (event: WifiForgetResultEvent) => void\n  saved_wifi_networks: (event: SavedWifiNetworksEvent) => void\n  hotspot_status_change: (event: HotspotStatusChangeEvent) => void\n  hotspot_error: (event: HotspotErrorEvent) => void\n  photo_response: (event: PhotoResponseEvent) => void\n  photo_status: (event: PhotoStatusEvent) => void\n  camera_status: (event: CameraStatusEvent) => void\n  video_recording_status: (event: VideoRecordingStatusEvent) => void\n  media_success: (event: MediaUploadSuccessEvent) => void\n  media_error: (event: MediaUploadErrorEvent) => void\n  gallery_status: (event: GalleryStatusEvent) => void\n  compatible_glasses_search_stop: (event: CompatibleGlassesSearchStopEvent) => void\n  heartbeat_sent: (event: HeartbeatSentEvent) => void\n  heartbeat_received: (event: HeartbeatReceivedEvent) => void\n  swipe_volume_status: (event: SwipeVolumeStatusEvent) => void\n  switch_status: (event: SwitchStatusEvent) => void\n  mic_tuning_state: (event: MicTuningStateEvent) => void\n  mic_rms: (event: MicRmsEvent) => void\n  wear_state: (event: WearStateEvent) => void\n  wear_tuning: (event: WearTuningEvent) => void\n  rgb_led_control_response: (event: RgbLedControlResponseEvent) => void\n  settings_ack: (event: SettingsAckEvent) => void\n  pair_failure: (event: PairFailureEvent) => void\n  pairing_info: (event: PairingInfoEvent) => void\n  entering_pairing_mode: (event: EnteringPairingModeEvent) => void\n  owner_replaced: (event: OwnerReplacedEvent) => void\n  audio_pairing_needed: (event: AudioPairingNeededEvent) => void\n  audio_connected: (event: AudioConnectedEvent) => void\n  audio_disconnected: (event: AudioDisconnectedEvent) => void\n  save_setting: (event: SaveSettingEvent) => void\n  ws_text: (event: WsTextEvent) => void\n  ws_bin: (event: WsBinEvent) => void\n  mic_pcm: (event: MicPcmEvent) => void\n  mic_lc3: (event: MicLc3Event) => void\n  mic_health: (event: MicHealthEvent) => void\n  stream_status: (event: StreamStatusEvent) => void\n  keep_alive_ack: (event: KeepAliveAckEvent) => void\n  mtk_update_complete: (event: MtkUpdateCompleteEvent) => void\n  glasses_session_changed: (event: GlassesSessionChangedEvent) => void\n  ota_start_ack: (event: OtaStartAckEvent) => void\n  ota_status: (event: OtaStatusEvent) => void\n  ar99_ota_status: (event: Ar99OtaStatusEvent) => void\n  version_info: (event: VersionInfoEvent) => void\n  send_command_to_ble: (event: BleCommandTraceEvent) => void\n  receive_command_from_ble: (event: BleCommandTraceEvent) => void\n  miniapp_selected: (event: MiniappSelectedEvent) => void\n  extraction_progress: (event: ExtractionProgressEvent) => void\n}\n\nexport interface ExtractionProgressEvent {\n  percentage: number\n  bytesRead: number\n  totalBytes: number\n}\n\nexport interface Ar99OtaStatusEvent {\n  type: \"ar99_ota_status\"\n  phase: string\n  progress: number\n  offset: number\n  total: number\n  errorMessage?: string\n  error_message?: string\n}\n\nexport interface PhoneNotificationEvent {\n  notificationId: string\n  app: string\n  title: string\n  content: string\n  priority: string\n  timestamp: number\n  packageName: string\n}\n\nexport interface PhoneNotificationDismissedEvent {\n  notificationId: string\n  notificationKey: string\n  packageName: string\n  timestamp: number\n}\n\n/**\n * Outbound payload for `sendPhoneNotification` — a notification pushed INTO the glasses' own\n * notification centre. The inverse of {@link PhoneNotificationEvent}, which reports\n * notifications the glasses relayed TO the phone (iOS/ANCS). Drivers map these keys onto\n * whatever their firmware expects.\n */\nexport interface NativeNotificationConfig {\n  enabled: boolean\n  autoDisplay: boolean\n  durationSeconds: number\n  doNotDisturb: boolean\n  /** Android package names. iOS rejects nonempty lists; its ANCS filter is firmware-owned. */\n  blockedApps: string[]\n}\n\nexport interface NativeNotificationStatus {\n  supported: boolean\n  source: \"phone\" | \"ancs\" | \"unsupported\"\n  authorization: \"system\" | \"authorized\" | \"not_authorized\" | \"unknown\"\n  /** `submitted` is not a firmware-confirmed acknowledgement. */\n  state: \"unavailable\" | \"disabled\" | \"configuring\" | \"submitted\" | \"needs_reconnect\" | \"failed\"\n  config: NativeNotificationConfig\n  error: string\n}\n\nexport interface NativeNotificationDelivery {\n  notificationId: string\n  status: \"delivered\" | \"failed\" | \"cancelled\" | \"dropped\"\n  reason: string\n}\n\nexport interface NativePhoneNotification {\n  /** Stable id from the phone's notification listener; parsed to an int where firmware needs one. */\n  notificationId: string\n  /** Reverse-DNS package id of the originating app. */\n  packageName: string\n  /** Human app name (e.g. \"Messages\"). */\n  appName: string\n  title: string\n  /** Android `android.subText`. Empty when the listener didn't capture one. */\n  subtitle: string\n  body: string\n  /** Unix ms post time. */\n  timestampMs: number\n  /** Posted or updated. Removal is not supported by the verified protocol. */\n  action: 0\n}\n\nexport type PublicGlassesStatus = Omit<\n  GlassesStatus,\n  \"otaUpdateAvailable\" | \"otaProgress\" | \"otaInProgress\" | \"otaVersionUrl\"\n>\n\nexport type PublicBluetoothStatus = Pick<\n  BluetoothStatus,\n  | \"searching\"\n  | \"searchingController\"\n  | \"systemMicUnavailable\"\n  | \"micRanking\"\n  | \"currentMic\"\n  | \"searchResults\"\n  | \"wifiScanResults\"\n  | \"lastLog\"\n  | \"otherBtConnected\"\n  | \"galleryModeEnabled\"\n>\n\nexport type BluetoothSdkEventMap = {\n  native_notification_status: NativeNotificationStatus\n  native_notification_delivery: NativeNotificationDelivery\n  log: LogEvent\n  device_discovered: Device\n  default_device_changed: {device?: Device}\n  glasses_not_ready: GlassesNotReadyEvent\n  button_press: ButtonPressEvent\n  touch_event: TouchEvent\n  accel_event: AccelEvent\n  head_up: HeadUpEvent\n  voice_activity_detection_status: VoiceActivityDetectionStatusEvent\n  speaking_status: SpeakingStatusEvent\n  battery_status: BatteryStatusEvent\n  local_transcription: LocalTranscriptionEvent\n  wifi_status_change: WifiStatusChangeEvent\n  wifi_scan_result: WifiScanResultEvent\n  wifi_forget_result: WifiForgetResultEvent\n  saved_wifi_networks: SavedWifiNetworksEvent\n  hotspot_status_change: HotspotStatusChangeEvent\n  hotspot_error: HotspotErrorEvent\n  photo_response: PhotoResponseEvent\n  photo_status: PhotoStatusEvent\n  camera_status: CameraStatusEvent\n  video_recording_status: VideoRecordingStatusEvent\n  media_success: MediaUploadSuccessEvent\n  media_error: MediaUploadErrorEvent\n  gallery_status: GalleryStatusEvent\n  compatible_glasses_search_stop: CompatibleGlassesSearchStopEvent\n  swipe_volume_status: SwipeVolumeStatusEvent\n  switch_status: SwitchStatusEvent\n  mic_tuning_state: MicTuningStateEvent\n  mic_rms: MicRmsEvent\n  wear_state: WearStateEvent\n  wear_tuning: WearTuningEvent\n  rgb_led_control_response: RgbLedControlResponseEvent\n  settings_ack: SettingsAckEvent\n  pair_failure: PairFailureEvent\n  pairing_info: PairingInfoEvent\n  entering_pairing_mode: EnteringPairingModeEvent\n  owner_replaced: OwnerReplacedEvent\n  audio_pairing_needed: AudioPairingNeededEvent\n  audio_connected: AudioConnectedEvent\n  audio_disconnected: AudioDisconnectedEvent\n  mic_pcm: MicPcmEvent\n  mic_lc3: MicLc3Event\n  mic_health: MicHealthEvent\n  stream_status: StreamStatusEvent\n  /** Mentra Live MTK updater completed and the glasses are about to restart. */\n  mtk_update_complete: MtkUpdateCompleteEvent\n  /** The ASG process restarted while the BES kept the BLE connection alive. */\n  glasses_session_changed: GlassesSessionChangedEvent\n  ota_start_ack: OtaStartAckEvent\n  ota_status: OtaStatusEvent\n  ar99_ota_status: Ar99OtaStatusEvent\n  version_info: VersionInfoEvent\n  extraction_progress: ExtractionProgressEvent\n}\n\nexport type BluetoothSdkEventName = keyof BluetoothSdkEventMap\n\nexport type BluetoothSdkEventListener<EventName extends BluetoothSdkEventName> = (\n  event: BluetoothSdkEventMap[EventName],\n) => void\n\nexport type BluetoothSdkSubscription = {\n  remove(): void\n}\n\nexport type BluetoothSdkEvent = BluetoothSdkEventMap[BluetoothSdkEventName]\n\nexport interface BluetoothSdkPublicModule {\n  configureNativeNotifications(config: NativeNotificationConfig): Promise<void>\n  getNativeNotificationStatus(): Promise<NativeNotificationStatus>\n  addListener<EventName extends BluetoothSdkEventName>(\n    eventName: EventName,\n    listener: BluetoothSdkEventListener<EventName>,\n  ): BluetoothSdkSubscription\n\n  /** Read an immutable snapshot of the current glasses state. */\n  getGlassesStatus(): Promise<PublicGlassesStatus>\n  /** Read an immutable snapshot of the phone Bluetooth adapter state. */\n  getBluetoothStatus(): Promise<PublicBluetoothStatus>\n  /** Observe immutable glasses-state patches. Returns an unsubscribe function. */\n  subscribeGlassesStatus(listener: (changed: Partial<PublicGlassesStatus>) => void): () => void\n  /** Observe immutable Bluetooth-state patches. Returns an unsubscribe function. */\n  subscribeBluetoothStatus(listener: (changed: Partial<PublicBluetoothStatus>) => void): () => void\n\n  getDefaultDevice(): Promise<Device | null>\n  setDefaultDevice(device: Device | null): Promise<void>\n  clearDefaultDevice(): Promise<void>\n\n  startScan(model: DeviceModel): Promise<void>\n  stopScan(): Promise<void>\n  scan(options: ScanOptions): Promise<Device[]>\n  scan(model: DeviceModel, options?: ScanModelOptions): Promise<Device[]>\n  connect(device: Device, options?: ConnectOptions): Promise<void>\n  connectDefault(options?: ConnectOptions): Promise<void>\n  cancelConnectionAttempt(): Promise<void>\n  disconnect(): Promise<void>\n  forget(): Promise<void>\n\n  displayText(text: string, x?: number, y?: number, size?: number): Promise<void>\n  clearDisplay(): Promise<void>\n  /** Set session-only content below the dashboard status header. Pass an empty string to reset it. */\n  setDashboardContent(content: string): Promise<void>\n  showDashboard(): Promise<void>\n  setDashboardPosition(height: number, depth: number): Promise<void>\n  setHeadUpAngle(angleDegrees: number): Promise<void>\n  setImuEnabled(enabled: boolean): Promise<void>\n  setScreenDisabled(disabled: boolean): Promise<void>\n  /** Keep legacy Mentra Live OTA sessions awake. Modern sessions normally do not require this. */\n  ping(): Promise<void>\n\n  requestWifiScan(): Promise<WifiSearchResult[]>\n  /** List exact WiFi SSIDs from glasses that support reliable saved-network enumeration. */\n  getSavedWifiNetworks(): Promise<SavedWifiNetworksResult>\n  sendWifiCredentials(ssid: string, password: string): Promise<WifiStatusChangeEvent>\n  /** Forget a saved network and return its correlated semantic outcome. */\n  forgetWifiNetwork(ssid: string): Promise<WifiForgetResult>\n  setHotspotState(enabled: boolean): Promise<HotspotStatusChangeEvent>\n  /** Set the glasses clock from the phone after an OTA clock-skew failure. */\n  setSystemTime(timestampMs: number): Promise<void>\n  /** Enable or disable Wi-Fi ADB on Mentra Live (no-op on other devices). */\n  setWifiAdbState(enabled: boolean): Promise<void>\n\n  /**\n   * Persistently enable/disable unauthenticated HTTP gallery access on the glasses' Wi-Fi.\n   * Default off; survives reconnects/restarts until disabled. Only use on trusted networks.\n   * Returns saved enabled state plus current listening/url. No Wi-Fi means listening=false.\n   */\n  setGalleryServerEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>\n  setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>\n  setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>\n  setLoudnessGateEnabled(enabled: boolean): Promise<void>\n  setAutoPowerOffEnabled(enabled: boolean): Promise<void>\n  /**\n   * @deprecated Sticky action-button photo presets are deprecated. Prefer per-request\n   * `requestPhoto(...)` options (e.g. `mode: \"text\"` for text sensor size/crop, or explicit per-shot\n   * fields). Still functional until removed in a future release.\n   */\n  setPhotoCaptureDefaults(settings: PhotoCaptureDefaults): Promise<SettingsAckSuccessEvent>\n  setVideoRecordingDefaults(settings: VideoRecordingDefaults): Promise<SettingsAckSuccessEvent>\n  setMaxVideoRecordingDuration(minutes: number): Promise<SettingsAckSuccessEvent>\n  setCameraFov(request: CameraFovRequest): Promise<CameraFovResult>\n  /** One-way FOV command for legacy ASG clients that do not send settings acknowledgements. */\n  setLegacyCameraFov(request: CameraFovRequest): Promise<CameraFovResult>\n  setCameraFovOverride(request: CameraFovOverrideRequest): Promise<CameraFovResult>\n  releaseCameraFovOverride(leaseId: string): Promise<SettingsAckSuccessEvent>\n  /**\n   * Configure camera HAL tuning (ANR / gain) on Mentra Live glasses.\n   *\n   * The phone sends a {@code camera_tuning_config} BLE command; the glasses relay it as a\n   * {@code camconfig} broadcast to the camera HAL so parameters take effect without a reboot.\n   *\n   * **Scan-mode convention**: call with `(false, false)` when activating scan mode to disable ANR\n   * and pixsmart gain for sharper text/barcode captures. Call with `(true, true)` to restore\n   * defaults when exiting scan mode.\n   *\n   * @param anrOn  `true` = ANR enabled (default), `false` = ANR disabled\n   * @param gainOn `true` = stock gain params (default), `false` = pixsmart gain-off params\n   */\n  setCameraTuningConfig(anrOn: boolean, gainOn: boolean): Promise<SettingsAckSuccessEvent>\n  queryGalleryStatus(): Promise<GalleryStatusEvent>\n  requestPhoto(params: PhotoRequestParams): Promise<PhotoSuccessResponseEvent>\n  warmUpCamera(params: WarmUpCameraParams): Promise<CameraStatusEvent>\n  /** Release one request-owned warm-up. Opening requests reject with camera_warm_up_cancelled. */\n  stopCameraWarmUp(requestId: string): Promise<void>\n  startVideoRecording(\n    requestId: string,\n    save: boolean,\n    sound: boolean,\n    settings?: VideoRecordingSettings,\n  ): Promise<VideoRecordingStartedStatusEvent>\n  /**\n   * Stop the active recording. When {@link webhookUrl} is provided, the glasses\n   * upload the recorded video to it (multipart) using {@link authToken}. These\n   * are supplied at stop time (not start) so the token is fresh when the upload\n   * runs 闂?a recording can last arbitrarily long. An empty/omitted webhook keeps\n   * the video on device (no upload).\n   */\n  stopVideoRecording(\n    requestId: string,\n    webhookUrl?: string,\n    authToken?: string,\n  ): Promise<VideoRecordingStoppedStatusEvent>\n  /** Query the glasses for the current recording state and elapsed duration. */\n  queryVideoRecordingStatus(requestId: string): Promise<VideoRecordingStatusEvent>\n\n  startStream(params: StreamStartRequest): Promise<StreamStatusEvent>\n  stopStream(): Promise<StreamStatusEvent>\n\n  setMicState(enabled: boolean, useGlassesMic?: boolean, sendTranscript?: boolean, sendLc3Data?: boolean): Promise<void>\n  setPreferredMic(preferredMic: MicPreference): Promise<void>\n  setOwnAppAudioPlaying(playing: boolean): Promise<void>\n  getGlassesMediaVolume(): Promise<GlassesMediaVolumeGetResult>\n  setGlassesMediaVolume(level: number): Promise<GlassesMediaVolumeSetResult>\n\n  rgbLedControl(\n    requestId: string,\n    packageName: string | null,\n    action: RgbLedAction,\n    color: RgbLedColor | null,\n    onDurationMs: number,\n    offDurationMs: number,\n    count: number,\n  ): Promise<RgbLedControlSuccessResponseEvent>\n\n  requestVersionInfo(): Promise<VersionInfoResult>\n  /**\n   * Select the OTA manifest used by subsequent update checks and installs.\n   * The URL may point at Mentra's hosted manifest or any customer-controlled HTTP(S) server.\n   */\n  setOtaVersionUrl(otaVersionUrl: string): void\n  /** Return the configured or release-embedded OTA manifest URL. Rejects when a source build is unconfigured. */\n  getOtaVersionUrl(): string\n  /** Fetch the configured OTA manifest and return whether any ASG/BES/MTK update is available. */\n  checkForOtaUpdate(): Promise<boolean>\n  /** Return bundled release changelogs crossed between two coordinated product versions, newest first. */\n  getReleaseChangelogs(fromVersion?: string | null, toVersion?: string | null): ReleaseChangelog[]\n  /** Start OTA from the configured or explicitly supplied manifest URL. */\n  startOtaUpdate(otaVersionUrl?: string | null): Promise<OtaStartAckEvent>\n  /** Query the active OTA session and return the correlated status response. */\n  queryOtaStatus(): Promise<OtaQueryResult>\n  startAr99OtaFromFile(path: string): Promise<boolean>\n  cancelAr99Ota(): Promise<void>\n  sendAr99FactoryReset(): Promise<void>\n  buildAr99OtaSignature(\n    secret: string,\n    appName: string,\n    currentVersion: string,\n    serialNumber: string,\n    nonce: string,\n  ): string\n\n  // // stt commands (MOVE TO CRUST)\n  // setSttModelDetails(path: string, languageCode: string): Promise<void>\n  // getSttModelPath(): Promise<string>\n  // checkSttModelAvailable(): Promise<boolean>\n  // validateSttModel(path: string): Promise<boolean>\n  // extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>\n\n  // // tts commands (MOVE TO CRUST)\n  // setTtsModelDetails(path: string, languageCode: string): Promise<void>\n  // getTtsModelPath(): Promise<string>\n  // getTtsModelLanguage(): Promise<string>\n  // checkTtsModelAvailable(): Promise<boolean>\n  // validateTtsModel(path: string): Promise<boolean>\n  // generateTtsAudio(text: string, path: string, outputPath: string, speakerId: number, speed: number): Promise<boolean>\n\n  // STT Commands (TODO: MOVE TO CRUST)\n  setSttModelDetails(path: string, languageCode: string): Promise<void>\n  getSttModelPath(): Promise<string>\n  checkSttModelAvailable(): Promise<boolean>\n  validateSttModel(path: string): Promise<boolean>\n  extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>\n  restartTranscriber(): Promise<void>\n\n  // TTS Commands (TODO: MOVE TO CRUST)\n  setTtsModelDetails(path: string, languageCode: string): Promise<void>\n  getTtsModelPath(): Promise<string>\n  getTtsModelLanguage(): Promise<string>\n  checkTtsModelAvailable(): Promise<boolean>\n  validateTtsModel(path: string): Promise<boolean>\n  generateTtsAudio(\n    text: string,\n    modelPath: string,\n    outputPath: string,\n    speakerId: number,\n    speed: number,\n  ): Promise<boolean>\n}\n\n// OTA update status types\nexport type OtaStage = \"download\" | \"install\"\nexport type OtaProgressStatus = \"STARTED\" | \"PROGRESS\" | \"FINISHED\" | \"FAILED\"\n\nexport interface OtaStatus {\n  sessionId: string\n  totalSteps: number\n  currentStep: number\n  stepType: \"apk\" | \"mtk\" | \"bes\"\n  phase: \"download\" | \"install\"\n  stepPercent: number\n  /** Real bytes received in the current download; independent of rounded percent. */\n  bytesDownloaded?: number\n  overallPercent: number\n  status: \"in_progress\" | \"step_complete\" | \"complete\" | \"failed\" | \"idle\"\n  error?: string\n}\n\nexport interface OtaUpdateInfo {\n  available: boolean\n  versionCode: number\n  versionName: string\n  updates: string[] // [\"apk\", \"mtk\", \"bes\"]\n  totalSize: number\n  cacheReady?: boolean\n  /** Exact BES target selected from the OTA manifest, when a BES step is pending. */\n  besVersion?: string\n  /** True when the APK step installs an older build than the glasses currently run (exact-pin manifests only). */\n  isDowngrade?: boolean\n}\n\nexport interface ReleaseChangelog {\n  /** Base production version, for example `3.1.0`. */\n  version: string\n  /** Markdown body authored in `/changelogs/<version>.md`. */\n  markdown: string\n}\n\nexport interface OtaProgress {\n  stage: OtaStage\n  status: OtaProgressStatus\n  progress: number\n  bytesDownloaded: number\n  totalBytes: number\n  currentUpdate: string\n  errorMessage?: string\n}\n\nexport interface GlassesStatus {\n  /** iOS G2 arm still disconnected after a three-second partial link; cleared on reset or both links. */\n  g2MissingArm?: \"left\" | \"right\" | null\n  // state:\n  connection: GlassesConnectionStatus\n  micEnabled: boolean\n  voiceActivityDetectionEnabled: boolean\n  bluetoothClassicConnected: boolean\n  signalStrength: number\n  /** Milliseconds since epoch when signalStrength was last refreshed by the phone BLE stack. */\n  signalStrengthUpdatedAt: number\n  // device info\n  deviceModel: string\n  androidVersion: string\n  firmwareVersion: string\n  besFirmwareVersion: string\n  mtkFirmwareVersion: string\n  bluetoothMacAddress: string\n  wifiMacAddress: string\n  leftMacAddress: string\n  rightMacAddress: string\n  buildNumber: string\n  /** Glasses System.currentTimeMillis() from last version_info (clock skew detection). */\n  systemTimeMs?: number\n  otaVersionUrl: string\n  appVersion: string\n  /**\n   * Package the glasses client actually runs as, from `version_info_1`. Empty string on glasses\n   * whose client predates the field. `\"com.mentra.asg_client\"` is the stock client; anything else\n   * is a sideloaded build (Android forces a distinct package on any build not signed with Mentra's\n   * release key) that coexists with the stock app and must not be driven by OTA.\n   */\n  packageName: string\n  /** Phone-served hotspot OTA protocol version; 0 means unsupported/legacy glasses. */\n  hotspotOtaVersion: number\n  bluetoothName: string\n  serialNumber: string\n  style: string\n  color: string\n  // wifi info\n  wifi: WifiStatus\n  // battery info\n  batteryLevel: number\n  charging: boolean\n  caseBatteryLevel: number\n  caseCharging: boolean\n  caseOpen: boolean\n  caseRemoved: boolean\n  // hotspot info\n  hotspot: HotspotStatus\n  // OTA update info\n  otaUpdateAvailable: OtaUpdateInfo | null\n  otaProgress: OtaProgress | null\n  otaInProgress: boolean\n  // ring info\n  controllerConnected: boolean\n  controllerFullyBooted: boolean\n  controllerMacAddress: string\n  controllerBatteryLevel: number\n  controllerSignalStrength: number\n}\n\nexport interface CoreDashboardMenuItem {\n  name: string\n  packageName: string\n  running: boolean\n}\n\nexport interface CalendarEvent {\n  title: string\n  location?: string\n  time: string\n  endDate: number\n}\n\nexport interface CoreSettings {\n  menu_apps: CoreDashboardMenuItem[]\n  calendar_events: CalendarEvent[]\n}\n\nexport interface Device {\n  /**\n   * Stable app-facing key for this scan result, within the limits of the\n   * platform identifier available to the SDK. Do not parse this value; use the\n   * typed model, name, address, projectName, and rssi fields instead.\n   */\n  id: string\n  model: DeviceModel\n  name: string\n  /** Platform address/identifier when available: Android Bluetooth address, iOS CoreBluetooth identifier. */\n  address?: string\n  /** Optional AR99 project discriminator. Supported value: AR99. */\n  projectName?: string\n  /**\n   * Optional scan signal strength. It may be undefined at first discovery and\n   * appear in a later scan update when the platform reports RSSI metadata.\n   */\n  rssi?: number\n  /** Mentra Live: unit is currently in pairing mode (adv flag). */\n  pairingMode?: boolean\n  /** Mentra Live: four-character hex spoken pairing code when available. */\n  pairingCode?: string\n  /** Mentra Live: advertisement carries the secure-pairing capability trailer. */\n  securePairingCapable?: boolean\n}\n\nexport interface ConnectOptions {\n  saveAsDefault?: boolean\n  cancelExistingConnectionAttempt?: boolean\n  /**\n   * iOS Mentra Live only. When true, CoreBluetooth requires ANCS authorization\n   * as part of the connection. Set false when the app does not use notification\n   * relay and must avoid the system ANCS authorization flow. Defaults to true.\n   * Android accepts this option as a no-op.\n   */\n  requiresAncs?: boolean\n}\n\nexport type ScanResultsCallback = (devices: Device[]) => void\n\n/** Advisory for an empty scan. System connection state does not identify an owning app. */\nexport interface ScanDiagnostic {\n  code: string\n  message: string\n}\n\nexport interface ScanOptions {\n  model: DeviceModel\n  /** Defaults to 15000. */\n  timeoutMs?: number\n  /** Alias for `timeoutMs`, useful when mirroring native examples. */\n  timeout?: number\n  /** Called every time the discovered device list changes during the scan. */\n  onResults?: ScanResultsCallback\n  /** Optional non-fatal hint before an empty scan resolves, on Android and iOS. */\n  onDiagnostic?: (diagnostic: ScanDiagnostic) => void\n}\n\nexport type ScanModelOptions = Omit<ScanOptions, \"model\">\n\nexport interface WifiSearchResult {\n  ssid: string\n  requiresPassword: boolean\n  signalStrength: number\n  /** Frequency in MHz (from glasses scan). 5 GHz band is typically 5170闂?825. Omitted if unknown. */\n  frequency?: number\n}\n\nexport interface BluetoothStatus {\n  // state:\n  searching: boolean\n  searchingController: boolean\n  default_wearable?: DeviceModel | \"\"\n  pending_wearable?: DeviceModel | \"\"\n  device_name?: string\n  device_address?: string\n  default_controller?: DeviceModel | \"\"\n  pending_controller?: DeviceModel | \"\"\n  controller_device_name?: string\n  controller_address?: string\n  systemMicUnavailable: boolean\n  micRanking: MicMode[]\n  currentMic: MicMode | \"\" | null\n  /**\n   * Nearby glasses in stable discovery order.\n   * Existing entries keep their array position as details refresh; new glasses append at the end,\n   * and removals should not reorder remaining entries.\n   */\n  searchResults: Device[]\n  wifiScanResults: WifiSearchResult[]\n  lastLog: string[]\n  otherBtConnected: boolean\n  // desired settings the SDK sends to compatible connected glasses:\n  galleryModeEnabled: boolean\n}\n\nexport type BluetoothSettingsUpdate = Partial<{\n  auth_email: string\n  core_token: string\n  sensing_enabled: boolean\n  power_saving_mode: boolean\n  lc3_frame_size: number\n  preferred_mic: MicPreference\n  screen_disabled: boolean\n  contextual_dashboard: boolean\n  head_up_angle: number\n  imu_enabled: boolean\n  brightness: number\n  auto_brightness: boolean\n  dashboard_height: number\n  dashboard_depth: number\n  menu_apps: DashboardMenuItem[] | CoreDashboardMenuItem[] | Array<Record<string, unknown>> | null\n  calendar_events: CalendarEvent[]\n  metric_system: boolean\n  twelve_hour_time: boolean\n  gallery_mode: boolean\n  voice_activity_detection_enabled: boolean\n  loudness_gate_enabled: boolean\n  auto_power_off_enabled: boolean\n  /** Effective mic tuning only. `{}` means \"reset to firmware defaults\". */\n  mic_tuning: MicTuning\n  button_photo_size: ButtonPhotoSize\n  button_video_settings: {width: number; height: number; fps: number}\n  button_video_width: number\n  button_video_height: number\n  button_video_fps: number\n  button_max_recording_time: number\n  camera_fov: NativeCameraFovSetting\n  should_send_pcm: boolean\n  should_send_lc3: boolean\n  should_send_transcript: boolean\n  offline_mode: boolean\n  local_stt_fallback_active: boolean\n  pending_wearable: DeviceModel | \"\"\n  default_wearable: DeviceModel | \"\"\n  device_name: string\n  device_address: string\n  default_controller: DeviceModel | \"\"\n  pending_controller: DeviceModel | \"\"\n  controller_device_name: string\n  controller_address: string\n}>\n"]}

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.1",
-    "releaseIdentity": "3.2.1-beta.455",
-    "releaseSetId": "mentra-3.2.1-beta.455",
-    "sourceCommit": "07da1db49bab0ceacbcea480102309b8e8ae5bc6",
-    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.455.json",
-    "otaManifestSha256": "0e3867266f9f3836f06b9ce574e6c3870f0864087e219002e424f54f194934e0"
+    "releaseIdentity": "3.2.1-beta.464",
+    "releaseSetId": "mentra-3.2.1-beta.464",
+    "sourceCommit": "02a42222a7f1d3807325cf6c8d081b8738aaf213",
+    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.464.json",
+    "otaManifestSha256": "a55ad585f02ca9c63f7a8dde6f845516bdc1dcba36dad930001df69917856c15"
 });
 //# 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,gBAAgB;IACnC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,kIAAkI;IACpJ,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.1\",\n  \"releaseIdentity\": \"3.2.1-beta.455\",\n  \"releaseSetId\": \"mentra-3.2.1-beta.455\",\n  \"sourceCommit\": \"07da1db49bab0ceacbcea480102309b8e8ae5bc6\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.455.json\",\n  \"otaManifestSha256\": \"0e3867266f9f3836f06b9ce574e6c3870f0864087e219002e424f54f194934e0\"\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,gBAAgB;IACnC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,kIAAkI;IACpJ,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.1\",\n  \"releaseIdentity\": \"3.2.1-beta.464\",\n  \"releaseSetId\": \"mentra-3.2.1-beta.464\",\n  \"sourceCommit\": \"02a42222a7f1d3807325cf6c8d081b8738aaf213\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.464.json\",\n  \"otaManifestSha256\": \"a55ad585f02ca9c63f7a8dde6f845516bdc1dcba36dad930001df69917856c15\"\n})\n"]}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -16,7 +16,7 @@ enum BluetoothSdkDefaults {
     /// silently disable it on every pair the app touches.
     static let autoPowerOffEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.1-beta.455"
+    private static let swiftPackageSdkVersion = "3.2.1-beta.464"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/DeviceManager.swift

@@ -318,9 +318,9 @@ struct ViewState {
     var lc3Converter: PcmConverter?
     /// Audio output format - defaults to LC3 for bandwidth savings
     private var audioOutputFormat: AudioOutputFormat = .lc3
-    /// Last time we received an LC3 frame from the glasses (used by the mic
-    /// inactivity watchdog).
-    private var lastLc3Event: Date?
+    private var micWatchdog = GlassesMicWatchdog()
+    // Injectable monotonic clock so recovery deadlines can be tested without sleeping.
+    var micWatchdogNow: () -> TimeInterval = { ProcessInfo.processInfo.systemUptime }
     private var sequenceGapEvents: Int64 = 0
     private var decodeFailures: Int64 = 0
     private var lastLc3ReceivedAt: Int64?
@@ -472,10 +472,17 @@ struct ViewState {
     }
 
     func reportGlassesAudioActivity() {
-        lastLc3Event = Date()
+        micWatchdog.receivedAudio(at: micWatchdogNow())
         lastPcmProducedAt = nowMs()
     }
 
+    /// Decoded glasses audio must update recovery health; phone PCM must not.
+    func handleGlassesPcm(_ pcmData: Data) {
+        guard !pcmData.isEmpty else { return }
+        reportGlassesAudioActivity()
+        handlePcm(pcmData)
+    }
+
     private func micHealth() -> MicHealth {
         MicHealth(
             sequenceGapEvents: sequenceGapEvents,
@@ -499,13 +506,13 @@ struct ViewState {
         lastLc3ReceivedAt = nil
         lastPcmProducedAt = nil
         lastLc3Sequence = nil
-        lastLc3Event = nil
+        micWatchdog = GlassesMicWatchdog()
     }
 
     private func recordLc3Packet(sequenceNumber: Int?) {
         let receivedAt = nowMs()
         lastLc3ReceivedAt = receivedAt
-        lastLc3Event = Date()
+        micWatchdog.receivedAudio(at: micWatchdogNow())
         var hasGap = false
         if let sequenceNumber {
             let normalized = sequenceNumber & 0xFF
@@ -605,6 +612,7 @@ struct ViewState {
         }
 
         currentMic = micUsed
+        updateGlassesMicExpectation()
 
         // log if no mic was found:
         if micUsed == "" && micEnabled {
@@ -723,6 +731,7 @@ struct ViewState {
             Bridge.log("MAN: Manager already initialized, cleaning up previous sgc")
             sgc?.cleanup()
             sgc = nil
+            DeviceStore.shared.apply("glasses", "micEnabled", false)
             resetSystemTimeSync()
         }
 
@@ -902,27 +911,20 @@ struct ViewState {
         return result
     }
 
-    private func checkAndReinitGlassesMic() {
-        // if the glasses mic is marked as enabled (and the glasses are connected), but our last known lc3 event is from > 5 seconds ago, reinitialize the mic:
-        let glassesMicEnabled = DeviceStore.shared.get("glasses", "micEnabled") as? Bool ?? false
-        let glassesConnected = DeviceStore.shared.get("glasses", "connected") as? Bool ?? false
-        if !glassesMicEnabled || !glassesConnected {
-            return
-        }
-
-        if sgc?.isMicSuspendedForAudio == true {
-            Bridge.log("MAN: Glasses mic intentionally suspended for phone audio; skipping mic recovery")
-            return
-        }
-
-        if PhoneAudioMonitor.getInstance().isOwnAppAudioPlaying() {
-            Bridge.log("MAN: Mentra audio is playing; skipping glasses mic recovery")
-            return
-        }
+    private func updateGlassesMicExpectation() {
+        // Demand/route and device readiness decide whether audio is expected. The
+        // shared micEnabled flag alone is not evidence of a running hardware stream.
+        let expected = micEnabled && currentMic == MicTypes.GLASSES_CUSTOM
+            && sgc?.fullyBooted == true && sgc?.hasMic == true
+            && sgc?.isMicSuspendedForAudio != true
+            && !PhoneAudioMonitor.getInstance().isOwnAppAudioPlaying()
+        micWatchdog.expectAudio(expected, at: micWatchdogNow())
+    }
 
-        let timeSinceLastLc3Event = Date().timeIntervalSince(lastLc3Event ?? Date())
-        if timeSinceLastLc3Event > 5 {
-            Bridge.log("MAN: No audio activity in the last 5 seconds from glasses, reinitializing glasses mic")
+    func checkAndReinitGlassesMic() {
+        updateGlassesMicExpectation()
+        if micWatchdog.shouldRetry(at: micWatchdogNow()) {
+            Bridge.log("MAN: Expected glasses audio missing for 5 seconds; retrying mic start")
             sgc?.setMicEnabled(true)
         }
     }
@@ -1066,6 +1068,11 @@ struct ViewState {
         #endif
         checkCurrentAudioDevice()
 
+        // Disconnect clears micEnabled but preserves the consumers' audio requests.
+        // Recompute demand before selecting a microphone; unchanged requests are
+        // deduplicated by DeviceStore.apply().
+        setMicState()
+
         // save the default_wearable now that we're connected:
         Bridge.saveSetting("default_wearable", defaultWearable)
         Bridge.saveSetting("device_name", deviceName)
@@ -1960,6 +1967,9 @@ struct ViewState {
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
+        // This cache belongs to the discarded connection. Keep consumer demand,
+        // but require a new mic-enable command when replacement glasses are ready.
+        DeviceStore.shared.apply("glasses", "micEnabled", false)
         resetSystemTimeSync()
         resetMicHealth()
         searching = false

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.1"
-    static let releaseIdentity = "3.2.1-beta.455"
-    static let releaseSetId = "mentra-3.2.1-beta.455"
-    static let sourceCommit = "07da1db49bab0ceacbcea480102309b8e8ae5bc6"
-    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.455.json"
-    static let otaManifestSha256 = "0e3867266f9f3836f06b9ce574e6c3870f0864087e219002e424f54f194934e0"
+    static let releaseIdentity = "3.2.1-beta.464"
+    static let releaseSetId = "mentra-3.2.1-beta.464"
+    static let sourceCommit = "02a42222a7f1d3807325cf6c8d081b8738aaf213"
+    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-beta.464.json"
+    static let otaManifestSha256 = "a55ad585f02ca9c63f7a8dde6f845516bdc1dcba36dad930001df69917856c15"
 }

package/ios/Source/audio/GlassesMicWatchdog.swift

@@ -0,0 +1,33 @@
+import Foundation
+
+/// Tracks expected audio separately from observed audio. All times use a monotonic clock.
+struct GlassesMicWatchdog {
+    private var expectedSince: TimeInterval?
+    private var lastActivity: TimeInterval?
+    private var lastRetry: TimeInterval?
+    private let timeout: TimeInterval = 5
+
+    mutating func expectAudio(_ expected: Bool, at now: TimeInterval) {
+        guard expected else {
+            self = GlassesMicWatchdog()
+            return
+        }
+        if expectedSince == nil {
+            expectedSince = now
+        }
+    }
+
+    mutating func receivedAudio(at now: TimeInterval) {
+        guard expectedSince != nil else { return }
+        lastActivity = now
+    }
+
+    mutating func shouldRetry(at now: TimeInterval) -> Bool {
+        guard let expectedSince else { return false }
+        let lastProgress = max(expectedSince, lastActivity ?? expectedSince, lastRetry ?? expectedSince)
+        guard now - lastProgress >= timeout else { return false }
+        // Rate-limit retries even when the device never produces its first packet.
+        lastRetry = now
+        return true
+    }
+}

package/ios/Source/sgcs/Ar99.swift

@@ -1850,8 +1850,7 @@ final class Ar99: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SGCM
     private func ensureOpusDecoder() {
         guard opusDecoder == nil else { return }
         opusDecoder = Ar99OpusPcmDecoder { pcm in
-            DeviceManager.shared.reportGlassesAudioActivity()
-            DeviceManager.shared.handlePcm(pcm)
+            DeviceManager.shared.handleGlassesPcm(pcm)
         }
         if opusDecoder == nil {
             Bridge.log("AR99: system Opus decoder unavailable")