@mentra/engine 0.1.0-dev.0 → 3.1.0-dev.10

package/src/utils/timers/timers.ts

@@ -1,6 +1,28 @@
-// until https://github.com/tconns/react-native-nitro-bg-timer/issues/2 is resolved, we need to use this class to disable this package on iOS:
-
-import {Platform} from "react-native"
+// BgTimer — background-safe timers for the engine.
+//
+// Everything timing-critical in the engine runs through this class: the
+// miniapp liveness watchdog, display durationMs expiries, boot windows,
+// auth-token refresh. On Android, React Native PAUSES plain JS timers while
+// the app is backgrounded, so those features only keep working in the
+// background when the native implementation (react-native-nitro-bg-timer)
+// is active.
+//
+// Who actually gets native timers:
+//   - Android, dev AND release: always attempted — dev must match production
+//     background behavior. There is no opt-in/opt-out env var. If the native
+//     module is unavailable (a dev client whose binary predates it, or a
+//     broken release binary), the failure is LOUD: a console.error with the
+//     remediation, plus a blocking dev alert. The JS-timer fallback still
+//     engages so foreground behavior keeps working, but backgrounded
+//     behavior is broken until the native rebuild — the error says exactly
+//     that. (A silent dev fallback previously cost a full debugging day of
+//     phantom "zombie miniapp" bugs; see OS-1790.)
+//   - iOS: never, dev or prod — the package is disabled pending
+//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS
+//     suspends the whole process in background anyway, so background timing
+//     there is handled by native per-device queues, not JS timers.
+
+import {Alert, Platform} from "react-native"
 
 type NitroTimerApi = {
   setInterval: (callback: () => void, delay: number) => number
@@ -11,14 +33,36 @@ type NitroTimerApi = {
 
 let nitroTimer: NitroTimerApi | null | undefined
 let nitroDisabled = false
-let warnedUnavailable = false
-
-function warnUnavailable(reason: string) {
-  if (warnedUnavailable) {
+let failedLoud = false
+
+/**
+ * The native background timer is unavailable — say so ONCE, loudly, with the
+ * remediation. The JS-timer fallback keeps foreground behavior working, but
+ * everything timing-driven freezes while the app is backgrounded, which
+ * presents as phantom miniapp bugs (frozen captions, missed wake words,
+ * watchdog kills on resume). A quiet warning here has already cost a full
+ * debugging day; never downgrade this to console.warn.
+ */
+function failUnavailable(reason: string) {
+  if (failedLoud) {
     return
   }
-  warnedUnavailable = true
-  console.warn(`BgTimer: ${reason}, using JS timers`)
+  failedLoud = true
+  const message =
+    `BgTimer: native background timer unavailable (${reason}). ` +
+    "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
+    "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded."
+  console.error(message)
+  if (__DEV__) {
+    // A stale dev client may ALSO show the library's own require-time red box
+    // (bridgeless LogBox surfaces it even though we catch below) — this alert
+    // is the actionable one: it names the fix.
+    try {
+      Alert.alert("Background timers unavailable", message)
+    } catch {
+      /* Alert not available (tests / headless) — the console.error stands. */
+    }
+  }
 }
 
 function getNitroTimer(): NitroTimerApi | null {
@@ -26,15 +70,6 @@ function getNitroTimer(): NitroTimerApi | null {
     return null
   }
 
-  // react-native-nitro-bg-timer calls createHybridObject() at require() time. On dev
-  // builds with a stale native binary that throws NPE, React Native still surfaces a
-  // red LogBox error even when the exception is caught. Skip nitro in __DEV__ unless
-  // explicitly enabled after a native rebuild (bun android).
-  if (__DEV__ && process.env.EXPO_PUBLIC_USE_NITRO_BG_TIMER !== "true") {
-    warnUnavailable("nitro bg-timer disabled in dev (set EXPO_PUBLIC_USE_NITRO_BG_TIMER=true after native rebuild)")
-    return null
-  }
-
   if (nitroTimer !== undefined) {
     return nitroTimer
   }
@@ -43,7 +78,7 @@ function getNitroTimer(): NitroTimerApi | null {
     const {isRuntimeAlive} = require("react-native-nitro-modules") as {isRuntimeAlive?: () => boolean}
     if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
       nitroTimer = null
-      warnUnavailable("nitro runtime is not alive")
+      failUnavailable("nitro runtime is not alive")
       return nitroTimer
     }
 
@@ -62,7 +97,7 @@ function getNitroTimer(): NitroTimerApi | null {
   }
 
   if (!nitroTimer) {
-    warnUnavailable("react-native-nitro-bg-timer unavailable")
+    failUnavailable("react-native-nitro-bg-timer failed to load")
   }
   return nitroTimer
 }
@@ -77,7 +112,8 @@ function withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {
   } catch (error) {
     nitroDisabled = true
     nitroTimer = null
-    console.warn("BgTimer: nitro timer failed, using JS timers", error)
+    failedLoud = false // a mid-session failure is new information — re-announce
+    failUnavailable(`nitro timer call threw: ${String(error)}`)
     return fallback()
   }
 }

package/build/devtools.d.ts

@@ -1,11 +0,0 @@
-/**
- * `@mentra/engine/devtools` — the devtools-only surface.
- *
- * Debug/diagnostic singletons consumed by the Mentra app's internal dev
- * screens (stress test, miniapp dev-server tooling). Never import this from
- * product UI or host services; every `/devtools` import in mobile/src is
- * counted (report-only) by scripts/check-mobile-runtime-boundary.sh.
- */
-export { miniappRunningRegistry } from "./services/MiniappRunningRegistry";
-export { default as devServerBridge } from "./services/DevServerBridge";
-//# sourceMappingURL=devtools.d.ts.map

package/build/devtools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAC,sBAAsB,EAAC,MAAM,mCAAmC,CAAA;AAExE,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,4BAA4B,CAAA"}

package/build/devtools.js

@@ -1,13 +0,0 @@
-/**
- * `@mentra/engine/devtools` — the devtools-only surface.
- *
- * Debug/diagnostic singletons consumed by the Mentra app's internal dev
- * screens (stress test, miniapp dev-server tooling). Never import this from
- * product UI or host services; every `/devtools` import in mobile/src is
- * counted (report-only) by scripts/check-mobile-runtime-boundary.sh.
- */
-// Which miniapps the local runtime currently has running (stress-test screen).
-export { miniappRunningRegistry } from "./services/MiniappRunningRegistry";
-// Dev-server connection bridge for live-reloading local miniapps.
-export { default as devServerBridge } from "./services/DevServerBridge";
-//# sourceMappingURL=devtools.js.map

package/build/devtools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"devtools.js","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,OAAO,EAAC,sBAAsB,EAAC,MAAM,mCAAmC,CAAA;AACxE,kEAAkE;AAClE,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,4BAA4B,CAAA","sourcesContent":["/**\n * `@mentra/engine/devtools` — the devtools-only surface.\n *\n * Debug/diagnostic singletons consumed by the Mentra app's internal dev\n * screens (stress test, miniapp dev-server tooling). Never import this from\n * product UI or host services; every `/devtools` import in mobile/src is\n * counted (report-only) by scripts/check-mobile-runtime-boundary.sh.\n */\n\n// Which miniapps the local runtime currently has running (stress-test screen).\nexport {miniappRunningRegistry} from \"./services/MiniappRunningRegistry\"\n// Dev-server connection bridge for live-reloading local miniapps.\nexport {default as devServerBridge} from \"./services/DevServerBridge\"\n"]}

package/build/internal.d.ts

@@ -1,66 +0,0 @@
-/**
- * `@mentra/engine/internal` — the migration-era runtime surface.
- *
- * Raw zustand stores and service singletons that the Mentra app's host-side
- * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while
- * the typed `engine` facades grow. Everything here either mutates runtime
- * state or exposes a store/service directly, so none of it belongs on the
- * OEM-facing `@mentra/engine` main entry: new host code should read/act
- * through `engine.*` instead.
- *
- * Every `/internal` import in mobile/src is counted (report-only) by
- * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is
- * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
- * Types that only describe these internal surfaces live here with them;
- * types host UI renders with stay on the main entry.
- */
-export { default as webviewBridge } from "./services/WebviewBridge";
-export { default as appRegistry, normalizeManifestPermissions, normalizeManifestActions, buildHardwareRequirements, saveLocalAppRunningState, registerDevApp, unregisterDevApp, getDevAppRecords, getDevAppSourcePackage, getDevAppAttestation, DEV_APP_PACKAGE_NAME, type DevAppRecord, } from "./services/AppRegistry";
-export { default as displayProcessor } from "./services/DisplayProcessor";
-export { default as localDisplayManager, type DisplayPayload } from "./services/LocalDisplayManager";
-export { default as localMiniappRuntime, type InstalledMiniappManifest } from "./services/LocalMiniappRuntime";
-export { miniappLauncher, type LaunchHints, type LaunchResult, type ResolvedBundle } from "./services/MiniappLauncher";
-export { MentraJSRouter, type MentraJSCrustBinding, type OutboundMessagePayload as MentraJSOutboundMessage, type RouterLogger as MentraJSRouterLogger, } from "./services/MentraJSRouter";
-export { buildMentraUiShim, type MentraUiShimOptions } from "./services/mentraUiShim";
-export { MentraUIRouter, type MentraUICrustBinding } from "./services/MentraUIRouter";
-export { MentraJSCrashController, type CrashState, type CrashOutcome, type CrashControllerOptions, } from "./services/MentraJSCrashController";
-export { ensureMiniappEngine, getMiniappEngine, type MiniappEngine } from "./services/MiniappEngine";
-export { redactSecrets, MentraJSLogThrottle, MentraJSLogRingBuffer, type ThrottleOptions, } from "./services/MentraJSLogPipeline";
-export { buildMiniappGlobalsScript, getCapsuleMenuRect, type BuildMiniappGlobalsOptions, type CapsuleMenuRect, type MiniappColorScheme, type MiniappSafeArea, } from "./utils/miniappGlobals";
-export { default as localSttFallbackCoordinator } from "./services/LocalSttFallbackCoordinator";
-export { default as micStateCoordinator } from "./services/MicStateCoordinator";
-export { default as audioPlaybackService } from "./services/AudioPlaybackService";
-export { default as sttModelManager, STTModelManager, type LanguageInfo as SttLanguageInfo, type LanguageConfig as SttLanguageConfig, type DownloadProgress as SttDownloadProgress, type ExtractionProgress as SttExtractionProgress, } from "./services/STTModelManager";
-export { default as ttsModelManager, TTSModelManager } from "./services/TTSModelManager";
-export { default as offlineSpeechModelService, type DownloadStatus as OfflineModelDownloadStatus, type DownloadStage as OfflineModelDownloadStage, } from "./services/OfflineSpeechModelService";
-export { default as navigationService } from "./services/NavigationService";
-export { phoneLocationService, stopPhoneLocation } from "./services/PhoneLocationService";
-export { fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo } from "./services/glassesClockSync";
-export { getAsgOtaVersionUrl } from "./services/asgOtaVersionUrl";
-export { fetchVersionInfo, checkVersionUpdateAvailable, getLatestVersionInfo, findMatchingMtkPatch, checkBesUpdate, checkForOtaUpdate, checkCurrentGlassesForUpdate, } from "./services/OtaUpdateCheckService";
-export { detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS } from "./services/gallerySyncClock";
-export { gallerySyncService } from "./services/asg/gallerySyncService";
-export { asgCameraApi } from "./services/asg/asgCameraApi";
-export { localStorageService } from "./services/asg/localStorageService";
-export { mediaProcessingQueue } from "./services/asg/mediaProcessingQueue";
-export { gallerySettingsService } from "./services/asg/gallerySettingsService";
-export { INVALID_DOWNLOADED_MEDIA, validateCaptureMetadataForDownload, validateDownloadedMediaFile, } from "./services/asg/galleryMediaValidation";
-export { emitGalleryNotice, onGalleryNotice } from "./services/asg/galleryNotices";
-export { phonePhotoCoordinator } from "./services/PhonePhotoCoordinator";
-export { phoneStreamCoordinator } from "./services/PhoneStreamCoordinator";
-export { useDisplayStore, flushDisplayCoalesceForTests } from "./stores/display";
-export { useCoreStore } from "./stores/core";
-export { useConnectionStore } from "./stores/connection";
-export { useCloudClientStatusStore } from "./stores/cloudClientStatus";
-export type { RuntimeAudioTransport, RuntimeSnapshot, RuntimeStatus } from "./stores/cloudClientStatus";
-export { SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting } from "./stores/settings";
-export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
-export { useAppStatusStore, installAppStoreHooks, type AppStoreHooks } from "./stores/apps";
-export { cloudSecureStore } from "./utils/cloudClient/cloudSecureStore";
-export { cloudClientService } from "./services/CloudClientService";
-export { createCloudUdpSocket } from "./utils/cloudClient/RnUdpAdapter";
-export { logBuffer, type LogEntry } from "./utils/devLogging";
-export { default as BluetoothSdk } from "@mentra/bluetooth-sdk/internal";
-export { storage, printDirectory } from "./utils/storage";
-export { default as GlobalEventEmitter } from "./utils/GlobalEventEmitter";
-//# sourceMappingURL=internal.d.ts.map

package/build/internal.d.ts.map

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

package/build/internal.js

@@ -1,89 +0,0 @@
-/**
- * `@mentra/engine/internal` — the migration-era runtime surface.
- *
- * Raw zustand stores and service singletons that the Mentra app's host-side
- * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while
- * the typed `engine` facades grow. Everything here either mutates runtime
- * state or exposes a store/service directly, so none of it belongs on the
- * OEM-facing `@mentra/engine` main entry: new host code should read/act
- * through `engine.*` instead.
- *
- * Every `/internal` import in mobile/src is counted (report-only) by
- * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is
- * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
- * Types that only describe these internal surfaces live here with them;
- * types host UI renders with stay on the main entry.
- */
-// Miniapp runtime plumbing: WebView bridge, registry, launcher, engine.
-export { default as webviewBridge } from "./services/WebviewBridge";
-export { default as appRegistry, normalizeManifestPermissions, normalizeManifestActions, buildHardwareRequirements, saveLocalAppRunningState, registerDevApp, unregisterDevApp, getDevAppRecords, getDevAppSourcePackage, getDevAppAttestation, DEV_APP_PACKAGE_NAME, } from "./services/AppRegistry";
-export { default as displayProcessor } from "./services/DisplayProcessor";
-export { default as localDisplayManager } from "./services/LocalDisplayManager";
-export { default as localMiniappRuntime } from "./services/LocalMiniappRuntime";
-export { miniappLauncher } from "./services/MiniappLauncher";
-export { MentraJSRouter, } from "./services/MentraJSRouter";
-export { buildMentraUiShim } from "./services/mentraUiShim";
-export { MentraUIRouter } from "./services/MentraUIRouter";
-export { MentraJSCrashController, } from "./services/MentraJSCrashController";
-export { ensureMiniappEngine, getMiniappEngine } from "./services/MiniappEngine";
-export { redactSecrets, MentraJSLogThrottle, MentraJSLogRingBuffer, } from "./services/MentraJSLogPipeline";
-// WebView-injection script builders (miniapp globals + mentra-ui shim).
-export { buildMiniappGlobalsScript, getCapsuleMenuRect, } from "./utils/miniappGlobals";
-// Speech/audio coordinators and model managers.
-export { default as localSttFallbackCoordinator } from "./services/LocalSttFallbackCoordinator";
-export { default as micStateCoordinator } from "./services/MicStateCoordinator";
-export { default as audioPlaybackService } from "./services/AudioPlaybackService";
-export { default as sttModelManager, STTModelManager, } from "./services/STTModelManager";
-export { default as ttsModelManager, TTSModelManager } from "./services/TTSModelManager";
-export { default as offlineSpeechModelService, } from "./services/OfflineSpeechModelService";
-export { default as navigationService } from "./services/NavigationService";
-// Phone GPS — the background location task + tier control. Importing this
-// module registers the background task, so the entry that MantleManager loads
-// must keep re-exporting it (was: the main barrel).
-export { phoneLocationService, stopPhoneLocation } from "./services/PhoneLocationService";
-// Clock-skew fix commands (BLE writes) used by OTA + gallery sync.
-export { fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo } from "./services/glassesClockSync";
-// OTA manifest-URL resolution (dev-override/legacy-build/env/prod).
-export { getAsgOtaVersionUrl } from "./services/asgOtaVersionUrl";
-// Flat OTA check helpers (network + BLE state). Host usage is a tracked
-// burn-down surface (§F); the sanctioned path is engine.ota.checkForUpdates().
-export { fetchVersionInfo, checkVersionUpdateAvailable, getLatestVersionInfo, findMatchingMtkPatch, checkBesUpdate, checkForOtaUpdate, checkCurrentGlassesForUpdate, } from "./services/OtaUpdateCheckService";
-// Gallery cluster — sync orchestrator, glasses-camera HTTP API, media/storage,
-// settings, validation and the service-to-service notice bus. Host gallery UI
-// renders engine.gallery; these are the underlying services.
-export { detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS } from "./services/gallerySyncClock";
-export { gallerySyncService } from "./services/asg/gallerySyncService";
-export { asgCameraApi } from "./services/asg/asgCameraApi";
-export { localStorageService } from "./services/asg/localStorageService";
-export { mediaProcessingQueue } from "./services/asg/mediaProcessingQueue";
-export { gallerySettingsService } from "./services/asg/gallerySettingsService";
-export { INVALID_DOWNLOADED_MEDIA, validateCaptureMetadataForDownload, validateDownloadedMediaFile, } from "./services/asg/galleryMediaValidation";
-export { emitGalleryNotice, onGalleryNotice } from "./services/asg/galleryNotices";
-// Phone-side capture coordinators.
-export { phonePhotoCoordinator } from "./services/PhonePhotoCoordinator";
-export { phoneStreamCoordinator } from "./services/PhoneStreamCoordinator";
-// Raw runtime stores (re-exported via the host @/stores/* shims). Read models
-// live on the engine facades; these are the migration escape hatch.
-export { useDisplayStore, flushDisplayCoalesceForTests } from "./stores/display";
-export { useCoreStore } from "./stores/core";
-export { useConnectionStore } from "./stores/connection";
-export { useCloudClientStatusStore } from "./stores/cloudClientStatus";
-export { SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting } from "./stores/settings";
-export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
-export { useAppStatusStore, installAppStoreHooks } from "./stores/apps";
-// Cloud client + credentials + v1 comms.
-export { cloudSecureStore } from "./utils/cloudClient/cloudSecureStore";
-export { cloudClientService } from "./services/CloudClientService";
-export { createCloudUdpSocket } from "./utils/cloudClient/RnUdpAdapter";
-// Log ring buffer + console interception (bug-report attachments).
-export { logBuffer } from "./utils/devLogging";
-// Bluetooth SDK internal compatibility passthrough. Prefer an engine facade
-// when one exists; this remains an escape hatch for app-only compatibility
-// needs (its event TYPES stay on the main entry).
-export { default as BluetoothSdk } from "@mentra/bluetooth-sdk/internal";
-// Engine-owned MMKV instance + debug helper.
-export { storage, printDirectory } from "./utils/storage";
-// Process-wide event bus — one shared instance for engine services + host
-// (re-exported via the @/utils/GlobalEventEmitter shim).
-export { default as GlobalEventEmitter } from "./utils/GlobalEventEmitter";
-//# sourceMappingURL=internal.js.map

package/build/internal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `@mentra/engine/internal` — the migration-era runtime surface.\n *\n * Raw zustand stores and service singletons that the Mentra app's host-side\n * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while\n * the typed `engine` facades grow. Everything here either mutates runtime\n * state or exposes a store/service directly, so none of it belongs on the\n * OEM-facing `@mentra/engine` main entry: new host code should read/act\n * through `engine.*` instead.\n *\n * Every `/internal` import in mobile/src is counted (report-only) by\n * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is\n * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n * Types that only describe these internal surfaces live here with them;\n * types host UI renders with stay on the main entry.\n */\n\n// Miniapp runtime plumbing: WebView bridge, registry, launcher, engine.\nexport {default as webviewBridge} from \"./services/WebviewBridge\"\nexport {\n  default as appRegistry,\n  normalizeManifestPermissions,\n  normalizeManifestActions,\n  buildHardwareRequirements,\n  saveLocalAppRunningState,\n  registerDevApp,\n  unregisterDevApp,\n  getDevAppRecords,\n  getDevAppSourcePackage,\n  getDevAppAttestation,\n  DEV_APP_PACKAGE_NAME,\n  type DevAppRecord,\n} from \"./services/AppRegistry\"\nexport {default as displayProcessor} from \"./services/DisplayProcessor\"\nexport {default as localDisplayManager, type DisplayPayload} from \"./services/LocalDisplayManager\"\nexport {default as localMiniappRuntime, type InstalledMiniappManifest} from \"./services/LocalMiniappRuntime\"\nexport {miniappLauncher, type LaunchHints, type LaunchResult, type ResolvedBundle} from \"./services/MiniappLauncher\"\nexport {\n  MentraJSRouter,\n  type MentraJSCrustBinding,\n  type OutboundMessagePayload as MentraJSOutboundMessage,\n  type RouterLogger as MentraJSRouterLogger,\n} from \"./services/MentraJSRouter\"\nexport {buildMentraUiShim, type MentraUiShimOptions} from \"./services/mentraUiShim\"\nexport {MentraUIRouter, type MentraUICrustBinding} from \"./services/MentraUIRouter\"\nexport {\n  MentraJSCrashController,\n  type CrashState,\n  type CrashOutcome,\n  type CrashControllerOptions,\n} from \"./services/MentraJSCrashController\"\nexport {ensureMiniappEngine, getMiniappEngine, type MiniappEngine} from \"./services/MiniappEngine\"\nexport {\n  redactSecrets,\n  MentraJSLogThrottle,\n  MentraJSLogRingBuffer,\n  type ThrottleOptions,\n} from \"./services/MentraJSLogPipeline\"\n// WebView-injection script builders (miniapp globals + mentra-ui shim).\nexport {\n  buildMiniappGlobalsScript,\n  getCapsuleMenuRect,\n  type BuildMiniappGlobalsOptions,\n  type CapsuleMenuRect,\n  type MiniappColorScheme,\n  type MiniappSafeArea,\n} from \"./utils/miniappGlobals\"\n\n// Speech/audio coordinators and model managers.\nexport {default as localSttFallbackCoordinator} from \"./services/LocalSttFallbackCoordinator\"\nexport {default as micStateCoordinator} from \"./services/MicStateCoordinator\"\nexport {default as audioPlaybackService} from \"./services/AudioPlaybackService\"\nexport {\n  default as sttModelManager,\n  STTModelManager,\n  type LanguageInfo as SttLanguageInfo,\n  type LanguageConfig as SttLanguageConfig,\n  type DownloadProgress as SttDownloadProgress,\n  type ExtractionProgress as SttExtractionProgress,\n} from \"./services/STTModelManager\"\nexport {default as ttsModelManager, TTSModelManager} from \"./services/TTSModelManager\"\nexport {\n  default as offlineSpeechModelService,\n  type DownloadStatus as OfflineModelDownloadStatus,\n  type DownloadStage as OfflineModelDownloadStage,\n} from \"./services/OfflineSpeechModelService\"\n\nexport {default as navigationService} from \"./services/NavigationService\"\n// Phone GPS — the background location task + tier control. Importing this\n// module registers the background task, so the entry that MantleManager loads\n// must keep re-exporting it (was: the main barrel).\nexport {phoneLocationService, stopPhoneLocation} from \"./services/PhoneLocationService\"\n// Clock-skew fix commands (BLE writes) used by OTA + gallery sync.\nexport {fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo} from \"./services/glassesClockSync\"\n// OTA manifest-URL resolution (dev-override/legacy-build/env/prod).\nexport {getAsgOtaVersionUrl} from \"./services/asgOtaVersionUrl\"\n// Flat OTA check helpers (network + BLE state). Host usage is a tracked\n// burn-down surface (§F); the sanctioned path is engine.ota.checkForUpdates().\nexport {\n  fetchVersionInfo,\n  checkVersionUpdateAvailable,\n  getLatestVersionInfo,\n  findMatchingMtkPatch,\n  checkBesUpdate,\n  checkForOtaUpdate,\n  checkCurrentGlassesForUpdate,\n} from \"./services/OtaUpdateCheckService\"\n\n// Gallery cluster — sync orchestrator, glasses-camera HTTP API, media/storage,\n// settings, validation and the service-to-service notice bus. Host gallery UI\n// renders engine.gallery; these are the underlying services.\nexport {detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS} from \"./services/gallerySyncClock\"\nexport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nexport {asgCameraApi} from \"./services/asg/asgCameraApi\"\nexport {localStorageService} from \"./services/asg/localStorageService\"\nexport {mediaProcessingQueue} from \"./services/asg/mediaProcessingQueue\"\nexport {gallerySettingsService} from \"./services/asg/gallerySettingsService\"\nexport {\n  INVALID_DOWNLOADED_MEDIA,\n  validateCaptureMetadataForDownload,\n  validateDownloadedMediaFile,\n} from \"./services/asg/galleryMediaValidation\"\nexport {emitGalleryNotice, onGalleryNotice} from \"./services/asg/galleryNotices\"\n\n// Phone-side capture coordinators.\nexport {phonePhotoCoordinator} from \"./services/PhonePhotoCoordinator\"\nexport {phoneStreamCoordinator} from \"./services/PhoneStreamCoordinator\"\n\n// Raw runtime stores (re-exported via the host @/stores/* shims). Read models\n// live on the engine facades; these are the migration escape hatch.\nexport {useDisplayStore, flushDisplayCoalesceForTests} from \"./stores/display\"\nexport {useCoreStore} from \"./stores/core\"\nexport {useConnectionStore} from \"./stores/connection\"\nexport {useCloudClientStatusStore} from \"./stores/cloudClientStatus\"\nexport type {RuntimeAudioTransport, RuntimeSnapshot, RuntimeStatus} from \"./stores/cloudClientStatus\"\nexport {SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting} from \"./stores/settings\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\nexport {useAppStatusStore, installAppStoreHooks, type AppStoreHooks} from \"./stores/apps\"\n\n// Cloud client + credentials + v1 comms.\nexport {cloudSecureStore} from \"./utils/cloudClient/cloudSecureStore\"\nexport {cloudClientService} from \"./services/CloudClientService\"\nexport {createCloudUdpSocket} from \"./utils/cloudClient/RnUdpAdapter\"\n\n// Log ring buffer + console interception (bug-report attachments).\nexport {logBuffer, type LogEntry} from \"./utils/devLogging\"\n\n// Bluetooth SDK internal compatibility passthrough. Prefer an engine facade\n// when one exists; this remains an escape hatch for app-only compatibility\n// needs (its event TYPES stay on the main entry).\nexport {default as BluetoothSdk} from \"@mentra/bluetooth-sdk/internal\"\n\n\n// Engine-owned MMKV instance + debug helper.\nexport {storage, printDirectory} from \"./utils/storage\"\n// Process-wide event bus — one shared instance for engine services + host\n// (re-exported via the @/utils/GlobalEventEmitter shim).\nexport {default as GlobalEventEmitter} from \"./utils/GlobalEventEmitter\"\n"]}

package/build/services/asgOtaVersionUrl.d.ts

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

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

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

package/build/services/asgOtaVersionUrl.js

@@ -1,36 +0,0 @@
-import { SETTINGS, useSettingsStore } from "../stores/settings";
-const OTA_VERSION_URL_PROD = "https://ota.mentraglass.com/prod_live_version.json";
-function isLegacyAsgOtaStartBuild(glassesBuildNumber) {
-    const buildNumber = Number.parseInt(glassesBuildNumber ?? "", 10);
-    // ASG builds before 39 ignore ota_start.ota_version_url, so compare against
-    // the URL they will actually use.
-    return Number.isFinite(buildNumber) && buildNumber < 39;
-}
-function getOtaVersionUrlDevOverride() {
-    // Super mode only: a wrong OTA manifest can brick glasses, so a saved
-    // override is inert unless super mode is currently enabled.
-    if (!useSettingsStore.getState().getSetting(SETTINGS.super_mode.key)) {
-        return null;
-    }
-    const value = useSettingsStore.getState().getSetting(SETTINGS.ota_version_url.key);
-    const trimmed = typeof value === "string" ? value.trim() : "";
-    return trimmed || null;
-}
-export function getAsgOtaVersionUrl(glassesUrl, glassesBuildNumber) {
-    const deviceUrl = glassesUrl?.trim();
-    if (isLegacyAsgOtaStartBuild(glassesBuildNumber)) {
-        // Legacy glasses ignore ota_start.ota_version_url and install from their
-        // compiled default, so the developer override does not apply to them either.
-        return deviceUrl || OTA_VERSION_URL_PROD;
-    }
-    const devOverrideUrl = getOtaVersionUrlDevOverride();
-    if (devOverrideUrl) {
-        return devOverrideUrl;
-    }
-    const envUrl = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim();
-    if (envUrl) {
-        return envUrl;
-    }
-    return deviceUrl || OTA_VERSION_URL_PROD;
-}
-//# sourceMappingURL=asgOtaVersionUrl.js.map

package/build/services/asgOtaVersionUrl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asgOtaVersionUrl.js","sourceRoot":"","sources":["../../src/services/asgOtaVersionUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,gBAAgB,EAAC,MAAM,oBAAoB,CAAA;AAE7D,MAAM,oBAAoB,GAAG,oDAAoD,CAAA;AAEjF,SAAS,wBAAwB,CAAC,kBAAkC;IAClE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;IACjE,4EAA4E;IAC5E,kCAAkC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,2BAA2B;IAClC,sEAAsE;IACtE,4DAA4D;IAC5D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IAClF,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,OAAO,OAAO,IAAI,IAAI,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAA0B,EAAE,kBAAkC;IAChG,MAAM,SAAS,GAAG,UAAU,EAAE,IAAI,EAAE,CAAA;IACpC,IAAI,wBAAwB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACjD,yEAAyE;QACzE,6EAA6E;QAC7E,OAAO,SAAS,IAAI,oBAAoB,CAAA;IAC1C,CAAC;IAED,MAAM,cAAc,GAAG,2BAA2B,EAAE,CAAA;IACpD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,EAAE,CAAA;IAClE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,SAAS,IAAI,oBAAoB,CAAA;AAC1C,CAAC","sourcesContent":["import {SETTINGS, useSettingsStore} from \"../stores/settings\"\n\nconst OTA_VERSION_URL_PROD = \"https://ota.mentraglass.com/prod_live_version.json\"\n\nfunction isLegacyAsgOtaStartBuild(glassesBuildNumber?: string | null): boolean {\n  const buildNumber = Number.parseInt(glassesBuildNumber ?? \"\", 10)\n  // ASG builds before 39 ignore ota_start.ota_version_url, so compare against\n  // the URL they will actually use.\n  return Number.isFinite(buildNumber) && buildNumber < 39\n}\n\nfunction getOtaVersionUrlDevOverride(): string | null {\n  // Super mode only: a wrong OTA manifest can brick glasses, so a saved\n  // override is inert unless super mode is currently enabled.\n  if (!useSettingsStore.getState().getSetting(SETTINGS.super_mode.key)) {\n    return null\n  }\n  const value = useSettingsStore.getState().getSetting(SETTINGS.ota_version_url.key)\n  const trimmed = typeof value === \"string\" ? value.trim() : \"\"\n  return trimmed || null\n}\n\nexport function getAsgOtaVersionUrl(glassesUrl?: string | null, glassesBuildNumber?: string | null): string {\n  const deviceUrl = glassesUrl?.trim()\n  if (isLegacyAsgOtaStartBuild(glassesBuildNumber)) {\n    // Legacy glasses ignore ota_start.ota_version_url and install from their\n    // compiled default, so the developer override does not apply to them either.\n    return deviceUrl || OTA_VERSION_URL_PROD\n  }\n\n  const devOverrideUrl = getOtaVersionUrlDevOverride()\n  if (devOverrideUrl) {\n    return devOverrideUrl\n  }\n\n  const envUrl = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim()\n  if (envUrl) {\n    return envUrl\n  }\n  return deviceUrl || OTA_VERSION_URL_PROD\n}\n"]}

package/src/devtools.ts

@@ -1,13 +0,0 @@
-/**
- * `@mentra/engine/devtools` — the devtools-only surface.
- *
- * Debug/diagnostic singletons consumed by the Mentra app's internal dev
- * screens (stress test, miniapp dev-server tooling). Never import this from
- * product UI or host services; every `/devtools` import in mobile/src is
- * counted (report-only) by scripts/check-mobile-runtime-boundary.sh.
- */
-
-// Which miniapps the local runtime currently has running (stress-test screen).
-export {miniappRunningRegistry} from "./services/MiniappRunningRegistry"
-// Dev-server connection bridge for live-reloading local miniapps.
-export {default as devServerBridge} from "./services/DevServerBridge"

package/src/internal.ts

@@ -1,158 +0,0 @@
-/**
- * `@mentra/engine/internal` — the migration-era runtime surface.
- *
- * Raw zustand stores and service singletons that the Mentra app's host-side
- * services (and the `@/stores/*` / `@/utils/*` shims) still reach into while
- * the typed `engine` facades grow. Everything here either mutates runtime
- * state or exposes a store/service directly, so none of it belongs on the
- * OEM-facing `@mentra/engine` main entry: new host code should read/act
- * through `engine.*` instead.
- *
- * Every `/internal` import in mobile/src is counted (report-only) by
- * scripts/check-mobile-runtime-boundary.sh; the burn-down plan is
- * cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
- * Types that only describe these internal surfaces live here with them;
- * types host UI renders with stay on the main entry.
- */
-
-// Miniapp runtime plumbing: WebView bridge, registry, launcher, engine.
-export {default as webviewBridge} from "./services/WebviewBridge"
-export {
-  default as appRegistry,
-  normalizeManifestPermissions,
-  normalizeManifestActions,
-  buildHardwareRequirements,
-  saveLocalAppRunningState,
-  registerDevApp,
-  unregisterDevApp,
-  getDevAppRecords,
-  getDevAppSourcePackage,
-  getDevAppAttestation,
-  DEV_APP_PACKAGE_NAME,
-  type DevAppRecord,
-} from "./services/AppRegistry"
-export {default as displayProcessor} from "./services/DisplayProcessor"
-export {default as localDisplayManager, type DisplayPayload} from "./services/LocalDisplayManager"
-export {default as localMiniappRuntime, type InstalledMiniappManifest} from "./services/LocalMiniappRuntime"
-export {miniappLauncher, type LaunchHints, type LaunchResult, type ResolvedBundle} from "./services/MiniappLauncher"
-export {
-  MentraJSRouter,
-  type MentraJSCrustBinding,
-  type OutboundMessagePayload as MentraJSOutboundMessage,
-  type RouterLogger as MentraJSRouterLogger,
-} from "./services/MentraJSRouter"
-export {buildMentraUiShim, type MentraUiShimOptions} from "./services/mentraUiShim"
-export {MentraUIRouter, type MentraUICrustBinding} from "./services/MentraUIRouter"
-export {
-  MentraJSCrashController,
-  type CrashState,
-  type CrashOutcome,
-  type CrashControllerOptions,
-} from "./services/MentraJSCrashController"
-export {ensureMiniappEngine, getMiniappEngine, type MiniappEngine} from "./services/MiniappEngine"
-export {
-  redactSecrets,
-  MentraJSLogThrottle,
-  MentraJSLogRingBuffer,
-  type ThrottleOptions,
-} from "./services/MentraJSLogPipeline"
-// WebView-injection script builders (miniapp globals + mentra-ui shim).
-export {
-  buildMiniappGlobalsScript,
-  getCapsuleMenuRect,
-  type BuildMiniappGlobalsOptions,
-  type CapsuleMenuRect,
-  type MiniappColorScheme,
-  type MiniappSafeArea,
-} from "./utils/miniappGlobals"
-
-// Speech/audio coordinators and model managers.
-export {default as localSttFallbackCoordinator} from "./services/LocalSttFallbackCoordinator"
-export {default as micStateCoordinator} from "./services/MicStateCoordinator"
-export {default as audioPlaybackService} from "./services/AudioPlaybackService"
-export {
-  default as sttModelManager,
-  STTModelManager,
-  type LanguageInfo as SttLanguageInfo,
-  type LanguageConfig as SttLanguageConfig,
-  type DownloadProgress as SttDownloadProgress,
-  type ExtractionProgress as SttExtractionProgress,
-} from "./services/STTModelManager"
-export {default as ttsModelManager, TTSModelManager} from "./services/TTSModelManager"
-export {
-  default as offlineSpeechModelService,
-  type DownloadStatus as OfflineModelDownloadStatus,
-  type DownloadStage as OfflineModelDownloadStage,
-} from "./services/OfflineSpeechModelService"
-
-export {default as navigationService} from "./services/NavigationService"
-// Phone GPS — the background location task + tier control. Importing this
-// module registers the background task, so the entry that MantleManager loads
-// must keep re-exporting it (was: the main barrel).
-export {phoneLocationService, stopPhoneLocation} from "./services/PhoneLocationService"
-// Clock-skew fix commands (BLE writes) used by OTA + gallery sync.
-export {fixGlassesClockIfSkewed, maybeFixGlassesClockFromVersionInfo} from "./services/glassesClockSync"
-// OTA manifest-URL resolution (dev-override/legacy-build/env/prod).
-export {getAsgOtaVersionUrl} from "./services/asgOtaVersionUrl"
-// Flat OTA check helpers (network + BLE state). Host usage is a tracked
-// burn-down surface (§F); the sanctioned path is engine.ota.checkForUpdates().
-export {
-  fetchVersionInfo,
-  checkVersionUpdateAvailable,
-  getLatestVersionInfo,
-  findMatchingMtkPatch,
-  checkBesUpdate,
-  checkForOtaUpdate,
-  checkCurrentGlassesForUpdate,
-} from "./services/OtaUpdateCheckService"
-
-// Gallery cluster — sync orchestrator, glasses-camera HTTP API, media/storage,
-// settings, validation and the service-to-service notice bus. Host gallery UI
-// renders engine.gallery; these are the underlying services.
-export {detectClockSkew, isSyncManifestEmpty, CLOCK_SKEW_TOLERANCE_MS} from "./services/gallerySyncClock"
-export {gallerySyncService} from "./services/asg/gallerySyncService"
-export {asgCameraApi} from "./services/asg/asgCameraApi"
-export {localStorageService} from "./services/asg/localStorageService"
-export {mediaProcessingQueue} from "./services/asg/mediaProcessingQueue"
-export {gallerySettingsService} from "./services/asg/gallerySettingsService"
-export {
-  INVALID_DOWNLOADED_MEDIA,
-  validateCaptureMetadataForDownload,
-  validateDownloadedMediaFile,
-} from "./services/asg/galleryMediaValidation"
-export {emitGalleryNotice, onGalleryNotice} from "./services/asg/galleryNotices"
-
-// Phone-side capture coordinators.
-export {phonePhotoCoordinator} from "./services/PhonePhotoCoordinator"
-export {phoneStreamCoordinator} from "./services/PhoneStreamCoordinator"
-
-// Raw runtime stores (re-exported via the host @/stores/* shims). Read models
-// live on the engine facades; these are the migration escape hatch.
-export {useDisplayStore, flushDisplayCoalesceForTests} from "./stores/display"
-export {useCoreStore} from "./stores/core"
-export {useConnectionStore} from "./stores/connection"
-export {useCloudClientStatusStore} from "./stores/cloudClientStatus"
-export type {RuntimeAudioTransport, RuntimeSnapshot, RuntimeStatus} from "./stores/cloudClientStatus"
-export {SETTINGS, OFFLINE_APPLETS, useSettingsStore, useSetting} from "./stores/settings"
-export {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from "./stores/bluetoothSettingKeys"
-export {useAppStatusStore, installAppStoreHooks, type AppStoreHooks} from "./stores/apps"
-
-// Cloud client + credentials + v1 comms.
-export {cloudSecureStore} from "./utils/cloudClient/cloudSecureStore"
-export {cloudClientService} from "./services/CloudClientService"
-export {createCloudUdpSocket} from "./utils/cloudClient/RnUdpAdapter"
-
-// Log ring buffer + console interception (bug-report attachments).
-export {logBuffer, type LogEntry} from "./utils/devLogging"
-
-// Bluetooth SDK internal compatibility passthrough. Prefer an engine facade
-// when one exists; this remains an escape hatch for app-only compatibility
-// needs (its event TYPES stay on the main entry).
-export {default as BluetoothSdk} from "@mentra/bluetooth-sdk/internal"
-
-
-// Engine-owned MMKV instance + debug helper.
-export {storage, printDirectory} from "./utils/storage"
-// Process-wide event bus — one shared instance for engine services + host
-// (re-exported via the @/utils/GlobalEventEmitter shim).
-export {default as GlobalEventEmitter} from "./utils/GlobalEventEmitter"

package/src/services/asgOtaVersionUrl.ts

@@ -1,41 +0,0 @@
-import {SETTINGS, useSettingsStore} from "../stores/settings"
-
-const OTA_VERSION_URL_PROD = "https://ota.mentraglass.com/prod_live_version.json"
-
-function isLegacyAsgOtaStartBuild(glassesBuildNumber?: string | null): boolean {
-  const buildNumber = Number.parseInt(glassesBuildNumber ?? "", 10)
-  // ASG builds before 39 ignore ota_start.ota_version_url, so compare against
-  // the URL they will actually use.
-  return Number.isFinite(buildNumber) && buildNumber < 39
-}
-
-function getOtaVersionUrlDevOverride(): string | null {
-  // Super mode only: a wrong OTA manifest can brick glasses, so a saved
-  // override is inert unless super mode is currently enabled.
-  if (!useSettingsStore.getState().getSetting(SETTINGS.super_mode.key)) {
-    return null
-  }
-  const value = useSettingsStore.getState().getSetting(SETTINGS.ota_version_url.key)
-  const trimmed = typeof value === "string" ? value.trim() : ""
-  return trimmed || null
-}
-
-export function getAsgOtaVersionUrl(glassesUrl?: string | null, glassesBuildNumber?: string | null): string {
-  const deviceUrl = glassesUrl?.trim()
-  if (isLegacyAsgOtaStartBuild(glassesBuildNumber)) {
-    // Legacy glasses ignore ota_start.ota_version_url and install from their
-    // compiled default, so the developer override does not apply to them either.
-    return deviceUrl || OTA_VERSION_URL_PROD
-  }
-
-  const devOverrideUrl = getOtaVersionUrlDevOverride()
-  if (devOverrideUrl) {
-    return devOverrideUrl
-  }
-
-  const envUrl = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim()
-  if (envUrl) {
-    return envUrl
-  }
-  return deviceUrl || OTA_VERSION_URL_PROD
-}