@mentra/engine 0.1.0-dev.0 → 0.1.0-dev.1

package/build/services/manifestActions.js

@@ -0,0 +1,25 @@
+/**
+ * Normalize manifest actions defensively for installed and dev-sideloaded
+ * bundles. Input and output schemas are passed through as opaque JSON Schema.
+ */
+export function normalizeManifestActions(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const a of raw) {
+        if (a && typeof a.id === "string" && typeof a.description === "string") {
+            out.push({
+                id: a.id,
+                description: a.description,
+                ...(a.parameters && typeof a.parameters === "object" && !Array.isArray(a.parameters)
+                    ? { parameters: a.parameters }
+                    : {}),
+                ...(a.outputSchema && typeof a.outputSchema === "object" && !Array.isArray(a.outputSchema)
+                    ? { outputSchema: a.outputSchema }
+                    : {}),
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=manifestActions.js.map

package/build/services/manifestActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestActions.js","sourceRoot":"","sources":["../../src/services/manifestActions.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,GAAG,GAAqB,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,IAAI,GAKd,EAAE,CAAC;QACH,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACvE,GAAG,CAAC,IAAI,CAAC;gBACP,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;oBAClF,CAAC,CAAC,EAAC,UAAU,EAAE,CAAC,CAAC,UAAqC,EAAC;oBACvD,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;oBACxF,CAAC,CAAC,EAAC,YAAY,EAAE,CAAC,CAAC,YAAuC,EAAC;oBAC3D,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["import type {DeclaredAction} from \"../types/applet\"\n\n/**\n * Normalize manifest actions defensively for installed and dev-sideloaded\n * bundles. Input and output schemas are passed through as opaque JSON Schema.\n */\nexport function normalizeManifestActions(raw: unknown): DeclaredAction[] {\n  if (!Array.isArray(raw)) return []\n  const out: DeclaredAction[] = []\n  for (const a of raw as Array<{\n    id?: unknown\n    description?: unknown\n    parameters?: unknown\n    outputSchema?: unknown\n  }>) {\n    if (a && typeof a.id === \"string\" && typeof a.description === \"string\") {\n      out.push({\n        id: a.id,\n        description: a.description,\n        ...(a.parameters && typeof a.parameters === \"object\" && !Array.isArray(a.parameters)\n          ? {parameters: a.parameters as Record<string, unknown>}\n          : {}),\n        ...(a.outputSchema && typeof a.outputSchema === \"object\" && !Array.isArray(a.outputSchema)\n          ? {outputSchema: a.outputSchema as Record<string, unknown>}\n          : {}),\n      })\n    }\n  }\n  return out\n}\n"]}

package/build/services/otaDisplayState.d.ts

@@ -14,29 +14,40 @@ export type DisplayState = "starting" | "updating" | "complete" | "failed" | "di
  *
  * Priority-ordered rules (first match wins):
  *   1. errorMsg !== ""                                          -> "failed"
- *   2. BES terminal + connected + sawReconnectEdge             -> "complete"
- *   3. BES terminal (any connection state)                     -> "restarting"
+ *   2. BES reboot recovery complete                             -> "complete"
+ *   3. BES reboot recovery awaiting reconnect                  -> "restarting"
+ *   4. BES terminal (any connection state)                     -> "restarting"
  *      (legacy-shaped BES "complete" counts only in install phase)
- *   4. apkCompletedViaBuildIncrease (legacy build-number port) -> "complete"
- *   5. otaStatus.status === "failed"                           -> "failed"
- *   6. otaStatus.status === "complete" (non-BES)               -> "complete"
+ *   6. apkCompletedViaBuildIncrease (legacy build-number port) -> "complete"
+ *   7. otaStatus.status === "failed"                           -> "failed"
+ *   8. otaStatus.status === "complete" (non-BES)               -> "complete"
  *      (unless legacy-shaped download-complete or held apk settle -> in flight)
- *   7. !connected + legacy in-flight complete (held apk)       -> "updating"
- *   8. !connected + APK step_complete with totalSteps > 1      -> "starting"   (expected reboot)
- *   9. !connected + BES in flight                              -> "restarting" (defensive)
- *   10. !connected                                             -> "disconnected"
- *   11. connected + in_progress | step_complete | legacy in-flight complete -> "updating"
- *   12. fallback                                               -> "starting"
+ *   9. !connected + legacy in-flight complete (held apk)       -> "updating"
+ *   10. !connected + APK step_complete with totalSteps > 1     -> "starting"   (expected reboot)
+ *   11. !connected + BES in flight                             -> "restarting" (defensive)
+ *   12. !connected                                             -> "disconnected"
+ *   13. connected + in_progress | step_complete | legacy in-flight complete -> "updating"
+ *   14. fallback                                               -> "starting"
  */
 export declare function deriveDisplayState(args: {
     otaStatus: OtaStatus | null;
     otaProgress: OtaProgress | null;
     connected: boolean;
     errorMsg: string;
+    /**
+     * Retained for host API compatibility. A session-wide reconnect edge is not
+     * sufficient for BES completion because it may belong to an earlier APK step.
+     */
     sawReconnectEdge: boolean;
     /** Coordinator is holding a legacy apk install "complete" for the settle window (WP 8C). */
     legacyApkSettleHold?: boolean;
     /** Legacy APK completion detected by build-number increase (WP 8C). */
     apkCompletedViaBuildIncrease?: boolean;
+    /** Phone-observed BES disconnect/reconnect recovery, independent of stale OTA progress. */
+    besRestartRecovery?: "awaiting" | "complete" | null;
+    /** Downgrade detour: the reconnected glasses reported exactly the pinned target version. */
+    versionChangeConverged?: boolean;
+    /** True for the whole downgrade (version-change) session. */
+    versionChangeSession?: boolean;
 }): DisplayState;
 //# sourceMappingURL=otaDisplayState.d.ts.map

package/build/services/otaDisplayState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otaDisplayState.d.ts","sourceRoot":"","sources":["../../src/services/otaDisplayState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,gCAAgC,CAAA;AAI1E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,YAAY,CAAA;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,OAAO,CAAA;IACzB,4FAA4F;IAC5F,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uEAAuE;IACvE,4BAA4B,CAAC,EAAE,OAAO,CAAA;CACvC,GAAG,YAAY,CAuDf"}
+{"version":3,"file":"otaDisplayState.d.ts","sourceRoot":"","sources":["../../src/services/otaDisplayState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,gCAAgC,CAAA;AAI1E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,YAAY,CAAA;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAA;IACzB,4FAA4F;IAC5F,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,uEAAuE;IACvE,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAAA;IACnD,4FAA4F;IAC5F,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,GAAG,YAAY,CAqFf"}

package/build/services/otaDisplayState.js

@@ -13,27 +13,49 @@ import { isLegacyShapedOtaStatus } from "./otaInstallPolicy";
  *
  * Priority-ordered rules (first match wins):
  *   1. errorMsg !== ""                                          -> "failed"
- *   2. BES terminal + connected + sawReconnectEdge             -> "complete"
- *   3. BES terminal (any connection state)                     -> "restarting"
+ *   2. BES reboot recovery complete                             -> "complete"
+ *   3. BES reboot recovery awaiting reconnect                  -> "restarting"
+ *   4. BES terminal (any connection state)                     -> "restarting"
  *      (legacy-shaped BES "complete" counts only in install phase)
- *   4. apkCompletedViaBuildIncrease (legacy build-number port) -> "complete"
- *   5. otaStatus.status === "failed"                           -> "failed"
- *   6. otaStatus.status === "complete" (non-BES)               -> "complete"
+ *   6. apkCompletedViaBuildIncrease (legacy build-number port) -> "complete"
+ *   7. otaStatus.status === "failed"                           -> "failed"
+ *   8. otaStatus.status === "complete" (non-BES)               -> "complete"
  *      (unless legacy-shaped download-complete or held apk settle -> in flight)
- *   7. !connected + legacy in-flight complete (held apk)       -> "updating"
- *   8. !connected + APK step_complete with totalSteps > 1      -> "starting"   (expected reboot)
- *   9. !connected + BES in flight                              -> "restarting" (defensive)
- *   10. !connected                                             -> "disconnected"
- *   11. connected + in_progress | step_complete | legacy in-flight complete -> "updating"
- *   12. fallback                                               -> "starting"
+ *   9. !connected + legacy in-flight complete (held apk)       -> "updating"
+ *   10. !connected + APK step_complete with totalSteps > 1     -> "starting"   (expected reboot)
+ *   11. !connected + BES in flight                             -> "restarting" (defensive)
+ *   12. !connected                                             -> "disconnected"
+ *   13. connected + in_progress | step_complete | legacy in-flight complete -> "updating"
+ *   14. fallback                                               -> "starting"
  */
 export function deriveDisplayState(args) {
-    const { otaStatus, otaProgress, connected, errorMsg, sawReconnectEdge, legacyApkSettleHold, apkCompletedViaBuildIncrease } = args;
+    const { otaStatus, otaProgress, connected, errorMsg, legacyApkSettleHold, apkCompletedViaBuildIncrease, besRestartRecovery, versionChangeConverged, versionChangeSession, } = args;
     if (errorMsg)
         return "failed";
-    const besTerminal = isBesTerminal(otaStatus, otaProgress);
-    if (besTerminal && connected && sawReconnectEdge)
+    // Downgrade detour completion: exact-version convergence after reconnect is the
+    // only completion signal (the wipe destroys ASG's ota_session, and the target is
+    // a LOWER build so no build-number increase fires). Outranks the stale install
+    // status still sitting in the store from before the handoff.
+    if (versionChangeConverged)
+        return "complete";
+    // A BES reboot destroys or strands the glasses-side OTA session on older
+    // clients. Once the phone observed that reboot, stale pre-reboot progress must
+    // not move the UI from restarting back to updating.
+    if (besRestartRecovery === "complete")
         return "complete";
+    if (besRestartRecovery === "awaiting")
+        return "restarting";
+    // In a version-change session, convergence (above) is the ONLY completion for the ASG
+    // downgrade. A bare non-firmware "complete" before convergence — the glasses refusing
+    // the downgrade (floor/gate) with no install, or a stale pre-handoff status — must never
+    // present as success. Firmware-step completions (mtk/bes) DO pass through: a combined
+    // downgrade+firmware manifest applies firmware first on its own pass, which must finish
+    // so the phone re-checks and re-offers the now-firmware-free downgrade.
+    const isFirmwareComplete = otaStatus?.stepType === "mtk" || otaStatus?.stepType === "bes";
+    if (versionChangeSession && otaStatus?.status === "complete" && !isFirmwareComplete) {
+        return connected ? "updating" : "disconnected";
+    }
+    const besTerminal = isBesTerminal(otaStatus, otaProgress);
     if (besTerminal)
         return "restarting";
     // Legacy build-number APK completion: the coordinator clears errorMsg when it fires,

package/build/services/otaDisplayState.js.map

@@ -1 +1 @@
-{"version":3,"file":"otaDisplayState.js","sourceRoot":"","sources":["../../src/services/otaDisplayState.ts"],"names":[],"mappings":"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","sourcesContent":["import type {OtaProgress, OtaStatus} from \"@mentra/bluetooth-sdk/internal\"\n\nimport {isLegacyShapedOtaStatus} from \"./otaInstallPolicy\"\n\nexport type DisplayState = \"starting\" | \"updating\" | \"complete\" | \"failed\" | \"disconnected\" | \"restarting\"\n\n/**\n * Pure derivation of the OTA progress UI state from the glasses data in the\n * Zustand store plus a couple of genuinely-local inputs. See\n * OtaInstallCoordinator.ts for the state machine that consumes this (the host\n * progress screen renders its snapshot).\n *\n * Legacy shape (WP 8C): old (< 37) ASG builds send `ota_progress`, which the SDK\n * maps to ota_status with sessionId \"\" and FINISHED→\"complete\" at ANY phase. For\n * those statuses a download-phase \"complete\" only means the download finished\n * (the install is still ahead), and an apk install \"complete\" may be held by the\n * coordinator's settle window — both stay \"updating\" instead of terminal.\n *\n * Priority-ordered rules (first match wins):\n *   1. errorMsg !== \"\"                                          -> \"failed\"\n *   2. BES terminal + connected + sawReconnectEdge             -> \"complete\"\n *   3. BES terminal (any connection state)                     -> \"restarting\"\n *      (legacy-shaped BES \"complete\" counts only in install phase)\n *   4. apkCompletedViaBuildIncrease (legacy build-number port) -> \"complete\"\n *   5. otaStatus.status === \"failed\"                           -> \"failed\"\n *   6. otaStatus.status === \"complete\" (non-BES)               -> \"complete\"\n *      (unless legacy-shaped download-complete or held apk settle -> in flight)\n *   7. !connected + legacy in-flight complete (held apk)       -> \"updating\"\n *   8. !connected + APK step_complete with totalSteps > 1      -> \"starting\"   (expected reboot)\n *   9. !connected + BES in flight                              -> \"restarting\" (defensive)\n *   10. !connected                                             -> \"disconnected\"\n *   11. connected + in_progress | step_complete | legacy in-flight complete -> \"updating\"\n *   12. fallback                                               -> \"starting\"\n */\nexport function deriveDisplayState(args: {\n  otaStatus: OtaStatus | null\n  otaProgress: OtaProgress | null\n  connected: boolean\n  errorMsg: string\n  sawReconnectEdge: boolean\n  /** Coordinator is holding a legacy apk install \"complete\" for the settle window (WP 8C). */\n  legacyApkSettleHold?: boolean\n  /** Legacy APK completion detected by build-number increase (WP 8C). */\n  apkCompletedViaBuildIncrease?: boolean\n}): DisplayState {\n  const {otaStatus, otaProgress, connected, errorMsg, sawReconnectEdge, legacyApkSettleHold, apkCompletedViaBuildIncrease} =\n    args\n\n  if (errorMsg) return \"failed\"\n\n  const besTerminal = isBesTerminal(otaStatus, otaProgress)\n  if (besTerminal && connected && sawReconnectEdge) return \"complete\"\n  if (besTerminal) return \"restarting\"\n\n  // Legacy build-number APK completion: the coordinator clears errorMsg when it fires,\n  // and the flag outranks whatever stale legacy status is still in the store (the old\n  // screen's last-write-wins completion from starting/failed/installing).\n  if (apkCompletedViaBuildIncrease) return \"complete\"\n\n  if (otaStatus?.status === \"failed\") return \"failed\"\n\n  // Legacy-shaped \"complete\" that is still in flight: a download-phase FINISHED (the\n  // install is still ahead), or an apk install FINISHED held by the settle window.\n  const legacyInFlightComplete =\n    isLegacyShapedOtaStatus(otaStatus) &&\n    otaStatus?.status === \"complete\" &&\n    (otaStatus.phase === \"download\" ||\n      (!!legacyApkSettleHold && otaStatus.stepType === \"apk\" && otaStatus.phase === \"install\"))\n\n  if (otaStatus?.status === \"complete\" && !legacyInFlightComplete) return \"complete\"\n\n  if (!connected) {\n    // The held apk install complete means the glasses are restarting into the new\n    // build — the legacy screen kept showing \"installing\" through that restart.\n    if (legacyInFlightComplete && otaStatus?.phase === \"install\") return \"updating\"\n\n    // By here, the failed/complete rules already returned for terminal statuses.\n    // For APK multi-step, \"step_complete\" means the current step ended and the\n    // glasses are rebooting to start the next one.\n    const apkRebootExpected =\n      otaStatus?.stepType === \"apk\" && (otaStatus?.totalSteps ?? 0) > 1 && otaStatus.status === \"step_complete\"\n    if (apkRebootExpected) return \"starting\"\n\n    // Legacy-shaped BES download events do not mean a reboot is coming (the flash\n    // has not started); the legacy screen treated that drop as a plain disconnect.\n    const besStatusInFlight =\n      otaStatus?.stepType === \"bes\" && !(isLegacyShapedOtaStatus(otaStatus) && otaStatus.phase === \"download\")\n    const besInFlight =\n      besStatusInFlight || (otaProgress?.currentUpdate === \"bes\" && otaProgress?.stage === \"install\")\n    if (besInFlight) return \"restarting\"\n\n    return \"disconnected\"\n  }\n\n  if (otaStatus?.status === \"in_progress\" || otaStatus?.status === \"step_complete\" || legacyInFlightComplete) {\n    return \"updating\"\n  }\n\n  return \"starting\"\n}\n\nfunction isBesTerminal(otaStatus: OtaStatus | null, otaProgress: OtaProgress | null): boolean {\n  if (otaStatus?.stepType === \"bes\" && (otaStatus.status === \"step_complete\" || otaStatus.status === \"complete\")) {\n    // Legacy-shaped statuses map download FINISHED to \"complete\" too; only an\n    // install-phase terminal means the BES flash actually ran (WP 8C).\n    if (isLegacyShapedOtaStatus(otaStatus) && otaStatus.phase !== \"install\") {\n      return false\n    }\n    return true\n  }\n  if (otaProgress?.currentUpdate === \"bes\" && otaProgress.stage === \"install\" && otaProgress.status === \"FINISHED\") {\n    return true\n  }\n  return false\n}\n"]}
+{"version":3,"file":"otaDisplayState.js","sourceRoot":"","sources":["../../src/services/otaDisplayState.ts"],"names":[],"mappings":"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","sourcesContent":["import type {OtaProgress, OtaStatus} from \"@mentra/bluetooth-sdk/internal\"\n\nimport {isLegacyShapedOtaStatus} from \"./otaInstallPolicy\"\n\nexport type DisplayState = \"starting\" | \"updating\" | \"complete\" | \"failed\" | \"disconnected\" | \"restarting\"\n\n/**\n * Pure derivation of the OTA progress UI state from the glasses data in the\n * Zustand store plus a couple of genuinely-local inputs. See\n * OtaInstallCoordinator.ts for the state machine that consumes this (the host\n * progress screen renders its snapshot).\n *\n * Legacy shape (WP 8C): old (< 37) ASG builds send `ota_progress`, which the SDK\n * maps to ota_status with sessionId \"\" and FINISHED→\"complete\" at ANY phase. For\n * those statuses a download-phase \"complete\" only means the download finished\n * (the install is still ahead), and an apk install \"complete\" may be held by the\n * coordinator's settle window — both stay \"updating\" instead of terminal.\n *\n * Priority-ordered rules (first match wins):\n *   1. errorMsg !== \"\"                                          -> \"failed\"\n *   2. BES reboot recovery complete                             -> \"complete\"\n *   3. BES reboot recovery awaiting reconnect                  -> \"restarting\"\n *   4. BES terminal (any connection state)                     -> \"restarting\"\n *      (legacy-shaped BES \"complete\" counts only in install phase)\n *   6. apkCompletedViaBuildIncrease (legacy build-number port) -> \"complete\"\n *   7. otaStatus.status === \"failed\"                           -> \"failed\"\n *   8. otaStatus.status === \"complete\" (non-BES)               -> \"complete\"\n *      (unless legacy-shaped download-complete or held apk settle -> in flight)\n *   9. !connected + legacy in-flight complete (held apk)       -> \"updating\"\n *   10. !connected + APK step_complete with totalSteps > 1     -> \"starting\"   (expected reboot)\n *   11. !connected + BES in flight                             -> \"restarting\" (defensive)\n *   12. !connected                                             -> \"disconnected\"\n *   13. connected + in_progress | step_complete | legacy in-flight complete -> \"updating\"\n *   14. fallback                                               -> \"starting\"\n */\nexport function deriveDisplayState(args: {\n  otaStatus: OtaStatus | null\n  otaProgress: OtaProgress | null\n  connected: boolean\n  errorMsg: string\n  /**\n   * Retained for host API compatibility. A session-wide reconnect edge is not\n   * sufficient for BES completion because it may belong to an earlier APK step.\n   */\n  sawReconnectEdge: boolean\n  /** Coordinator is holding a legacy apk install \"complete\" for the settle window (WP 8C). */\n  legacyApkSettleHold?: boolean\n  /** Legacy APK completion detected by build-number increase (WP 8C). */\n  apkCompletedViaBuildIncrease?: boolean\n  /** Phone-observed BES disconnect/reconnect recovery, independent of stale OTA progress. */\n  besRestartRecovery?: \"awaiting\" | \"complete\" | null\n  /** Downgrade detour: the reconnected glasses reported exactly the pinned target version. */\n  versionChangeConverged?: boolean\n  /** True for the whole downgrade (version-change) session. */\n  versionChangeSession?: boolean\n}): DisplayState {\n  const {\n    otaStatus,\n    otaProgress,\n    connected,\n    errorMsg,\n    legacyApkSettleHold,\n    apkCompletedViaBuildIncrease,\n    besRestartRecovery,\n    versionChangeConverged,\n    versionChangeSession,\n  } = args\n\n  if (errorMsg) return \"failed\"\n\n  // Downgrade detour completion: exact-version convergence after reconnect is the\n  // only completion signal (the wipe destroys ASG's ota_session, and the target is\n  // a LOWER build so no build-number increase fires). Outranks the stale install\n  // status still sitting in the store from before the handoff.\n  if (versionChangeConverged) return \"complete\"\n\n  // A BES reboot destroys or strands the glasses-side OTA session on older\n  // clients. Once the phone observed that reboot, stale pre-reboot progress must\n  // not move the UI from restarting back to updating.\n  if (besRestartRecovery === \"complete\") return \"complete\"\n  if (besRestartRecovery === \"awaiting\") return \"restarting\"\n\n  // In a version-change session, convergence (above) is the ONLY completion for the ASG\n  // downgrade. A bare non-firmware \"complete\" before convergence — the glasses refusing\n  // the downgrade (floor/gate) with no install, or a stale pre-handoff status — must never\n  // present as success. Firmware-step completions (mtk/bes) DO pass through: a combined\n  // downgrade+firmware manifest applies firmware first on its own pass, which must finish\n  // so the phone re-checks and re-offers the now-firmware-free downgrade.\n  const isFirmwareComplete = otaStatus?.stepType === \"mtk\" || otaStatus?.stepType === \"bes\"\n  if (versionChangeSession && otaStatus?.status === \"complete\" && !isFirmwareComplete) {\n    return connected ? \"updating\" : \"disconnected\"\n  }\n\n  const besTerminal = isBesTerminal(otaStatus, otaProgress)\n  if (besTerminal) return \"restarting\"\n\n  // Legacy build-number APK completion: the coordinator clears errorMsg when it fires,\n  // and the flag outranks whatever stale legacy status is still in the store (the old\n  // screen's last-write-wins completion from starting/failed/installing).\n  if (apkCompletedViaBuildIncrease) return \"complete\"\n\n  if (otaStatus?.status === \"failed\") return \"failed\"\n\n  // Legacy-shaped \"complete\" that is still in flight: a download-phase FINISHED (the\n  // install is still ahead), or an apk install FINISHED held by the settle window.\n  const legacyInFlightComplete =\n    isLegacyShapedOtaStatus(otaStatus) &&\n    otaStatus?.status === \"complete\" &&\n    (otaStatus.phase === \"download\" ||\n      (!!legacyApkSettleHold && otaStatus.stepType === \"apk\" && otaStatus.phase === \"install\"))\n\n  if (otaStatus?.status === \"complete\" && !legacyInFlightComplete) return \"complete\"\n\n  if (!connected) {\n    // The held apk install complete means the glasses are restarting into the new\n    // build — the legacy screen kept showing \"installing\" through that restart.\n    if (legacyInFlightComplete && otaStatus?.phase === \"install\") return \"updating\"\n\n    // By here, the failed/complete rules already returned for terminal statuses.\n    // For APK multi-step, \"step_complete\" means the current step ended and the\n    // glasses are rebooting to start the next one.\n    const apkRebootExpected =\n      otaStatus?.stepType === \"apk\" && (otaStatus?.totalSteps ?? 0) > 1 && otaStatus.status === \"step_complete\"\n    if (apkRebootExpected) return \"starting\"\n\n    // Legacy-shaped BES download events do not mean a reboot is coming (the flash\n    // has not started); the legacy screen treated that drop as a plain disconnect.\n    const besStatusInFlight =\n      otaStatus?.stepType === \"bes\" && !(isLegacyShapedOtaStatus(otaStatus) && otaStatus.phase === \"download\")\n    const besInFlight = besStatusInFlight || (otaProgress?.currentUpdate === \"bes\" && otaProgress?.stage === \"install\")\n    if (besInFlight) return \"restarting\"\n\n    return \"disconnected\"\n  }\n\n  if (otaStatus?.status === \"in_progress\" || otaStatus?.status === \"step_complete\" || legacyInFlightComplete) {\n    return \"updating\"\n  }\n\n  return \"starting\"\n}\n\nfunction isBesTerminal(otaStatus: OtaStatus | null, otaProgress: OtaProgress | null): boolean {\n  if (otaStatus?.stepType === \"bes\" && (otaStatus.status === \"step_complete\" || otaStatus.status === \"complete\")) {\n    // Legacy-shaped statuses map download FINISHED to \"complete\" too; only an\n    // install-phase terminal means the BES flash actually ran (WP 8C).\n    if (isLegacyShapedOtaStatus(otaStatus) && otaStatus.phase !== \"install\") {\n      return false\n    }\n    return true\n  }\n  if (otaProgress?.currentUpdate === \"bes\" && otaProgress.stage === \"install\" && otaProgress.status === \"FINISHED\") {\n    return true\n  }\n  return false\n}\n"]}

package/build/services/otaInstallPolicy.d.ts

@@ -8,6 +8,7 @@ import type { OtaProgress, OtaStatus } from "@mentra/bluetooth-sdk/internal";
  */
 export declare const MINIMUM_OTA_STATUS_BUILD = 37;
 export declare const MAX_RETRIES = 3;
+/** Wait between ended native ota_start requests; never overlaps a pending request. */
 export declare const RETRY_INTERVAL_MS = 5000;
 /** APK/BES and general install when progress events are expected */
 export declare const PROGRESS_TIMEOUT_MS = 120000;
@@ -17,8 +18,6 @@ export declare const DOWNLOAD_STUCK_TIMEOUT_MS = 70000;
 export declare const MTK_INSTALL_TIMEOUT_MS = 300000;
 /** Whole multi-step session cap */
 export declare const GLOBAL_OTA_TIMEOUT_MS: number;
-/** After APK reboot, ASG OTA service needs time before next ota_start */
-export declare const POST_APK_OTA_START_DELAY_MS = 6000;
 /** BLE keepalive during OTA */
 export declare const PING_INTERVAL_MS = 10000;
 /**
@@ -58,6 +57,7 @@ export declare const LEGACY_MTK_STALL_ZONE_MIN_PERCENT = 45;
 export declare const LEGACY_MTK_STALL_ZONE_MAX_PERCENT = 55;
 export declare const LEGACY_MTK_SIM_FLOOR_PERCENT = 51;
 export declare const LEGACY_MTK_SIM_CAP_PERCENT = 60;
+export type OtaProtocolProfile = "legacy" | "unified";
 /**
  * Legacy-shaped ota_status: old (< 37) ASG builds send `ota_progress`, which the SDK
  * (Android MentraLive.kt / iOS MentraLive.swift) maps to a unified ota_status with
@@ -72,10 +72,22 @@ export declare function isLegacyShapedOtaStatus(otaStatus: OtaStatus | null): bo
  * before any event arrives only the glasses build number can tell.
  */
 export declare function isLegacyShapedOtaSession(otaStatus: OtaStatus | null, otaProgress: OtaProgress | null, buildNumber: string | null | undefined): boolean;
+/**
+ * Select the compatibility profile once at install-screen attach. The old split
+ * routes made this decision from the pre-update build and kept it for the whole
+ * mounted flow, even when an APK step restarted into a newer ASG build. Returning
+ * null leaves the coordinator undecided until the first meaningful OTA event.
+ */
+export declare function selectOtaProtocolProfile(otaStatus: OtaStatus | null, otaProgress: OtaProgress | null, buildNumber: string | null | undefined): OtaProtocolProfile | null;
 export declare const OtaProgressMessages: {
-    readonly noAckResponse: "Unable to start update. Glasses did not respond.";
     readonly stalledOrStuck: "Update may have failed. Ensure glasses have internet access and try again.";
     readonly globalTimeout: "Update took too long. Please try again.";
     readonly sendOtaStartFailed: "Failed to communicate with glasses.";
+    readonly hotspotArtifactDownloadFailed: "Could not download the update to your phone. Check phone internet and try again.";
+    readonly hotspotArtifactVerifyFailed: "The update package could not be verified. Please try again later.";
+    readonly hotspotWifiPermissionDenied: "Allow nearby devices access so the phone can connect to the glasses hotspot.";
+    readonly hotspotStartFailed: "Could not start the glasses hotspot. Please try again.";
+    readonly hotspotJoinFailed: "Could not connect the phone to the glasses hotspot. Please try again.";
+    readonly hotspotServerFailed: "Could not make the update available to the glasses. Please try again.";
 };
 //# sourceMappingURL=otaInstallPolicy.d.ts.map

package/build/services/otaInstallPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otaInstallPolicy.d.ts","sourceRoot":"","sources":["../../src/services/otaInstallPolicy.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,gCAAgC,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAE1C,eAAO,MAAM,WAAW,IAAI,CAAA;AAC5B,eAAO,MAAM,iBAAiB,OAAO,CAAA;AACrC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,SAAU,CAAA;AAC1C,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAC/C,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,SAAU,CAAA;AAC7C,mCAAmC;AACnC,eAAO,MAAM,qBAAqB,QAAiB,CAAA;AACnD,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,OAAO,CAAA;AAC/C,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,QAAS,CAAA;AACtC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAC1C,4FAA4F;AAC5F,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAW7C,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAC7C,eAAO,MAAM,wBAAwB,QAA8C,CAAA;AACnF,eAAO,MAAM,0BAA0B,QAAgD,CAAA;AACvF,eAAO,MAAM,gCAAgC,QAAsD,CAAA;AACnG,eAAO,MAAM,6BAA6B,QAAmD,CAAA;AAC7F,eAAO,MAAM,4BAA4B,QAAkD,CAAA;AAC3F,eAAO,MAAM,uBAAuB,QAA6C,CAAA;AACjF,eAAO,MAAM,8BAA8B,QAAoD,CAAA;AAC/F;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAAmC,CAAA;AAC/E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAmC,CAAA;AAC1E,eAAO,MAAM,sBAAsB,QAAmC,CAAA;AACtE,eAAO,MAAM,iCAAiC,KAAK,CAAA;AACnD,eAAO,MAAM,iCAAiC,KAAK,CAAA;AACnD,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAC9C,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAKT;AAED,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAA"}
+{"version":3,"file":"otaInstallPolicy.d.ts","sourceRoot":"","sources":["../../src/services/otaInstallPolicy.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,gCAAgC,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAE1C,eAAO,MAAM,WAAW,IAAI,CAAA;AAC5B,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,OAAO,CAAA;AACrC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,SAAU,CAAA;AAC1C,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAC/C,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,SAAU,CAAA;AAC7C,mCAAmC;AACnC,eAAO,MAAM,qBAAqB,QAAiB,CAAA;AACnD,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,QAAS,CAAA;AACtC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAC1C,4FAA4F;AAC5F,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAW7C,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAC7C,eAAO,MAAM,wBAAwB,QAA8C,CAAA;AACnF,eAAO,MAAM,0BAA0B,QAAgD,CAAA;AACvF,eAAO,MAAM,gCAAgC,QAAsD,CAAA;AACnG,eAAO,MAAM,6BAA6B,QAAmD,CAAA;AAC7F,eAAO,MAAM,4BAA4B,QAAkD,CAAA;AAC3F,eAAO,MAAM,uBAAuB,QAA6C,CAAA;AACjF,eAAO,MAAM,8BAA8B,QAAoD,CAAA;AAC/F;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAAmC,CAAA;AAC/E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAmC,CAAA;AAC1E,eAAO,MAAM,sBAAsB,QAAmC,CAAA;AACtE,eAAO,MAAM,iCAAiC,KAAK,CAAA;AACnD,eAAO,MAAM,iCAAiC,KAAK,CAAA;AACnD,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAC9C,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAA;AAErD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,kBAAkB,GAAG,IAAI,CAQ3B;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUtB,CAAA"}

package/build/services/otaInstallPolicy.js

@@ -6,6 +6,7 @@
  */
 export const MINIMUM_OTA_STATUS_BUILD = 37;
 export const MAX_RETRIES = 3;
+/** Wait between ended native ota_start requests; never overlaps a pending request. */
 export const RETRY_INTERVAL_MS = 5000;
 /** APK/BES and general install when progress events are expected */
 export const PROGRESS_TIMEOUT_MS = 120_000;
@@ -15,8 +16,6 @@ export const DOWNLOAD_STUCK_TIMEOUT_MS = 70_000;
 export const MTK_INSTALL_TIMEOUT_MS = 300_000;
 /** Whole multi-step session cap */
 export const GLOBAL_OTA_TIMEOUT_MS = 20 * 60 * 1000;
-/** After APK reboot, ASG OTA service needs time before next ota_start */
-export const POST_APK_OTA_START_DELAY_MS = 6000;
 /** BLE keepalive during OTA */
 export const PING_INTERVAL_MS = 10_000;
 /**
@@ -87,10 +86,32 @@ export function isLegacyShapedOtaSession(otaStatus, otaProgress, buildNumber) {
     const build = Number.parseInt(buildNumber ?? "", 10);
     return Number.isFinite(build) && build > 0 && build < MINIMUM_OTA_STATUS_BUILD;
 }
+/**
+ * Select the compatibility profile once at install-screen attach. The old split
+ * routes made this decision from the pre-update build and kept it for the whole
+ * mounted flow, even when an APK step restarted into a newer ASG build. Returning
+ * null leaves the coordinator undecided until the first meaningful OTA event.
+ */
+export function selectOtaProtocolProfile(otaStatus, otaProgress, buildNumber) {
+    const build = Number.parseInt(buildNumber ?? "", 10);
+    if (Number.isFinite(build) && build > 0) {
+        return build < MINIMUM_OTA_STATUS_BUILD ? "legacy" : "unified";
+    }
+    if (otaStatus)
+        return isLegacyShapedOtaStatus(otaStatus) ? "legacy" : "unified";
+    if (otaProgress)
+        return "legacy";
+    return null;
+}
 export const OtaProgressMessages = {
-    noAckResponse: "Unable to start update. Glasses did not respond.",
     stalledOrStuck: "Update may have failed. Ensure glasses have internet access and try again.",
     globalTimeout: "Update took too long. Please try again.",
     sendOtaStartFailed: "Failed to communicate with glasses.",
+    hotspotArtifactDownloadFailed: "Could not download the update to your phone. Check phone internet and try again.",
+    hotspotArtifactVerifyFailed: "The update package could not be verified. Please try again later.",
+    hotspotWifiPermissionDenied: "Allow nearby devices access so the phone can connect to the glasses hotspot.",
+    hotspotStartFailed: "Could not start the glasses hotspot. Please try again.",
+    hotspotJoinFailed: "Could not connect the phone to the glasses hotspot. Please try again.",
+    hotspotServerFailed: "Could not make the update available to the glasses. Please try again.",
 };
 //# sourceMappingURL=otaInstallPolicy.js.map

package/build/services/otaInstallPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"otaInstallPolicy.js","sourceRoot":"","sources":["../../src/services/otaInstallPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["/** Shared OTA progress watchdog timings (see progress-legacy.tsx / progress.tsx). */\nimport type {OtaProgress, OtaStatus} from \"@mentra/bluetooth-sdk/internal\"\n\n/**\n * First glasses `build_number` (ASG `versionCode`) that uses `progress.tsx` with unified\n * `ota_status` session UI. Strictly lower builds use `/ota/progress-legacy` (routed from\n * `check-for-updates.tsx` before navigation), and get the LEGACY_* padded policy below\n * in the unified OtaInstallCoordinator (WP 8C). Change only here.\n */\nexport const MINIMUM_OTA_STATUS_BUILD = 37\n\nexport const MAX_RETRIES = 3\nexport const RETRY_INTERVAL_MS = 5000\n/** APK/BES and general install when progress events are expected */\nexport const PROGRESS_TIMEOUT_MS = 120_000\n/** Fail if still at 0% in starting/downloading */\nexport const DOWNLOAD_STUCK_TIMEOUT_MS = 70_000\n/** MTK system install often goes quiet for long periods */\nexport const MTK_INSTALL_TIMEOUT_MS = 300_000\n/** Whole multi-step session cap */\nexport const GLOBAL_OTA_TIMEOUT_MS = 20 * 60 * 1000\n/** After APK reboot, ASG OTA service needs time before next ota_start */\nexport const POST_APK_OTA_START_DELAY_MS = 6000\n/** BLE keepalive during OTA */\nexport const PING_INTERVAL_MS = 10_000\n/**\n * If we sent ota_query_status (e.g. on reconnect) and the glasses haven't\n * replied with an ota_status by then, fall back to ota_start. This recovers\n * from the case where the glasses process restarted between mount and\n * reconnect — the session is gone, ota_query_status returns nothing, and\n * the user would otherwise sit on the spinner forever.\n */\nexport const QUERY_REPLY_TIMEOUT_MS = 6000\n/** 15s lockout on the Continue button after a BES restart, to prevent an accidental tap. */\nexport const BES_CONTINUE_LOCKOUT_MS = 15_000\n\n// --- Legacy old-build (< MINIMUM_OTA_STATUS_BUILD) OTA policy (WP 8C) ---\n//\n// Ported verbatim from mobile/src/app/ota/progress-legacy.tsx, which padded EVERY\n// watchdog/timer by +20s for old ASG builds (\"Legacy OTA: +20s on every watchdog /\n// timer duration\"). Old builds respond slower on every path, so where the legacy\n// screen used a longer duration the coordinator applies the longer value whenever\n// the session is legacy-shaped (see isLegacyShapedOtaStatus / the coordinator's\n// session-shape check). Builds >= 37 keep the unpadded values above.\n\n/** The uniform pad progress-legacy.tsx added to every duration for old builds. */\nexport const LEGACY_EXTRA_TIMEOUT_MS = 20_000\nexport const LEGACY_RETRY_INTERVAL_MS = RETRY_INTERVAL_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_PROGRESS_TIMEOUT_MS = PROGRESS_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_DOWNLOAD_STUCK_TIMEOUT_MS = DOWNLOAD_STUCK_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_MTK_INSTALL_TIMEOUT_MS = MTK_INSTALL_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_GLOBAL_OTA_TIMEOUT_MS = GLOBAL_OTA_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_PING_INTERVAL_MS = PING_INTERVAL_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_BES_CONTINUE_LOCKOUT_MS = BES_CONTINUE_LOCKOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\n/**\n * After a legacy apk `install FINISHED` observed in-flight, the legacy screen held the\n * completed state for 12s (+20s pad) so the ASG process restart settles (and fresh\n * version_info lands) before the user can continue.\n */\nexport const LEGACY_APK_COMPLETION_SETTLE_MS = 12_000 + LEGACY_EXTRA_TIMEOUT_MS\n/**\n * Legacy MTK install stall simulation (display-only): the MTK system install typically\n * stalls around 49-50%. After LEGACY_MTK_STALL_DETECT_MS without a new event in the\n * [45, 55) zone, the legacy screen simulated +1% every LEGACY_MTK_SIM_TICK_MS starting\n * at max(stall+1, 51) and capped at 60%, purely to keep the user informed.\n */\nexport const LEGACY_MTK_STALL_DETECT_MS = 20_000 + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_MTK_SIM_TICK_MS = 15_000 + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_MTK_STALL_ZONE_MIN_PERCENT = 45\nexport const LEGACY_MTK_STALL_ZONE_MAX_PERCENT = 55\nexport const LEGACY_MTK_SIM_FLOOR_PERCENT = 51\nexport const LEGACY_MTK_SIM_CAP_PERCENT = 60\n\n/**\n * Legacy-shaped ota_status: old (< 37) ASG builds send `ota_progress`, which the SDK\n * (Android MentraLive.kt / iOS MentraLive.swift) maps to a unified ota_status with\n * sessionId \"\" and totalSteps 1, and FINISHED→\"complete\" regardless of phase. A real\n * (>= 37) session always carries a sessionId; an \"idle\" reply also has sessionId \"\" but\n * proves the glasses speak the unified protocol, so it is NOT legacy-shaped.\n */\nexport function isLegacyShapedOtaStatus(otaStatus: OtaStatus | null): boolean {\n  return !!otaStatus && otaStatus.sessionId === \"\" && otaStatus.status !== \"idle\"\n}\n\n/**\n * Is the current install session legacy-shaped? Event shape wins when events exist\n * (per the WP 8C rule: key off legacy-shaped inputs, not a build flag, where possible);\n * before any event arrives only the glasses build number can tell.\n */\nexport function isLegacyShapedOtaSession(\n  otaStatus: OtaStatus | null,\n  otaProgress: OtaProgress | null,\n  buildNumber: string | null | undefined,\n): boolean {\n  if (otaStatus) return isLegacyShapedOtaStatus(otaStatus)\n  if (otaProgress) return true\n  const build = Number.parseInt(buildNumber ?? \"\", 10)\n  return Number.isFinite(build) && build > 0 && build < MINIMUM_OTA_STATUS_BUILD\n}\n\nexport const OtaProgressMessages = {\n  noAckResponse: \"Unable to start update. Glasses did not respond.\",\n  stalledOrStuck: \"Update may have failed. Ensure glasses have internet access and try again.\",\n  globalTimeout: \"Update took too long. Please try again.\",\n  sendOtaStartFailed: \"Failed to communicate with glasses.\",\n} as const\n"]}
+{"version":3,"file":"otaInstallPolicy.js","sourceRoot":"","sources":["../../src/services/otaInstallPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["/** Shared OTA progress watchdog timings (see progress-legacy.tsx / progress.tsx). */\nimport type {OtaProgress, OtaStatus} from \"@mentra/bluetooth-sdk/internal\"\n\n/**\n * First glasses `build_number` (ASG `versionCode`) that uses `progress.tsx` with unified\n * `ota_status` session UI. Strictly lower builds use `/ota/progress-legacy` (routed from\n * `check-for-updates.tsx` before navigation), and get the LEGACY_* padded policy below\n * in the unified OtaInstallCoordinator (WP 8C). Change only here.\n */\nexport const MINIMUM_OTA_STATUS_BUILD = 37\n\nexport const MAX_RETRIES = 3\n/** Wait between ended native ota_start requests; never overlaps a pending request. */\nexport const RETRY_INTERVAL_MS = 5000\n/** APK/BES and general install when progress events are expected */\nexport const PROGRESS_TIMEOUT_MS = 120_000\n/** Fail if still at 0% in starting/downloading */\nexport const DOWNLOAD_STUCK_TIMEOUT_MS = 70_000\n/** MTK system install often goes quiet for long periods */\nexport const MTK_INSTALL_TIMEOUT_MS = 300_000\n/** Whole multi-step session cap */\nexport const GLOBAL_OTA_TIMEOUT_MS = 20 * 60 * 1000\n/** BLE keepalive during OTA */\nexport const PING_INTERVAL_MS = 10_000\n/**\n * If we sent ota_query_status (e.g. on reconnect) and the glasses haven't\n * replied with an ota_status by then, fall back to ota_start. This recovers\n * from the case where the glasses process restarted between mount and\n * reconnect — the session is gone, ota_query_status returns nothing, and\n * the user would otherwise sit on the spinner forever.\n */\nexport const QUERY_REPLY_TIMEOUT_MS = 6000\n/** 15s lockout on the Continue button after a BES restart, to prevent an accidental tap. */\nexport const BES_CONTINUE_LOCKOUT_MS = 15_000\n\n// --- Legacy old-build (< MINIMUM_OTA_STATUS_BUILD) OTA policy (WP 8C) ---\n//\n// Ported verbatim from mobile/src/app/ota/progress-legacy.tsx, which padded EVERY\n// watchdog/timer by +20s for old ASG builds (\"Legacy OTA: +20s on every watchdog /\n// timer duration\"). Old builds respond slower on every path, so where the legacy\n// screen used a longer duration the coordinator applies the longer value whenever\n// the session is legacy-shaped (see isLegacyShapedOtaStatus / the coordinator's\n// session-shape check). Builds >= 37 keep the unpadded values above.\n\n/** The uniform pad progress-legacy.tsx added to every duration for old builds. */\nexport const LEGACY_EXTRA_TIMEOUT_MS = 20_000\nexport const LEGACY_RETRY_INTERVAL_MS = RETRY_INTERVAL_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_PROGRESS_TIMEOUT_MS = PROGRESS_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_DOWNLOAD_STUCK_TIMEOUT_MS = DOWNLOAD_STUCK_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_MTK_INSTALL_TIMEOUT_MS = MTK_INSTALL_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_GLOBAL_OTA_TIMEOUT_MS = GLOBAL_OTA_TIMEOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_PING_INTERVAL_MS = PING_INTERVAL_MS + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_BES_CONTINUE_LOCKOUT_MS = BES_CONTINUE_LOCKOUT_MS + LEGACY_EXTRA_TIMEOUT_MS\n/**\n * After a legacy apk `install FINISHED` observed in-flight, the legacy screen held the\n * completed state for 12s (+20s pad) so the ASG process restart settles (and fresh\n * version_info lands) before the user can continue.\n */\nexport const LEGACY_APK_COMPLETION_SETTLE_MS = 12_000 + LEGACY_EXTRA_TIMEOUT_MS\n/**\n * Legacy MTK install stall simulation (display-only): the MTK system install typically\n * stalls around 49-50%. After LEGACY_MTK_STALL_DETECT_MS without a new event in the\n * [45, 55) zone, the legacy screen simulated +1% every LEGACY_MTK_SIM_TICK_MS starting\n * at max(stall+1, 51) and capped at 60%, purely to keep the user informed.\n */\nexport const LEGACY_MTK_STALL_DETECT_MS = 20_000 + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_MTK_SIM_TICK_MS = 15_000 + LEGACY_EXTRA_TIMEOUT_MS\nexport const LEGACY_MTK_STALL_ZONE_MIN_PERCENT = 45\nexport const LEGACY_MTK_STALL_ZONE_MAX_PERCENT = 55\nexport const LEGACY_MTK_SIM_FLOOR_PERCENT = 51\nexport const LEGACY_MTK_SIM_CAP_PERCENT = 60\n\nexport type OtaProtocolProfile = \"legacy\" | \"unified\"\n\n/**\n * Legacy-shaped ota_status: old (< 37) ASG builds send `ota_progress`, which the SDK\n * (Android MentraLive.kt / iOS MentraLive.swift) maps to a unified ota_status with\n * sessionId \"\" and totalSteps 1, and FINISHED→\"complete\" regardless of phase. A real\n * (>= 37) session always carries a sessionId; an \"idle\" reply also has sessionId \"\" but\n * proves the glasses speak the unified protocol, so it is NOT legacy-shaped.\n */\nexport function isLegacyShapedOtaStatus(otaStatus: OtaStatus | null): boolean {\n  return !!otaStatus && otaStatus.sessionId === \"\" && otaStatus.status !== \"idle\"\n}\n\n/**\n * Is the current install session legacy-shaped? Event shape wins when events exist\n * (per the WP 8C rule: key off legacy-shaped inputs, not a build flag, where possible);\n * before any event arrives only the glasses build number can tell.\n */\nexport function isLegacyShapedOtaSession(\n  otaStatus: OtaStatus | null,\n  otaProgress: OtaProgress | null,\n  buildNumber: string | null | undefined,\n): boolean {\n  if (otaStatus) return isLegacyShapedOtaStatus(otaStatus)\n  if (otaProgress) return true\n  const build = Number.parseInt(buildNumber ?? \"\", 10)\n  return Number.isFinite(build) && build > 0 && build < MINIMUM_OTA_STATUS_BUILD\n}\n\n/**\n * Select the compatibility profile once at install-screen attach. The old split\n * routes made this decision from the pre-update build and kept it for the whole\n * mounted flow, even when an APK step restarted into a newer ASG build. Returning\n * null leaves the coordinator undecided until the first meaningful OTA event.\n */\nexport function selectOtaProtocolProfile(\n  otaStatus: OtaStatus | null,\n  otaProgress: OtaProgress | null,\n  buildNumber: string | null | undefined,\n): OtaProtocolProfile | null {\n  const build = Number.parseInt(buildNumber ?? \"\", 10)\n  if (Number.isFinite(build) && build > 0) {\n    return build < MINIMUM_OTA_STATUS_BUILD ? \"legacy\" : \"unified\"\n  }\n  if (otaStatus) return isLegacyShapedOtaStatus(otaStatus) ? \"legacy\" : \"unified\"\n  if (otaProgress) return \"legacy\"\n  return null\n}\n\nexport const OtaProgressMessages = {\n  stalledOrStuck: \"Update may have failed. Ensure glasses have internet access and try again.\",\n  globalTimeout: \"Update took too long. Please try again.\",\n  sendOtaStartFailed: \"Failed to communicate with glasses.\",\n  hotspotArtifactDownloadFailed: \"Could not download the update to your phone. Check phone internet and try again.\",\n  hotspotArtifactVerifyFailed: \"The update package could not be verified. Please try again later.\",\n  hotspotWifiPermissionDenied: \"Allow nearby devices access so the phone can connect to the glasses hotspot.\",\n  hotspotStartFailed: \"Could not start the glasses hotspot. Please try again.\",\n  hotspotJoinFailed: \"Could not connect the phone to the glasses hotspot. Please try again.\",\n  hotspotServerFailed: \"Could not make the update available to the glasses. Please try again.\",\n} as const\n"]}

package/build/services/otaManifestUrl.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveOtaManifestUrl(glassesUrl?: string | null, glassesBuildNumber?: string | null): string;
+//# sourceMappingURL=otaManifestUrl.d.ts.map

package/build/services/otaManifestUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otaManifestUrl.d.ts","sourceRoot":"","sources":["../../src/services/otaManifestUrl.ts"],"names":[],"mappings":"AA6BA,wBAAgB,qBAAqB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAuB5G"}

package/build/services/{asgOtaVersionUrl.js → otaManifestUrl.js}

@@ -1,5 +1,11 @@
+import { sdkPinnedOtaManifestUrl } from "@mentra/bluetooth-sdk/internal";
 import { SETTINGS, useSettingsStore } from "../stores/settings";
-const OTA_VERSION_URL_PROD = "https://ota.mentraglass.com/prod_live_version.json";
+// Legacy production manifest — pre-39 glasses install from this (they ignore ota_start's URL).
+const OTA_VERSION_URL_LEGACY_PROD = "https://ota.mentraglass.com/prod_live_version.json";
+// Modern production fleet manifest (v2). Only a last-resort fallback when the SDK-derived pin
+// URL is somehow unavailable; modern glasses honor ota_start's URL, so this must be the v2
+// artifact, not the legacy v1 rescue manifest.
+const OTA_VERSION_URL_PROD = "https://ota.mentraglass.com/prod_live_version_v2.json";
 function isLegacyAsgOtaStartBuild(glassesBuildNumber) {
     const buildNumber = Number.parseInt(glassesBuildNumber ?? "", 10);
     // ASG builds before 39 ignore ota_start.ota_version_url, so compare against
@@ -16,12 +22,12 @@ function getOtaVersionUrlDevOverride() {
     const trimmed = typeof value === "string" ? value.trim() : "";
     return trimmed || null;
 }
-export function getAsgOtaVersionUrl(glassesUrl, glassesBuildNumber) {
+export function resolveOtaManifestUrl(glassesUrl, glassesBuildNumber) {
     const deviceUrl = glassesUrl?.trim();
     if (isLegacyAsgOtaStartBuild(glassesBuildNumber)) {
         // Legacy glasses ignore ota_start.ota_version_url and install from their
         // compiled default, so the developer override does not apply to them either.
-        return deviceUrl || OTA_VERSION_URL_PROD;
+        return deviceUrl || OTA_VERSION_URL_LEGACY_PROD;
     }
     const devOverrideUrl = getOtaVersionUrlDevOverride();
     if (devOverrideUrl) {
@@ -31,6 +37,10 @@ export function getAsgOtaVersionUrl(glassesUrl, glassesBuildNumber) {
     if (envUrl) {
         return envUrl;
     }
-    return deviceUrl || OTA_VERSION_URL_PROD;
+    // The phone owns manifest selection: modern glasses are driven with the manifest pinned to
+    // this app's Bluetooth SDK version. Modern ASG builds report no manifest URL of their own;
+    // a glasses-reported URL (older modern builds advertising their baked fleet default) is only
+    // a last resort when the SDK version is somehow unavailable.
+    return sdkPinnedOtaManifestUrl() || deviceUrl || OTA_VERSION_URL_PROD;
 }
-//# sourceMappingURL=asgOtaVersionUrl.js.map
+//# sourceMappingURL=otaManifestUrl.js.map

package/build/services/otaManifestUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otaManifestUrl.js","sourceRoot":"","sources":["../../src/services/otaManifestUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAC,MAAM,gCAAgC,CAAA;AAEtE,OAAO,EAAC,QAAQ,EAAE,gBAAgB,EAAC,MAAM,oBAAoB,CAAA;AAE7D,+FAA+F;AAC/F,MAAM,2BAA2B,GAAG,oDAAoD,CAAA;AACxF,8FAA8F;AAC9F,2FAA2F;AAC3F,+CAA+C;AAC/C,MAAM,oBAAoB,GAAG,uDAAuD,CAAA;AAEpF,SAAS,wBAAwB,CAAC,kBAAkC;IAClE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;IACjE,4EAA4E;IAC5E,kCAAkC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,2BAA2B;IAClC,sEAAsE;IACtE,4DAA4D;IAC5D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IAClF,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,OAAO,OAAO,IAAI,IAAI,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAA0B,EAAE,kBAAkC;IAClG,MAAM,SAAS,GAAG,UAAU,EAAE,IAAI,EAAE,CAAA;IACpC,IAAI,wBAAwB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACjD,yEAAyE;QACzE,6EAA6E;QAC7E,OAAO,SAAS,IAAI,2BAA2B,CAAA;IACjD,CAAC;IAED,MAAM,cAAc,GAAG,2BAA2B,EAAE,CAAA;IACpD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,EAAE,CAAA;IAClE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAA;IACf,CAAC;IAED,2FAA2F;IAC3F,2FAA2F;IAC3F,6FAA6F;IAC7F,6DAA6D;IAC7D,OAAO,uBAAuB,EAAE,IAAI,SAAS,IAAI,oBAAoB,CAAA;AACvE,CAAC","sourcesContent":["import {sdkPinnedOtaManifestUrl} from \"@mentra/bluetooth-sdk/internal\"\n\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\n\n// Legacy production manifest — pre-39 glasses install from this (they ignore ota_start's URL).\nconst OTA_VERSION_URL_LEGACY_PROD = \"https://ota.mentraglass.com/prod_live_version.json\"\n// Modern production fleet manifest (v2). Only a last-resort fallback when the SDK-derived pin\n// URL is somehow unavailable; modern glasses honor ota_start's URL, so this must be the v2\n// artifact, not the legacy v1 rescue manifest.\nconst OTA_VERSION_URL_PROD = \"https://ota.mentraglass.com/prod_live_version_v2.json\"\n\nfunction isLegacyAsgOtaStartBuild(glassesBuildNumber?: string | null): boolean {\n  const buildNumber = Number.parseInt(glassesBuildNumber ?? \"\", 10)\n  // ASG builds before 39 ignore ota_start.ota_version_url, so compare against\n  // the URL they will actually use.\n  return Number.isFinite(buildNumber) && buildNumber < 39\n}\n\nfunction getOtaVersionUrlDevOverride(): string | null {\n  // Super mode only: a wrong OTA manifest can brick glasses, so a saved\n  // override is inert unless super mode is currently enabled.\n  if (!useSettingsStore.getState().getSetting(SETTINGS.super_mode.key)) {\n    return null\n  }\n  const value = useSettingsStore.getState().getSetting(SETTINGS.ota_version_url.key)\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\"\n  return trimmed || null\n}\n\nexport function resolveOtaManifestUrl(glassesUrl?: string | null, glassesBuildNumber?: string | null): string {\n  const deviceUrl = glassesUrl?.trim()\n  if (isLegacyAsgOtaStartBuild(glassesBuildNumber)) {\n    // Legacy glasses ignore ota_start.ota_version_url and install from their\n    // compiled default, so the developer override does not apply to them either.\n    return deviceUrl || OTA_VERSION_URL_LEGACY_PROD\n  }\n\n  const devOverrideUrl = getOtaVersionUrlDevOverride()\n  if (devOverrideUrl) {\n    return devOverrideUrl\n  }\n\n  const envUrl = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim()\n  if (envUrl) {\n    return envUrl\n  }\n\n  // The phone owns manifest selection: modern glasses are driven with the manifest pinned to\n  // this app's Bluetooth SDK version. Modern ASG builds report no manifest URL of their own;\n  // a glasses-reported URL (older modern builds advertising their baked fleet default) is only\n  // a last resort when the SDK version is somehow unavailable.\n  return sdkPinnedOtaManifestUrl() || deviceUrl || OTA_VERSION_URL_PROD\n}\n"]}

package/build/services/slimStreamStatus.d.ts

@@ -1,7 +1,18 @@
 import type { StreamStatusEvent } from "@mentra/bluetooth-sdk/internal";
+/**
+ * 1Hz encoder FPS/bitrate telemetry on `stream_status.stats`.
+ * Lifecycle status (started/stopped/error) is unaffected.
+ * Keep false in production; flip locally to debug the Mentra Call FPS ladder.
+ *
+ * Compatibility kill switch: old glasses can still emit stats. Copy onto a new object;
+ * never mutate the incoming event. Manual acceptance with every layer false: join
+ * waterfall yes; BLE stream_status.stats / STREAM_QUALITY / encoder-stats / watch-stats no.
+ */
+export declare const ENABLE_PIPELINE_FPS_TELEMETRY = false;
 /** Fields forwarded to cloud / miniapps after the first resolvedConfig ack. */
 export declare function slimStreamStatusEvent(event: StreamStatusEvent, options?: {
     includeResolvedConfig?: boolean;
+    enableFpsTelemetry?: boolean;
 }): Record<string, unknown>;
 export declare function streamStatusSignature(payload: Record<string, unknown>): string;
 //# sourceMappingURL=slimStreamStatus.d.ts.map

package/build/services/slimStreamStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slimStreamStatus.d.ts","sourceRoot":"","sources":["../../src/services/slimStreamStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA;AAErE,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAM,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE9E"}
+{"version":3,"file":"slimStreamStatus.d.ts","sourceRoot":"","sources":["../../src/services/slimStreamStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAA;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,QAAQ,CAAA;AAElD,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAM,GAC5E,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE9E"}

package/build/services/slimStreamStatus.js

@@ -1,5 +1,16 @@
+/**
+ * 1Hz encoder FPS/bitrate telemetry on `stream_status.stats`.
+ * Lifecycle status (started/stopped/error) is unaffected.
+ * Keep false in production; flip locally to debug the Mentra Call FPS ladder.
+ *
+ * Compatibility kill switch: old glasses can still emit stats. Copy onto a new object;
+ * never mutate the incoming event. Manual acceptance with every layer false: join
+ * waterfall yes; BLE stream_status.stats / STREAM_QUALITY / encoder-stats / watch-stats no.
+ */
+export const ENABLE_PIPELINE_FPS_TELEMETRY = false;
 /** Fields forwarded to cloud / miniapps after the first resolvedConfig ack. */
 export function slimStreamStatusEvent(event, options = {}) {
+    const enableFpsTelemetry = options.enableFpsTelemetry ?? ENABLE_PIPELINE_FPS_TELEMETRY;
     const slim = {
         type: "stream_status",
         kind: event.kind,
@@ -13,10 +24,9 @@ export function slimStreamStatusEvent(event, options = {}) {
     if (options.includeResolvedConfig && event.resolvedConfig) {
         slim.resolvedConfig = event.resolvedConfig;
     }
-    // Live telemetry passes straight through — unlike resolvedConfig it changes
-    // per event, and the signature dedupe upstream only suppresses identical
-    // payloads.
-    if (event.stats)
+    // Compatibility kill switch: old glasses may still emit 1Hz stats. Copy onto a
+    // new object; never mutate `event` — other consumers may still need the original.
+    if (enableFpsTelemetry && event.stats)
         slim.stats = event.stats;
     return slim;
 }

package/build/services/slimStreamStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"slimStreamStatus.js","sourceRoot":"","sources":["../../src/services/slimStreamStatus.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CACnC,KAAwB,EACxB,UAA6C,EAAE;IAE/C,MAAM,IAAI,GAA4B;QACpC,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAA;IACD,IAAI,KAAK,CAAC,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAClD,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAA;IAC1B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;IACtE,IAAI,OAAO,CAAC,qBAAqB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;IAC5C,CAAC;IACD,4EAA4E;IAC5E,yEAAyE;IACzE,YAAY;IACZ,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IACzC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgC;IACpE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC","sourcesContent":["import type {StreamStatusEvent} from \"@mentra/bluetooth-sdk/internal\"\r\n\r\n/** Fields forwarded to cloud / miniapps after the first resolvedConfig ack. */\r\nexport function slimStreamStatusEvent(\r\n  event: StreamStatusEvent,\r\n  options: {includeResolvedConfig?: boolean} = {},\r\n): Record<string, unknown> {\r\n  const slim: Record<string, unknown> = {\r\n    type: \"stream_status\",\r\n    kind: event.kind,\r\n    status: event.status,\r\n  }\r\n  if (event.streamId) slim.streamId = event.streamId\r\n  const ts = event.timestamp\r\n  if (typeof ts === \"number\" && Number.isFinite(ts)) slim.timestamp = ts\r\n  if (options.includeResolvedConfig && event.resolvedConfig) {\r\n    slim.resolvedConfig = event.resolvedConfig\r\n  }\r\n  // Live telemetry passes straight through — unlike resolvedConfig it changes\r\n  // per event, and the signature dedupe upstream only suppresses identical\r\n  // payloads.\r\n  if (event.stats) slim.stats = event.stats\r\n  return slim\r\n}\r\n\r\nexport function streamStatusSignature(payload: Record<string, unknown>): string {\r\n  return JSON.stringify(payload)\r\n}\r\n"]}
+{"version":3,"file":"slimStreamStatus.js","sourceRoot":"","sources":["../../src/services/slimStreamStatus.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAA;AAElD,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CACnC,KAAwB,EACxB,UAA2E,EAAE;IAE7E,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,6BAA6B,CAAA;IACtF,MAAM,IAAI,GAA4B;QACpC,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAA;IACD,IAAI,KAAK,CAAC,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAClD,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAA;IAC1B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;IACtE,IAAI,OAAO,CAAC,qBAAqB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;IAC5C,CAAC;IACD,+EAA+E;IAC/E,kFAAkF;IAClF,IAAI,kBAAkB,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IAC/D,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgC;IACpE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC","sourcesContent":["import type {StreamStatusEvent} from \"@mentra/bluetooth-sdk/internal\"\r\n\r\n/**\r\n * 1Hz encoder FPS/bitrate telemetry on `stream_status.stats`.\r\n * Lifecycle status (started/stopped/error) is unaffected.\r\n * Keep false in production; flip locally to debug the Mentra Call FPS ladder.\r\n *\r\n * Compatibility kill switch: old glasses can still emit stats. Copy onto a new object;\r\n * never mutate the incoming event. Manual acceptance with every layer false: join\r\n * waterfall yes; BLE stream_status.stats / STREAM_QUALITY / encoder-stats / watch-stats no.\r\n */\r\nexport const ENABLE_PIPELINE_FPS_TELEMETRY = false\r\n\r\n/** Fields forwarded to cloud / miniapps after the first resolvedConfig ack. */\r\nexport function slimStreamStatusEvent(\r\n  event: StreamStatusEvent,\r\n  options: {includeResolvedConfig?: boolean; enableFpsTelemetry?: boolean} = {},\r\n): Record<string, unknown> {\r\n  const enableFpsTelemetry = options.enableFpsTelemetry ?? ENABLE_PIPELINE_FPS_TELEMETRY\r\n  const slim: Record<string, unknown> = {\r\n    type: \"stream_status\",\r\n    kind: event.kind,\r\n    status: event.status,\r\n  }\r\n  if (event.streamId) slim.streamId = event.streamId\r\n  const ts = event.timestamp\r\n  if (typeof ts === \"number\" && Number.isFinite(ts)) slim.timestamp = ts\r\n  if (options.includeResolvedConfig && event.resolvedConfig) {\r\n    slim.resolvedConfig = event.resolvedConfig\r\n  }\r\n  // Compatibility kill switch: old glasses may still emit 1Hz stats. Copy onto a\r\n  // new object; never mutate `event` — other consumers may still need the original.\r\n  if (enableFpsTelemetry && event.stats) slim.stats = event.stats\r\n  return slim\r\n}\r\n\r\nexport function streamStatusSignature(payload: Record<string, unknown>): string {\r\n  return JSON.stringify(payload)\r\n}\r\n"]}

package/build/stores/apps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/stores/apps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAC,WAAW,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAA;AAG9D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAA;AAiB9C,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAA;IAChD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAA;IAC/C;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;CAChE;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAE/D;AAMD,UAAU,cAAc;IACtB,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,oHAAoH;IACpH,KAAK,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAChE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,OAAO,EAAE,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAC,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACrF,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC9E,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/D,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAA;IACjD,oFAAoF;IACpF,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,IAAI,CAAA;CACrC;AAED,eAAO,MAAM,YAAY,EAAE,SAe1B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAG7C,eAAO,MAAM,aAAa,GAAI,UAAU,QAAQ,KAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAEpE,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,MAAM,CAAC,QAAQ,EAAE,KAAK,CAErD,CAAA;AAeD,eAAO,MAAM,6BAA6B,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,KAAG,MAO1E,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,IAEtD,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,KAAG,MAIrD,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,CAAC,SAAS;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,EAAE,MAAM,CAAC,EAAE,KAAG,OAAO,CAAC,CAAC,EAAE,CAGpG,CAAA;AAgHD,eAAO,MAAM,iBAAiB,6EA2P3B,CAAA;AAsCH,eAAO,MAAM,OAAO,mBAAiD,CAAA;AACrE,eAAO,MAAM,QAAQ,cA/dN,SAAS,SAAS,YAAY,KAAK,OAAO,CAAC,OAAO,CA+dM,CAAA;AACvE,eAAO,MAAM,OAAO,sBA/dE,MAAM,KAAK,OAAO,CAAC,IAAI,CA+dwB,CAAA;AACrE,eAAO,MAAM,gBAAgB,sBA/dE,MAAM,KAAK,OAAO,CAAC,IAAI,CA+diC,CAAA;AACvF,eAAO,MAAM,kBAAkB,cA/dN,IA+dkE,CAAA;AAC3F,eAAO,MAAM,UAAU,cAreN,OAAO,CAAC,IAAI,CAqe8C,CAAA;AAC3E,eAAO,MAAM,UAAU,cAheN,WAAW,CAAC,IAAI,EAAE,KAAK,CAgemC,CAAA;AAC3E,eAAO,MAAM,UAAU,cAheN,MAAM,SAAS;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAgeX,CAAA;AAC3E,eAAO,MAAM,YAAY,sBAheE,MAAM,YAAY,MAAM,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAgeA,CAAA;AAE/E,eAAO,MAAM,aAAa,mBAGzB,CAAA;AAED,eAAO,MAAM,uBAAuB,mBAGnC,CAAA;AAED,eAAO,MAAM,iBAAiB;;;CAS7B,CAAA;AAED,eAAO,MAAM,sBAAsB,wBAGlC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,wBAG5B,CAAA;AAED,eAAO,MAAM,4BAA4B,cAGxC,CAAA;AAED,eAAO,MAAM,gBAAgB,mBAG5B,CAAA"}
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../src/stores/apps.ts"],"names":[],"mappings":"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"}

package/build/stores/apps.js

@@ -17,6 +17,7 @@ import { getModelCapabilities } from "../types/hardware";
 import { HardwareCompatibility } from "../utils/hardware/hardware";
 import { storage } from "../utils/storage/storage";
 import appRegistry from "../services/AppRegistry";
+import localDisplayManager from "../services/LocalDisplayManager";
 import { islandNotifications } from "../services/NotificationsEmitter";
 import sttModelManager from "../services/STTModelManager";
 import { miniappLauncher } from "../services/MiniappLauncher";
@@ -433,6 +434,16 @@ miniappRunningRegistry.subscribe(() => {
         useAppStatusStore.setState({ apps: updated });
     }
 });
+// The display-manager's core (foreground) slot is DERIVED state: always the
+// currently-running standard app, no matter HOW it came to run — user tap
+// (start()), boot restore (autostartLocalMiniapps → registry projection
+// above), crash-respawn, or interop. One reconciler instead of per-path call
+// sites, so no launch/stop path can forget to claim or release the slot.
+// onCoreAppChange is idempotent, so firing on every store write is free.
+useAppStatusStore.subscribe((state) => {
+    const core = state.apps.find((a) => a.running && (a.type === "standard" || !a.type));
+    localDisplayManager.onCoreAppChange(core?.packageName ?? null);
+});
 // AppRegistry change events trigger a store refresh.
 appRegistry.subscribe(() => {
     void useAppStatusStore.getState().refresh();