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

package/build/types/hardware.js.map

@@ -1 +1 @@
-{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../src/types/hardware.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAA0C,MAAM,SAAS,CAAC;AAyK9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,eAAe;IAC5C,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,eAAe;IAC5C,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,aAAa;IACxC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU;IAClC,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,gBAAgB;IAC9C,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS;IAChC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,mDAAmD;IACnF,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QAClB,GAAG,eAAe;QAClB,SAAS,EAAE,WAAW,CAAC,IAAI;QAC3B,OAAO,EAAE;YACP,GAAG,eAAe,CAAC,OAAO;YAC1B,gBAAgB,EAAE,KAAK;SACxB;QACD,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE;YACV,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,KAAK;SACd;KACF;IACD,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAuB,EAAgB,EAAE;IAC5E,MAAM,SAAS,GAAG,UAAoB,CAAC;IACvC,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC","sourcesContent":["/**\n * @mentra/types - Hardware capability types\n */\n\nimport { evenRealitiesG1 } from \"./capabilities/even-realities-g1\";\nimport { evenRealitiesG2 } from \"./capabilities/even-realities-g2\";\nimport { mentraDisplay } from \"./capabilities/mentra-display\";\nimport { mentraLive } from \"./capabilities/mentra-live\";\nimport { simulatedGlasses } from \"./capabilities/simulated-glasses\";\nimport { vuzixZ100 } from \"./capabilities/vuzix-z100\";\nimport { none } from \"./capabilities/none\";\nimport { DeviceTypes, HardwareRequirementLevel, HardwareType } from \"./enums\";\n\n/**\n * Hardware requirement for an app\n * Specifies what hardware components an app needs\n */\nexport interface HardwareRequirement {\n  type: HardwareType;\n  level: HardwareRequirementLevel;\n  description?: string; // Why this hardware is needed\n}\n\n/**\n * Camera capabilities\n */\nexport interface CameraCapabilities {\n  resolution?: { width: number; height: number };\n  hasHDR?: boolean;\n  hasFocus?: boolean;\n  video: {\n    canRecord: boolean;\n    canStream: boolean;\n    supportedStreamTypes?: string[];\n    supportedResolutions?: { width: number; height: number }[];\n  };\n}\n\n/**\n * Display capabilities\n */\nexport interface DisplayCapabilities {\n  count?: number;\n  isColor?: boolean;\n  color?: string; // e.g., \"green\", \"full_color\", \"pallet\"\n  canDisplayBitmap?: boolean;\n  resolution?: { width: number; height: number };\n  fieldOfView?: { horizontal?: number; vertical?: number };\n  maxTextLines?: number;\n  adjustBrightness?: boolean;\n\n  // --- Scene display API (display.render()) — typed capabilities ---\n  // Pure DATA the host scene pipeline acts on generically; a device without\n  // canPosition renders scenes via the host degrade path instead.\n  /** Public drawable canvas in px — the raw coordinate space for render() boxes. */\n  width?: number;\n  height?: number;\n  /** True ⇒ the device renders positioned elements (containers / canvas components). */\n  canPosition?: boolean;\n  /** Element budgets. Rects share the text pool on container-based devices. */\n  maxTextElements?: number;\n  maxImageElements?: number;\n  /** Per-image dimension cap (box-level), when the firmware has one. */\n  maxImagePx?: { width: number; height: number };\n  shapes?: \"rect\"[];\n  intensityLevels?: number;\n  partialUpdate?: boolean;\n}\n\n/**\n * Microphone capabilities\n */\nexport interface MicrophoneCapabilities {\n  count?: number;\n  hasVAD?: boolean; // Voice Activity Detection\n}\n\n/**\n * Speaker capabilities\n */\nexport interface SpeakerCapabilities {\n  count?: number;\n  isPrivate?: boolean; // e.g., bone conduction\n}\n\n/**\n * IMU (Inertial Measurement Unit) capabilities\n */\nexport interface IMUCapabilities {\n  axisCount?: number;\n  hasAccelerometer?: boolean;\n  hasCompass?: boolean;\n  hasGyroscope?: boolean;\n}\n\n/**\n * Button capabilities\n */\nexport interface ButtonCapabilities {\n  count?: number;\n  buttons?: {\n    type: \"press\" | \"swipe1d\" | \"swipe2d\";\n    events: string[]; // e.g., \"press\", \"double_press\", \"long_press\", \"swipe_up\", \"swipe_down\"\n    isCapacitive?: boolean;\n  }[];\n}\n\n/**\n * Light capabilities\n */\nexport interface LightCapabilities {\n  count?: number;\n  lights?: {\n    id: string; // Unique identifier for the LED (e.g., \"privacy\", \"user_feedback\")\n    purpose: \"privacy\" | \"user_feedback\" | \"general\"; // LED purpose/function\n    isFullColor: boolean;\n    color?: string; // e.g., \"white\", \"rgb\"\n    position?: \"front_facing\" | \"user_facing\" | \"side\" | \"unknown\"; // LED physical position\n  }[];\n}\n\n/**\n * Power capabilities\n */\nexport interface PowerCapabilities {\n  hasExternalBattery: boolean; // e.g., a case or puck\n}\n\n/**\n * Device hardware capabilities\n * Complete information about what hardware a device has\n */\nexport interface Capabilities {\n  modelName: string;\n\n  // Camera capabilities\n  hasCamera: boolean;\n  camera: CameraCapabilities | null;\n\n  // Display capabilities\n  hasDisplay: boolean;\n  display: DisplayCapabilities | null;\n\n  // Microphone capabilities\n  hasMicrophone: boolean;\n  microphone: MicrophoneCapabilities | null;\n\n  // Speaker capabilities\n  hasSpeaker: boolean;\n  speaker: SpeakerCapabilities | null;\n\n  // IMU capabilities\n  hasIMU: boolean;\n  imu: IMUCapabilities | null;\n\n  // Button capabilities\n  hasButton: boolean;\n  button: ButtonCapabilities | null;\n\n  // Light capabilities\n  hasLight: boolean;\n  light: LightCapabilities | null;\n\n  // Power capabilities\n  power: PowerCapabilities;\n\n  // WiFi capability\n  hasWifi: boolean;\n\n  // OTA capability\n  hasOta?: boolean;\n\n  // Native dashboard capability\n  // True when the device renders its own dashboard in firmware (e.g. Even\n  // Realities' built-in dashboard on G2). MentraOS does not manage or expose\n  // dashboard settings for these devices. Absent/false means MentraOS owns the\n  // dashboard.\n  hasNativeDashboard?: boolean;\n}\n\n/**\n * Hardware capability profiles for supported glasses models\n * Key: model_name string (e.g., \"Even Realities G1\", \"Mentra Live\")\n * Value: Capabilities object defining device features\n */\nexport const HARDWARE_CAPABILITIES: Record<string, Capabilities> = {\n  [evenRealitiesG1.modelName]: evenRealitiesG1,\n  [evenRealitiesG2.modelName]: evenRealitiesG2,\n  [mentraDisplay.modelName]: mentraDisplay,\n  [mentraLive.modelName]: mentraLive,\n  [simulatedGlasses.modelName]: simulatedGlasses,\n  [vuzixZ100.modelName]: vuzixZ100,\n  [DeviceTypes.MACH1]: vuzixZ100, // Mach1 uses same Vuzix Ultralite hardware as Z100\n  [DeviceTypes.AR99]: {\n    ...evenRealitiesG1,\n    modelName: DeviceTypes.AR99,\n    display: {\n      ...evenRealitiesG1.display,\n      canDisplayBitmap: false,\n    },\n    hasMicrophone: true,\n    hasOta: true,\n    microphone: {\n      count: 1,\n      hasVAD: false,\n    },\n  },\n  [none.modelName]: none,\n};\n\nexport const getModelCapabilities = (deviceType: DeviceTypes): Capabilities => {\n  const modelName = deviceType as string;\n  if (!HARDWARE_CAPABILITIES[modelName]) {\n    return HARDWARE_CAPABILITIES[DeviceTypes.NONE];\n  }\n  return HARDWARE_CAPABILITIES[modelName];\n};\n\n// export * from \"./capabilities\"\nexport { simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay };\n"]}
+{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../src/types/hardware.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAiKtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,eAAe;IAC5C,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,eAAe;IAC5C,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,aAAa;IACxC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU;IAClC,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,gBAAgB;IAC9C,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS;IAChC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,mDAAmD;IACnF,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QAClB,GAAG,eAAe;QAClB,SAAS,EAAE,WAAW,CAAC,IAAI;QAC3B,OAAO,EAAE;YACP,GAAG,eAAe,CAAC,OAAO;YAC1B,gBAAgB,EAAE,KAAK;SACxB;QACD,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE;YACV,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,KAAK;SACd;KACF;IACD,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAuB,EAAgB,EAAE;IAC5E,MAAM,SAAS,GAAG,UAAoB,CAAC;IACvC,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC","sourcesContent":["/** Hardware capability types used by the Engine. */\n\nimport { evenRealitiesG1 } from \"./capabilities/even-realities-g1\";\nimport { evenRealitiesG2 } from \"./capabilities/even-realities-g2\";\nimport { mentraDisplay } from \"./capabilities/mentra-display\";\nimport { mentraLive } from \"./capabilities/mentra-live\";\nimport { simulatedGlasses } from \"./capabilities/simulated-glasses\";\nimport { vuzixZ100 } from \"./capabilities/vuzix-z100\";\nimport { none } from \"./capabilities/none\";\nimport { DeviceTypes } from \"./enums\";\n\nexport type { HardwareRequirement } from \"@mentra/miniapp/hardware\";\n\n/**\n * Camera capabilities\n */\nexport interface CameraCapabilities {\n  resolution?: { width: number; height: number };\n  hasHDR?: boolean;\n  hasFocus?: boolean;\n  video: {\n    canRecord: boolean;\n    canStream: boolean;\n    supportedStreamTypes?: string[];\n    supportedResolutions?: { width: number; height: number }[];\n  };\n}\n\n/**\n * Display capabilities\n */\nexport interface DisplayCapabilities {\n  count?: number;\n  isColor?: boolean;\n  color?: string; // e.g., \"green\", \"full_color\", \"pallet\"\n  canDisplayBitmap?: boolean;\n  resolution?: { width: number; height: number };\n  fieldOfView?: { horizontal?: number; vertical?: number };\n  maxTextLines?: number;\n  adjustBrightness?: boolean;\n\n  // --- Scene display API (display.render()) — typed capabilities ---\n  // Pure DATA the host scene pipeline acts on generically; a device without\n  // canPosition renders scenes via the host degrade path instead.\n  /** Public drawable canvas in px — the raw coordinate space for render() boxes. */\n  width?: number;\n  height?: number;\n  /** True ⇒ the device renders positioned elements (containers / canvas components). */\n  canPosition?: boolean;\n  /** Element budgets. Rects share the text pool on container-based devices. */\n  maxTextElements?: number;\n  maxImageElements?: number;\n  /** Per-image dimension cap (box-level), when the firmware has one. */\n  maxImagePx?: { width: number; height: number };\n  shapes?: \"rect\"[];\n  intensityLevels?: number;\n  partialUpdate?: boolean;\n}\n\n/**\n * Microphone capabilities\n */\nexport interface MicrophoneCapabilities {\n  count?: number;\n  hasVAD?: boolean; // Voice Activity Detection\n}\n\n/**\n * Speaker capabilities\n */\nexport interface SpeakerCapabilities {\n  count?: number;\n  isPrivate?: boolean; // e.g., bone conduction\n}\n\n/**\n * IMU (Inertial Measurement Unit) capabilities\n */\nexport interface IMUCapabilities {\n  axisCount?: number;\n  hasAccelerometer?: boolean;\n  hasCompass?: boolean;\n  hasGyroscope?: boolean;\n}\n\n/**\n * Button capabilities\n */\nexport interface ButtonCapabilities {\n  count?: number;\n  buttons?: {\n    type: \"press\" | \"swipe1d\" | \"swipe2d\";\n    events: string[]; // e.g., \"press\", \"double_press\", \"long_press\", \"swipe_up\", \"swipe_down\"\n    isCapacitive?: boolean;\n  }[];\n}\n\n/**\n * Light capabilities\n */\nexport interface LightCapabilities {\n  count?: number;\n  lights?: {\n    id: string; // Unique identifier for the LED (e.g., \"privacy\", \"user_feedback\")\n    purpose: \"privacy\" | \"user_feedback\" | \"general\"; // LED purpose/function\n    isFullColor: boolean;\n    color?: string; // e.g., \"white\", \"rgb\"\n    position?: \"front_facing\" | \"user_facing\" | \"side\" | \"unknown\"; // LED physical position\n  }[];\n}\n\n/**\n * Power capabilities\n */\nexport interface PowerCapabilities {\n  hasExternalBattery: boolean; // e.g., a case or puck\n}\n\n/**\n * Device hardware capabilities\n * Complete information about what hardware a device has\n */\nexport interface Capabilities {\n  modelName: string;\n\n  // Camera capabilities\n  hasCamera: boolean;\n  camera: CameraCapabilities | null;\n\n  // Display capabilities\n  hasDisplay: boolean;\n  display: DisplayCapabilities | null;\n\n  // Microphone capabilities\n  hasMicrophone: boolean;\n  microphone: MicrophoneCapabilities | null;\n\n  // Speaker capabilities\n  hasSpeaker: boolean;\n  speaker: SpeakerCapabilities | null;\n\n  // IMU capabilities\n  hasIMU: boolean;\n  imu: IMUCapabilities | null;\n\n  // Button capabilities\n  hasButton: boolean;\n  button: ButtonCapabilities | null;\n\n  // Light capabilities\n  hasLight: boolean;\n  light: LightCapabilities | null;\n\n  // Power capabilities\n  power: PowerCapabilities;\n\n  // WiFi capability\n  hasWifi: boolean;\n\n  // OTA capability\n  hasOta?: boolean;\n\n  // Native dashboard capability\n  // True when the device renders its own dashboard in firmware (e.g. Even\n  // Realities' built-in dashboard on G2). MentraOS does not manage or expose\n  // dashboard settings for these devices. Absent/false means MentraOS owns the\n  // dashboard.\n  hasNativeDashboard?: boolean;\n}\n\n/**\n * Hardware capability profiles for supported glasses models\n * Key: model_name string (e.g., \"Even Realities G1\", \"Mentra Live\")\n * Value: Capabilities object defining device features\n */\nexport const HARDWARE_CAPABILITIES: Record<string, Capabilities> = {\n  [evenRealitiesG1.modelName]: evenRealitiesG1,\n  [evenRealitiesG2.modelName]: evenRealitiesG2,\n  [mentraDisplay.modelName]: mentraDisplay,\n  [mentraLive.modelName]: mentraLive,\n  [simulatedGlasses.modelName]: simulatedGlasses,\n  [vuzixZ100.modelName]: vuzixZ100,\n  [DeviceTypes.MACH1]: vuzixZ100, // Mach1 uses same Vuzix Ultralite hardware as Z100\n  [DeviceTypes.AR99]: {\n    ...evenRealitiesG1,\n    modelName: DeviceTypes.AR99,\n    display: {\n      ...evenRealitiesG1.display,\n      canDisplayBitmap: false,\n    },\n    hasMicrophone: true,\n    hasOta: true,\n    microphone: {\n      count: 1,\n      hasVAD: false,\n    },\n  },\n  [none.modelName]: none,\n};\n\nexport const getModelCapabilities = (deviceType: DeviceTypes): Capabilities => {\n  const modelName = deviceType as string;\n  if (!HARDWARE_CAPABILITIES[modelName]) {\n    return HARDWARE_CAPABILITIES[DeviceTypes.NONE];\n  }\n  return HARDWARE_CAPABILITIES[modelName];\n};\n\n// export * from \"./capabilities\"\nexport { simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay };\n"]}

package/build/types/index.d.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. */
 export { HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes } from "./enums";
 export type { HardwareRequirement, CameraCapabilities, DisplayCapabilities, MicrophoneCapabilities, SpeakerCapabilities, IMUCapabilities, ButtonCapabilities, LightCapabilities, PowerCapabilities, Capabilities, } from "./hardware";
 export { HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay, } from "./hardware";

package/build/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,SAAS,CAAA;AAG5F,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAA;AAGnB,YAAY,EAAC,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAC,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;kEACkE;AAGlE,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,SAAS,CAAA;AAG5F,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAA;AAGnB,YAAY,EAAC,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAC,MAAM,UAAU,CAAA"}

package/build/types/index.js

@@ -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";
 export { HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay, } from "./hardware";

package/build/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yBAAyB;AACzB,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,SAAS,CAAA;AAgB5F,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAA","sourcesContent":["/**\n * Engine shared types — copied verbatim from @mentra/types so the module is\n * self-contained. Keep these in sync with cloud/packages/types/src when the\n * canonical types change. The capability profiles also live here under\n * ./capabilities/.\n */\n\n// Enums (runtime values)\nexport {HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes} from \"./enums\"\n\n// Hardware types\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n} from \"./hardware\"\n\nexport {\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./hardware\"\n\n// Applet types\nexport type {AppletType, AppPermissionType, AppletPermission, AppletInterface, ClientApp} from \"./applet\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;kEACkE;AAElE,yBAAyB;AACzB,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,SAAS,CAAA;AAgB5F,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAA","sourcesContent":["/** Engine capability types and profiles. Miniapp manifest requirement types\n * are re-exported from @mentra/miniapp, their canonical owner. */\n\n// Enums (runtime values)\nexport {HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes} from \"./enums\"\n\n// Hardware types\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n} from \"./hardware\"\n\nexport {\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./hardware\"\n\n// Applet types\nexport type {AppletType, AppPermissionType, AppletPermission, AppletInterface, ClientApp} from \"./applet\"\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/engine",
-  "version": "0.1.0-dev.1",
+  "version": "3.1.0-dev.4",
   "description": "Mentra Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -11,21 +11,36 @@
       "react-native": "./src/index.ts",
       "default": "./build/index.js"
     },
-    "./internal": {
-      "types": "./build/internal.d.ts",
-      "react-native": "./src/internal.ts",
-      "default": "./build/internal.js"
-    },
-    "./devtools": {
-      "types": "./build/devtools.d.ts",
-      "react-native": "./src/devtools.ts",
-      "default": "./build/devtools.js"
-    },
     "./ota": {
       "types": "./build/react/index.d.ts",
       "react-native": "./src/react/index.ts",
       "default": "./build/react/index.js"
     },
+    "./bluetooth-sdk": {
+      "types": "./build/bluetooth-sdk/index.d.ts",
+      "react-native": "./src/bluetooth-sdk/index.ts",
+      "default": "./build/bluetooth-sdk/index.js"
+    },
+    "./bluetooth-sdk/react": {
+      "types": "./build/bluetooth-sdk/react.d.ts",
+      "react-native": "./src/bluetooth-sdk/react.ts",
+      "default": "./build/bluetooth-sdk/react.js"
+    },
+    "./bluetooth-sdk/types": {
+      "types": "./build/bluetooth-sdk/types.d.ts",
+      "react-native": "./src/bluetooth-sdk/types.ts",
+      "default": "./build/bluetooth-sdk/types.js"
+    },
+    "./bluetooth-sdk/photo-receiver": {
+      "types": "./build/bluetooth-sdk/photo-receiver.d.ts",
+      "react-native": "./src/bluetooth-sdk/photo-receiver.ts",
+      "default": "./build/bluetooth-sdk/photo-receiver.js"
+    },
+    "./bluetooth-sdk/debug": {
+      "types": "./build/bluetooth-sdk/debug.d.ts",
+      "react-native": "./src/bluetooth-sdk/debug.ts",
+      "default": "./build/bluetooth-sdk/debug.js"
+    },
     "./build/*": null,
     "./src/*": null,
     "./package.json": "./package.json"
@@ -34,6 +49,10 @@
     "build",
     "README.md",
     "src",
+    "!build/devtools.*",
+    "!build/internal.*",
+    "!src/devtools.ts",
+    "!src/internal.ts",
     "!src/**/__tests__",
     "!src/**/*.test.ts"
   ],
@@ -41,7 +60,10 @@
     "build": "expo-module build",
     "clean": "expo-module clean",
     "lint": "expo-module lint",
-    "test": "./scripts/test.sh",
+    "test": "./scripts/test.sh && node --test scripts/*.test.mjs",
+    "write:release-metadata": "node scripts/write-release-metadata.mjs",
+    "verify:release-package": "node scripts/verify-release-package.mjs",
+    "test:public-api": "bun test src/bluetooth-sdk/__tests__/publicApi.test.ts",
     "build:module": "expo-module prepare",
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module"
@@ -69,16 +91,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@mentra/bluetooth-sdk": "3.1.0-dev.4",
+    "@mentra/cloud-client": "3.1.0-dev.4",
+    "@mentra/cloud-protocol": "3.1.0-dev.4",
+    "@mentra/crust": "3.1.0-dev.4",
+    "@mentra/miniapp": "3.1.0-dev.4",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1"
   },
   "devDependencies": {
-    "@mentra/bluetooth-sdk": "workspace:*",
-    "@mentra/cloud-client": "workspace:*",
-    "@mentra/cloud-protocol": "workspace:*",
-    "@mentra/miniapp": "workspace:*",
     "@types/semver": "^7.7.1",
     "expo-module-scripts": "^55.0.2",
     "expo-modules-core": "55.0.25",
@@ -119,11 +142,6 @@
     "@react-native-community/netinfo": "*",
     "@dr.pogodin/react-native-fs": "*",
     "@craftzdog/react-native-buffer": "*",
-    "axios": "*",
-    "@mentra/bluetooth-sdk": "*",
-    "@mentra/crust": "^0.1.0-dev.1",
-    "@mentra/cloud-client": "^0.1.0-dev.0",
-    "@mentra/miniapp": "^0.3.0-dev.1",
-    "@mentra/cloud-protocol": "^0.1.0-dev.0"
+    "axios": "*"
   }
 }

package/src/bluetooth-sdk/debug.ts

@@ -0,0 +1 @@
+export * from "@mentra/bluetooth-sdk/debug"

package/src/bluetooth-sdk/index.ts

@@ -0,0 +1,2 @@
+export {default} from "@mentra/bluetooth-sdk"
+export * from "@mentra/bluetooth-sdk"

package/src/bluetooth-sdk/photo-receiver.ts

@@ -0,0 +1,2 @@
+export {default} from "@mentra/bluetooth-sdk/photo-receiver"
+export * from "@mentra/bluetooth-sdk/photo-receiver"

package/src/bluetooth-sdk/react.ts

@@ -0,0 +1 @@
+export * from "@mentra/bluetooth-sdk/react"

package/src/bluetooth-sdk/types.ts

@@ -0,0 +1 @@
+export * from "@mentra/bluetooth-sdk/types"

package/src/engine.ts

@@ -5,8 +5,8 @@
  * name stays `engine` in code; the public API surface is `engine`.)
  *
  * It grows one facade at a time. The migration-era flat store/service exports
- * live on the `@mentra/engine/internal` entry (and the debug singletons on
- * `@mentra/engine/devtools`); they shrink as screens move onto `engine.*`.
+ * remain in a private MentraOS host package; they shrink as screens move onto
+ * `engine.*`.
  */
 import {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from "./runtime/bootstrap"
 import {cloudClientService} from "./services/CloudClientService"

package/src/facades/display.ts

@@ -4,7 +4,7 @@
  * glasses display for dev tools and escape-hatch use (normal rendering goes through
  * the engine DisplayProcessor / layout system, not these).
  */
-import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
+import BluetoothSdk from "@mentra/bluetooth-sdk"
 import {displayMirror} from "./displayMirror"
 
 export const display = {

package/src/facades/glasses.ts

@@ -11,7 +11,7 @@
 // surface, not the public entry. Relative path (the alias doesn't resolve in engine's
 // standalone build); jest moduleNameMapper + tsconfig both resolve it.
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
-import type {ButtonPressEvent, TouchEvent} from "@mentra/bluetooth-sdk/internal"
+import type {ButtonPressEvent, ConnectOptions, Device, TouchEvent} from "@mentra/bluetooth-sdk"
 import {useGlassesStore} from "../stores/glasses"
 import {useSettingsStore, SETTINGS} from "../stores/settings"
 import {hasDefaultDevice} from "../services/DeviceStoreHydration"
@@ -94,10 +94,10 @@ export const glasses = {
   disconnect: (): Promise<void> => BluetoothSdk.disconnect(),
   forget: (): Promise<void> => BluetoothSdk.forget(),
   /** Connect to a specific (discovered) device. */
-  connect: async (...args: Parameters<typeof BluetoothSdk.connect>): Promise<void> => {
+  connect: async (device: Device, options?: ConnectOptions): Promise<void> => {
     try {
       await pushAllBluetoothSettings()
-      await BluetoothSdk.connect(...args)
+      await BluetoothSdk.connect(device, options)
     } catch (error) {
       recordSupportProfileConnectionFailure(error, "connect")
       throw error
@@ -106,7 +106,7 @@ export const glasses = {
   /** Connect the built-in simulated glasses (dev/testing). */
   connectSimulated: (): Promise<void> => BluetoothSdk.connectSimulated(),
   /** Set a device as the `connectDefault()` target. */
-  setDefault: (...args: Parameters<typeof BluetoothSdk.setDefaultDevice>) => BluetoothSdk.setDefaultDevice(...args),
+  setDefault: (device: Device | null): Promise<void> => BluetoothSdk.setDefaultDevice(device),
   /**
    * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
    * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered

package/src/facades/ota.ts

@@ -9,7 +9,7 @@
  * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.
  */
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
-import type {OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo} from "@mentra/bluetooth-sdk/internal"
+import type {OtaProgress, OtaProgressStatus, OtaStartAckEvent, OtaStatus, OtaUpdateInfo} from "@mentra/bluetooth-sdk"
 import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
 import {resolveOtaManifestUrl} from "../services/otaManifestUrl"
 import {otaInstallCoordinator, type OtaInstallSnapshot} from "../services/OtaInstallCoordinator"
@@ -65,11 +65,11 @@ export const ota = {
   },
   /**
    * Start the firmware install with the resolved OTA manifest URL. Progress lands on
-   * `status()`/`onStatus()`. (The host resolves the manifest URL — dev-override/env/prod
-   * resolution stays with the OTA config; the host-side stuck/retry watchdog is its own
+   * `status()`/`onStatus()`. (The host resolves the manifest URL — developer override,
+   * host pin, or Engine release pin resolution stays with the OTA config; the stuck/retry watchdog is its own
    * resilience layer on top of this command.)
    */
-  install: (...args: Parameters<typeof BluetoothSdk.startOtaUpdate>) => BluetoothSdk.startOtaUpdate(...args),
+  install: (otaVersionUrl?: string | null): Promise<OtaStartAckEvent> => BluetoothSdk.startOtaUpdate(otaVersionUrl),
   // Deferred: this facade entry was intended to become the engine-owned retry/check
   // action, but BluetoothSdk.checkForOtaUpdate() only returns a boolean. Exposing it
   // here would make callers think the rich otaUpdateAvailable read model is refreshed,

package/src/facades/pairing.ts

@@ -10,7 +10,7 @@
 // target hint) lives on the full surface, not the public entry (same reason
 // the glasses facade imports internal).
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
-import type {ConnectOptions, Device, PairFailureEvent, GlassesNotReadyEvent} from "@mentra/bluetooth-sdk"
+import type {ConnectOptions, Device, DeviceModel, PairFailureEvent, GlassesNotReadyEvent} from "@mentra/bluetooth-sdk"
 import {useCoreStore} from "../stores/core"
 import {useGlassesStore} from "../stores/glasses"
 import {hasDefaultDevice} from "../services/DeviceStoreHydration"
@@ -206,7 +206,7 @@ export const pairing = {
   markPendingSelection: (model: string) => markPendingSelection(model),
 
   /** Start scanning for nearby glasses. Results land on `searchResults()`/`onFound()`. */
-  scan: (...args: Parameters<typeof BluetoothSdk.startScan>) => BluetoothSdk.startScan(...args),
+  scan: (model: DeviceModel): Promise<void> => BluetoothSdk.startScan(model),
   /** Whether a scan is currently in progress. */
   scanning: (): boolean => useCoreStore.getState().searching,
   /** Subscribe to scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */
@@ -226,7 +226,7 @@ export const pairing = {
   // leak as mutable references into the store.
   searchResults: () => useCoreStore.getState().searchResults.map((result) => ({...result})),
   /** Subscribe to scan-result changes; fires only when they change. Returns an unsubscribe. */
-  onFound: (cb: (results: ReturnType<typeof useCoreStore.getState>["searchResults"]) => void): (() => void) => {
+  onFound: (cb: (results: Device[]) => void): (() => void) => {
     let last = JSON.stringify(useCoreStore.getState().searchResults)
     return useCoreStore.subscribe(() => {
       const results = useCoreStore.getState().searchResults
@@ -250,7 +250,7 @@ export const pairing = {
     return BluetoothSdk.connect(device, {...options, saveAsDefault: false})
   },
   /** Set a device as the default for subsequent `glasses.connectDefault()`. */
-  setDefault: (...args: Parameters<typeof BluetoothSdk.setDefaultDevice>) => BluetoothSdk.setDefaultDevice(...args),
+  setDefault: (device: Device | null): Promise<void> => BluetoothSdk.setDefaultDevice(device),
   /**
    * Prime the native Bluetooth Classic audio watcher with the picked device.
    * The iOS Mentra Live flow pairs Classic audio BEFORE any BLE connect

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.4",
+  "releaseSetId": "mentra-3.1.0-dev.4",
+  "sourceCommit": "43b81aea1c84675fade024077063e45fddde4861",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.4/mentra-live-ota-3.1.0-dev.4.json",
+  "otaManifestSha256": "8fbea7589345658dc5dffcb394229ffc5c52fbe75352acb8f6827d83290ce750"
+})

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.
  */
 
@@ -47,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 {
@@ -132,11 +126,19 @@ export {
 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"
@@ -181,7 +183,7 @@ export {
 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,

package/src/services/AppRegistry.ts

@@ -871,6 +871,22 @@ class AppRegistry {
     this.notify()
   }
 
+  /**
+   * Update whether a registered offline app is projected into launcher UIs.
+   *
+   * Offline apps are registered once at host startup, so settings-backed
+   * visibility changes need to update the projection without reinstalling or
+   * duplicating the app. No-op when the app is missing or already matches.
+   */
+  public setOfflineAppHidden(packageName: string, hidden: boolean): void {
+    const app = this.offlineApps.find((candidate) => candidate.packageName === packageName)
+    if (!app || app.hidden === hidden) return
+
+    app.hidden = hidden
+    this.refreshNeeded = true
+    this.notify()
+  }
+
   /**
    * Registered as needing the on-device STT model before it can start (the
    * host declares this per offline app; the apps store gates start() on it).

package/src/services/OtaInstallCoordinator.ts

@@ -18,7 +18,7 @@
  * during React effects scheduled a re-render after the current effect batch.
  */
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
-import type {OtaProgress, OtaStatus} from "@mentra/bluetooth-sdk/internal"
+import type {OtaProgress, OtaStatus} from "@mentra/bluetooth-sdk"
 import GlobalEventEmitter from "../utils/GlobalEventEmitter"
 import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
 import {resolveOtaManifestUrl} from "./otaManifestUrl"
@@ -1492,6 +1492,9 @@ class OtaInstallCoordinator {
         otaVersionUrl = this.hotspotManifestUrl
         this.maybeArmStuckWatchdog()
       }
+      if (!otaVersionUrl) {
+        throw new Error("OTA is disabled because this build has no immutable manifest pin")
+      }
       console.log(`[OTA_PROGRESS] sending ota_start with ${this.selectedTransport} manifest URL: ${otaVersionUrl}`)
       nativeStartAttempted = true
       await BluetoothSdk.startOtaUpdate(otaVersionUrl)

package/src/services/OtaUpdateCheckService.ts

@@ -1,9 +1,8 @@
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
-import type {OtaUpdateInfo} from "@mentra/bluetooth-sdk/internal"
+import type {OtaUpdateInfo} from "@mentra/bluetooth-sdk"
 import {getGlassesSystemTimeMs, isGlassesConnected, useGlassesStore, waitForGlassesState} from "../stores/glasses"
-import {SETTINGS, useSettingsStore} from "../stores/settings"
 import {maybeFixGlassesClockFromVersionInfo} from "./glassesClockSync"
-import {resolveOtaManifestUrl} from "./otaManifestUrl"
+import {hasConfiguredModernOtaManifestPin, resolveOtaManifestUrl} from "./otaManifestUrl"
 
 /**
  * Phone-side mirror of ASG's `DOWNGRADE_FLOOR_VERSION_CODE`. Set to the versionCode of the first
@@ -127,7 +126,10 @@ async function fetchVersionInfoDetailed(url: string): Promise<ManifestFetchResul
       // 4xx: the manifest does not exist (or is gone) — permanent for this app
       // build, retrying cannot help. Everything else is transient server/network
       // trouble and retryable.
-      return {json: null, failureReason: response.status >= 400 && response.status < 500 ? "pin_unavailable" : "network"}
+      return {
+        json: null,
+        failureReason: response.status >= 400 && response.status < 500 ? "pin_unavailable" : "network",
+      }
     }
     try {
       return {json: await response.json()}
@@ -194,12 +196,7 @@ export function getApkUpdateDirection(
   // Downgrades require an exact pin AND a target at/above the enabled floor. A non-positive floor
   // disables downgrades entirely, matching ASG's fail-closed DowngradeGate — so the phone never
   // offers what the glasses would refuse.
-  if (
-    serverVersion < currentVersion &&
-    exactPin &&
-    floorVersionCode > 0 &&
-    serverVersion >= floorVersionCode
-  ) {
+  if (serverVersion < currentVersion && exactPin && floorVersionCode > 0 && serverVersion >= floorVersionCode) {
     return "downgrade"
   }
   return null
@@ -403,17 +400,10 @@ export async function checkCurrentGlassesForUpdate(
     return emptyCheckResult("disconnected")
   }
 
-  const embeddedManifestUrl = process.env.EXPO_PUBLIC_ASG_OTA_VERSION_URL?.trim()
-  const superMode = useSettingsStore.getState().getSetting(SETTINGS.super_mode.key)
-  const overrideUrl = useSettingsStore.getState().getSetting(SETTINGS.ota_version_url.key)
-  const overrideActive = superMode && typeof overrideUrl === "string" && overrideUrl.trim() !== ""
-  if (!embeddedManifestUrl && !overrideActive) {
-    console.log("OTA: check skipped - mobile app has no embedded OTA manifest pin")
+  if (!hasConfiguredModernOtaManifestPin()) {
+    console.log("OTA: check skipped - this app or Engine package has no embedded OTA manifest pin")
     return emptyCheckResult("dev_build")
   }
-  if (!embeddedManifestUrl) {
-    console.log("OTA: no embedded manifest pin, but super-mode manifest override is active - checking anyway")
-  }
 
   if (refreshVersionInfo) {
     void BluetoothSdk.requestVersionInfo().catch((error) => {
@@ -472,7 +462,17 @@ export async function checkCurrentGlassesForUpdate(
   }
 
   const manifestUrl = resolveOtaManifestUrl(useGlassesStore.getState().otaVersionUrl, buildNumber)
-  const result = await checkForOtaUpdate(manifestUrl, buildNumber, mtkFirmwareVersion, besFirmwareVersion, floorVersionCode)
+  if (!manifestUrl) {
+    console.log("OTA: check skipped - no OTA manifest pin resolved")
+    return emptyCheckResult("dev_build")
+  }
+  const result = await checkForOtaUpdate(
+    manifestUrl,
+    buildNumber,
+    mtkFirmwareVersion,
+    besFirmwareVersion,
+    floorVersionCode,
+  )
 
   if (!result.hasCheckCompleted) {
     return {

package/src/services/glassesClockSync.ts

@@ -87,6 +87,10 @@ export async function handleOtaClockSkewFromGlasses(
       lastOtaClockFixAt = Date.now()
       const {buildNumber, otaVersionUrl} = useGlassesStore.getState()
       const manifestUrl = resolveOtaManifestUrl(otaVersionUrl, buildNumber)
+      if (!manifestUrl) {
+        console.warn("[GlassesClockSync] OTA restart skipped because this build has no manifest pin")
+        return false
+      }
       console.log("[GlassesClockSync] ⏰ Restarting OTA with ota_start after clock fix")
       await BluetoothSdk.startOtaUpdate(manifestUrl)
       return true

package/src/services/otaDisplayState.ts

@@ -1,4 +1,4 @@
-import type {OtaProgress, OtaStatus} from "@mentra/bluetooth-sdk/internal"
+import type {OtaProgress, OtaStatus} from "@mentra/bluetooth-sdk"
 
 import {isLegacyShapedOtaStatus} from "./otaInstallPolicy"
 

package/src/services/otaInstallPolicy.ts

@@ -1,5 +1,5 @@
 /** Shared OTA progress watchdog timings (see progress-legacy.tsx / progress.tsx). */
-import type {OtaProgress, OtaStatus} from "@mentra/bluetooth-sdk/internal"
+import type {OtaProgress, OtaStatus} from "@mentra/bluetooth-sdk"
 
 /**
  * First glasses `build_number` (ASG `versionCode`) that uses `progress.tsx` with unified

package/src/services/otaLegacyMapping.ts

@@ -1,4 +1,4 @@
-import type {OtaProgress, OtaProgressStatus, OtaStatus} from "@mentra/bluetooth-sdk/internal"
+import type {OtaProgress, OtaProgressStatus, OtaStatus} from "@mentra/bluetooth-sdk"
 
 /** Normalized ota_status fields (snake_case) after bridging Core/expo (snake or camel). */
 export type NormalizedOtaStatusEvent = {