@mentra/engine 3.1.0-dev.98 → 3.1.1-beta.230

package/src/react/MentraLiveOtaFlow.tsx

@@ -70,6 +70,20 @@ const DEFAULT_THEME: MentraLiveOtaFlowTheme = {
 }
 
 const ENGLISH_COPY: Record<string, string> = {
+  "ota:downloadingToPhone": "Downloading update to phone...",
+  "ota:startingGlassesHotspot": "Starting glasses hotspot...",
+  "ota:connectingPhoneToGlasses": "Connecting phone to glasses...",
+  "ota:startingHotspotUpdate": "Starting update...",
+  "ota:transferringToGlasses": "Transferring update to glasses...",
+  "ota:installingOnGlasses": "Installing update on glasses...",
+  "ota:componentApk": "Glasses software",
+  "ota:componentMtk": "System firmware",
+  "ota:componentBes": "Bluetooth firmware",
+  "ota:updateFile": "File {{current}} of {{total}} · {{component}}",
+  "ota:updatePart": "Update {{current}} of {{total}} · {{component}}",
+  "ota:phoneFileProgress": "Each file downloads separately. Progress is for the current file.",
+  "ota:transferFileProgress": "Progress is for this file’s transfer from your phone.",
+
   "common:continue": "Continue",
   "common:done": "Done",
   "ota:checkingForUpdates": "Checking for updates",
@@ -125,6 +139,12 @@ const ENGLISH_COPY: Record<string, string> = {
     "Your glasses restarted with new firmware. One more step: they'll now continue to the required version.",
 }
 
+const componentCopyKey = {
+  apk: "ota:componentApk",
+  mtk: "ota:componentMtk",
+  bes: "ota:componentBes",
+} as const
+
 function defaultTranslate(key: string, options?: Record<string, string>): string {
   let value = ENGLISH_COPY[key] ?? key
   for (const [name, replacement] of Object.entries(options ?? {})) {
@@ -374,28 +394,65 @@ function OtaFlowContent({
   }
 
   if (state.screen === "starting" || state.screen === "preparing_hotspot") {
-    const title =
+    const title = translate(
       state.hotspotPhase === "downloading"
-        ? "Downloading update to phone..."
+        ? "ota:downloadingToPhone"
         : state.hotspotPhase === "starting_hotspot"
-          ? "Starting glasses hotspot..."
+          ? "ota:startingGlassesHotspot"
           : state.hotspotPhase === "joining_hotspot"
-            ? "Connecting phone to glasses..."
-            : "Starting update..."
+            ? "ota:connectingPhoneToGlasses"
+            : "ota:startingHotspotUpdate",
+    )
+    const artifact = state.hotspotPhase === "downloading" ? state.hotspotArtifact : null
     return (
       <FlowPage colors={colors} icon="download" title={title}>
+        {artifact ? (
+          <BodyText colors={colors}>
+            {translate("ota:updateFile", {
+              current: String(artifact.index + 1),
+              total: String(artifact.totalCount),
+              component: translate(componentCopyKey[artifact.kind]),
+            })}
+          </BodyText>
+        ) : null}
         {state.hotspotPhase === "downloading" && state.hotspotArtifactPercent !== null ? (
           <PercentText colors={colors} percent={state.hotspotArtifactPercent} />
         ) : null}
         <ActivityIndicator size="large" color={colors.foreground} />
+        {state.hotspotPhase === "downloading" ? (
+          <BodyText colors={colors}>{translate("ota:phoneFileProgress")}</BodyText>
+        ) : null}
         <BodyText colors={colors}>Do not disconnect your glasses</BodyText>
       </FlowPage>
     )
   }
 
   if (state.screen === "updating") {
+    const hotspot = state.transport === "hotspot"
+    const title = hotspot
+      ? translate(state.phase === "download" ? "ota:transferringToGlasses" : "ota:installingOnGlasses")
+      : state.phase === "download"
+        ? "Downloading..."
+        : "Installing..."
+    const component = state.step ? translate(componentCopyKey[state.step]) : null
+    const hasStepCount =
+      state.currentStep !== null &&
+      state.totalSteps !== null &&
+      state.currentStep > 0 &&
+      state.currentStep <= state.totalSteps
     return (
-      <FlowPage colors={colors} icon="download" title={state.phase === "download" ? "Downloading..." : "Installing..."}>
+      <FlowPage colors={colors} icon="download" title={title}>
+        {hotspot && component ? (
+          <BodyText colors={colors}>
+            {hasStepCount
+              ? translate("ota:updatePart", {
+                  current: String(state.currentStep),
+                  total: String(state.totalSteps),
+                  component,
+                })
+              : component}
+          </BodyText>
+        ) : null}
         {state.installingApkOnly ? (
           <ActivityIndicator size="large" color={colors.foreground} />
         ) : (
@@ -409,6 +466,9 @@ function OtaFlowContent({
           </>
         )}
         <BodyText colors={colors}>Do not disconnect your glasses</BodyText>
+        {hotspot && state.phase === "download" ? (
+          <BodyText colors={colors}>{translate("ota:transferFileProgress")}</BodyText>
+        ) : null}
         {state.versionChange && state.phase === "install" ? (
           <BodyText colors={colors}>{translate("ota:downgradeDuration")}</BodyText>
         ) : null}
@@ -512,11 +572,15 @@ type FlowPageProps = {
 function FlowPage({actions, children, colors, contentAlignment = "center", icon, title}: FlowPageProps) {
   return (
     <View style={styles.page} testID="mentra-live-ota-flow">
-      <View style={[styles.centerContent, contentAlignment === "top" && styles.topContent]}>
+      <ScrollView
+        contentContainerStyle={[styles.centerContent, contentAlignment === "top" && styles.topContent]}
+        nestedScrollEnabled
+        style={styles.contentScroll}
+        testID="ota-page-scroll">
         <FlowIcon colors={colors} name={icon} />
         <Text style={[styles.title, {color: colors.foreground}]}>{title}</Text>
         {children}
-      </View>
+      </ScrollView>
       {actions ? <View style={styles.actions}>{actions}</View> : <View style={styles.actionSpacer} />}
     </View>
   )
@@ -628,12 +692,14 @@ export function ChangelogList({
   title: string
 }) {
   if (changelogs.length === 0) return null
+
   return (
     <View style={[styles.changelogCard, {borderColor: colors.border}]} testID="ota-changelog-card">
       <Text style={[styles.changelogTitle, {color: colors.foreground}]}>{title}</Text>
       <ScrollView
         contentContainerStyle={styles.changelogContent}
         nestedScrollEnabled
+        persistentScrollbar
         showsVerticalScrollIndicator
         style={styles.changelogList}
         testID="ota-changelog-scroll">
@@ -715,8 +781,9 @@ const styles = StyleSheet.create({
     paddingHorizontal: 20,
   },
   page: {flex: 1, paddingBottom: 24, paddingHorizontal: 24},
-  centerContent: {alignItems: "center", flex: 1, gap: 16, justifyContent: "center"},
-  topContent: {justifyContent: "flex-start", paddingTop: 12},
+  contentScroll: {flex: 1},
+  centerContent: {alignItems: "center", flexGrow: 1, gap: 16, justifyContent: "center"},
+  topContent: {justifyContent: "flex-start", paddingBottom: 16, paddingTop: 12},
   actionSpacer: {height: 48},
   actions: {gap: 12},
   icon: {fontSize: 64, fontWeight: "500", lineHeight: 72, textAlign: "center"},
@@ -728,16 +795,17 @@ const styles = StyleSheet.create({
   changelogCard: {
     borderRadius: 16,
     borderWidth: 1,
-    flexShrink: 1,
+    flexGrow: 1,
     gap: 12,
-    maxHeight: 300,
     maxWidth: 420,
+    minHeight: 200,
     padding: 16,
     width: "100%",
   },
   changelogTitle: {fontSize: 16, fontWeight: "700"},
-  changelogList: {flexShrink: 1, maxHeight: 232, width: "100%"},
-  changelogContent: {gap: 20, paddingBottom: 2},
+  // Bound the notes themselves so the card can grow for its title, but not for all of the Markdown.
+  changelogList: {flexGrow: 1, height: 120, width: "100%"},
+  changelogContent: {gap: 20, paddingBottom: 4},
   changelogEntry: {gap: 8},
   changelogEntryDivider: {borderTopWidth: StyleSheet.hairlineWidth, paddingTop: 20},
   changelogVersion: {fontSize: 14, fontWeight: "600"},

package/src/react/useMentraLiveOta.ts

@@ -82,6 +82,11 @@ export type MentraLiveOtaState = {
   hotspotSupported: boolean
   hotspotPhase: MentraLiveOtaHotspotPhase
   hotspotArtifactPercent: number | null
+  /**
+   * Current phone download context. Index is zero-based; percent applies to this file only.
+   * Optional for source compatibility; this hook returns null when no file is active.
+   */
+  hotspotArtifact?: {kind: MentraLiveOtaStep; index: number; totalCount: number} | null
   phase: MentraLiveOtaInstallPhase | null
   step: MentraLiveOtaStep | null
   currentStep: number | null
@@ -624,6 +629,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         hotspotSupported,
         hotspotPhase: "idle",
         hotspotArtifactPercent: null,
+        hotspotArtifact: null,
         phase: null,
         step: null,
         currentStep: null,
@@ -678,6 +684,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
         hotspotSupported,
         hotspotPhase: "idle",
         hotspotArtifactPercent: null,
+        hotspotArtifact: null,
         phase: null,
         step: null,
         currentStep: null,
@@ -732,6 +739,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
           }
         : null
     const totalSteps = installSnapshot.otaStatus?.totalSteps ?? null
+    const artifact = installSnapshot.hotspotArtifact
     const changelogs = screen === "complete" ? releaseChangelogsForActiveChain() : []
     return {
       screen,
@@ -747,6 +755,7 @@ export function useMentraLiveOta(options: UseMentraLiveOtaOptions = {}): MentraL
       hotspotSupported,
       hotspotPhase: installSnapshot.hotspotPhase,
       hotspotArtifactPercent: installSnapshot.hotspotArtifactPercent,
+      hotspotArtifact: artifact ? {kind: artifact.kind, index: artifact.index, totalCount: artifact.totalCount} : null,
       phase: installSnapshot.otaStatus?.phase ?? installSnapshot.otaProgress?.stage ?? null,
       step: installSnapshot.otaStatus?.stepType ?? null,
       currentStep: installSnapshot.otaStatus?.currentStep ?? null,

package/src/services/OtaArtifactDownloader.ts

@@ -139,6 +139,16 @@ export async function prepareArtifacts(
   const prepared: PreparedOtaArtifact[] = []
   for (let index = 0; index < plan.length; index++) {
     const entry = plan[index]
+    // Announce each file before cache verification or native download callbacks,
+    // so the previous file's 100% cannot linger under the next file's label.
+    onProgress?.({
+      kind: entry.kind,
+      index,
+      totalCount: plan.length,
+      artifactPercent: 0,
+      bytesWritten: 0,
+      contentLength: 0,
+    })
 
     const cachedPath = `${directory}/${entry.sha256}`
     if (await RNFS.exists(cachedPath)) {

package/src/services/OtaInstallCoordinator.ts

@@ -22,6 +22,7 @@ import GlobalEventEmitter from "../utils/GlobalEventEmitter"
 import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
 import {resolveOtaManifestUrl} from "./otaManifestUrl"
 import {hotspotOtaTransport, type HotspotOtaPhase} from "./HotspotOtaTransport"
+import type {OtaArtifactDownloadProgress} from "./OtaArtifactDownloader"
 import type {OtaCheckCurrentGlassesResult} from "./OtaUpdateCheckService"
 import {deriveDisplayState, type DisplayState} from "./otaDisplayState"
 import {
@@ -139,8 +140,10 @@ function latestPercentForStuck(otaStatus: OtaStatus | null, otaProgress: OtaProg
  * reply that cancels the fallback.
  */
 function hasRecoveringOtaReply(otaStatus: OtaStatus | null, otaProgress: OtaProgress | null): boolean {
-  if (otaProgress) return true
-  return !!otaStatus && otaStatus.status !== "idle"
+  // OtaService projects status into legacy progress too: idle becomes STARTED.
+  // Neither that projection nor progress retained across reboot proves activity.
+  if (otaStatus) return otaStatus.status !== "idle"
+  return !!otaProgress
 }
 
 /** Read model the host progress screen renders from. */
@@ -171,6 +174,7 @@ export interface OtaInstallSnapshot {
   /** Pre-ota_start phone staging/join state for a hotspot attempt. */
   hotspotPhase: HotspotOtaPhase
   hotspotArtifactPercent: number | null
+  hotspotArtifact: OtaArtifactDownloadProgress | null
   /** Transport selected from the checked glasses capabilities and Wi-Fi state. */
   transport: "wifi" | "hotspot"
 }
@@ -189,6 +193,7 @@ class OtaInstallCoordinator {
   private hotspotManifestUrl: string | null = null
   private hotspotPhase: HotspotOtaPhase = "idle"
   private hotspotArtifactPercent: number | null = null
+  private hotspotArtifact: OtaArtifactDownloadProgress | null = null
 
   // Genuinely session-local state (was component state/refs).
   private errorMsg = ""
@@ -303,6 +308,7 @@ class OtaInstallCoordinator {
     this.hotspotManifestUrl = null
     this.hotspotPhase = "idle"
     this.hotspotArtifactPercent = null
+    this.hotspotArtifact = null
     return this.selectedTransport
   }
 
@@ -510,6 +516,7 @@ class OtaInstallCoordinator {
       versionChangePhase: this.deriveVersionChangePhase(connected),
       hotspotPhase: this.hotspotPhase,
       hotspotArtifactPercent: this.hotspotArtifactPercent,
+      hotspotArtifact: this.hotspotArtifact ? {...this.hotspotArtifact} : null,
       transport: this.selectedTransport,
     }
   }
@@ -1501,7 +1508,9 @@ class OtaInstallCoordinator {
           }
           this.hotspotManifestUrl = await hotspotOtaTransport.prepare(this.preparedCheckResult, (progress) => {
             this.hotspotPhase = progress.phase
-            this.hotspotArtifactPercent = progress.artifact?.artifactPercent ?? null
+            this.hotspotArtifact = progress.artifact ? {...progress.artifact} : null
+            this.hotspotArtifactPercent =
+              progress.artifact && progress.artifact.contentLength > 0 ? progress.artifact.artifactPercent : null
             this.emitInternalChange()
           })
         }
@@ -1581,6 +1590,7 @@ class OtaInstallCoordinator {
     this.hotspotManifestUrl = null
     this.hotspotPhase = "idle"
     this.hotspotArtifactPercent = null
+    this.hotspotArtifact = null
     this.emitInternalChange()
   }
 

package/src/services/OtaUpdateCheckService.ts

@@ -13,7 +13,11 @@ import {resolveOtaReleaseVersion} from "./otaReleaseVersion"
  * glasses reporting a bare "complete", which would otherwise present as false success. Keep this
  * in lockstep with the ASG/recovery constant at release time.
  */
-export const DOWNGRADE_FLOOR_VERSION_CODE = 0
+// Mentra 3.0: matches OtaConstants and RecoveryConstants on the glasses.
+// Coordinated releases guarantee higher supported ASG builds can downgrade; no source gate is needed.
+// The shipped floor may increase, never decrease, and must stay aligned across all checkers.
+// See asg_client/docs/mentra-live-spec.md#ota-and-updates.
+export const DOWNGRADE_FLOOR_VERSION_CODE = 51518114
 
 export interface VersionInfo {
   versionCode: number

package/src/services/PhoneStreamCoordinator.ts

@@ -813,12 +813,6 @@ export class PhoneStreamCoordinator {
       for (const reject of entry.hlsReadyRejecters) reject(pendingErr)
       entry.hlsReadyResolvers = []
       entry.hlsReadyRejecters = []
-      // Cloudflare DELETE is fire-and-forget — failing it doesn't undo the
-      // BLE stop we're about to do, and Cloudflare's idle-input scavenger
-      // will eventually clean up leaked inputs.
-      teardownManagedStream(entry.liveInputId).catch((err) => {
-        console.warn("[STREAM] teardownManagedStream failed:", err)
-      })
     }
 
     try {
@@ -833,6 +827,16 @@ export class PhoneStreamCoordinator {
       // Only clear if we're still the active entry (defensive — runExclusive
       // serializes us, so this should always be true).
       if (this.current === entry) this.current = null
+
+      if (entry.kind === "managed") {
+        // Start remote cleanup only after the publisher has stopped, but do not
+        // hold the local transition lock on an unbounded network request. The
+        // runtime's durable cleanup queue owns retries if this request fails or
+        // the app exits before Cloudflare finishes finalizing the recording.
+        void teardownManagedStream(entry.liveInputId).catch((err) => {
+          console.warn("[STREAM] teardownManagedStream failed:", err)
+        })
+      }
     }
   }
 }

package/src/stores/settings.ts

@@ -410,10 +410,10 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
-  // Mentra Live center-mic loudness / "Barrier" gate (cs_swit type 10). Default on.
+  // Mentra Live center-mic loudness / "Barrier" gate (cs_swit type 10). Opt-in.
   loudness_gate_enabled: {
     key: "loudness_gate_enabled",
-    defaultValue: () => true,
+    defaultValue: () => false,
     writable: true,
     saveOnServer: true,
     persist: true,
@@ -1048,6 +1048,21 @@ export const useSettingsStore = create<SettingsState>()(
           }
         }
 
+        // Reset existing installs once; later user/app opt-ins remain available.
+        const LOUDNESS_GATE_MIGRATION_KEY = "migration:loudness_gate_default_off_v1"
+        const loudnessGateMigrationDone = storage.load<boolean>(LOUDNESS_GATE_MIGRATION_KEY)
+        if (loudnessGateMigrationDone.is_error() || !loudnessGateMigrationDone.value) {
+          // updateServer: true, matching the android_blur / camera_fov migrations. The flag is
+          // inert until the Cloud V2 settings sync lands, but this setting is saveOnServer, so
+          // the intent recorded here is the one that should carry over.
+          const result = await get().setSetting(SETTINGS.loudness_gate_enabled.key, false, true)
+          if (result.is_error()) {
+            console.log("SETTINGS: loudness gate migration failed:", result.error)
+          } else {
+            storage.save(LOUDNESS_GATE_MIGRATION_KEY, true)
+          }
+        }
+
         const NOTIFICATION_LISTENER_MIGRATION_KEY = "migration:android_notification_listener_default_on_v1"
         const notificationListenerMigrationDone = storage.load<boolean>(NOTIFICATION_LISTENER_MIGRATION_KEY)
         if (notificationListenerMigrationDone.is_error() || !notificationListenerMigrationDone.value) {

package/src/utils/devLogging.ts

@@ -59,7 +59,6 @@ class LogRingBuffer {
       /The action 'POP_TO_TOP' was not handled/,
       /socket-0 binding/,
       /socket-0 bound to/,
-      /Error while flushing PostHog/,
       /backTitleFontFamily prop is not available on Android/,
       /disableBackButtonMenu prop is not available on Android/,
       /backTitleVisible prop is not available on Android/,