@mentra/engine 3.1.0-beta.169 → 3.1.0-beta.171

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/engine",
-  "version": "3.1.0-beta.169",
+  "version": "3.1.0-beta.171",
   "description": "Mentra Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,11 +97,11 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/bluetooth-sdk": "3.1.0-beta.169",
-    "@mentra/cloud-client": "3.1.0-beta.169",
-    "@mentra/cloud-protocol": "3.1.0-beta.169",
-    "@mentra/crust": "3.1.0-beta.169",
-    "@mentra/miniapp": "3.1.0-beta.169",
+    "@mentra/bluetooth-sdk": "3.1.0-beta.171",
+    "@mentra/cloud-client": "3.1.0-beta.171",
+    "@mentra/cloud-protocol": "3.1.0-beta.171",
+    "@mentra/crust": "3.1.0-beta.171",
+    "@mentra/miniapp": "3.1.0-beta.171",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.1.0",
-  "releaseIdentity": "3.1.0-beta.169",
-  "releaseSetId": "mentra-3.1.0-beta.169",
-  "sourceCommit": "c3ad979a600aa6a879e2d41e73b46f2faa0467de",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.1.0/mentra-live-ota-3.1.0-beta.169.json",
-  "otaManifestSha256": "f1b503b8e740d4a5ee9a816ed402bae6cce9821b8895409bebe6a1c506027b7f"
+  "releaseIdentity": "3.1.0-beta.171",
+  "releaseSetId": "mentra-3.1.0-beta.171",
+  "sourceCommit": "ea4baf4f6b2372c5cf3e6984759ccf40a4a8d94c",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.1.0/mentra-live-ota-3.1.0-beta.171.json",
+  "otaManifestSha256": "b1a66cd2040a5c87b343cd94616398d8e2d37293786cc852dd4ff9049491e4a2"
 })

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}

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()
   }