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

package/src/services/otaManifestPolicy.ts

@@ -0,0 +1,42 @@
+const OTA_VERSION_URL_LEGACY_PROD = "https://ota.mentraglass.com/prod_live_version.json"
+
+function trimmed(value?: string | null): string | null {
+  const result = value?.trim()
+  return result || null
+}
+
+export function isLegacyAsgOtaStartBuild(glassesBuildNumber?: string | null): boolean {
+  const buildNumber = Number.parseInt(glassesBuildNumber ?? "", 10)
+  return Number.isFinite(buildNumber) && buildNumber < 39
+}
+
+export function selectModernOtaManifestPin({
+  developerOverride,
+  hostReleasePin,
+  engineReleasePin,
+}: {
+  developerOverride?: string | null
+  hostReleasePin?: string | null
+  engineReleasePin?: string | null
+}): string | null {
+  return trimmed(developerOverride) || trimmed(hostReleasePin) || trimmed(engineReleasePin)
+}
+
+export function resolveOtaManifestPolicy({
+  glassesUrl,
+  glassesBuildNumber,
+  developerOverride,
+  hostReleasePin,
+  engineReleasePin,
+}: {
+  glassesUrl?: string | null
+  glassesBuildNumber?: string | null
+  developerOverride?: string | null
+  hostReleasePin?: string | null
+  engineReleasePin?: string | null
+}): string | null {
+  if (isLegacyAsgOtaStartBuild(glassesBuildNumber)) {
+    return trimmed(glassesUrl) || OTA_VERSION_URL_LEGACY_PROD
+  }
+  return selectModernOtaManifestPin({developerOverride, hostReleasePin, engineReleasePin})
+}

package/src/services/otaManifestUrl.ts

@@ -1,20 +1,6 @@
-import {sdkPinnedOtaManifestUrl} from "@mentra/bluetooth-sdk/internal"
-
+import {ENGINE_RELEASE_METADATA} from "../generated/releaseMetadata"
 import {SETTINGS, useSettingsStore} from "../stores/settings"
-
-// Legacy production manifest — pre-39 glasses install from this (they ignore ota_start's URL).
-const OTA_VERSION_URL_LEGACY_PROD = "https://ota.mentraglass.com/prod_live_version.json"
-// Modern production fleet manifest (v2). Only a last-resort fallback when the SDK-derived pin
-// URL is somehow unavailable; modern glasses honor ota_start's URL, so this must be the v2
-// artifact, not the legacy v1 rescue manifest.
-const OTA_VERSION_URL_PROD = "https://ota.mentraglass.com/prod_live_version_v2.json"
-
-function isLegacyAsgOtaStartBuild(glassesBuildNumber?: 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
-}
+import {resolveOtaManifestPolicy, selectModernOtaManifestPin} from "./otaManifestPolicy"
 
 function getOtaVersionUrlDevOverride(): string | null {
   // Super mode only: a wrong OTA manifest can brick glasses, so a saved
@@ -27,27 +13,32 @@ function getOtaVersionUrlDevOverride(): string | null {
   return trimmed || null
 }
 
-export function resolveOtaManifestUrl(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_LEGACY_PROD
-  }
+function getHostReleasePin(): string | null {
+  const value = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim()
+  return value || null
+}
 
-  const devOverrideUrl = getOtaVersionUrlDevOverride()
-  if (devOverrideUrl) {
-    return devOverrideUrl
-  }
+function getEmbeddedEngineReleasePin(): string | null {
+  const value = ENGINE_RELEASE_METADATA.otaManifestUrl?.trim()
+  return value || null
+}
 
-  const envUrl = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim()
-  if (envUrl) {
-    return envUrl
-  }
+export function hasConfiguredModernOtaManifestPin(): boolean {
+  return Boolean(
+    selectModernOtaManifestPin({
+      developerOverride: getOtaVersionUrlDevOverride(),
+      hostReleasePin: getHostReleasePin(),
+      engineReleasePin: getEmbeddedEngineReleasePin(),
+    }),
+  )
+}
 
-  // The phone owns manifest selection: modern glasses are driven with the manifest pinned to
-  // this app's Bluetooth SDK version. Modern ASG builds report no manifest URL of their own;
-  // a glasses-reported URL (older modern builds advertising their baked fleet default) is only
-  // a last resort when the SDK version is somehow unavailable.
-  return sdkPinnedOtaManifestUrl() || deviceUrl || OTA_VERSION_URL_PROD
+export function resolveOtaManifestUrl(glassesUrl?: string | null, glassesBuildNumber?: string | null): string | null {
+  return resolveOtaManifestPolicy({
+    glassesUrl,
+    glassesBuildNumber,
+    developerOverride: getOtaVersionUrlDevOverride(),
+    hostReleasePin: getHostReleasePin(),
+    engineReleasePin: getEmbeddedEngineReleasePin(),
+  })
 }

package/src/stores/settings.ts

@@ -994,9 +994,9 @@ export const useSettingsStore = create<SettingsState>()(
         // easy to get backwards. TestFlight and the App Store receive the SAME
         // binary, so promotion does not change EXPO_PUBLIC_BUILD_ENV and this
         // reset never fires on it. Promotion is safe for a different reason:
-        // the publishing lane bakes prod URLs (staging-builds.yml defaults
-        // cloud_env to prod), so a promoted build was pointed at production the
-        // whole time. The same holds for Android internal-track to production.
+        // the publishing lane bakes the selected release cloud environment, and
+        // production promotes the already-tested binary. The same holds for
+        // Android beta-track to production.
         //
         // The residual gap is therefore an override pinned while already on a
         // prod-labelled build, which no label comparison can see. That is a

package/src/types/enums.ts

@@ -1,30 +1,4 @@
-/**
- * @mentra/types - Shared enums for MentraOS
- * These are runtime values (not pure types)
- */
-
-/**
- * Hardware component types that apps can require
- */
-export enum HardwareType {
-  CAMERA = "CAMERA",
-  DISPLAY = "DISPLAY",
-  MICROPHONE = "MICROPHONE",
-  SPEAKER = "SPEAKER",
-  IMU = "IMU",
-  BUTTON = "BUTTON",
-  LIGHT = "LIGHT",
-  WIFI = "WIFI",
-  EXIST = "EXIST",
-}
-
-/**
- * Levels of hardware requirements
- */
-export enum HardwareRequirementLevel {
-  REQUIRED = "REQUIRED", // App cannot function without this hardware
-  OPTIONAL = "OPTIONAL", // App has enhanced features with this hardware
-}
+export {HardwareType, HardwareRequirementLevel} from "@mentra/miniapp/hardware"
 
 export enum DeviceTypes {
   NONE = "None",

package/src/types/hardware.ts

@@ -1,6 +1,4 @@
-/**
- * @mentra/types - Hardware capability types
- */
+/** Hardware capability types used by the Engine. */
 
 import { evenRealitiesG1 } from "./capabilities/even-realities-g1";
 import { evenRealitiesG2 } from "./capabilities/even-realities-g2";
@@ -9,17 +7,9 @@ import { mentraLive } from "./capabilities/mentra-live";
 import { simulatedGlasses } from "./capabilities/simulated-glasses";
 import { vuzixZ100 } from "./capabilities/vuzix-z100";
 import { none } from "./capabilities/none";
-import { DeviceTypes, HardwareRequirementLevel, HardwareType } from "./enums";
+import { DeviceTypes } from "./enums";
 
-/**
- * Hardware requirement for an app
- * Specifies what hardware components an app needs
- */
-export interface HardwareRequirement {
-  type: HardwareType;
-  level: HardwareRequirementLevel;
-  description?: string; // Why this hardware is needed
-}
+export type { HardwareRequirement } from "@mentra/miniapp/hardware";
 
 /**
  * Camera capabilities

package/src/types/index.ts

@@ -1,9 +1,5 @@
-/**
- * Engine shared types — copied verbatim from @mentra/types so the module is
- * self-contained. Keep these in sync with cloud/packages/types/src when the
- * canonical types change. The capability profiles also live here under
- * ./capabilities/.
- */
+/** Engine capability types and profiles. Miniapp manifest requirement types
+ * are re-exported from @mentra/miniapp, their canonical owner. */
 
 // Enums (runtime values)
 export {HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes} from "./enums"

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,67 +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, type MiniappReleaseIdentity, } 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 { resolveOtaManifestUrl } from "./services/otaManifestUrl";
-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 { cameraRollExportCoordinator, type CameraRollExportSummary } from "./services/asg/cameraRollExportCoordinator";
-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,90 +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 { resolveOtaManifestUrl } from "./services/otaManifestUrl";
-// 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 { cameraRollExportCoordinator } from "./services/asg/cameraRollExportCoordinator";
-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  type MiniappReleaseIdentity,\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 {resolveOtaManifestUrl} from \"./services/otaManifestUrl\"\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 {cameraRollExportCoordinator, type CameraRollExportSummary} from \"./services/asg/cameraRollExportCoordinator\"\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/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,160 +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,
-  type MiniappReleaseIdentity,
-} 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 {resolveOtaManifestUrl} from "./services/otaManifestUrl"
-// 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 {cameraRollExportCoordinator, type CameraRollExportSummary} from "./services/asg/cameraRollExportCoordinator"
-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"