@mentra/engine 3.2.0-dev.137 → 3.2.0-dev.154

package/build/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,SAAS,EAAkD,aAAa,EAAC,MAAM,qBAAqB,CAAA;AAuC5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IA8E7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BrC,mFAAmF;;;;;;;;IAEnF,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;gBA/FjF,CAAL;mBAAiB,CAAC;;;gBAImB,CAAC;mBAAiB,CAAC;;;;;;;;;;;;;;;;IA6FvD,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;IAE9E,qFAAqF;;;;;;;;;;;;;;CAGtF,CAAA"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,SAAS,EAIT,aAAa,EACd,MAAM,qBAAqB,CAAA;AAuC5B,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IAkF7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BrC,mFAAmF;;;;;;;;IAEnF,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;gBApGjF,CAAL;mBAAiB,CAAC;;;gBAKX,CAAC;mBAAiB,CAAC;;;;;;;;;;;;;;;;IAiGzB,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;IAE9E,qFAAqF;;;;;;;;;;;;;;CAGtF,CAAA"}

package/build/engine.js

@@ -8,7 +8,7 @@
  * remain in a private MentraOS host package; they shrink as screens move onto
  * `engine.*`.
  */
-import { configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams } from "./runtime/bootstrap";
+import { configure, getConfigValues, start as bootstrapStart, stop as bootstrapStop, updateUiSeams, } from "./runtime/bootstrap";
 import { cloudClientService } from "./services/CloudClientService";
 import { hydrateDeviceStore, demoteOrphanedDefaultWearable } from "./services/DeviceStoreHydration";
 import { startGlassesSettingsSync, stopGlassesSettingsSync } from "./services/GlassesSettingsSync";
@@ -92,14 +92,18 @@ export const engine = {
         startOtaService();
         // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription
         // works for any host (not just the Mentra app's host-side MantleManager fork).
-        startAudioCloudUplink();
-        try {
-            await cloudClientService.syncCoreTokenToBluetooth();
+        if (getConfigValues().runtimeRealtimeSession !== false && getConfigValues().features?.cloudSpeech !== false) {
+            startAudioCloudUplink();
         }
-        catch (error) {
-            console.warn("engine.start: initial Cloud V2 core token sync failed:", error instanceof Error ? error.message : error);
+        if (cloudClientService.hasCore()) {
+            try {
+                await cloudClientService.syncCoreTokenToBluetooth();
+            }
+            catch (error) {
+                console.warn("engine.start: initial Cloud V2 core token sync failed:", error instanceof Error ? error.message : error);
+            }
+            startSupportProfileSync();
         }
-        startSupportProfileSync();
         // Push device-setting changes to the glasses for ANY host, so
         // engine.glasses.settings.set() reaches the device (not just the Mentra app).
         startGlassesSettingsSync();
@@ -107,10 +111,12 @@ export const engine = {
         startPhoneNotificationsSync();
         // Android internal/e2e: laptop captions tester can broadcast a failure intent;
         // engine owns turning that into a Cloud V2 report.
-        startCaptionsTesterReportService();
+        if (cloudClientService.hasCore())
+            startCaptionsTesterReportService();
         // MentraJS crashloop-disabled is runtime state; engine owns filing the
         // automatic report while hosts only render alert/telemetry side effects.
-        startMentraJSCrashloopReportService();
+        if (cloudClientService.hasCore())
+            startMentraJSCrashloopReportService();
         // Bring up the local-miniapp engine so a bare OEM can run MentraJS miniapps:
         // the LocalMiniappRuntime (registry + WebView bridge), the MentraJS router
         // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor

package/build/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `engine` — the namespaced OEM-facing engine API (the \"(A) host API\" from the\n * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a\n * typed facade over the runtime. (Exported from the `@mentra/engine` module, whose\n * name stays `engine` in code; the public API surface is `engine`.)\n *\n * It grows one facade at a time. The migration-era flat store/service exports\n * remain in a private MentraOS host package; they shrink as screens move onto\n * `engine.*`.\n */\nimport {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from \"./runtime/bootstrap\"\nimport {cloudClientService} from \"./services/CloudClientService\"\nimport {hydrateDeviceStore, demoteOrphanedDefaultWearable} from \"./services/DeviceStoreHydration\"\nimport {startGlassesSettingsSync, stopGlassesSettingsSync} from \"./services/GlassesSettingsSync\"\nimport {\n  startGlassesStatusProjection,\n  stopGlassesStatusProjection,\n  toMiniappConnectionData,\n} from \"./services/GlassesStatusProjection\"\nimport {startOtaService, stopOtaService} from \"./services/OtaService\"\nimport {startAudioCloudUplink, stopAudioCloudUplink} from \"./services/AudioCloudUplink\"\nimport {startSupportProfileSync, stopSupportProfileSync} from \"./services/SupportProfileSync\"\nimport {startDeviceEventRouter, stopDeviceEventRouter} from \"./services/DeviceEventRouter\"\nimport {startPhoneNotificationsSync, stopPhoneNotificationsSync} from \"./services/PhoneNotificationsSync\"\nimport {startCaptionsTesterReportService, stopCaptionsTesterReportService} from \"./services/CaptionsTesterReportService\"\nimport {\n  startMentraJSCrashloopReportService,\n  stopMentraJSCrashloopReportService,\n} from \"./services/MentraJSCrashloopReportService\"\nimport {ensureMiniappEngine, stopMiniappEngine} from \"./services/MiniappEngine\"\nimport localMiniappRuntime from \"./services/LocalMiniappRuntime\"\nimport displayProcessor from \"./services/DisplayProcessor\"\nimport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nimport {glasses} from \"./facades/glasses\"\nimport {display} from \"./facades/display\"\nimport {speech} from \"./facades/speech\"\nimport {session} from \"./facades/session\"\nimport {settings} from \"./facades/settings\"\nimport {dev} from \"./facades/dev\"\nimport {reports} from \"./facades/reports\"\nimport {ota} from \"./facades/ota\"\nimport {gallery} from \"./facades/gallery\"\nimport {miniapps} from \"./facades/miniapps\"\nimport {pairing} from \"./facades/pairing\"\nimport {phoneNotifications} from \"./facades/phoneNotifications\"\nimport {permissions} from \"./facades/permissions\"\nimport {notifications} from \"./facades/notifications\"\nimport {logBuffer} from \"./utils/devLogging\"\n\nexport const engine = {\n  /** Front door — hand engine auth + config, then start/stop the runtime. */\n  configure,\n  /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */\n  updateUiSeams,\n  /** Start the runtime: mark started + construct/connect the cloud client + begin\n   * syncing device settings to the glasses. */\n  async start() {\n    // Reports attach recent phone logs, so engine owns console interception for\n    // OEM hosts too. Idempotent; the Mentra host may start it earlier.\n    logBuffer.startConsoleInterception()\n    await bootstrapStart()\n    // Construct + connect the cloud client so the documented configure()+start()\n    // lifecycle yields a live engine.session for OEMs. Idempotent for repeated\n    // start() calls.\n    cloudClientService.init()\n    // Project native device status -> the engine stores (the inbound feed the rest\n    // of the runtime reads). Established first so the stores are live before the\n    // syncs below react to them.\n    startGlassesStatusProjection((changed) => {\n      const connection = toMiniappConnectionData(changed)\n      if (!connection) return\n      localMiniappRuntime.forwardEvent(\"glasses_connection_state\", connection)\n    })\n    // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,\n    // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->\n    // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the\n    // Mentra app's MantleManager.\n    startDeviceEventRouter()\n    // Hydration contract: the native DeviceStore is in-memory and starts empty\n    // every launch; seed it from the persisted settings BEFORE start() resolves\n    // so every post-start getDefaultDevice() read is a trustworthy two-state\n    // answer (no false \"absent\" for genuinely-paired users at cold start).\n    // Ordered before startGlassesSettingsSync so the settings load can't\n    // double-push through the change subscription. A failed hydration must not\n    // brick the runtime: start() continues, and the guards that consume\n    // hasDefaultDevice() see the rejection and fail open.\n    try {\n      await hydrateDeviceStore()\n      // Boot repair: a persisted default_wearable without a native default\n      // device (identity abandoned mid-pairing, or resurrected from the server\n      // before identity stopped syncing) demotes to pending_wearable so hosts\n      // render finish-pairing instead of a connect that would throw.\n      await demoteOrphanedDefaultWearable()\n    } catch (error) {\n      console.warn(\"engine.start: device-store hydration failed:\", error instanceof Error ? error.message : error)\n    }\n    // Project the glasses' OTA events into the store for the engine.ota read surface.\n    startOtaService()\n    // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription\n    // works for any host (not just the Mentra app's host-side MantleManager fork).\n    startAudioCloudUplink()\n    try {\n      await cloudClientService.syncCoreTokenToBluetooth()\n    } catch (error) {\n      console.warn(\n        \"engine.start: initial Cloud V2 core token sync failed:\",\n        error instanceof Error ? error.message : error,\n      )\n    }\n    startSupportProfileSync()\n    // Push device-setting changes to the glasses for ANY host, so\n    // engine.glasses.settings.set() reaches the device (not just the Mentra app).\n    startGlassesSettingsSync()\n    // Same for phone-notification config -> the native listener (Android).\n    startPhoneNotificationsSync()\n    // Android internal/e2e: laptop captions tester can broadcast a failure intent;\n    // engine owns turning that into a Cloud V2 report.\n    startCaptionsTesterReportService()\n    // MentraJS crashloop-disabled is runtime state; engine owns filing the\n    // automatic report while hosts only render alert/telemetry side effects.\n    startMentraJSCrashloopReportService()\n    // Bring up the local-miniapp engine so a bare OEM can run MentraJS miniapps:\n    // the LocalMiniappRuntime (registry + WebView bridge), the MentraJS router\n    // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor\n    // (layout arbitration over the engine stores), and the gallery-sync service.\n    // All idempotent — when the Mentra app's host bootstrap also calls these, the\n    // second call is a no-op. Host-only crashloop telemetry is attached\n    // separately by the Mentra app.\n    localMiniappRuntime.initialize()\n    ensureMiniappEngine()\n    displayProcessor.attachToRuntime()\n    gallerySyncService.initialize()\n  },\n  /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.\n   * Each step is guarded so one failing teardown can't skip the rest and leak\n   * the remaining runtime services. */\n  async stop() {\n    const safely = async (label: string, step: () => unknown): Promise<void> => {\n      try {\n        await step()\n      } catch (error) {\n        console.warn(`engine.stop: ${label} failed:`, error)\n      }\n    }\n    await safely(\"glasses settings sync\", stopGlassesSettingsSync)\n    await safely(\"glasses status projection\", stopGlassesStatusProjection)\n    await safely(\"device event router\", stopDeviceEventRouter)\n    await safely(\"ota service\", stopOtaService)\n    await safely(\"audio cloud uplink\", stopAudioCloudUplink)\n    await safely(\"support profile sync\", stopSupportProfileSync)\n    await safely(\"phone notifications sync\", stopPhoneNotificationsSync)\n    await safely(\"captions tester report service\", stopCaptionsTesterReportService)\n    await safely(\"mentrajs crashloop report service\", stopMentraJSCrashloopReportService)\n    await safely(\"miniapp engine\", stopMiniappEngine)\n    await safely(\"local miniapp runtime\", () => localMiniappRuntime.cleanup())\n    await safely(\"display processor\", () => displayProcessor.detachFromRuntime())\n    await safely(\"gallery sync service\", () => gallerySyncService.cleanup())\n    await safely(\"cloud client\", () => cloudClientService.stop())\n    await safely(\"bootstrap\", bootstrapStop)\n  },\n  glasses,\n  speech,\n  /** Cloud (cloud-v2) live-session status + account ops — engine owns the client. */\n  session,\n  /** Typed keyed user settings over the engine-owned settings store. */\n  settings,\n  /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */\n  dev,\n  /** Bug-report, automatic runtime report, and feedback submission. */\n  reports,\n  /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */\n  ota,\n  /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */\n  gallery,\n  /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */\n  miniapps,\n  /** First-time glasses discovery + pairing. */\n  pairing,\n  /** Phone→glasses notification forwarding (Android). */\n  phoneNotifications,\n  /** OS permissions (check/request/openSettings + per-miniapp requirements). */\n  permissions,\n  /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */\n  notifications,\n  display,\n}\n"]}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `engine` — the namespaced OEM-facing engine API (the \"(A) host API\" from the\n * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a\n * typed facade over the runtime. (Exported from the `@mentra/engine` module, whose\n * name stays `engine` in code; the public API surface is `engine`.)\n *\n * It grows one facade at a time. The migration-era flat store/service exports\n * remain in a private MentraOS host package; they shrink as screens move onto\n * `engine.*`.\n */\nimport {\n  configure,\n  getConfigValues,\n  start as bootstrapStart,\n  stop as bootstrapStop,\n  updateUiSeams,\n} from \"./runtime/bootstrap\"\nimport {cloudClientService} from \"./services/CloudClientService\"\nimport {hydrateDeviceStore, demoteOrphanedDefaultWearable} from \"./services/DeviceStoreHydration\"\nimport {startGlassesSettingsSync, stopGlassesSettingsSync} from \"./services/GlassesSettingsSync\"\nimport {\n  startGlassesStatusProjection,\n  stopGlassesStatusProjection,\n  toMiniappConnectionData,\n} from \"./services/GlassesStatusProjection\"\nimport {startOtaService, stopOtaService} from \"./services/OtaService\"\nimport {startAudioCloudUplink, stopAudioCloudUplink} from \"./services/AudioCloudUplink\"\nimport {startSupportProfileSync, stopSupportProfileSync} from \"./services/SupportProfileSync\"\nimport {startDeviceEventRouter, stopDeviceEventRouter} from \"./services/DeviceEventRouter\"\nimport {startPhoneNotificationsSync, stopPhoneNotificationsSync} from \"./services/PhoneNotificationsSync\"\nimport {startCaptionsTesterReportService, stopCaptionsTesterReportService} from \"./services/CaptionsTesterReportService\"\nimport {\n  startMentraJSCrashloopReportService,\n  stopMentraJSCrashloopReportService,\n} from \"./services/MentraJSCrashloopReportService\"\nimport {ensureMiniappEngine, stopMiniappEngine} from \"./services/MiniappEngine\"\nimport localMiniappRuntime from \"./services/LocalMiniappRuntime\"\nimport displayProcessor from \"./services/DisplayProcessor\"\nimport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nimport {glasses} from \"./facades/glasses\"\nimport {display} from \"./facades/display\"\nimport {speech} from \"./facades/speech\"\nimport {session} from \"./facades/session\"\nimport {settings} from \"./facades/settings\"\nimport {dev} from \"./facades/dev\"\nimport {reports} from \"./facades/reports\"\nimport {ota} from \"./facades/ota\"\nimport {gallery} from \"./facades/gallery\"\nimport {miniapps} from \"./facades/miniapps\"\nimport {pairing} from \"./facades/pairing\"\nimport {phoneNotifications} from \"./facades/phoneNotifications\"\nimport {permissions} from \"./facades/permissions\"\nimport {notifications} from \"./facades/notifications\"\nimport {logBuffer} from \"./utils/devLogging\"\n\nexport const engine = {\n  /** Front door — hand engine auth + config, then start/stop the runtime. */\n  configure,\n  /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */\n  updateUiSeams,\n  /** Start the runtime: mark started + construct/connect the cloud client + begin\n   * syncing device settings to the glasses. */\n  async start() {\n    // Reports attach recent phone logs, so engine owns console interception for\n    // OEM hosts too. Idempotent; the Mentra host may start it earlier.\n    logBuffer.startConsoleInterception()\n    await bootstrapStart()\n    // Construct + connect the cloud client so the documented configure()+start()\n    // lifecycle yields a live engine.session for OEMs. Idempotent for repeated\n    // start() calls.\n    cloudClientService.init()\n    // Project native device status -> the engine stores (the inbound feed the rest\n    // of the runtime reads). Established first so the stores are live before the\n    // syncs below react to them.\n    startGlassesStatusProjection((changed) => {\n      const connection = toMiniappConnectionData(changed)\n      if (!connection) return\n      localMiniappRuntime.forwardEvent(\"glasses_connection_state\", connection)\n    })\n    // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,\n    // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->\n    // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the\n    // Mentra app's MantleManager.\n    startDeviceEventRouter()\n    // Hydration contract: the native DeviceStore is in-memory and starts empty\n    // every launch; seed it from the persisted settings BEFORE start() resolves\n    // so every post-start getDefaultDevice() read is a trustworthy two-state\n    // answer (no false \"absent\" for genuinely-paired users at cold start).\n    // Ordered before startGlassesSettingsSync so the settings load can't\n    // double-push through the change subscription. A failed hydration must not\n    // brick the runtime: start() continues, and the guards that consume\n    // hasDefaultDevice() see the rejection and fail open.\n    try {\n      await hydrateDeviceStore()\n      // Boot repair: a persisted default_wearable without a native default\n      // device (identity abandoned mid-pairing, or resurrected from the server\n      // before identity stopped syncing) demotes to pending_wearable so hosts\n      // render finish-pairing instead of a connect that would throw.\n      await demoteOrphanedDefaultWearable()\n    } catch (error) {\n      console.warn(\"engine.start: device-store hydration failed:\", error instanceof Error ? error.message : error)\n    }\n    // Project the glasses' OTA events into the store for the engine.ota read surface.\n    startOtaService()\n    // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription\n    // works for any host (not just the Mentra app's host-side MantleManager fork).\n    if (getConfigValues().runtimeRealtimeSession !== false && getConfigValues().features?.cloudSpeech !== false) {\n      startAudioCloudUplink()\n    }\n    if (cloudClientService.hasCore()) {\n      try {\n        await cloudClientService.syncCoreTokenToBluetooth()\n      } catch (error) {\n        console.warn(\n          \"engine.start: initial Cloud V2 core token sync failed:\",\n          error instanceof Error ? error.message : error,\n        )\n      }\n      startSupportProfileSync()\n    }\n    // Push device-setting changes to the glasses for ANY host, so\n    // engine.glasses.settings.set() reaches the device (not just the Mentra app).\n    startGlassesSettingsSync()\n    // Same for phone-notification config -> the native listener (Android).\n    startPhoneNotificationsSync()\n    // Android internal/e2e: laptop captions tester can broadcast a failure intent;\n    // engine owns turning that into a Cloud V2 report.\n    if (cloudClientService.hasCore()) startCaptionsTesterReportService()\n    // MentraJS crashloop-disabled is runtime state; engine owns filing the\n    // automatic report while hosts only render alert/telemetry side effects.\n    if (cloudClientService.hasCore()) startMentraJSCrashloopReportService()\n    // Bring up the local-miniapp engine so a bare OEM can run MentraJS miniapps:\n    // the LocalMiniappRuntime (registry + WebView bridge), the MentraJS router\n    // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor\n    // (layout arbitration over the engine stores), and the gallery-sync service.\n    // All idempotent — when the Mentra app's host bootstrap also calls these, the\n    // second call is a no-op. Host-only crashloop telemetry is attached\n    // separately by the Mentra app.\n    localMiniappRuntime.initialize()\n    ensureMiniappEngine()\n    displayProcessor.attachToRuntime()\n    gallerySyncService.initialize()\n  },\n  /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.\n   * Each step is guarded so one failing teardown can't skip the rest and leak\n   * the remaining runtime services. */\n  async stop() {\n    const safely = async (label: string, step: () => unknown): Promise<void> => {\n      try {\n        await step()\n      } catch (error) {\n        console.warn(`engine.stop: ${label} failed:`, error)\n      }\n    }\n    await safely(\"glasses settings sync\", stopGlassesSettingsSync)\n    await safely(\"glasses status projection\", stopGlassesStatusProjection)\n    await safely(\"device event router\", stopDeviceEventRouter)\n    await safely(\"ota service\", stopOtaService)\n    await safely(\"audio cloud uplink\", stopAudioCloudUplink)\n    await safely(\"support profile sync\", stopSupportProfileSync)\n    await safely(\"phone notifications sync\", stopPhoneNotificationsSync)\n    await safely(\"captions tester report service\", stopCaptionsTesterReportService)\n    await safely(\"mentrajs crashloop report service\", stopMentraJSCrashloopReportService)\n    await safely(\"miniapp engine\", stopMiniappEngine)\n    await safely(\"local miniapp runtime\", () => localMiniappRuntime.cleanup())\n    await safely(\"display processor\", () => displayProcessor.detachFromRuntime())\n    await safely(\"gallery sync service\", () => gallerySyncService.cleanup())\n    await safely(\"cloud client\", () => cloudClientService.stop())\n    await safely(\"bootstrap\", bootstrapStop)\n  },\n  glasses,\n  speech,\n  /** Cloud (cloud-v2) live-session status + account ops — engine owns the client. */\n  session,\n  /** Typed keyed user settings over the engine-owned settings store. */\n  settings,\n  /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */\n  dev,\n  /** Bug-report, automatic runtime report, and feedback submission. */\n  reports,\n  /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */\n  ota,\n  /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */\n  gallery,\n  /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */\n  miniapps,\n  /** First-time glasses discovery + pairing. */\n  pairing,\n  /** Phone→glasses notification forwarding (Android). */\n  phoneNotifications,\n  /** OS permissions (check/request/openSettings + per-miniapp requirements). */\n  permissions,\n  /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */\n  notifications,\n  display,\n}\n"]}

package/build/facades/ota.d.ts

@@ -6,6 +6,7 @@ declare function projectSnapshot(): {
     ready: boolean;
     buildNumber: string | null;
     appVersion: string | null;
+    packageName: string | null;
     mtkFirmwareVersion: string | null;
     besFirmwareVersion: string | null;
     batteryLevel: number | null;

package/build/facades/ota.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAwB,KAAK,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AAGhG,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAA;AAE1C,iBAAS,eAAe;;;;;;;;;;;;;;;;;EAoBvB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAC5D,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,GAC7B,CAAA;AAED,eAAO,MAAM,GAAG;IAEd;;;;OAIG;;IAMH;;;;;OAKG;8BACuB,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnE;;;OAGG;;IAEH,sGAAsG;gCAC1E,6BAA6B;IACzD,wGAAwG;yCACnE,MAAM,GAAG,IAAI,cAAc,MAAM,GAAG,IAAI,KAAG,gBAAgB,EAAE;IAElG,+CAA+C;;IAE/C,yEAAyE;;IAMzE;;;;;OAKG;4CACqC,aAAa,CAAC,SAAS,CAAC,KAAG,aAAa,GAAG,IAAI;IAQvF;;;;;OAKG;;IAIH;;;OAGG;yCACkC,OAAO;IAE5C;;;;OAIG;;QAED,oFAAoF;0BAClE,4BAA4B;QAC9C,2FAA2F;;QAE3F,+EAA+E;;QAE/E,+EAA+E;;QAE/E,4EAA4E;;QAE5E,8FAA8F;;QAE9F,qFAAqF;wBACvE,kBAAkB;QAChC,iGAAiG;yBAChF,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAGxE,8EAA8E;2BACzD,aAAa,GAAG,IAAI;IACzC,iFAAiF;kBACrE,SAAS,GAAG,IAAI;IAC5B,iEAAiE;oBACnD,WAAW;IAEzB,iGAAiG;4BACzE,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAU3E,uEAAuE;mBACxD,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAUhE,iEAAiE;qBAChD,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAUhE,CAAA"}
+{"version":3,"file":"ota.d.ts","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAwB,KAAK,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AAGhG,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,mCAAmC,CAAA;AAE1C,iBAAS,eAAe;;;;;;;;;;;;;;;;;;EAqBvB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAC5D,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,4BAA4B,GAC7B,CAAA;AAED,eAAO,MAAM,GAAG;IAEd;;;;OAIG;;IAMH;;;;;OAKG;8BACuB,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnE;;;OAGG;;IAEH,sGAAsG;gCAC1E,6BAA6B;IACzD,wGAAwG;yCACnE,MAAM,GAAG,IAAI,cAAc,MAAM,GAAG,IAAI,KAAG,gBAAgB,EAAE;IAElG,+CAA+C;;IAE/C,yEAAyE;;IAMzE;;;;;OAKG;4CACqC,aAAa,CAAC,SAAS,CAAC,KAAG,aAAa,GAAG,IAAI;IAQvF;;;;;OAKG;;IAIH;;;OAGG;yCACkC,OAAO;IAE5C;;;;OAIG;;QAED,oFAAoF;0BAClE,4BAA4B;QAC9C,2FAA2F;;QAE3F,+EAA+E;;QAE/E,+EAA+E;;QAE/E,4EAA4E;;QAE5E,8FAA8F;;QAE9F,qFAAqF;wBACvE,kBAAkB;QAChC,iGAAiG;yBAChF,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAGxE,8EAA8E;2BACzD,aAAa,GAAG,IAAI;IACzC,iFAAiF;kBACrE,SAAS,GAAG,IAAI;IAC5B,iEAAiE;oBACnD,WAAW;IAEzB,iGAAiG;4BACzE,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAU3E,uEAAuE;mBACxD,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAUhE,iEAAiE;qBAChD,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAUhE,CAAA"}

package/build/facades/ota.js

@@ -22,6 +22,7 @@ function projectSnapshot() {
         ready: isGlassesReady(s.connection),
         buildNumber: s.buildNumber || null,
         appVersion: s.appVersion || null,
+        packageName: s.packageName || null,
         mtkFirmwareVersion: s.mtkFirmwareVersion || null,
         besFirmwareVersion: s.besFirmwareVersion || null,
         batteryLevel: s.batteryLevel >= 0 ? s.batteryLevel : null,

package/build/facades/ota.js.map

@@ -1 +1 @@
-{"version":3,"file":"ota.js","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ota facade — `engine.ota`: the OEM-facing OTA read/observe surface. Engine's\n * OtaService projects the glasses' OTA BLE events into the engine store; this facade\n * exposes the snapshot + change subscriptions behind the shared OTA flow exported by\n * `@mentra/engine/ota`. Hosts retain only their surrounding navigation and theme/i18n adapters.\n *\n * Availability checks live in engine. Install orchestration lives in engine too:\n * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host\n * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk\"\nimport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStartAckEvent,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n} from \"@mentra/bluetooth-sdk\"\nimport {isGlassesConnected, isGlassesReady, useGlassesStore} from \"../stores/glasses\"\nimport {resolveOtaManifestUrl} from \"../services/otaManifestUrl\"\nimport {otaInstallCoordinator, type OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport {startGlassesStatusProjection} from \"../services/GlassesStatusProjection\"\nimport {startOtaService} from \"../services/OtaService\"\nimport {\n  checkCurrentGlassesForUpdate,\n  type OtaCheckCurrentGlassesOptions,\n  type OtaCheckCurrentGlassesResult,\n} from \"../services/OtaUpdateCheckService\"\n\nfunction projectSnapshot() {\n  const s = useGlassesStore.getState()\n  return {\n    connected: isGlassesConnected(s.connection),\n    ready: isGlassesReady(s.connection),\n    buildNumber: s.buildNumber || null,\n    appVersion: s.appVersion || null,\n    mtkFirmwareVersion: s.mtkFirmwareVersion || null,\n    besFirmwareVersion: s.besFirmwareVersion || null,\n    batteryLevel: s.batteryLevel >= 0 ? s.batteryLevel : null,\n    hotspotOtaVersion: s.hotspotOtaVersion ?? 0,\n    wifiConnected: s.wifi.state === \"connected\",\n    wifiStatusKnown: s.wifiStatusKnown,\n    manifestUrl: resolveOtaManifestUrl(s.otaVersionUrl, s.buildNumber),\n    updateAvailable: s.otaUpdateAvailable,\n    status: s.otaStatus,\n    legacyProgress: s.otaProgress,\n    inProgress: s.otaInProgress,\n    mtkUpdatedThisSession: s.mtkUpdatedThisSession,\n  }\n}\n\nexport type OtaSnapshot = ReturnType<typeof projectSnapshot>\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n  OtaInstallSnapshot,\n  OtaCheckCurrentGlassesOptions,\n  OtaCheckCurrentGlassesResult,\n}\n\nexport const ota = {\n  // --- actions ---\n  /**\n   * Start the device-status and OTA projections without starting the authenticated\n   * cloud connection or miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.\n   * Idempotent and safe when the full engine runtime is already running.\n   */\n  initialize: async () => {\n    const hydrated = startGlassesStatusProjection()\n    startOtaService()\n    await hydrated\n  },\n  /**\n   * Start the firmware install with the resolved OTA manifest URL. Progress lands on\n   * `status()`/`onStatus()`. (The host resolves the manifest URL — developer override,\n   * host pin, or Engine release pin resolution stays with the OTA config; the stuck/retry watchdog is its own\n   * resilience layer on top of this command.)\n   */\n  install: (otaVersionUrl?: string | null): Promise<OtaStartAckEvent> => BluetoothSdk.startOtaUpdate(otaVersionUrl),\n  // Deferred: this facade entry was intended to become the engine-owned retry/check\n  // action, but BluetoothSdk.checkForOtaUpdate() only returns a boolean. Exposing it\n  // here would make callers think the rich otaUpdateAvailable read model is refreshed,\n  // while the original view still depends on the host-side manifest compare to build\n  // versionName/updates/totalSize. Keep that behavior unchanged until the whole rich\n  // availability check moves into engine.\n  // retry: () => BluetoothSdk.checkForOtaUpdate(),\n  /**\n   * Keep glasses awake while an OTA session is actively progressing.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  ping: () => BluetoothSdk.ping(),\n  /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */\n  checkForUpdates: (options?: OtaCheckCurrentGlassesOptions) => checkCurrentGlassesForUpdate(options),\n  /** Return bundled release changelogs crossed between two coordinated product versions, newest first. */\n  getReleaseChangelogs: (fromVersion?: string | null, toVersion?: string | null): ReleaseChangelog[] =>\n    BluetoothSdk.getReleaseChangelogs(fromVersion, toVersion),\n  /** Clear the available-update prompt state. */\n  clearUpdateAvailable: () => useGlassesStore.getState().setOtaUpdateAvailable(null),\n  /** Clear active progress/status before entering a fresh install flow. */\n  clearProgress: () => {\n    const store = useGlassesStore.getState()\n    store.setOtaProgress(null)\n    store.setOtaStatus(null)\n  },\n  /**\n   * Replace the pending update sequence after an in-flow firmware revalidation.\n   * Kept as a named OTA policy operation so host screens do not mutate the raw\n   * glasses store.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  replacePendingUpdateSequence: (updates: OtaUpdateInfo[\"updates\"]): OtaUpdateInfo | null => {\n    const store = useGlassesStore.getState()\n    const current = store.otaUpdateAvailable\n    if (!current) return null\n    const next = {...current, updates}\n    store.setOtaUpdateAvailable(next)\n    return next\n  },\n  /**\n   * Clear stale build metadata before returning to the update-check screen.\n   * This forces the next version_info event through both the native observable\n   * store and the engine projection after an APK reboot.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  clearBuildNumberForNextCheck: () => {\n    useGlassesStore.getState().setGlassesInfo({buildNumber: \"\"})\n  },\n  /**\n   * Mark MTK as already applied during this app session until the glasses reboot/disconnect.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  markMtkUpdatedThisSession: (updated: boolean) => useGlassesStore.getState().setMtkUpdatedThisSession(updated),\n\n  /**\n   * The OTA install state machine (unified `ota_status` sessions, build >= 37).\n   * The host progress screen attaches on mount, detaches on unmount, and renders\n   * the snapshot; every watchdog/retry/reconnect rule lives in the coordinator.\n   */\n  installSession: {\n    /** Select Wi-Fi or capability-gated hotspot transport for this checked manifest. */\n    prepare: (result: OtaCheckCurrentGlassesResult) => otaInstallCoordinator.prepare(result),\n    /** Bind the machine to the mounted progress screen. Idempotent per attach/detach cycle. */\n    attach: () => otaInstallCoordinator.attach(),\n    /** Unbind on unmount: clears all timers/listeners and resets session state. */\n    detach: () => otaInstallCoordinator.detach(),\n    /** Retry after a failure: clear state and re-send ota_start (if connected). */\n    retry: () => otaInstallCoordinator.retry(),\n    /** Terminal cleanup for Continue/Done, including hotspot route teardown. */\n    finish: () => otaInstallCoordinator.finish(),\n    /** Abandon an interrupted session: await finish() then drop the session's status/progress. */\n    discard: () => otaInstallCoordinator.discard(),\n    /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */\n    snapshot: (): OtaInstallSnapshot => otaInstallCoordinator.snapshot(),\n    /** Subscribe to install snapshot changes (deduped on projected JSON). Returns an unsubscribe. */\n    onSnapshot: (cb: (snapshot: OtaInstallSnapshot) => void): (() => void) => otaInstallCoordinator.onSnapshot(cb),\n  },\n\n  /** Current available-update info (versionName/updates/totalSize), or null. */\n  updateAvailable: (): OtaUpdateInfo | null => useGlassesStore.getState().otaUpdateAvailable,\n  /** Current OTA install status (stepType/phase/percent/status/error), or null. */\n  status: (): OtaStatus | null => useGlassesStore.getState().otaStatus,\n  /** Current OTA read model for update prompt/progress screens. */\n  snapshot: (): OtaSnapshot => projectSnapshot(),\n\n  /** Subscribe to OTA availability changes (info or null when cleared). Returns an unsubscribe. */\n  onUpdateAvailable: (cb: (info: OtaUpdateInfo | null) => void): (() => void) => {\n    let last = useGlassesStore.getState().otaUpdateAvailable\n    return useGlassesStore.subscribe(() => {\n      const info = useGlassesStore.getState().otaUpdateAvailable\n      if (info === last) return\n      last = info\n      cb(info)\n    })\n  },\n\n  /** Subscribe to OTA install status changes. Returns an unsubscribe. */\n  onStatus: (cb: (status: OtaStatus | null) => void): (() => void) => {\n    let last = useGlassesStore.getState().otaStatus\n    return useGlassesStore.subscribe(() => {\n      const status = useGlassesStore.getState().otaStatus\n      if (status === last) return\n      last = status\n      cb(status)\n    })\n  },\n\n  /** Subscribe to OTA snapshot changes. Returns an unsubscribe. */\n  onSnapshot: (cb: (snapshot: OtaSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectSnapshot())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectSnapshot()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n}\n"]}
+{"version":3,"file":"ota.js","sourceRoot":"","sources":["../../src/facades/ota.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ota facade — `engine.ota`: the OEM-facing OTA read/observe surface. Engine's\n * OtaService projects the glasses' OTA BLE events into the engine store; this facade\n * exposes the snapshot + change subscriptions behind the shared OTA flow exported by\n * `@mentra/engine/ota`. Hosts retain only their surrounding navigation and theme/i18n adapters.\n *\n * Availability checks live in engine. Install orchestration lives in engine too:\n * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host\n * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk\"\nimport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStartAckEvent,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n} from \"@mentra/bluetooth-sdk\"\nimport {isGlassesConnected, isGlassesReady, useGlassesStore} from \"../stores/glasses\"\nimport {resolveOtaManifestUrl} from \"../services/otaManifestUrl\"\nimport {otaInstallCoordinator, type OtaInstallSnapshot} from \"../services/OtaInstallCoordinator\"\nimport {startGlassesStatusProjection} from \"../services/GlassesStatusProjection\"\nimport {startOtaService} from \"../services/OtaService\"\nimport {\n  checkCurrentGlassesForUpdate,\n  type OtaCheckCurrentGlassesOptions,\n  type OtaCheckCurrentGlassesResult,\n} from \"../services/OtaUpdateCheckService\"\n\nfunction projectSnapshot() {\n  const s = useGlassesStore.getState()\n  return {\n    connected: isGlassesConnected(s.connection),\n    ready: isGlassesReady(s.connection),\n    buildNumber: s.buildNumber || null,\n    appVersion: s.appVersion || null,\n    packageName: s.packageName || null,\n    mtkFirmwareVersion: s.mtkFirmwareVersion || null,\n    besFirmwareVersion: s.besFirmwareVersion || null,\n    batteryLevel: s.batteryLevel >= 0 ? s.batteryLevel : null,\n    hotspotOtaVersion: s.hotspotOtaVersion ?? 0,\n    wifiConnected: s.wifi.state === \"connected\",\n    wifiStatusKnown: s.wifiStatusKnown,\n    manifestUrl: resolveOtaManifestUrl(s.otaVersionUrl, s.buildNumber),\n    updateAvailable: s.otaUpdateAvailable,\n    status: s.otaStatus,\n    legacyProgress: s.otaProgress,\n    inProgress: s.otaInProgress,\n    mtkUpdatedThisSession: s.mtkUpdatedThisSession,\n  }\n}\n\nexport type OtaSnapshot = ReturnType<typeof projectSnapshot>\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n  OtaInstallSnapshot,\n  OtaCheckCurrentGlassesOptions,\n  OtaCheckCurrentGlassesResult,\n}\n\nexport const ota = {\n  // --- actions ---\n  /**\n   * Start the device-status and OTA projections without starting the authenticated\n   * cloud connection or miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.\n   * Idempotent and safe when the full engine runtime is already running.\n   */\n  initialize: async () => {\n    const hydrated = startGlassesStatusProjection()\n    startOtaService()\n    await hydrated\n  },\n  /**\n   * Start the firmware install with the resolved OTA manifest URL. Progress lands on\n   * `status()`/`onStatus()`. (The host resolves the manifest URL — developer override,\n   * host pin, or Engine release pin resolution stays with the OTA config; the stuck/retry watchdog is its own\n   * resilience layer on top of this command.)\n   */\n  install: (otaVersionUrl?: string | null): Promise<OtaStartAckEvent> => BluetoothSdk.startOtaUpdate(otaVersionUrl),\n  // Deferred: this facade entry was intended to become the engine-owned retry/check\n  // action, but BluetoothSdk.checkForOtaUpdate() only returns a boolean. Exposing it\n  // here would make callers think the rich otaUpdateAvailable read model is refreshed,\n  // while the original view still depends on the host-side manifest compare to build\n  // versionName/updates/totalSize. Keep that behavior unchanged until the whole rich\n  // availability check moves into engine.\n  // retry: () => BluetoothSdk.checkForOtaUpdate(),\n  /**\n   * Keep glasses awake while an OTA session is actively progressing.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  ping: () => BluetoothSdk.ping(),\n  /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */\n  checkForUpdates: (options?: OtaCheckCurrentGlassesOptions) => checkCurrentGlassesForUpdate(options),\n  /** Return bundled release changelogs crossed between two coordinated product versions, newest first. */\n  getReleaseChangelogs: (fromVersion?: string | null, toVersion?: string | null): ReleaseChangelog[] =>\n    BluetoothSdk.getReleaseChangelogs(fromVersion, toVersion),\n  /** Clear the available-update prompt state. */\n  clearUpdateAvailable: () => useGlassesStore.getState().setOtaUpdateAvailable(null),\n  /** Clear active progress/status before entering a fresh install flow. */\n  clearProgress: () => {\n    const store = useGlassesStore.getState()\n    store.setOtaProgress(null)\n    store.setOtaStatus(null)\n  },\n  /**\n   * Replace the pending update sequence after an in-flow firmware revalidation.\n   * Kept as a named OTA policy operation so host screens do not mutate the raw\n   * glasses store.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  replacePendingUpdateSequence: (updates: OtaUpdateInfo[\"updates\"]): OtaUpdateInfo | null => {\n    const store = useGlassesStore.getState()\n    const current = store.otaUpdateAvailable\n    if (!current) return null\n    const next = {...current, updates}\n    store.setOtaUpdateAvailable(next)\n    return next\n  },\n  /**\n   * Clear stale build metadata before returning to the update-check screen.\n   * This forces the next version_info event through both the native observable\n   * store and the engine projection after an APK reboot.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  clearBuildNumberForNextCheck: () => {\n    useGlassesStore.getState().setGlassesInfo({buildNumber: \"\"})\n  },\n  /**\n   * Mark MTK as already applied during this app session until the glasses reboot/disconnect.\n   * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.\n   */\n  markMtkUpdatedThisSession: (updated: boolean) => useGlassesStore.getState().setMtkUpdatedThisSession(updated),\n\n  /**\n   * The OTA install state machine (unified `ota_status` sessions, build >= 37).\n   * The host progress screen attaches on mount, detaches on unmount, and renders\n   * the snapshot; every watchdog/retry/reconnect rule lives in the coordinator.\n   */\n  installSession: {\n    /** Select Wi-Fi or capability-gated hotspot transport for this checked manifest. */\n    prepare: (result: OtaCheckCurrentGlassesResult) => otaInstallCoordinator.prepare(result),\n    /** Bind the machine to the mounted progress screen. Idempotent per attach/detach cycle. */\n    attach: () => otaInstallCoordinator.attach(),\n    /** Unbind on unmount: clears all timers/listeners and resets session state. */\n    detach: () => otaInstallCoordinator.detach(),\n    /** Retry after a failure: clear state and re-send ota_start (if connected). */\n    retry: () => otaInstallCoordinator.retry(),\n    /** Terminal cleanup for Continue/Done, including hotspot route teardown. */\n    finish: () => otaInstallCoordinator.finish(),\n    /** Abandon an interrupted session: await finish() then drop the session's status/progress. */\n    discard: () => otaInstallCoordinator.discard(),\n    /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */\n    snapshot: (): OtaInstallSnapshot => otaInstallCoordinator.snapshot(),\n    /** Subscribe to install snapshot changes (deduped on projected JSON). Returns an unsubscribe. */\n    onSnapshot: (cb: (snapshot: OtaInstallSnapshot) => void): (() => void) => otaInstallCoordinator.onSnapshot(cb),\n  },\n\n  /** Current available-update info (versionName/updates/totalSize), or null. */\n  updateAvailable: (): OtaUpdateInfo | null => useGlassesStore.getState().otaUpdateAvailable,\n  /** Current OTA install status (stepType/phase/percent/status/error), or null. */\n  status: (): OtaStatus | null => useGlassesStore.getState().otaStatus,\n  /** Current OTA read model for update prompt/progress screens. */\n  snapshot: (): OtaSnapshot => projectSnapshot(),\n\n  /** Subscribe to OTA availability changes (info or null when cleared). Returns an unsubscribe. */\n  onUpdateAvailable: (cb: (info: OtaUpdateInfo | null) => void): (() => void) => {\n    let last = useGlassesStore.getState().otaUpdateAvailable\n    return useGlassesStore.subscribe(() => {\n      const info = useGlassesStore.getState().otaUpdateAvailable\n      if (info === last) return\n      last = info\n      cb(info)\n    })\n  },\n\n  /** Subscribe to OTA install status changes. Returns an unsubscribe. */\n  onStatus: (cb: (status: OtaStatus | null) => void): (() => void) => {\n    let last = useGlassesStore.getState().otaStatus\n    return useGlassesStore.subscribe(() => {\n      const status = useGlassesStore.getState().otaStatus\n      if (status === last) return\n      last = status\n      cb(status)\n    })\n  },\n\n  /** Subscribe to OTA snapshot changes. Returns an unsubscribe. */\n  onSnapshot: (cb: (snapshot: OtaSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectSnapshot())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectSnapshot()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n}\n"]}

package/build/facades/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/facades/reports.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAO7B,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,uBAAuB,GAC/B,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,KAAK,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACtC,CAAC,GACF,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,UAAU,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CACjC,CAAC,CAAA;AAEN,MAAM,MAAM,gCAAgC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,WAAW,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAChH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAID,MAAM,MAAM,kBAAkB,GAC1B;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAC,GACnE;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAC,GACtD;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAA;AA8HrC,eAAO,MAAM,OAAO;kBACJ,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAGpE,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1G"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/facades/reports.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,qBAAqB,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAC,MAAM,sBAAsB,CAAA;AAO/G,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,uBAAuB,GAC/B,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,KAAK,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACtC,CAAC,GACF,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,UAAU,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CACjC,CAAC,CAAA;AAEN,MAAM,MAAM,gCAAgC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,WAAW,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAChH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAID,MAAM,MAAM,kBAAkB,GAC1B;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAC,GACnE;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAC,GACtD;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAA;AAiIrC,eAAO,MAAM,OAAO;kBACJ,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAGpE,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1G"}

package/build/facades/reports.js

@@ -47,6 +47,9 @@ function notifyGlasses(reportId, apiBaseUrl) {
     })();
 }
 async function submitReportInternal(input) {
+    if (!cloudClientService.hasCore()) {
+        return { status: "failed", error: "Reports are unavailable in this deployment" };
+    }
     const throttle = input.kind === "automatic" && input.throttleKey
         ? {
             key: input.throttleKey,

package/build/facades/reports.js.map

@@ -1 +1 @@
-{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../src/facades/reports.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * reports facade — `engine.reports`: user/system report submission over the\n * Cloud V2 core client.\n *\n * Host/OEM code owns UI and wording. Engine owns MentraOS mechanics: context\n * collection, recent phone logs, Cloud V2 calls, local automatic throttling,\n * screenshots, and notifying connected glasses.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportStatus,\n  SubmitReportInput,\n} from \"@mentra/cloud-client\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {isGlassesConnected} from \"../services/GlassesReadiness\"\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {collectDiagnosticContext} from \"../utils/diagnosticContext\"\nimport {logBuffer} from \"../utils/devLogging\"\n\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n} from \"@mentra/cloud-client\"\n\nexport type EngineSubmitReportInput =\n  | (Omit<Extract<SubmitReportInput, {kind: \"bug\"}>, \"context\"> & {\n      context?: Partial<ReportContext>\n      screenshots?: ReportAttachmentInput[]\n    })\n  | (Omit<Extract<SubmitReportInput, {kind: \"feedback\"}>, \"context\"> & {\n      context?: Partial<ReportContext>\n    })\n\nexport type EngineSubmitAutomaticReportInput = Omit<Extract<SubmitReportInput, {kind: \"automatic\"}>, \"context\"> & {\n  context?: Partial<ReportContext>\n  screenshots?: ReportAttachmentInput[]\n  throttleKey?: string\n  throttleWindowMs?: number\n}\n\ntype InternalSubmitReportInput = EngineSubmitReportInput | EngineSubmitAutomaticReportInput\n\nexport type ReportSubmitResult =\n  | {status: \"submitted\"; reportId: string; reportStatus: ReportStatus}\n  | {status: \"skipped\"; reason: \"throttled_within_window\"}\n  | {status: \"failed\"; error: string}\n\nconst DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS = 90_000\nconst automaticReportThrottleRegistry = new Map<string, number>()\n\nfunction automaticThrottleShouldSkip(key: string, nowMs: number, windowMs: number): boolean {\n  const previous = automaticReportThrottleRegistry.get(key)\n  if (previous !== undefined && nowMs - previous < windowMs) {\n    return true\n  }\n  pruneAutomaticThrottleRegistry(nowMs, windowMs)\n  return false\n}\n\nfunction markAutomaticThrottleSuccess(key: string, nowMs: number, windowMs: number): void {\n  automaticReportThrottleRegistry.set(key, nowMs)\n  pruneAutomaticThrottleRegistry(nowMs, windowMs)\n}\n\nfunction pruneAutomaticThrottleRegistry(nowMs: number, windowMs: number): void {\n  for (const [entryKey, entryTime] of automaticReportThrottleRegistry) {\n    if (nowMs - entryTime > windowMs * 3) {\n      automaticReportThrottleRegistry.delete(entryKey)\n    }\n  }\n}\n\nfunction notifyGlasses(reportId: string, apiBaseUrl?: string | null): void {\n  if (!isGlassesConnected(useGlassesStore.getState().connection)) return\n  void (async () => {\n    try {\n      await cloudClientService.syncCoreTokenToBluetooth()\n      await BluetoothSdk.sendIncidentId(reportId, apiBaseUrl ?? cloudClientService.getCoreUrl())\n    } catch (error) {\n      console.warn(\"reports.submit: notify glasses failed:\", error instanceof Error ? error.message : error)\n    }\n  })()\n}\n\nasync function submitReportInternal(input: InternalSubmitReportInput): Promise<ReportSubmitResult> {\n  const throttle =\n    input.kind === \"automatic\" && input.throttleKey\n      ? {\n          key: input.throttleKey,\n          windowMs: input.throttleWindowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,\n        }\n      : null\n\n  if (input.kind === \"automatic\" && input.throttleKey) {\n    const shouldSkip = automaticThrottleShouldSkip(\n      input.throttleKey,\n      Date.now(),\n      throttle?.windowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,\n    )\n    if (shouldSkip) return {status: \"skipped\", reason: \"throttled_within_window\"}\n  }\n\n  const context = await collectDiagnosticContext(input.context)\n  let reportId: string\n  let reportStatus: ReportStatus\n  let artifactsComplete = true\n  try {\n    const res =\n      input.kind === \"feedback\"\n        ? await cloudClientService.core.reports.submit({\n            kind: \"feedback\",\n            feedback: input.feedback,\n            context,\n          })\n        : input.kind === \"bug\"\n          ? await cloudClientService.core.reports.submit({\n              kind: \"bug\",\n              trigger: input.trigger,\n              report: input.report,\n              context,\n            })\n          : await cloudClientService.core.reports.submit({\n              kind: \"automatic\",\n              trigger: input.trigger,\n              report: input.report,\n              context,\n            })\n    reportId = res.reportId\n    reportStatus = res.status\n  } catch (error) {\n    return {status: \"failed\", error: error instanceof Error ? error.message : String(error)}\n  }\n\n  if (input.kind !== \"feedback\") {\n    const logs = logBuffer.getRecentLogs()\n    if (logs.length > 0) {\n      try {\n        await cloudClientService.core.reports.addLogs(reportId, \"phone\", logs)\n      } catch (error) {\n        artifactsComplete = false\n        console.warn(\"reports.submit: add phone logs failed:\", error instanceof Error ? error.message : error)\n      }\n    }\n\n    notifyGlasses(reportId, cloudClientService.getCoreUrl())\n\n    if (input.screenshots && input.screenshots.length > 0) {\n      try {\n        await cloudClientService.core.reports.addScreenshots(reportId, input.screenshots)\n      } catch (error) {\n        artifactsComplete = false\n        console.warn(\"reports.submit: add screenshots failed:\", error instanceof Error ? error.message : error)\n      }\n    }\n\n    try {\n      const completed = await cloudClientService.core.reports.complete(reportId)\n      reportStatus = completed.status\n    } catch (error) {\n      artifactsComplete = false\n      console.warn(\"reports.submit: complete report failed:\", error instanceof Error ? error.message : error)\n    }\n  }\n\n  if (throttle && artifactsComplete) {\n    markAutomaticThrottleSuccess(throttle.key, Date.now(), throttle.windowMs)\n  }\n\n  return {status: \"submitted\", reportId, reportStatus}\n}\n\nexport const reports = {\n  submit(input: EngineSubmitReportInput): Promise<ReportSubmitResult> {\n    return submitReportInternal(input)\n  },\n}\n\nexport function submitAutomaticReport(input: EngineSubmitAutomaticReportInput): Promise<ReportSubmitResult> {\n  return submitReportInternal(input)\n}\n"]}
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../src/facades/reports.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * reports facade — `engine.reports`: user/system report submission over the\n * Cloud V2 core client.\n *\n * Host/OEM code owns UI and wording. Engine owns MentraOS mechanics: context\n * collection, recent phone logs, Cloud V2 calls, local automatic throttling,\n * screenshots, and notifying connected glasses.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {ReportAttachmentInput, ReportContext, ReportStatus, SubmitReportInput} from \"@mentra/cloud-client\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {isGlassesConnected} from \"../services/GlassesReadiness\"\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {collectDiagnosticContext} from \"../utils/diagnosticContext\"\nimport {logBuffer} from \"../utils/devLogging\"\n\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n} from \"@mentra/cloud-client\"\n\nexport type EngineSubmitReportInput =\n  | (Omit<Extract<SubmitReportInput, {kind: \"bug\"}>, \"context\"> & {\n      context?: Partial<ReportContext>\n      screenshots?: ReportAttachmentInput[]\n    })\n  | (Omit<Extract<SubmitReportInput, {kind: \"feedback\"}>, \"context\"> & {\n      context?: Partial<ReportContext>\n    })\n\nexport type EngineSubmitAutomaticReportInput = Omit<Extract<SubmitReportInput, {kind: \"automatic\"}>, \"context\"> & {\n  context?: Partial<ReportContext>\n  screenshots?: ReportAttachmentInput[]\n  throttleKey?: string\n  throttleWindowMs?: number\n}\n\ntype InternalSubmitReportInput = EngineSubmitReportInput | EngineSubmitAutomaticReportInput\n\nexport type ReportSubmitResult =\n  | {status: \"submitted\"; reportId: string; reportStatus: ReportStatus}\n  | {status: \"skipped\"; reason: \"throttled_within_window\"}\n  | {status: \"failed\"; error: string}\n\nconst DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS = 90_000\nconst automaticReportThrottleRegistry = new Map<string, number>()\n\nfunction automaticThrottleShouldSkip(key: string, nowMs: number, windowMs: number): boolean {\n  const previous = automaticReportThrottleRegistry.get(key)\n  if (previous !== undefined && nowMs - previous < windowMs) {\n    return true\n  }\n  pruneAutomaticThrottleRegistry(nowMs, windowMs)\n  return false\n}\n\nfunction markAutomaticThrottleSuccess(key: string, nowMs: number, windowMs: number): void {\n  automaticReportThrottleRegistry.set(key, nowMs)\n  pruneAutomaticThrottleRegistry(nowMs, windowMs)\n}\n\nfunction pruneAutomaticThrottleRegistry(nowMs: number, windowMs: number): void {\n  for (const [entryKey, entryTime] of automaticReportThrottleRegistry) {\n    if (nowMs - entryTime > windowMs * 3) {\n      automaticReportThrottleRegistry.delete(entryKey)\n    }\n  }\n}\n\nfunction notifyGlasses(reportId: string, apiBaseUrl?: string | null): void {\n  if (!isGlassesConnected(useGlassesStore.getState().connection)) return\n  void (async () => {\n    try {\n      await cloudClientService.syncCoreTokenToBluetooth()\n      await BluetoothSdk.sendIncidentId(reportId, apiBaseUrl ?? cloudClientService.getCoreUrl())\n    } catch (error) {\n      console.warn(\"reports.submit: notify glasses failed:\", error instanceof Error ? error.message : error)\n    }\n  })()\n}\n\nasync function submitReportInternal(input: InternalSubmitReportInput): Promise<ReportSubmitResult> {\n  if (!cloudClientService.hasCore()) {\n    return {status: \"failed\", error: \"Reports are unavailable in this deployment\"}\n  }\n  const throttle =\n    input.kind === \"automatic\" && input.throttleKey\n      ? {\n          key: input.throttleKey,\n          windowMs: input.throttleWindowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,\n        }\n      : null\n\n  if (input.kind === \"automatic\" && input.throttleKey) {\n    const shouldSkip = automaticThrottleShouldSkip(\n      input.throttleKey,\n      Date.now(),\n      throttle?.windowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,\n    )\n    if (shouldSkip) return {status: \"skipped\", reason: \"throttled_within_window\"}\n  }\n\n  const context = await collectDiagnosticContext(input.context)\n  let reportId: string\n  let reportStatus: ReportStatus\n  let artifactsComplete = true\n  try {\n    const res =\n      input.kind === \"feedback\"\n        ? await cloudClientService.core.reports.submit({\n            kind: \"feedback\",\n            feedback: input.feedback,\n            context,\n          })\n        : input.kind === \"bug\"\n          ? await cloudClientService.core.reports.submit({\n              kind: \"bug\",\n              trigger: input.trigger,\n              report: input.report,\n              context,\n            })\n          : await cloudClientService.core.reports.submit({\n              kind: \"automatic\",\n              trigger: input.trigger,\n              report: input.report,\n              context,\n            })\n    reportId = res.reportId\n    reportStatus = res.status\n  } catch (error) {\n    return {status: \"failed\", error: error instanceof Error ? error.message : String(error)}\n  }\n\n  if (input.kind !== \"feedback\") {\n    const logs = logBuffer.getRecentLogs()\n    if (logs.length > 0) {\n      try {\n        await cloudClientService.core.reports.addLogs(reportId, \"phone\", logs)\n      } catch (error) {\n        artifactsComplete = false\n        console.warn(\"reports.submit: add phone logs failed:\", error instanceof Error ? error.message : error)\n      }\n    }\n\n    notifyGlasses(reportId, cloudClientService.getCoreUrl())\n\n    if (input.screenshots && input.screenshots.length > 0) {\n      try {\n        await cloudClientService.core.reports.addScreenshots(reportId, input.screenshots)\n      } catch (error) {\n        artifactsComplete = false\n        console.warn(\"reports.submit: add screenshots failed:\", error instanceof Error ? error.message : error)\n      }\n    }\n\n    try {\n      const completed = await cloudClientService.core.reports.complete(reportId)\n      reportStatus = completed.status\n    } catch (error) {\n      artifactsComplete = false\n      console.warn(\"reports.submit: complete report failed:\", error instanceof Error ? error.message : error)\n    }\n  }\n\n  if (throttle && artifactsComplete) {\n    markAutomaticThrottleSuccess(throttle.key, Date.now(), throttle.windowMs)\n  }\n\n  return {status: \"submitted\", reportId, reportStatus}\n}\n\nexport const reports = {\n  submit(input: EngineSubmitReportInput): Promise<ReportSubmitResult> {\n    return submitReportInternal(input)\n  },\n}\n\nexport function submitAutomaticReport(input: EngineSubmitAutomaticReportInput): Promise<ReportSubmitResult> {\n  return submitReportInternal(input)\n}\n"]}

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const ENGINE_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.0",
-    "releaseIdentity": "3.2.0-dev.137",
-    "releaseSetId": "mentra-3.2.0-dev.137",
-    "sourceCommit": "fa427847c1c2be7fe043795de9020af4abf4678e",
-    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.137.json",
-    "otaManifestSha256": "6084835d43284f3bb73d88b054db4fbf74a738ce708be9bebf43cc0c01ae6afd"
+    "releaseIdentity": "3.2.0-dev.154",
+    "releaseSetId": "mentra-3.2.0-dev.154",
+    "sourceCommit": "e4156a951bbf1627f139325ad098f90828e93c3d",
+    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.154.json",
+    "otaManifestSha256": "e224889c2c7fe5d3248c039b1963d24826784b2c67c26eef2efb95055058e457"
 });
 //# sourceMappingURL=releaseMetadata.js.map

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,wHAAwH;IAC1I,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface EngineReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.0\",\n  \"releaseIdentity\": \"3.2.0-dev.137\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.137\",\n  \"sourceCommit\": \"fa427847c1c2be7fe043795de9020af4abf4678e\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.137.json\",\n  \"otaManifestSha256\": \"6084835d43284f3bb73d88b054db4fbf74a738ce708be9bebf43cc0c01ae6afd\"\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,wHAAwH;IAC1I,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface EngineReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.2.0\",\n  \"releaseIdentity\": \"3.2.0-dev.154\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.154\",\n  \"sourceCommit\": \"e4156a951bbf1627f139325ad098f90828e93c3d\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.154.json\",\n  \"otaManifestSha256\": \"e224889c2c7fe5d3248c039b1963d24826784b2c67c26eef2efb95055058e457\"\n})\n"]}

package/build/index.d.ts

@@ -15,7 +15,7 @@ export type { IslandNotification, IslandNotificationKind } from "./facades/notif
 export type { WifiSearchResult } from "./facades/glassesWifi";
 export type { IdentitySnapshot } from "./services/PairingIdentity";
 export type { DisplayMirrorEvent } from "./facades/displayMirror";
-export type { IslandConfigureOptions, IslandAuth, IslandConfigValues, IslandAnalytics, IslandUiSeams, ScanQrOptions, ScanQrResult, SubjectTokenType, } from "./runtime/bootstrap";
+export type { IslandConfigureOptions, IslandAuth, IslandConfigValues, IslandAnalytics, IslandUiSeams, ScanQrOptions, ScanQrResult, SubjectTokenType, LocalMiniappPolicy, ManagedMiniappPolicyEntry, } from "./runtime/bootstrap";
 export { SETTINGS, useSetting } from "./stores/settings";
 export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
 export { ISLAND_SETTINGS_KEYS } from "./runtime/config";

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA;AAyB/B,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,qEAAqE;AACrE,kDAAkD;AAClD,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAC,wBAAwB,EAAE,gCAAgC,EAAC,MAAM,+BAA+B,CAAA;AAExG,8CAA8C;AAC9C,OAAO,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAA;AAGrD,2DAA2D;AAC3D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,6BAA6B,CAAA;AACpC,yEAAyE;AACzE,OAAO,EACL,eAAe,EACf,yBAAyB,GAI1B,MAAM,kCAAkC,CAAA;AAazC,uEAAuE;AACvE,2DAA2D;AAC3D,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAC,kBAAkB,EAAC,MAAM,4BAA4B,CAAA;AAW7D,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,mCAAmC,GACpC,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,uCAAuC,EACvC,yCAAyC,GAC1C,MAAM,4BAA4B,CAAA;AAMnC,OAAO,EAAC,uBAAuB,EAAC,MAAM,6CAA6C,CAAA;AACnF,OAAO,EAAC,wBAAwB,EAAC,MAAM,wCAAwC,CAAA;AAe/E,+EAA+E;AAC/E,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAA;AAEnD,yEAAyE;AACzE,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,OAAO,EACP,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,gBAAgB,GAGjB,MAAM,eAAe,CAAA;AAEtB,4EAA4E;AAC5E,OAAO,EACL,oBAAoB,GAIrB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,kBAAkB,GAEnB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAC,qBAAqB,EAA2B,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAE1D,0CAA0C;AAC1C,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,IAAI,EACJ,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAA","sourcesContent":["/**\n * `@mentra/engine` — the OEM-facing main entry.\n *\n * The `engine` namespace (configure/start/stop + typed domain facades), the\n * public contract/read-model types, and the pure helpers host UI legitimately\n * renders with (decision functions, sort/order helpers, policy constants,\n * capability tables, timers). Judgment rule: read models, commands, pure\n * functions and types belong here; anything that mutates runtime state or\n * exposes a raw store/service remains private to the MentraOS host.\n * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n */\n\n// The namespaced OEM-facing engine API (the \"(A) host API\"). See ./engine.\nexport {engine} from \"./engine\"\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n  ReportSubmitResult,\n  EngineSubmitReportInput,\n} from \"./facades/reports\"\nexport type {IslandNotification, IslandNotificationKind} from \"./facades/notifications\"\nexport type {WifiSearchResult} from \"./facades/glassesWifi\"\nexport type {IdentitySnapshot} from \"./services/PairingIdentity\"\nexport type {DisplayMirrorEvent} from \"./facades/displayMirror\"\nexport type {\n  IslandConfigureOptions,\n  IslandAuth,\n  IslandConfigValues,\n  IslandAnalytics,\n  IslandUiSeams,\n  ScanQrOptions,\n  ScanQrResult,\n  SubjectTokenType,\n} from \"./runtime/bootstrap\"\n\n// Settings contract: the typed key registry (schema descriptors — the same\n// surface engine.settings.descriptor()/keys() reads), the per-key React hook\n// (the hook layer, same precedent as the apps hooks below), and the pure\n// device-model key helpers. The raw useSettingsStore stays internal;\n// imperative access goes through engine.settings.\nexport {SETTINGS, useSetting} from \"./stores/settings\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\n\n// Runtime-shared constants and contract DTOs.\nexport {ISLAND_SETTINGS_KEYS} from \"./runtime/config\"\nexport type {CloudClientStatusSnapshot, MiniappAuthToken, InteropAuditEvent, TtsSynthesisResult} from \"./runtime/config\"\n\n// Pure readiness predicates over glasses connection state.\nexport {\n  isGlassesConnected,\n  isGlassesReady,\n  isGlassesLinkLayerBusy,\n  waitForGlassesReady,\n  type GlassesConnectionStatus,\n  type WaitForGlassesReadyOptions,\n} from \"./services/GlassesReadiness\"\n// Pure connect/reconnect decision helpers (host UI renders the outcome).\nexport {\n  decideReconnect,\n  decideConnectButtonAction,\n  type ReconnectDecision,\n  type ReconnectDecisionInput,\n  type ConnectButtonAction,\n} from \"./services/ConnectionCoordinator\"\n\n// OTA read-model types for host OTA UI (progress screen, error mapping,\n// progress section) — the check/install machinery itself is internal.\nexport type {\n  VersionInfo,\n  MtkPatch,\n  BesFirmware,\n  VersionJson,\n  OtaCheckResult,\n  OtaCheckCurrentGlassesResult,\n  OtaCheckCurrentGlassesOptions,\n} from \"./services/OtaUpdateCheckService\"\n// OTA install policy (watchdog timings + failure copy) + display-state\n// derivation, consumed by the OTA screens and their tests.\nexport {\n  MINIMUM_OTA_STATUS_BUILD,\n  MAX_RETRIES,\n  RETRY_INTERVAL_MS,\n  PROGRESS_TIMEOUT_MS,\n  DOWNLOAD_STUCK_TIMEOUT_MS,\n  MTK_INSTALL_TIMEOUT_MS,\n  GLOBAL_OTA_TIMEOUT_MS,\n  PING_INTERVAL_MS,\n  QUERY_REPLY_TIMEOUT_MS,\n  BES_RESTART_TIMEOUT_MS,\n  OtaProgressMessages,\n} from \"./services/otaInstallPolicy\"\nexport {deriveDisplayState} from \"./services/otaDisplayState\"\nexport type {DisplayState} from \"./services/otaDisplayState\"\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n  OtaSnapshot,\n  OtaInstallSnapshot,\n} from \"./facades/ota\"\nexport {\n  beginOtaAutoChain,\n  clearOtaAutoChainReconnectWait,\n  isOtaAutoChainActive,\n  otaAutoChainFingerprint,\n  otaAutoChainReconnectWaitRemaining,\n  stopOtaAutoChain,\n  tryAdvanceOtaAutoChain,\n  MAX_OTA_AUTO_CHAIN_PASSES,\n  OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS,\n} from \"./services/OtaAutoChain\"\nexport type {OtaAutoChainAdvanceResult} from \"./services/OtaAutoChain\"\nexport {\n  BES_INSTALL_RESTART_MESSAGE,\n  getOtaErrorMessage,\n  shouldRequireGlassesRebootForBesFailure,\n  shouldShowChangeWifiForOtaDownloadFailure,\n} from \"./services/OtaErrorMapping\"\n\n// Gallery read models: engine.gallery.onNotice payload types, the media\n// permission helper + display-name derivation host gallery UI uses, and the\n// glasses-camera DTO types (re-exported through the host @/types/asg shim).\nexport type {GalleryNotice, GalleryNoticeCode} from \"./services/asg/galleryNotices\"\nexport {MediaLibraryPermissions} from \"./utils/permissions/MediaLibraryPermissions\"\nexport {deriveGalleryDisplayName} from \"./utils/permissions/galleryDisplayName\"\nexport type {\n  PhotoInfo,\n  CaptureFile,\n  CaptureGroup,\n  GalleryResponse,\n  ServerStatus,\n  HealthResponse,\n  GalleryEvent,\n} from \"./types/asg\"\n\n// Bluetooth SDK event types host UI subscribes to via engine facades (the\n// BluetoothSdk singleton passthrough itself is internal).\nexport type {PairFailureEvent, GlassesNotReadyEvent} from \"@mentra/bluetooth-sdk\"\n\n// Cloud connection status enum (read model; the connection store is internal).\nexport {WebSocketStatus} from \"./stores/connection\"\n\n// App-list hook layer + pure list helpers (the raw useAppStatusStore and\n// installAppStoreHooks wiring are internal).\nexport {\n  DUMMY_APPLET,\n  saveAppsOrder,\n  getAppsOrder,\n  sortAppsByPackageNamePriority,\n  saveLastOpenTime,\n  getLastOpenTime,\n  sortAppsByLastOpenTime,\n  useApps,\n  useStart,\n  useStop,\n  useSetForeground,\n  useClearForeground,\n  useRefresh,\n  useStopAll,\n  useInstall,\n  useUninstall,\n  useActiveApps,\n  useActiveBackgroundApps,\n  useBackgroundApps,\n  useActiveForegroundApp,\n  useForegroundApp,\n  useActiveBackgroundAppsCount,\n  useLocalMiniApps,\n  type StartOptions,\n  type OrderMap,\n} from \"./stores/apps\"\n\n// Pure dev-miniapp launch-route decision (registration itself is internal).\nexport {\n  decideDevLaunchRoute,\n  type DecideDevLaunchOptions,\n  type DevLaunchResult,\n  type DevManifest,\n} from \"./utils/devMiniappLaunch\"\nexport {\n  decideDevOpenRoute,\n  type DevOpenDecision,\n} from \"./utils/devMiniappSnapshot\"\nexport {HardwareCompatibility, type CompatibilityResult} from \"./utils/hardware\"\nexport {BgTimer, throttle, debounce} from \"./utils/timers\"\n\n// Hardware types and capability profiles.\nexport {\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  ControllerTypes,\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  nimo,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./types\"\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n  AppletType,\n  AppPermissionType,\n  AppletPermission,\n  AppletInterface,\n  ClientApp,\n} from \"./types\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA;AA2B/B,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,qEAAqE;AACrE,kDAAkD;AAClD,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAC,wBAAwB,EAAE,gCAAgC,EAAC,MAAM,+BAA+B,CAAA;AAExG,8CAA8C;AAC9C,OAAO,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAA;AAGrD,2DAA2D;AAC3D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,6BAA6B,CAAA;AACpC,yEAAyE;AACzE,OAAO,EACL,eAAe,EACf,yBAAyB,GAI1B,MAAM,kCAAkC,CAAA;AAazC,uEAAuE;AACvE,2DAA2D;AAC3D,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAC,kBAAkB,EAAC,MAAM,4BAA4B,CAAA;AAW7D,OAAO,EACL,iBAAiB,EACjB,8BAA8B,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,mCAAmC,GACpC,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,uCAAuC,EACvC,yCAAyC,GAC1C,MAAM,4BAA4B,CAAA;AAMnC,OAAO,EAAC,uBAAuB,EAAC,MAAM,6CAA6C,CAAA;AACnF,OAAO,EAAC,wBAAwB,EAAC,MAAM,wCAAwC,CAAA;AAe/E,+EAA+E;AAC/E,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAA;AAEnD,yEAAyE;AACzE,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,OAAO,EACP,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,gBAAgB,GAGjB,MAAM,eAAe,CAAA;AAEtB,4EAA4E;AAC5E,OAAO,EACL,oBAAoB,GAIrB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,kBAAkB,GAEnB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAC,qBAAqB,EAA2B,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAE1D,0CAA0C;AAC1C,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,IAAI,EACJ,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAA","sourcesContent":["/**\n * `@mentra/engine` — the OEM-facing main entry.\n *\n * The `engine` namespace (configure/start/stop + typed domain facades), the\n * public contract/read-model types, and the pure helpers host UI legitimately\n * renders with (decision functions, sort/order helpers, policy constants,\n * capability tables, timers). Judgment rule: read models, commands, pure\n * functions and types belong here; anything that mutates runtime state or\n * exposes a raw store/service remains private to the MentraOS host.\n * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n */\n\n// The namespaced OEM-facing engine API (the \"(A) host API\"). See ./engine.\nexport {engine} from \"./engine\"\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n  ReportSubmitResult,\n  EngineSubmitReportInput,\n} from \"./facades/reports\"\nexport type {IslandNotification, IslandNotificationKind} from \"./facades/notifications\"\nexport type {WifiSearchResult} from \"./facades/glassesWifi\"\nexport type {IdentitySnapshot} from \"./services/PairingIdentity\"\nexport type {DisplayMirrorEvent} from \"./facades/displayMirror\"\nexport type {\n  IslandConfigureOptions,\n  IslandAuth,\n  IslandConfigValues,\n  IslandAnalytics,\n  IslandUiSeams,\n  ScanQrOptions,\n  ScanQrResult,\n  SubjectTokenType,\n  LocalMiniappPolicy,\n  ManagedMiniappPolicyEntry,\n} from \"./runtime/bootstrap\"\n\n// Settings contract: the typed key registry (schema descriptors — the same\n// surface engine.settings.descriptor()/keys() reads), the per-key React hook\n// (the hook layer, same precedent as the apps hooks below), and the pure\n// device-model key helpers. The raw useSettingsStore stays internal;\n// imperative access goes through engine.settings.\nexport {SETTINGS, useSetting} from \"./stores/settings\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\n\n// Runtime-shared constants and contract DTOs.\nexport {ISLAND_SETTINGS_KEYS} from \"./runtime/config\"\nexport type {CloudClientStatusSnapshot, MiniappAuthToken, InteropAuditEvent, TtsSynthesisResult} from \"./runtime/config\"\n\n// Pure readiness predicates over glasses connection state.\nexport {\n  isGlassesConnected,\n  isGlassesReady,\n  isGlassesLinkLayerBusy,\n  waitForGlassesReady,\n  type GlassesConnectionStatus,\n  type WaitForGlassesReadyOptions,\n} from \"./services/GlassesReadiness\"\n// Pure connect/reconnect decision helpers (host UI renders the outcome).\nexport {\n  decideReconnect,\n  decideConnectButtonAction,\n  type ReconnectDecision,\n  type ReconnectDecisionInput,\n  type ConnectButtonAction,\n} from \"./services/ConnectionCoordinator\"\n\n// OTA read-model types for host OTA UI (progress screen, error mapping,\n// progress section) — the check/install machinery itself is internal.\nexport type {\n  VersionInfo,\n  MtkPatch,\n  BesFirmware,\n  VersionJson,\n  OtaCheckResult,\n  OtaCheckCurrentGlassesResult,\n  OtaCheckCurrentGlassesOptions,\n} from \"./services/OtaUpdateCheckService\"\n// OTA install policy (watchdog timings + failure copy) + display-state\n// derivation, consumed by the OTA screens and their tests.\nexport {\n  MINIMUM_OTA_STATUS_BUILD,\n  MAX_RETRIES,\n  RETRY_INTERVAL_MS,\n  PROGRESS_TIMEOUT_MS,\n  DOWNLOAD_STUCK_TIMEOUT_MS,\n  MTK_INSTALL_TIMEOUT_MS,\n  GLOBAL_OTA_TIMEOUT_MS,\n  PING_INTERVAL_MS,\n  QUERY_REPLY_TIMEOUT_MS,\n  BES_RESTART_TIMEOUT_MS,\n  OtaProgressMessages,\n} from \"./services/otaInstallPolicy\"\nexport {deriveDisplayState} from \"./services/otaDisplayState\"\nexport type {DisplayState} from \"./services/otaDisplayState\"\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n  OtaSnapshot,\n  OtaInstallSnapshot,\n} from \"./facades/ota\"\nexport {\n  beginOtaAutoChain,\n  clearOtaAutoChainReconnectWait,\n  isOtaAutoChainActive,\n  otaAutoChainFingerprint,\n  otaAutoChainReconnectWaitRemaining,\n  stopOtaAutoChain,\n  tryAdvanceOtaAutoChain,\n  MAX_OTA_AUTO_CHAIN_PASSES,\n  OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS,\n} from \"./services/OtaAutoChain\"\nexport type {OtaAutoChainAdvanceResult} from \"./services/OtaAutoChain\"\nexport {\n  BES_INSTALL_RESTART_MESSAGE,\n  getOtaErrorMessage,\n  shouldRequireGlassesRebootForBesFailure,\n  shouldShowChangeWifiForOtaDownloadFailure,\n} from \"./services/OtaErrorMapping\"\n\n// Gallery read models: engine.gallery.onNotice payload types, the media\n// permission helper + display-name derivation host gallery UI uses, and the\n// glasses-camera DTO types (re-exported through the host @/types/asg shim).\nexport type {GalleryNotice, GalleryNoticeCode} from \"./services/asg/galleryNotices\"\nexport {MediaLibraryPermissions} from \"./utils/permissions/MediaLibraryPermissions\"\nexport {deriveGalleryDisplayName} from \"./utils/permissions/galleryDisplayName\"\nexport type {\n  PhotoInfo,\n  CaptureFile,\n  CaptureGroup,\n  GalleryResponse,\n  ServerStatus,\n  HealthResponse,\n  GalleryEvent,\n} from \"./types/asg\"\n\n// Bluetooth SDK event types host UI subscribes to via engine facades (the\n// BluetoothSdk singleton passthrough itself is internal).\nexport type {PairFailureEvent, GlassesNotReadyEvent} from \"@mentra/bluetooth-sdk\"\n\n// Cloud connection status enum (read model; the connection store is internal).\nexport {WebSocketStatus} from \"./stores/connection\"\n\n// App-list hook layer + pure list helpers (the raw useAppStatusStore and\n// installAppStoreHooks wiring are internal).\nexport {\n  DUMMY_APPLET,\n  saveAppsOrder,\n  getAppsOrder,\n  sortAppsByPackageNamePriority,\n  saveLastOpenTime,\n  getLastOpenTime,\n  sortAppsByLastOpenTime,\n  useApps,\n  useStart,\n  useStop,\n  useSetForeground,\n  useClearForeground,\n  useRefresh,\n  useStopAll,\n  useInstall,\n  useUninstall,\n  useActiveApps,\n  useActiveBackgroundApps,\n  useBackgroundApps,\n  useActiveForegroundApp,\n  useForegroundApp,\n  useActiveBackgroundAppsCount,\n  useLocalMiniApps,\n  type StartOptions,\n  type OrderMap,\n} from \"./stores/apps\"\n\n// Pure dev-miniapp launch-route decision (registration itself is internal).\nexport {\n  decideDevLaunchRoute,\n  type DecideDevLaunchOptions,\n  type DevLaunchResult,\n  type DevManifest,\n} from \"./utils/devMiniappLaunch\"\nexport {\n  decideDevOpenRoute,\n  type DevOpenDecision,\n} from \"./utils/devMiniappSnapshot\"\nexport {HardwareCompatibility, type CompatibilityResult} from \"./utils/hardware\"\nexport {BgTimer, throttle, debounce} from \"./utils/timers\"\n\n// Hardware types and capability profiles.\nexport {\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  ControllerTypes,\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  nimo,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./types\"\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n  AppletType,\n  AppPermissionType,\n  AppletPermission,\n  AppletInterface,\n  ClientApp,\n} from \"./types\"\n"]}

package/build/react/MentraLiveOtaFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MentraLiveOtaFlow.d.ts","sourceRoot":"","sources":["../../src/react/MentraLiveOtaFlow.tsx"],"names":[],"mappings":"AACA,OAAO,KAAgB,MAAM,OAAO,CAAA;AACpC,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAA;AAKrB,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAA;AAE7D,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;AAElG,MAAM,MAAM,sBAAsB,GAAG;IACnC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,oGAAoG;IACpG,0BAA0B,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAA;IACnF,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,0BAA0B,CAAA;IACtC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAC7B,CAAA;AA4ED,wBAAgB,iBAAiB,CAAC,EAChC,YAAwD,EACxD,UAA0B,EAC1B,WAAqB,EACrB,iBAAwB,EACxB,UAAU,EACV,0BAA0B,EAC1B,eAAe,EACf,KAAK,EACL,SAAiB,EACjB,KAAK,EACL,SAA4B,GAC7B,EAAE,sBAAsB,qBA0BxB;AAmcD,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,MAAM,EACN,KAAK,GACN,EAAE;IACD,UAAU,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAA;IAC1D,MAAM,EAAE,sBAAsB,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd,4BA8BA"}
+{"version":3,"file":"MentraLiveOtaFlow.d.ts","sourceRoot":"","sources":["../../src/react/MentraLiveOtaFlow.tsx"],"names":[],"mappings":"AACA,OAAO,KAAgB,MAAM,OAAO,CAAA;AACpC,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAA;AAKrB,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAA;AAE7D,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;AAElG,MAAM,MAAM,sBAAsB,GAAG;IACnC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,oGAAoG;IACpG,0BAA0B,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,KAAK,IAAI,CAAA;IACnF,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,0BAA0B,CAAA;IACtC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAC7B,CAAA;AAiFD,wBAAgB,iBAAiB,CAAC,EAChC,YAAwD,EACxD,UAA0B,EAC1B,WAAqB,EACrB,iBAAwB,EACxB,UAAU,EACV,0BAA0B,EAC1B,eAAe,EACf,KAAK,EACL,SAAiB,EACjB,KAAK,EACL,SAA4B,GAC7B,EAAE,sBAAsB,qBA0BxB;AAmdD,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,MAAM,EACN,KAAK,GACN,EAAE;IACD,UAAU,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAA;IAC1D,MAAM,EAAE,sBAAsB,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd,4BA8BA"}

package/build/react/MentraLiveOtaFlow.js

@@ -42,6 +42,9 @@ const ENGLISH_COPY = {
     "ota:upToDate": "Up To Date",
     "ota:devBuild": "Development Build",
     "ota:devBuildNoOta": "This mobile app is a development build, so automatic glasses updates are disabled. Use the developer settings manifest override to update them manually.",
+    "ota:unofficialClient": "Updates Blocked",
+    "ota:unofficialClientNoOta": "Your glasses are running a sideloaded client, so updates are blocked. Restore the stock client to update them.",
+    "ota:unofficialClientNoOtaNamed": "Your glasses are running a sideloaded client ({{packageName}}), so updates are blocked. Restore the stock client to update them.",
     "ota:noUpdatesAvailable": "Your glasses are running the latest version.",
     "ota:checkFailed": "Check Failed",
     "ota:checkFailedMessage": "Couldn't check for updates. Please check your connection and try again.",
@@ -149,6 +152,15 @@ function OtaFlowContent({ allowDevSkip, colors, controller, deviceName, superMod
         <BodyText colors={colors}>{translate("ota:devBuildNoOta")}</BodyText>
       </FlowPage>);
     }
+    if (state.screen === "unofficial_client") {
+        return (<FlowPage actions={<FlowButton colors={colors} label={translate("common:continue")} onPress={controller.finish}/>} colors={colors} icon="settings" title={translate("ota:unofficialClient")}>
+        <BodyText colors={colors}>
+          {state.glassesPackageName
+                ? translate("ota:unofficialClientNoOtaNamed", { packageName: state.glassesPackageName })
+                : translate("ota:unofficialClientNoOta")}
+        </BodyText>
+      </FlowPage>);
+    }
     if (state.screen === "up_to_date") {
         return (<FlowPage actions={<FlowButton colors={colors} label={translate(state.completedUpdate ? "common:done" : "common:continue")} onPress={controller.finish}/>} colors={colors} contentAlignment={state.changelogs.length > 0 ? "top" : "center"} icon="check" title={translate(state.completedUpdate ? "ota:updateComplete" : "ota:upToDate")}>
         <BodyText colors={colors}>{translate("ota:noUpdatesAvailable")}</BodyText>