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

package/src/facades/speech.ts

@@ -7,24 +7,38 @@
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
 import sttModelManager from "../services/STTModelManager"
 import ttsModelManager from "../services/TTSModelManager"
-import offlineSpeechModelService from "../services/OfflineSpeechModelService"
+import offlineSpeechModelService, {
+  type DownloadStatus as OfflineModelDownloadStatus,
+} from "../services/OfflineSpeechModelService"
+import type {
+  DownloadProgress as SttDownloadProgress,
+  ExtractionProgress as SttExtractionProgress,
+  LanguageConfig as SttLanguageConfig,
+  LanguageInfo as SttLanguageInfo,
+} from "../services/STTModelManager"
 
 export const speech = {
   /** Restart the glasses' on-device transcriber (e.g. after switching STT language). */
   restartTranscriber: (): Promise<void> => BluetoothSdk.restartTranscriber(),
   stt: {
     currentLanguage: () => sttModelManager.getCurrentLanguage(),
-    languages: () => sttModelManager.getAvailableLanguages(),
-    languageInfo: () => sttModelManager.getAllLanguageInfo(),
-    download: (...args: Parameters<typeof sttModelManager.downloadModel>) => sttModelManager.downloadModel(...args),
+    languages: (): SttLanguageConfig[] => sttModelManager.getAvailableLanguages(),
+    languageInfo: (): Promise<SttLanguageInfo[]> => sttModelManager.getAllLanguageInfo(),
+    download: (
+      ...args: [
+        code?: string,
+        onProgress?: (progress: SttDownloadProgress) => void,
+        onExtractionProgress?: (progress: SttExtractionProgress) => void,
+      ]
+    ): Promise<void> => sttModelManager.downloadModel(...args),
     activate: (code: string) => sttModelManager.setCurrentLanguage(code),
     cancelDownload: () => sttModelManager.cancelDownload(),
     deleteModel: (...args: Parameters<typeof sttModelManager.deleteModel>) => sttModelManager.deleteModel(...args),
     /** Current auto-download status of the offline STT model. */
-    status: () => offlineSpeechModelService.getStatus(),
+    status: (): OfflineModelDownloadStatus | null => offlineSpeechModelService.getStatus(),
     /** Subscribe to auto-download status changes; returns an unsubscribe. */
-    onStatusChanged: (...args: Parameters<typeof offlineSpeechModelService.subscribe>) =>
-      offlineSpeechModelService.subscribe(...args),
+    onStatusChanged: (listener: (status: OfflineModelDownloadStatus | null) => void): (() => void) =>
+      offlineSpeechModelService.subscribe(listener),
   },
   tts: {
     currentLanguage: () => ttsModelManager.getCurrentLanguage(),

package/src/generated/releaseMetadata.ts

@@ -0,0 +1,20 @@
+/** Generated by release CI. Do not edit in a release checkout. */
+export interface EngineReleaseMetadata {
+  schemaVersion: 1
+  familyBaseVersion: string | null
+  releaseIdentity: string | null
+  releaseSetId: string | null
+  sourceCommit: string | null
+  otaManifestUrl: string | null
+  otaManifestSha256: string | null
+}
+
+export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
+  "schemaVersion": 1,
+  "familyBaseVersion": "3.1.0",
+  "releaseIdentity": "3.1.0-dev.10",
+  "releaseSetId": "mentra-3.1.0-dev.10",
+  "sourceCommit": "64cf83b23a71e70261571a5f4401d1a7538f1852",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.10/mentra-live-ota-3.1.0-dev.10.json",
+  "otaManifestSha256": "214d92c8894033eaab276e668cb553c79990005d3330d23aaf499a514dc08cff"
+})

package/src/index.ts

@@ -6,8 +6,7 @@
  * renders with (decision functions, sort/order helpers, policy constants,
  * capability tables, timers). Judgment rule: read models, commands, pure
  * functions and types belong here; anything that mutates runtime state or
- * exposes a raw store/service lives on `@mentra/engine/internal`
- * (migration-era surface) or `@mentra/engine/devtools` (debug-only) instead.
+ * exposes a raw store/service remains private to the MentraOS host.
  * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
  */
 
@@ -32,6 +31,8 @@ export type {
   IslandConfigValues,
   IslandAnalytics,
   IslandUiSeams,
+  ScanQrOptions,
+  ScanQrResult,
   SubjectTokenType,
 } from "./runtime/bootstrap"
 
@@ -45,12 +46,7 @@ export {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from "./stor
 
 // Runtime-shared constants and contract DTOs.
 export {ISLAND_SETTINGS_KEYS} from "./runtime/config"
-export type {
-  CloudClientStatusSnapshot,
-  MiniappAuthToken,
-  InteropAuditEvent,
-  TtsSynthesisResult,
-} from "./runtime/config"
+export type {CloudClientStatusSnapshot, MiniappAuthToken, InteropAuditEvent, TtsSynthesisResult} from "./runtime/config"
 
 // Pure readiness predicates over glasses connection state.
 export {
@@ -91,7 +87,6 @@ export {
   DOWNLOAD_STUCK_TIMEOUT_MS,
   MTK_INSTALL_TIMEOUT_MS,
   GLOBAL_OTA_TIMEOUT_MS,
-  POST_APK_OTA_START_DELAY_MS,
   PING_INTERVAL_MS,
   QUERY_REPLY_TIMEOUT_MS,
   OtaProgressMessages,
@@ -106,6 +101,24 @@ export type {
   OtaSnapshot,
   OtaInstallSnapshot,
 } from "./facades/ota"
+export {
+  beginOtaAutoChain,
+  clearOtaAutoChainReconnectWait,
+  isOtaAutoChainActive,
+  otaAutoChainFingerprint,
+  otaAutoChainReconnectWaitRemaining,
+  stopOtaAutoChain,
+  tryAdvanceOtaAutoChain,
+  MAX_OTA_AUTO_CHAIN_PASSES,
+  OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS,
+} from "./services/OtaAutoChain"
+export type {OtaAutoChainAdvanceResult} from "./services/OtaAutoChain"
+export {
+  BES_INSTALL_RESTART_MESSAGE,
+  getOtaErrorMessage,
+  shouldRequireGlassesRebootForBesFailure,
+  shouldShowChangeWifiForOtaDownloadFailure,
+} from "./services/OtaErrorMapping"
 
 // Gallery read models: engine.gallery.onNotice payload types, the media
 // permission helper + display-name derivation host gallery UI uses, and the
@@ -113,11 +126,19 @@ export type {
 export type {GalleryNotice, GalleryNoticeCode} from "./services/asg/galleryNotices"
 export {MediaLibraryPermissions} from "./utils/permissions/MediaLibraryPermissions"
 export {deriveGalleryDisplayName} from "./utils/permissions/galleryDisplayName"
-export type {PhotoInfo, CaptureFile, CaptureGroup, GalleryResponse, ServerStatus, HealthResponse, GalleryEvent} from "./types/asg"
+export type {
+  PhotoInfo,
+  CaptureFile,
+  CaptureGroup,
+  GalleryResponse,
+  ServerStatus,
+  HealthResponse,
+  GalleryEvent,
+} from "./types/asg"
 
 // Bluetooth SDK event types host UI subscribes to via engine facades (the
 // BluetoothSdk singleton passthrough itself is internal).
-export type {PairFailureEvent, GlassesNotReadyEvent} from "@mentra/bluetooth-sdk/internal"
+export type {PairFailureEvent, GlassesNotReadyEvent} from "@mentra/bluetooth-sdk"
 
 // Cloud connection status enum (read model; the connection store is internal).
 export {WebSocketStatus} from "./stores/connection"
@@ -153,11 +174,16 @@ export {
 } from "./stores/apps"
 
 // Pure dev-miniapp launch-route decision (registration itself is internal).
-export {decideDevLaunchRoute, type DevLaunchResult, type DevManifest} from "./utils/devMiniappLaunch"
+export {
+  decideDevLaunchRoute,
+  type DecideDevLaunchOptions,
+  type DevLaunchResult,
+  type DevManifest,
+} from "./utils/devMiniappLaunch"
 export {HardwareCompatibility, type CompatibilityResult} from "./utils/hardware"
 export {BgTimer, throttle, debounce} from "./utils/timers"
 
-// Types (copied from @mentra/types — keep in sync with cloud/packages/types/src)
+// Hardware types and capability profiles.
 export {
   HardwareType,
   HardwareRequirementLevel,