@mentra/engine 3.1.0-dev.91 → 3.1.0-dev.95

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.1.0",
-  "releaseIdentity": "3.1.0-dev.91",
-  "releaseSetId": "mentra-3.1.0-dev.91",
-  "sourceCommit": "80585dd0dec3b5b77c13be19fddeccd20e288144",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.1.0/mentra-live-ota-3.1.0-dev.91.json",
-  "otaManifestSha256": "568b25ce8f7b6883fed70873b5e7ca3286a7602b407dfc28d22eb6d41747d032"
+  "releaseIdentity": "3.1.0-dev.95",
+  "releaseSetId": "mentra-3.1.0-dev.95",
+  "sourceCommit": "84b6e22828cf1f07f8e2c337461ce9168457fb94",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.1.0/mentra-live-ota-3.1.0-dev.95.json",
+  "otaManifestSha256": "ff0e9bc4f223dd30be4fd3c820c7fb1ef3a0ba1711b9a33ef94c68401a78d214"
 })

package/src/index.ts

@@ -197,6 +197,7 @@ export {
   evenRealitiesG1,
   evenRealitiesG2,
   mentraLive,
+  nimo,
   vuzixZ100,
   mentraDisplay,
 } from "./types"

package/src/services/DisplayProcessor.ts

@@ -2,15 +2,15 @@
  * DisplayProcessor
  *
  * Processes display events with pixel-accurate text wrapping using the same
- * display-utils library as the cloud. This ensures the mobile preview matches
- * exactly what is shown on the glasses.
+ * Engine display utilities. This ensures the mobile preview matches exactly
+ * what is shown on the glasses.
  *
  * Key responsibilities:
  * 1. Intercept display events before sending to native SGC
  * 2. Wrap text using the correct device profile (G1, etc.)
  * 3. Ensure GlassesDisplayMirror shows exactly what glasses will show
  *
- * @see cloud/issues/026-mobile-display-processor for design docs
+ * @see notes/miniapp-display-api-redesign.md for the current display design
  */
 
 import {

package/src/services/LocalDisplayManager.ts

@@ -2,9 +2,8 @@
  * LocalDisplayManager
  *
  * Phone-side arbiter for display requests originating from LOCAL miniapps
- * (the @mentra/miniapp SDK). Mirrors the user-facing behavior of the cloud
- * DisplayManager (cloud/packages/cloud/src/services/layout/DisplayManager6.1.ts)
- * for the features that matter on the phone:
+ * (the @mentra/miniapp SDK). Preserves the retired cloud display manager's
+ * user-facing behavior for the features that matter on the phone:
  *
  *   - boot message ("Starting <AppName>…") with a bounded window
  *   - durationMs auto-clear

package/src/services/PhonePhotoCoordinator.ts

@@ -166,7 +166,7 @@ export class PhonePhotoCoordinator {
     // to time out. Fail fast with a typed error.
     //
     // We DON'T pre-check `hasCamera` here — the canonical capability data
-    // lives in `getModelCapabilities(deviceModel)` from @mentra/types and
+    // lives in `getModelCapabilities(deviceModel)` from @mentra/engine and
     // pulling that into this file would add a cross-package import. If a
     // cameraless device receives the BLE photo command, the glasses-side
     // handler will return a photo_response error within ~1s and the gated

package/src/services/StreamLifecycleController.ts

@@ -3,9 +3,9 @@
  * `setActive(true)` starts the timer; each tick sends a keep-alive with a
  * fresh ackId; `maxMissedAcks` consecutive timeouts fire `onTimeout`.
  *
- * Mirror of `cloud/packages/cloud/src/services/streaming/StreamLifecycleController.ts`
- * — kept byte-equivalent except for the `LifecycleLogger` interface (pino
- * isn't a phone dep). Behavior changes must land in both files.
+ * Phone-owned successor to the retired cloud stream lifecycle controller.
+ * It uses the local `LifecycleLogger` interface because pino is not a phone
+ * dependency.
  */
 
 export interface LifecycleLogger {

package/src/types/applet.ts

@@ -1,5 +1,5 @@
 /**
- * @mentra/types - App/Applet types for client interfaces
+ * App and miniapp types owned by @mentra/engine.
  */
 
 import type {ReactNode} from "react"

package/src/types/capabilities/even-realities-g1.ts

@@ -64,4 +64,7 @@ export const evenRealitiesG1: Capabilities = {
 
   // WiFi capabilities - G1 does not support WiFi
   hasWifi: false,
+
+  // OTA capabilities - G1 firmware updates are not driven by the ASG OTA flow
+  hasOta: false,
 };

package/src/types/capabilities/even-realities-g2.ts

@@ -82,6 +82,9 @@ export const evenRealitiesG2: Capabilities = {
   // WiFi capabilities - G2 does not support WiFi
   hasWifi: false,
 
+  // OTA capabilities - G2 firmware updates are not driven by the ASG OTA flow
+  hasOta: false,
+
   // Dashboard - G2 renders Even Realities' native dashboard in firmware, so
   // MentraOS does not manage the dashboard or expose dashboard settings for it
   hasNativeDashboard: true,

package/src/types/capabilities/mentra-display.ts

@@ -72,4 +72,7 @@ export const mentraDisplay: Capabilities = {
 
   // WiFi capabilities - Mentra Display does not support WiFi
   hasWifi: false,
+
+  // OTA capabilities - Mentra Display firmware updates are not driven by the ASG OTA flow
+  hasOta: false,
 };

package/src/types/capabilities/mentra-live.ts

@@ -100,4 +100,7 @@ export const mentraLive: Capabilities = {
 
   // WiFi capabilities - Mentra Live supports WiFi
   hasWifi: true,
+
+  // OTA capabilities - Mentra Live supports ASG/BES/MTK OTA updates
+  hasOta: true,
 };

package/src/types/capabilities/nimo.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview NIMO hardware capabilities.
+ *
+ * NIMO uses framed UART-over-BLE for widget content and a separate Opus
+ * microphone channel.
+ */
+
+import type {Capabilities} from "../hardware"
+
+export const nimo: Capabilities = {
+  modelName: "NIMO",
+  hasCamera: false,
+  camera: null,
+  hasDisplay: true,
+  display: {
+    count: 2,
+    isColor: false,
+    color: "green",
+    canDisplayBitmap: true,
+    // Bitmaps render into the 160x160 2bpp navigation widget. The resolution
+    // below remains the existing text-display placeholder until hardware
+    // screen information is available.
+    resolution: {width: 640, height: 400},
+    maxTextLines: 5,
+    adjustBrightness: true,
+  },
+  hasMicrophone: true,
+  microphone: {
+    count: 2,
+    hasVAD: false,
+  },
+  hasSpeaker: false,
+  speaker: null,
+  hasIMU: true,
+  imu: null,
+  hasButton: true,
+  button: {
+    count: 2,
+    buttons: [
+      {
+        type: "press",
+        events: ["press", "double_press", "long_press"],
+        isCapacitive: true,
+      },
+      {
+        type: "press",
+        events: ["press", "double_press", "long_press"],
+        isCapacitive: true,
+      },
+    ],
+  },
+  hasLight: false,
+  light: null,
+  power: {
+    hasExternalBattery: false,
+  },
+  hasWifi: false,
+  hasOta: false,
+}

package/src/types/capabilities/none.ts

@@ -73,4 +73,7 @@ export const none: Capabilities = {
 
   // WiFi capabilities - does not support WiFi
   hasWifi: false,
+
+  // OTA capabilities - none profile does not support OTA
+  hasOta: false,
 };

package/src/types/capabilities/simulated-glasses.ts

@@ -73,4 +73,7 @@ export const simulatedGlasses: Capabilities = {
 
   // WiFi capabilities - does not support WiFi
   hasWifi: false,
+
+  // OTA capabilities - simulated glasses do not support OTA
+  hasOta: false,
 };

package/src/types/capabilities/vuzix-z100.ts

@@ -61,4 +61,7 @@ export const vuzixZ100: Capabilities = {
 
   // WiFi capabilities - does not support WiFi
   hasWifi: false,
+
+  // OTA capabilities - Z100 firmware updates are not driven by the ASG OTA flow
+  hasOta: false,
 };

package/src/types/enums.ts

@@ -11,6 +11,7 @@ export enum DeviceTypes {
   Z100 = "Vuzix Z100",
   NEX = "Mentra Display",
   FRAME = "Brilliant Frame",
+  NIMO = "NIMO",
 }
 
 export enum ControllerTypes {

package/src/types/hardware.ts

@@ -4,6 +4,7 @@ import { evenRealitiesG1 } from "./capabilities/even-realities-g1";
 import { evenRealitiesG2 } from "./capabilities/even-realities-g2";
 import { mentraDisplay } from "./capabilities/mentra-display";
 import { mentraLive } from "./capabilities/mentra-live";
+import { nimo } from "./capabilities/nimo";
 import { simulatedGlasses } from "./capabilities/simulated-glasses";
 import { vuzixZ100 } from "./capabilities/vuzix-z100";
 import { none } from "./capabilities/none";
@@ -158,7 +159,7 @@ export interface Capabilities {
   hasWifi: boolean;
 
   // OTA capability
-  hasOta?: boolean;
+  hasOta: boolean;
 
   // Native dashboard capability
   // True when the device renders its own dashboard in firmware (e.g. Even
@@ -180,6 +181,7 @@ export const HARDWARE_CAPABILITIES: Record<string, Capabilities> = {
   [mentraLive.modelName]: mentraLive,
   [simulatedGlasses.modelName]: simulatedGlasses,
   [vuzixZ100.modelName]: vuzixZ100,
+  [nimo.modelName]: nimo,
   [DeviceTypes.MACH1]: vuzixZ100, // Mach1 uses same Vuzix Ultralite hardware as Z100
   [DeviceTypes.AR99]: {
     ...evenRealitiesG1,
@@ -207,4 +209,4 @@ export const getModelCapabilities = (deviceType: DeviceTypes): Capabilities => {
 };
 
 // export * from "./capabilities"
-export { simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay };
+export { simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, nimo, vuzixZ100, mentraDisplay };

package/src/types/index.ts

@@ -25,6 +25,7 @@ export {
   evenRealitiesG1,
   evenRealitiesG2,
   mentraLive,
+  nimo,
   vuzixZ100,
   mentraDisplay,
 } from "./hardware"

package/src/utils/display/composer/ColumnComposer.ts

@@ -11,7 +11,7 @@
  * 2. Merges columns line-by-line with pixel-precise space padding
  * 3. Returns a single pre-composed string ready for native to chunk & send
  *
- * @see cloud/issues/026-mobile-display-processor for design docs
+ * @see notes/miniapp-display-api-redesign.md for the current display design
  */
 
 import type { DisplayProfile } from "../profiles/types";