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

package/build/stores/settings.d.ts

@@ -9,6 +9,23 @@ export interface Setting {
     override?: () => any;
     persist: boolean;
     nativeAuthoritative?: true;
+    /**
+     * Clear this setting when the build's environment changes.
+     *
+     * A persisted override normally outranks both the build's env and the
+     * compiled default, which is right within one environment: a developer's
+     * METRO_AUTO pin should survive a rebuild. It is wrong across environments,
+     * where an override pinned under a dev build would silently follow the
+     * install onto a store build pointed at production.
+     *
+     * Note this keys off the build's environment label, so it does NOT fire on a
+     * TestFlight to App Store promotion: that ships the same binary with the same
+     * label. Promotion is safe because the publishing lane bakes prod URLs, not
+     * because this reset runs. See the resolution block in loadSettings.
+     *
+     * Absent means the value is never invalidated automatically.
+     */
+    resetOnBuildEnvChange?: true;
 }
 export declare const SETTINGS: Record<string, Setting>;
 export declare const OFFLINE_APPLETS: string[];

package/build/stores/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/stores/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAwB,MAAM,aAAa,CAAA;AAQ9D,OAAO,EAAC,wBAAwB,EAAE,gCAAgC,EAAC,MAAM,wBAAwB,CAAA;AAEjG,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,GAAG,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,OAAO,CAAA;IAGrB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAEjC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAA;IAEpB,OAAO,EAAE,OAAO,CAAA;IAQhB,mBAAmB,CAAC,EAAE,IAAI,CAAA;CAC3B;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAonBnC,CAAA;AAEV,eAAO,MAAM,eAAe,EAAE,MAAM,EAAqD,CAAA;AAIzF,eAAO,MAAM,sBAAsB,EAAE,MAAM,EA+C1C,CAAA;AAeD,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAEV,CAAA;AAIhC,MAAM,WAAW,aAAa;IAE5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE7B,aAAa,EAAE,OAAO,CAAA;IAEtB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACzF,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC3E,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAA;IAEhC,eAAe,EAAE,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAE/C,oBAAoB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/C,uBAAuB,EAAE,MAAM,IAAI,CAAA;CACpC;AAiBD,eAAO,MAAM,gBAAgB;;;;;;;;EA4N5B,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,GAAG,EAAE,KAAK,MAAM,KAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAI3F,CAAA"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/stores/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAwB,MAAM,aAAa,CAAA;AAQ9D,OAAO,EAAC,wBAAwB,EAAE,gCAAgC,EAAC,MAAM,wBAAwB,CAAA;AAEjG,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,GAAG,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,OAAO,CAAA;IAGrB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAEjC,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAA;IAEpB,OAAO,EAAE,OAAO,CAAA;IAQhB,mBAAmB,CAAC,EAAE,IAAI,CAAA;IAC1B;;;;;;;;;;;;;;;OAeG;IACH,qBAAqB,CAAC,EAAE,IAAI,CAAA;CAC7B;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA2oBnC,CAAA;AAEV,eAAO,MAAM,eAAe,EAAE,MAAM,EAAqD,CAAA;AAIzF,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAiD1C,CAAA;AAeD,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAEV,CAAA;AAIhC,MAAM,WAAW,aAAa;IAE5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE7B,aAAa,EAAE,OAAO,CAAA;IAEtB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACzF,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC3E,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAA;IAEhC,eAAe,EAAE,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAE/C,oBAAoB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/C,uBAAuB,EAAE,MAAM,IAAI,CAAA;CACpC;AAqBD,eAAO,MAAM,gBAAgB;;;;;;;;EA+U5B,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,GAAG,EAAE,KAAK,MAAM,KAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAI3F,CAAA"}

package/build/stores/settings.js

@@ -10,6 +10,15 @@ export const SETTINGS = {
     // feature flags / mantle settings:
     dev_mode: { key: "dev_mode", defaultValue: () => __DEV__, writable: true, saveOnServer: true, persist: true }, // deprecated
     debug_mode: { key: "debug_mode", defaultValue: () => __DEV__, writable: true, saveOnServer: true, persist: true },
+    android_notification_listener_enabled: {
+        key: "android_notification_listener_enabled",
+        // Operational kill switch. The listener now runs in a guarded lightweight
+        // process, so normal installs can safely capture notifications by default.
+        defaultValue: () => true,
+        writable: true,
+        saveOnServer: true,
+        persist: true,
+    },
     super_mode: { key: "super_mode", defaultValue: () => false, writable: true, saveOnServer: true, persist: true },
     appearance_menu_enabled: {
         key: "appearance_menu_enabled",
@@ -134,6 +143,7 @@ export const SETTINGS = {
         writable: true,
         saveOnServer: false,
         persist: true,
+        resetOnBuildEnvChange: true,
     },
     cloud_runtime_url: {
         key: "cloud_runtime_url",
@@ -141,6 +151,7 @@ export const SETTINGS = {
         writable: true,
         saveOnServer: false,
         persist: true,
+        resetOnBuildEnvChange: true,
     },
     // Bookmarked Cloud V2 endpoint pairs. Each entry is {label, coreUrl,
     // runtimeUrl} — core + runtime are saved together because they are always
@@ -154,7 +165,7 @@ export const SETTINGS = {
     },
     // Developer override for the ASG OTA manifest URL. null/empty = no override;
     // the normal selection applies (legacy-glasses gate, EXPO_PUBLIC_ASG_OTA_VERSION_URL,
-    // glasses-reported URL, then production). See getAsgOtaVersionUrl.
+    // glasses-reported URL, then production). See resolveOtaManifestUrl.
     ota_version_url: {
         key: "ota_version_url",
         defaultValue: () => null,
@@ -225,6 +236,14 @@ export const SETTINGS = {
         persist: true,
         nativeAuthoritative: true,
     },
+    project_name: {
+        key: "project_name",
+        defaultValue: () => "",
+        writable: true,
+        saveOnServer: false,
+        persist: true,
+        nativeAuthoritative: true,
+    },
     default_controller: {
         key: "default_controller",
         defaultValue: () => "",
@@ -338,12 +357,23 @@ export const SETTINGS = {
         saveOnServer: true,
         persist: true,
     },
+    // The Mentra App intentionally preserves Mentra Live's historical VAD-on
+    // product default. Standalone public Bluetooth SDK hosts default VAD off so
+    // their microphone audio remains continuous.
     voice_activity_detection_enabled: {
         key: "voice_activity_detection_enabled",
         defaultValue: () => true,
         writable: true,
-        saveOnServer: false,
-        persist: false,
+        saveOnServer: true,
+        persist: true,
+    },
+    // Mentra Live center-mic loudness / "Barrier" gate (cs_swit type 10). Default on.
+    loudness_gate_enabled: {
+        key: "loudness_gate_enabled",
+        defaultValue: () => true,
+        writable: true,
+        saveOnServer: true,
+        persist: true,
     },
     always_on_status_bar: {
         key: "always_on_status_bar",
@@ -533,7 +563,7 @@ export const SETTINGS = {
     // offline applets
     offline_mode: { key: "offline_mode", defaultValue: () => false, writable: true, saveOnServer: true, persist: true },
     // Runtime flag: coordinator flips this on when cloud STT has failed and fallback is active.
-    // Native GlassesStore watches it to gate PCM → Sherpa feeding. Not user-facing.
+    // Native GlassesStore watches it to gate PCM 鈫?Sherpa feeding. Not user-facing.
     local_stt_fallback_active: {
         key: "local_stt_fallback_active",
         defaultValue: () => false,
@@ -594,13 +624,6 @@ export const SETTINGS = {
         persist: true,
     },
     // notifications
-    notifications_enabled: {
-        key: "notifications_enabled",
-        defaultValue: () => true,
-        writable: true,
-        saveOnServer: true,
-        persist: true,
-    },
     notifications_blocklist: {
         key: "notifications_blocklist",
         defaultValue: () => [],
@@ -641,6 +664,7 @@ export const BLUETOOTH_SETTING_KEYS = [
     SETTINGS.sensing_enabled.key,
     SETTINGS.power_saving_mode.key,
     SETTINGS.voice_activity_detection_enabled.key,
+    SETTINGS.loudness_gate_enabled.key,
     SETTINGS.lc3_frame_size.key,
     SETTINGS.preferred_mic.key,
     SETTINGS.screen_disabled.key,
@@ -669,6 +693,7 @@ export const BLUETOOTH_SETTING_KEYS = [
     SETTINGS.default_wearable.key,
     SETTINGS.device_name.key,
     SETTINGS.device_address.key,
+    SETTINGS.project_name.key,
     SETTINGS.default_controller.key,
     SETTINGS.pending_controller.key,
     SETTINGS.controller_device_name.key,
@@ -676,7 +701,7 @@ export const BLUETOOTH_SETTING_KEYS = [
     // offline applets:
     SETTINGS.offline_mode.key,
     // Runtime flag flipped by LocalSttFallbackCoordinator. Native reads it from
-    // GlassesStore to gate PCM → Sherpa feeding in handlePcm and to keep the
+    // GlassesStore to gate PCM 鈫?Sherpa feeding in handlePcm and to keep the
     // mic on while local STT is the active engine.
     SETTINGS.local_stt_fallback_active.key,
     SETTINGS.gallery_mode.key,
@@ -686,12 +711,12 @@ export const BLUETOOTH_SETTING_KEYS = [
 ];
 // Pairing identity is NATIVE-authoritative: the native layer writes it on
 // pairing success (handleDeviceReady) / forget and echoes it down via
-// save_setting; JS persists those echoes. JS→native, identity travels ONLY in
+// save_setting; JS persists those echoes. JS鈫抧ative, identity travels ONLY in
 // the explicit full seeds (device-store hydration, pre-connect push,
 // post-demotion re-push) — never in the change-push subscription. Relaying an
 // echoed identity change back up would make the sync bidirectional with loop
 // gain 1: two identity values in flight (e.g. a boot demotion crossing a
-// native promotion) then chase each other through push→apply→echo→push
+// native promotion) then chase each other through push鈫抋pply鈫抏cho鈫抪ush
 // forever, flapping the UI.
 //
 // Derived from the `nativeAuthoritative` descriptor flag (not maintained as a
@@ -709,6 +734,9 @@ const getDefaultSettings = () => Object.keys(SETTINGS).reduce((acc, key) => {
 // second caller runs a duplicate full disk load while the first is still in
 // flight. Cleared on failure so a later call can retry.
 let loadAllSettingsInFlight = null;
+function printableSettingValue(key, value) {
+    return key.includes("token") || key.includes("email") ? "<redacted>" : JSON.stringify(value);
+}
 export const useSettingsStore = create()(subscribeWithSelector((set, get) => ({
     settings: getDefaultSettings(),
     isInitialized: false,
@@ -727,7 +755,7 @@ export const useSettingsStore = create()(subscribeWithSelector((set, get) => ({
                 throw new Error(`SETTINGS: ${originalKey} is not writable!`);
             }
             // Update store immediately for optimistic UI
-            console.log(`SETTINGS: SET: ${key} = ${value}`);
+            console.log(`SETTINGS: SET: ${key} = ${printableSettingValue(key, value)}`);
             set((state) => ({
                 settings: { ...state.settings, [key]: value },
             }));
@@ -832,7 +860,13 @@ export const useSettingsStore = create()(subscribeWithSelector((set, get) => ({
                 }
                 // normal key:value pair:
                 let value = res.value;
-                console.log(`SETTINGS: LOAD: ${setting.key} = ${value.value}`);
+                // res.value IS the stored value; logging value.value printed
+                // "undefined" for every loaded setting and disguised present
+                // values as missing. Redact token- and email-bearing keys: console
+                // logs are uploaded in bug-report artifacts (same keys
+                // diagnosticContext's SENSITIVE_SETTINGS_KEYS strips, minus an
+                // import that would cycle stores <-> utils).
+                console.log(`SETTINGS: LOAD: ${setting.key} = ${printableSettingValue(setting.key, value)}`);
                 loadedSettings[setting.key] = value;
             }
             // console.log("##############################################")
@@ -842,6 +876,91 @@ export const useSettingsStore = create()(subscribeWithSelector((set, get) => ({
                 isInitialized: true,
                 settings: { ...state.settings, ...loadedSettings },
             }));
+            // This hidden debug switch originally shipped default-off while the
+            // notification-listener cold-start ANR was being investigated. Now
+            // that the listener runs in its own guarded process, migrate existing
+            // installs to the new default once; later explicit debug changes still
+            // persist normally.
+            // Reset the cloud backend override when the build's environment changes.
+            //
+            // cloud_core_url / cloud_runtime_url are persist:true and outrank both
+            // the build's env and the compiled default (see resolveUrl in
+            // cloudClient.ts). That is what we want inside one environment: a
+            // developer's METRO_AUTO pin should survive a rebuild. It is wrong
+            // across environments.
+            //
+            // The concrete case is an install that moves BETWEEN environments: an
+            // internal tester running a dev build with a pinned override who then
+            // installs the store build. The override outranks that build's prod
+            // URLs, so without this they keep talking to dev with nothing
+            // surfacing it.
+            //
+            // Note what this deliberately does NOT do, because the distinction is
+            // 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 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
+            // deliberate limit: reaching it means typing a URL into a dev-only
+            // screen, VersionInfo renders the current value, and the same screen
+            // clears it.
+            //
+            // Comparing the baked EXPO_PUBLIC_BUILD_ENV against the last one seen
+            // on this device covers those environment switches and fresh installs
+            // without touching the setting write path. A reinstall needs no
+            // handling: it drops the marker and the override together
+            // (android:allowBackup="false", and iOS deletes the container).
+            const BUILD_ENV_KEY = "settings.lastBuildEnv";
+            const buildEnv = (process.env.EXPO_PUBLIC_BUILD_ENV ?? "dev").trim() || "dev";
+            const lastBuildEnv = storage.load(BUILD_ENV_KEY);
+            const previousBuildEnv = lastBuildEnv.is_error() ? undefined : lastBuildEnv.value;
+            if (previousBuildEnv !== buildEnv) {
+                // Clear when there is no marker yet, not just on a recorded change.
+                // The first build carrying this code meets every existing install
+                // with previousBuildEnv === undefined, and those are exactly the
+                // installs that may hold an override set before the pin existed --
+                // the population this is here to repair. Treating "no marker" as a
+                // fresh install would record the marker and never look again. A
+                // genuinely fresh install has nothing persisted, so the clear below
+                // writes each default over itself and costs nothing.
+                //
+                // Driven by the descriptors rather than a hardcoded key list, so a
+                // setting that needs this behaviour declares it in one place and
+                // cannot be missed here.
+                const scoped = Object.values(SETTINGS).filter((setting) => setting.resetOnBuildEnvChange);
+                console.log(`SETTINGS: build env ${previousBuildEnv ?? "(none recorded)"} -> ${buildEnv}, ` +
+                    `clearing ${scoped.length} build-scoped setting(s)`);
+                let allCleared = true;
+                for (const setting of scoped) {
+                    const cleared = await get().setSetting(setting.key, setting.defaultValue(), false);
+                    if (cleared.is_error()) {
+                        allCleared = false;
+                        console.log(`SETTINGS: could not clear ${setting.key}:`, cleared.error);
+                    }
+                }
+                // Advance the marker only once the reset actually landed. Recording
+                // it after a failed write would retire the retry and leave the stale
+                // override for the life of the install; leaving it unset costs one
+                // repeated attempt per launch until a write succeeds.
+                if (allCleared) {
+                    storage.save(BUILD_ENV_KEY, buildEnv);
+                }
+            }
+            const NOTIFICATION_LISTENER_MIGRATION_KEY = "migration:android_notification_listener_default_on_v1";
+            const notificationListenerMigrationDone = storage.load(NOTIFICATION_LISTENER_MIGRATION_KEY);
+            if (notificationListenerMigrationDone.is_error() || !notificationListenerMigrationDone.value) {
+                const result = await get().setSetting(SETTINGS.android_notification_listener_enabled.key, true, false);
+                if (result.is_error()) {
+                    console.log("SETTINGS: notification listener migration failed:", result.error);
+                }
+                else {
+                    storage.save(NOTIFICATION_LISTENER_MIGRATION_KEY, true);
+                }
+            }
             // One-time migration: force android_blur=false for existing users.
             // The setting's default is already false; this migration covers users
             // who explicitly opted into Android blur effects before we discovered
@@ -849,7 +968,7 @@ export const useSettingsStore = create()(subscribeWithSelector((set, get) => ({
             // The dimezisBlurViewSdk31Plus blur each costs ~5-10ms/frame; with
             // multiple blurs on home (top fade + AppSwitcherButton x2) a low-end
             // device misses the 16ms budget consistently. Users can turn it back
-            // on under Settings → Appearance once we've optimized further.
+            // on under Settings 鈫?Appearance once we've optimized further.
             //
             // The setSetting call also pushes to the server (saveOnServer: true)
             // so the server-stored value flips too — otherwise the next sync
@@ -875,6 +994,27 @@ export const useSettingsStore = create()(subscribeWithSelector((set, get) => ({
                 // already correct.
                 storage.save(MIGRATION_KEY, true);
             }
+            // The old camera default cropped the sensor to 102掳. Move existing
+            // default-shaped values to the full 118掳 sensor once; named miniapp
+            // requests for the 102掳 "standard" preset remain available.
+            const CAMERA_FOV_MIGRATION_KEY = "migration:camera_fov_full_sensor_v1";
+            const cameraFovMigrationDone = storage.load(CAMERA_FOV_MIGRATION_KEY);
+            if (cameraFovMigrationDone.is_error() || !cameraFovMigrationDone.value) {
+                const current = get().getSetting(SETTINGS.camera_fov.key);
+                let migrationSucceeded = true;
+                if (current?.fov === 102 && (current.roi_position ?? 0) === 0) {
+                    const result = await get().setSetting(SETTINGS.camera_fov.key, { fov: 118, roi_position: 0 }, true);
+                    if (result.is_error()) {
+                        console.log("SETTINGS: camera FOV migration failed:", result.error);
+                        migrationSucceeded = false;
+                    }
+                }
+                // Unlike the blur migration above, a failed camera set may leave the
+                // local value unchanged. Only mark this migration complete once the
+                // desired value was applied so a transient failure retries on boot.
+                if (migrationSucceeded)
+                    storage.save(CAMERA_FOV_MIGRATION_KEY, true);
+            }
         });
         loadAllSettingsInFlight = inFlight;
         void Promise.resolve(inFlight).then((result) => {