@mentra/bluetooth-sdk 0.1.8 → 0.1.10

package/src/BluetoothSdk.types.ts

@@ -4,8 +4,11 @@ export type GlassesNotReadyEvent = {
   message: string
 }
 
+// NOTE: unlike most events below, the native module does NOT include a `type`
+// field on the button_press payload — it sends only {buttonId, pressType,
+// timestamp} (see BluetoothSdkModule on both iOS and Android). Consumers must
+// filter on `pressType` / the "button_press" listener name, never `event.type`.
 export type ButtonPressEvent = {
-  type: "button_press"
   buttonId: string
   pressType: "long" | "short"
   timestamp: number
@@ -27,6 +30,8 @@ export type VoiceActivityDetectionStatusEvent = {
   voiceActivityDetectionEnabled: boolean
 }
 
+export const DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED = false
+
 export type SpeakingStatusEvent = {
   type: "speaking_status"
   speaking: boolean
@@ -41,34 +46,34 @@ export type BatteryStatusEvent = {
 }
 
 export type GlassesConnectionStatus =
-  | {state: 'disconnected'}
-  | {state: 'scanning'}
-  | {state: 'connecting'}
-  | {state: 'bonding'}
-  | {state: 'connected'; fullyBooted: boolean}
+  | {state: "disconnected"}
+  | {state: "scanning"}
+  | {state: "connecting"}
+  | {state: "bonding"}
+  | {state: "connected"; fullyBooted: boolean}
 
-export type ConnectedGlassesConnectionStatus = Extract<GlassesConnectionStatus, {state: 'connected'}>
+export type ConnectedGlassesConnectionStatus = Extract<GlassesConnectionStatus, {state: "connected"}>
 
 export function isConnectedGlassesConnectionStatus(
   status: GlassesConnectionStatus,
 ): status is ConnectedGlassesConnectionStatus {
-  return status.state === 'connected'
+  return status.state === "connected"
 }
 
 export function isReadyGlassesConnectionStatus(status: GlassesConnectionStatus): boolean {
-  return status.state === 'connected' && status.fullyBooted
+  return status.state === "connected" && status.fullyBooted
 }
 
 export function isBusyGlassesConnectionStatus(status: GlassesConnectionStatus): boolean {
-  return status.state === 'scanning' || status.state === 'connecting' || status.state === 'bonding'
+  return status.state === "scanning" || status.state === "connecting" || status.state === "bonding"
 }
 
 export function createDisconnectedGlassesStatus(): Partial<GlassesStatus> {
   return {
-    connection: {state: 'disconnected'},
-    hotspot: {state: 'disabled'},
-    voiceActivityDetectionEnabled: true,
-    wifi: {state: 'disconnected'},
+    connection: {state: "disconnected"},
+    hotspot: {state: "disabled"},
+    voiceActivityDetectionEnabled: DEFAULT_VOICE_ACTIVITY_DETECTION_ENABLED,
+    wifi: {state: "disconnected"},
   }
 }
 
@@ -93,24 +98,24 @@ export type LogEvent = {
   message: string
 }
 
-export type WifiStatus = {state: 'disconnected'} | {state: 'connected'; ssid: string; localIp?: string}
+export type WifiStatus = {state: "disconnected"} | {state: "connected"; ssid: string; localIp?: string}
 
-export type ConnectedWifiStatus = Extract<WifiStatus, {state: 'connected'}>
+export type ConnectedWifiStatus = Extract<WifiStatus, {state: "connected"}>
 
 export function isConnectedWifiStatus(status: WifiStatus): status is ConnectedWifiStatus {
-  return status.state === 'connected'
+  return status.state === "connected"
 }
 
 export type WifiStatusChangeEvent = WifiStatus & {
   type: "wifi_status_change"
 }
 
-export type HotspotStatus = {state: 'disabled'} | {state: 'enabled'; ssid: string; password: string; localIp: string}
+export type HotspotStatus = {state: "disabled"} | {state: "enabled"; ssid: string; password: string; localIp: string}
 
-export type EnabledHotspotStatus = Extract<HotspotStatus, {state: 'enabled'}>
+export type EnabledHotspotStatus = Extract<HotspotStatus, {state: "enabled"}>
 
 export function isEnabledHotspotStatus(status: HotspotStatus): status is EnabledHotspotStatus {
-  return status.state === 'enabled'
+  return status.state === "enabled"
 }
 
 export type HotspotStatusChangeEvent = HotspotStatus & {
@@ -123,12 +128,37 @@ export type HotspotErrorEvent = {
   timestamp: number
 }
 
+export type VersionInfoResult = {
+  androidVersion: string
+  firmwareVersion: string
+  besFirmwareVersion: string
+  mtkFirmwareVersion: string
+  buildNumber: string
+  systemTimeMs?: number
+  otaVersionUrl: string
+  appVersion: string
+}
+
+export type VersionInfoEvent = VersionInfoResult & {
+  type: "version_info"
+}
+
+export type WifiScanResultEvent = {
+  type: "wifi_scan_result"
+  networks: WifiSearchResult[]
+  scanComplete?: boolean
+}
+
 export type PhotoResponseEvent =
   | {
       type: "photo_response"
       state: "success"
       requestId: string
       uploadUrl: string
+      photoUrl?: string
+      statusUrl?: string
+      contentType?: string
+      fileSizeBytes?: number
       timestamp: number
     }
   | {
@@ -140,6 +170,8 @@ export type PhotoResponseEvent =
       errorMessage: string
     }
 
+export type PhotoSuccessResponseEvent = Extract<PhotoResponseEvent, {state: "success"}>
+
 export type PhotoStatusState =
   | "accepted"
   | "queued"
@@ -147,6 +179,7 @@ export type PhotoStatusState =
   | "capturing"
   | "captured"
   | "compressing"
+  | "ble_fallback_compression"
   | "uploading"
   | "uploaded"
   | "ready_for_transfer"
@@ -167,16 +200,105 @@ export type PhotoResolvedConfig = {
   iso?: number
 }
 
+export type PhotoFpsRange = {
+  min?: number
+  max?: number
+}
+
+export type PhotoRequestedCaptureConfig = {
+  manual?: boolean
+  exposureTimeNs?: number
+  iso?: number
+  frameDurationNs?: number
+  aeMode?: number
+  aeLock?: boolean
+  aeExposureCompensation?: number
+  aeTargetFpsRange?: PhotoFpsRange
+  noiseReductionMode?: number
+  edgeMode?: number
+  afMode?: number
+  zsl?: boolean
+}
+
+export type PhotoMeteredPreview = {
+  exposureTimeNs?: number
+  iso?: number
+  totalLightProxy?: number
+}
+
+export type PhotoCaptureMetadata = {
+  manual?: boolean
+  exposureTimeNs?: number
+  iso?: number
+  frameDurationNs?: number
+  aeMode?: number
+  aeState?: number
+  aeStateName?: string
+  noiseReductionMode?: number
+  edgeMode?: number
+  zsl?: boolean
+  sensorTimestampNs?: number
+  totalLightProxy?: number
+  mfnrLikely?: boolean
+}
+
 export type PhotoStatusEvent = {
   type: "photo_status"
   requestId: string
   status: PhotoStatusState | string
   timestamp: number
   resolvedConfig?: PhotoResolvedConfig
+  requestedCaptureConfig?: PhotoRequestedCaptureConfig
+  meteredPreview?: PhotoMeteredPreview
+  captureMetadata?: PhotoCaptureMetadata
   errorCode?: string
   errorMessage?: string
 }
 
+export type VideoRecordingStatusEvent = {
+  type: "video_recording_status"
+  requestId?: string
+  success: boolean
+  status: VideoRecordingStatusState
+  details?: string | null
+  timestamp: number
+  data?: {
+    recording?: boolean
+    duration_ms?: number
+    duration_formatted?: string
+    [key: string]: unknown
+  }
+}
+
+export type VideoRecordingStatusState =
+  | "recording_started"
+  | "recording_status"
+  | "already_recording"
+  | "recording_stopped"
+  | "not_recording"
+  | "request_id_mismatch"
+  | "service_unavailable"
+  | "json_error"
+  | "battery_low"
+  | "camera_busy"
+  | "storage_unavailable"
+  | "integrity_failed"
+  | "error"
+
+export type VideoRecordingStartedStatusEvent = Omit<VideoRecordingStatusEvent, "success" | "status"> & {
+  success: true
+  status: "recording_started"
+}
+
+export type VideoRecordingStoppedStatusEvent = Omit<VideoRecordingStatusEvent, "success" | "status"> & {
+  success: true
+  status: "recording_stopped"
+}
+
+export type VideoRecordingSuccessStatusEvent =
+  | VideoRecordingStartedStatusEvent
+  | VideoRecordingStoppedStatusEvent
+
 export type GalleryStatusEvent = {
   type: "gallery_status"
   photos: number
@@ -185,6 +307,7 @@ export type GalleryStatusEvent = {
   totalSize?: number
   hasContent: boolean
   cameraBusy: boolean
+  cameraBusyReason?: "video" | "stream" | (string & {})
 }
 
 export type CompatibleGlassesSearchStopEvent = {
@@ -232,11 +355,60 @@ export type RgbLedControlResponseEvent =
       errorCode: string
     }
 
+export type RgbLedControlSuccessResponseEvent = Extract<RgbLedControlResponseEvent, {state: "success"}>
+
+export type SettingsAckStatus = "applied" | "ready" | "error" | "failed" | "failure" | "rejected"
+
+export type SettingsAckSetting =
+  | "gallery_mode"
+  | "button_photo"
+  | "button_video_recording"
+  | "button_camera_led"
+  | "button_max_recording_time"
+  | "camera_fov"
+
+export type SettingsAckEvent = {
+  type: "settings_ack"
+  requestId: string
+  setting: SettingsAckSetting
+  status: SettingsAckStatus
+  timestamp: number
+  fov?: number
+  roiPosition?: CameraRoiPositionValue
+  hardwareApplied?: boolean
+  active?: boolean
+  size?: ButtonPhotoSize | string
+  width?: number
+  height?: number
+  fps?: number
+  enabled?: boolean
+  minutes?: number
+  errorCode?: string
+  errorMessage?: string
+}
+
+export type SettingsAckSuccessStatus = Exclude<SettingsAckStatus, "error" | "failed" | "failure" | "rejected">
+
+export type SettingsAckSuccessEvent = Omit<SettingsAckEvent, "status"> & {
+  status: SettingsAckSuccessStatus
+}
+
 export type RgbLedAction = "on" | "off"
 export type RgbLedColor = "red" | "green" | "blue" | "orange" | "white"
 export type PhotoSize = "small" | "medium" | "large" | "full"
 export type ButtonPhotoSize = "small" | "medium" | "large"
 export type PhotoCompression = "none" | "medium" | "heavy"
+
+/**
+ * Optional per-recording video settings for {@link startVideoRecording}. When
+ * omitted, the glasses fall back to their saved button-video settings. Any
+ * field left undefined is omitted from the BLE command (glasses default applies).
+ */
+export interface VideoRecordingSettings {
+  width?: number
+  height?: number
+  fps?: number
+}
 export const DeviceModels = {
   Simulated: "Simulated Glasses",
   G1: "Even Realities G1",
@@ -258,25 +430,38 @@ export type DashboardMenuItem = {
   values?: Record<string, unknown>
 }
 
-export const CAMERA_FOV_MIN = 82
+export const CAMERA_FOV_MIN = 62
 export const CAMERA_FOV_MAX = 118
 export const CAMERA_FOV_DEFAULT = 102
 
-export type CameraRoiPosition = 0 | 1 | 2
+export type CameraRoiPosition = "center" | "bottom" | "top"
+export type CameraRoiPositionValue = 0 | 1 | 2
+export type CameraFovPreset = "narrow" | "standard" | "wide"
+
+export type CameraFovRequest =
+  | {
+      fov: number
+      roiPosition?: CameraRoiPosition
+    }
+  | {
+      preset: CameraFovPreset
+    }
 
-export type CameraFov = {
+export type CameraFovResult = {
+  requestId: string
   fov: number
-  roiPosition?: CameraRoiPosition
+  roiPosition: CameraRoiPosition
+  timestamp: number
 }
 
 export type CameraFovSetting = {
   fov: number
-  roiPosition: CameraRoiPosition
+  roiPosition: CameraRoiPositionValue
 }
 
 type NativeCameraFovSetting = {
   fov: number
-  roi_position: CameraRoiPosition
+  roi_position: CameraRoiPositionValue
 }
 
 export type MicPreference = "auto" | "phone" | "glasses" | "bluetooth"
@@ -289,6 +474,7 @@ export type PhotoRequestParams = {
   webhookUrl: string | null
   authToken: string | null
   compress: PhotoCompression
+  save?: boolean
   sound: boolean
   exposureTimeNs?: number | null
   /** Sensor ISO for this capture only. Only used when exposureTimeNs enables manual exposure. */
@@ -388,18 +574,27 @@ export type StreamStatusLifecycleState = "initializing" | "streaming" | "stoppin
 export type StreamStatusReconnectState = "reconnecting" | "reconnected" | "reconnect_failed"
 export type StreamStatusState = StreamStatusLifecycleState | StreamStatusReconnectState | "error"
 
+/** Effective stream settings reported by the glasses after defaults and clamps. */
 export type StreamResolvedConfig = {
   transport?: "rtmp" | "srt" | "whip"
   video?: {
+    /** Encoded output width sent to the stream endpoint. */
     width: number
+    /** Encoded output height sent to the stream endpoint. */
     height: number
+    /** Native camera buffer width selected before crop/downscale. */
     captureWidth?: number
+    /** Native camera buffer height selected before crop/downscale. */
     captureHeight?: number
+    /** Encoded video bitrate in bits per second. */
     bitrate: number
+    /** Resolved capture/encode frame rate. */
     fps: number
   }
   audio?: {
+    /** Encoded audio bitrate in bits per second. */
     bitrate?: number
+    /** Audio sample rate in Hz. */
     sampleRate?: number
     echoCancellation?: boolean
     noiseSuppression?: boolean
@@ -492,14 +687,16 @@ export type OtaStatusEvent = {
   session_id: string
   total_steps: number
   current_step: number
-  step_type: 'apk' | 'mtk' | 'bes'
-  phase: 'download' | 'install'
+  step_type: "apk" | "mtk" | "bes"
+  phase: "download" | "install"
   step_percent: number
   overall_percent: number
-  status: 'in_progress' | 'step_complete' | 'complete' | 'failed' | 'idle'
+  status: "in_progress" | "step_complete" | "complete" | "failed" | "idle"
   error_message?: string
 }
 
+export type OtaQueryResult = OtaUpdateAvailableEvent | OtaStatusEvent
+
 /** Nex BLE protobuf trace (NexEventUtils); payload matches native Map keys. */
 export type BleCommandTraceEvent = {
   command: string
@@ -531,10 +728,12 @@ export type BluetoothSdkModuleEvents = {
   battery_status: (event: BatteryStatusEvent) => void
   local_transcription: (event: LocalTranscriptionEvent) => void
   wifi_status_change: (event: WifiStatusChangeEvent) => void
+  wifi_scan_result: (event: WifiScanResultEvent) => void
   hotspot_status_change: (event: HotspotStatusChangeEvent) => void
   hotspot_error: (event: HotspotErrorEvent) => void
   photo_response: (event: PhotoResponseEvent) => void
   photo_status: (event: PhotoStatusEvent) => void
+  video_recording_status: (event: VideoRecordingStatusEvent) => void
   gallery_status: (event: GalleryStatusEvent) => void
   compatible_glasses_search_stop: (event: CompatibleGlassesSearchStopEvent) => void
   heartbeat_sent: (event: HeartbeatSentEvent) => void
@@ -542,6 +741,7 @@ export type BluetoothSdkModuleEvents = {
   swipe_volume_status: (event: SwipeVolumeStatusEvent) => void
   switch_status: (event: SwitchStatusEvent) => void
   rgb_led_control_response: (event: RgbLedControlResponseEvent) => void
+  settings_ack: (event: SettingsAckEvent) => void
   pair_failure: (event: PairFailureEvent) => void
   audio_pairing_needed: (event: AudioPairingNeededEvent) => void
   audio_connected: (event: AudioConnectedEvent) => void
@@ -557,9 +757,17 @@ export type BluetoothSdkModuleEvents = {
   ota_update_available: (event: OtaUpdateAvailableEvent) => void
   ota_start_ack: (event: OtaStartAckEvent) => void
   ota_status: (event: OtaStatusEvent) => void
+  version_info: (event: VersionInfoEvent) => void
   send_command_to_ble: (event: BleCommandTraceEvent) => void
   receive_command_from_ble: (event: BleCommandTraceEvent) => void
   miniapp_selected: (event: MiniappSelectedEvent) => void
+  extraction_progress: (event: ExtractionProgressEvent) => void
+}
+
+export interface ExtractionProgressEvent {
+  percentage: number
+  bytesRead: number
+  totalBytes: number
 }
 
 export type PublicGlassesStatus = Omit<
@@ -594,15 +802,18 @@ export type BluetoothSdkEventMap = {
   battery_status: BatteryStatusEvent
   local_transcription: LocalTranscriptionEvent
   wifi_status_change: WifiStatusChangeEvent
+  wifi_scan_result: WifiScanResultEvent
   hotspot_status_change: HotspotStatusChangeEvent
   hotspot_error: HotspotErrorEvent
   photo_response: PhotoResponseEvent
   photo_status: PhotoStatusEvent
+  video_recording_status: VideoRecordingStatusEvent
   gallery_status: GalleryStatusEvent
   compatible_glasses_search_stop: CompatibleGlassesSearchStopEvent
   swipe_volume_status: SwipeVolumeStatusEvent
   switch_status: SwitchStatusEvent
   rgb_led_control_response: RgbLedControlResponseEvent
+  settings_ack: SettingsAckEvent
   pair_failure: PairFailureEvent
   audio_pairing_needed: AudioPairingNeededEvent
   audio_connected: AudioConnectedEvent
@@ -610,6 +821,11 @@ export type BluetoothSdkEventMap = {
   mic_pcm: MicPcmEvent
   mic_lc3: MicLc3Event
   stream_status: StreamStatusEvent
+  ota_update_available: OtaUpdateAvailableEvent
+  ota_start_ack: OtaStartAckEvent
+  ota_status: OtaStatusEvent
+  version_info: VersionInfoEvent
+  extraction_progress: ExtractionProgressEvent
 }
 
 export type BluetoothSdkEventName = keyof BluetoothSdkEventMap
@@ -651,32 +867,32 @@ export interface BluetoothSdkPublicModule {
   setHeadUpAngle(angleDegrees: number): Promise<void>
   setScreenDisabled(disabled: boolean): Promise<void>
 
-  requestWifiScan(): Promise<void>
-  sendWifiCredentials(ssid: string, password: string): Promise<void>
-  forgetWifiNetwork(ssid: string): Promise<void>
-  setHotspotState(enabled: boolean): Promise<void>
+  requestWifiScan(): Promise<WifiSearchResult[]>
+  sendWifiCredentials(ssid: string, password: string): Promise<WifiStatusChangeEvent>
+  forgetWifiNetwork(ssid: string): Promise<WifiStatusChangeEvent>
+  setHotspotState(enabled: boolean): Promise<HotspotStatusChangeEvent>
 
-  setGalleryModeEnabled(enabled: boolean): Promise<void>
+  setGalleryModeEnabled(enabled: boolean): Promise<SettingsAckSuccessEvent>
   setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>
-  setButtonPhotoSettings(size: ButtonPhotoSize): Promise<void>
-  setButtonVideoRecordingSettings(width: number, height: number, fps: number): Promise<void>
-  setButtonCameraLed(enabled: boolean): Promise<void>
-  setButtonMaxRecordingTime(minutes: number): Promise<void>
-  setCameraFov(fov: CameraFov): Promise<void>
-  queryGalleryStatus(): Promise<void>
-  requestPhoto(params: PhotoRequestParams): Promise<void>
-  startVideoRecording(requestId: string, save: boolean, sound: boolean): Promise<void>
-  stopVideoRecording(requestId: string): Promise<void>
-
-  startStream(params: StreamStartRequest): Promise<void>
-  stopStream(): Promise<void>
-
-  setMicState(
-    enabled: boolean,
-    useGlassesMic?: boolean,
-    sendTranscript?: boolean,
-    sendLc3Data?: boolean,
-  ): Promise<void>
+  setButtonPhotoSettings(size: ButtonPhotoSize): Promise<SettingsAckSuccessEvent>
+  setButtonVideoRecordingSettings(width: number, height: number, fps: number): Promise<SettingsAckSuccessEvent>
+  setButtonCameraLed(enabled: boolean): Promise<SettingsAckSuccessEvent>
+  setButtonMaxRecordingTime(minutes: number): Promise<SettingsAckSuccessEvent>
+  setCameraFov(request: CameraFovRequest): Promise<CameraFovResult>
+  queryGalleryStatus(): Promise<GalleryStatusEvent>
+  requestPhoto(params: PhotoRequestParams): Promise<PhotoSuccessResponseEvent>
+  startVideoRecording(
+    requestId: string,
+    save: boolean,
+    sound: boolean,
+    settings?: VideoRecordingSettings,
+  ): Promise<VideoRecordingStartedStatusEvent>
+  stopVideoRecording(requestId: string): Promise<VideoRecordingStoppedStatusEvent>
+
+  startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
+  stopStream(): Promise<StreamStatusEvent>
+
+  setMicState(enabled: boolean, useGlassesMic?: boolean, sendTranscript?: boolean, sendLc3Data?: boolean): Promise<void>
   setPreferredMic(preferredMic: MicPreference): Promise<void>
   setOwnAppAudioPlaying(playing: boolean): Promise<void>
   getGlassesMediaVolume(): Promise<GlassesMediaVolumeGetResult>
@@ -690,9 +906,52 @@ export interface BluetoothSdkPublicModule {
     onDurationMs: number,
     offDurationMs: number,
     count: number,
-  ): Promise<void>
-
-  requestVersionInfo(): Promise<void>
+  ): Promise<RgbLedControlSuccessResponseEvent>
+
+  requestVersionInfo(): Promise<VersionInfoResult>
+  /** Ask connected Mentra Live glasses to check/report OTA availability and status. */
+  checkForOtaUpdate(): Promise<OtaQueryResult>
+  /** Start the OTA flow after your app has presented the available update to the user. */
+  startOtaUpdate(): Promise<OtaStartAckEvent>
+  /** Re-run the glasses-side OTA version check, mainly after correcting clock skew/TLS failures. */
+  retryOtaVersionCheck(): Promise<OtaQueryResult>
+
+  // // stt commands (MOVE TO CRUST)
+  // setSttModelDetails(path: string, languageCode: string): Promise<void>
+  // getSttModelPath(): Promise<string>
+  // checkSttModelAvailable(): Promise<boolean>
+  // validateSttModel(path: string): Promise<boolean>
+  // extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>
+
+  // // tts commands (MOVE TO CRUST)
+  // setTtsModelDetails(path: string, languageCode: string): Promise<void>
+  // getTtsModelPath(): Promise<string>
+  // getTtsModelLanguage(): Promise<string>
+  // checkTtsModelAvailable(): Promise<boolean>
+  // validateTtsModel(path: string): Promise<boolean>
+  // generateTtsAudio(text: string, path: string, outputPath: string, speakerId: number, speed: number): Promise<boolean>
+
+  // STT Commands (TODO: MOVE TO CRUST)
+  setSttModelDetails(path: string, languageCode: string): Promise<void>
+  getSttModelPath(): Promise<string>
+  checkSttModelAvailable(): Promise<boolean>
+  validateSttModel(path: string): Promise<boolean>
+  extractTarBz2(sourcePath: string, destinationPath: string): Promise<boolean>
+  restartTranscriber(): Promise<void>
+
+  // TTS Commands (TODO: MOVE TO CRUST)
+  setTtsModelDetails(path: string, languageCode: string): Promise<void>
+  getTtsModelPath(): Promise<string>
+  getTtsModelLanguage(): Promise<string>
+  checkTtsModelAvailable(): Promise<boolean>
+  validateTtsModel(path: string): Promise<boolean>
+  generateTtsAudio(
+    text: string,
+    modelPath: string,
+    outputPath: string,
+    speakerId: number,
+    speed: number,
+  ): Promise<boolean>
 }
 
 // OTA update status types
@@ -703,11 +962,11 @@ export interface OtaStatus {
   sessionId: string
   totalSteps: number
   currentStep: number
-  stepType: 'apk' | 'mtk' | 'bes'
-  phase: 'download' | 'install'
+  stepType: "apk" | "mtk" | "bes"
+  phase: "download" | "install"
   stepPercent: number
   overallPercent: number
-  status: 'in_progress' | 'step_complete' | 'complete' | 'failed' | 'idle'
+  status: "in_progress" | "step_complete" | "complete" | "failed" | "idle"
   error?: string
 }
 
@@ -749,6 +1008,8 @@ export interface GlassesStatus {
   leftMacAddress: string
   rightMacAddress: string
   buildNumber: string
+  /** Glasses System.currentTimeMillis() from last version_info (clock skew detection). */
+  systemTimeMs?: number
   otaVersionUrl: string
   appVersion: string
   bluetoothName: string
@@ -784,8 +1045,16 @@ export interface CoreDashboardMenuItem {
   running: boolean
 }
 
+export interface CalendarEvent {
+  title: string
+  location?: string
+  time: string
+  endDate: number
+}
+
 export interface CoreSettings {
   menu_apps: CoreDashboardMenuItem[]
+  calendar_events: CalendarEvent[]
 }
 
 export interface Device {
@@ -876,6 +1145,9 @@ export type BluetoothSettingsUpdate = Partial<{
   dashboard_height: number
   dashboard_depth: number
   menu_apps: DashboardMenuItem[] | CoreDashboardMenuItem[] | Array<Record<string, unknown>> | null
+  calendar_events: CalendarEvent[]
+  metric_system: boolean
+  twelve_hour_time: boolean
   gallery_mode: boolean
   voice_activity_detection_enabled: boolean
   button_photo_size: ButtonPhotoSize