@mentra/engine 0.1.0-beta.0

package/build/services/DevServerBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServerBridge.js","sourceRoot":"","sources":["../../src/services/DevServerBridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DevServerBridge — phone-side WebSocket connection to a `mentra-miniapp dev`\n * sidecar running on a developer's laptop.\n *\n * Multiplexed over a single WebSocket per dev miniapp:\n *   laptop → phone : {type: \"reload\"}                 → trigger WebView.reload()\n *   phone  → laptop: {type: \"log\", level, args, ...}  → forwarded console calls\n *\n * Lifecycle: `connect(packageName, devUrl, devPort)` is called from\n * MiniappHost.mountDev once the dev applet is mounted. `disconnect(packageName)`\n * is called from MiniappHost.unmount. Reconnect with exponential backoff on\n * unexpected close — the dev server is the developer's laptop and may bounce.\n *\n * Outgoing logs are buffered in a small ring while disconnected; flushed on\n * reconnect. This catches early-startup logs the developer would otherwise\n * miss when re-launching the dev server.\n */\n\nconst LOG_TAG = \"DEV_SERVER_BRIDGE\"\nconst PROTOCOL_VERSION = \"mentra-dev/1\"\nconst HELLO_TIMEOUT_MS = 1_000\nconst BACKOFF_MIN_MS = 1_000\nconst BACKOFF_MAX_MS = 30_000\nconst RING_BUFFER_MAX_ENTRIES = 100\nconst RING_BUFFER_MAX_BYTES = 32 * 1024\n\ntype State = \"idle\" | \"connecting\" | \"connected\" | \"disconnected\" | \"closed\"\n\ninterface BufferedLog {\n  packageName: string\n  level: string\n  args: unknown[]\n  timestamp: number\n  /** \"ui\" = WebView, \"background\" = JSContext. Stamped at capture time. */\n  source: \"ui\" | \"background\"\n  size: number\n}\n\ninterface BridgeEntry {\n  state: State\n  ws: WebSocket | null\n  url: string\n  attempts: number\n  ringBuffer: BufferedLog[]\n  ringBytes: number\n  reloadHandler: ((packageName: string) => void) | null\n  reconnectTimer: ReturnType<typeof setTimeout> | null\n}\n\nclass DevServerBridge {\n  private entries = new Map<string, BridgeEntry>()\n  private globalReloadHandler: ((packageName: string) => void) | null = null\n  private globalRespawnBackgroundHandler: ((packageName: string) => void) | null = null\n\n  /**\n   * Register a global reload handler. MiniappHost calls this once at boot. The\n   * bridge invokes the handler with the offending packageName whenever a\n   * reload signal is received.\n   */\n  public onReload(handler: (packageName: string) => void): void {\n    this.globalReloadHandler = handler\n  }\n\n  /**\n   * Register a global background-respawn handler. Fires when the dev\n   * server sends `{type: \"respawn-bg\"}` — emitted on filesystem changes\n   * under `src/background/`. The host (MentraJSRouter via the\n   * bootstrap) should kill + respawn the JSContext to pick up the\n   * change. WebView reload is separate (see `onReload`).\n   */\n  public onRespawnBackground(handler: ((packageName: string) => void) | null): void {\n    this.globalRespawnBackgroundHandler = handler\n  }\n\n  /** Clear the background-respawn handler when the miniapp engine is stopped. */\n  public clearRespawnBackgroundHandler(): void {\n    this.globalRespawnBackgroundHandler = null\n  }\n\n  /** Open (or re-open) a bridge to the given dev server. */\n  public connect(packageName: string, devHostUrl: string, devPort: number): void {\n    const url = this.buildWsUrl(devHostUrl, devPort)\n    let entry = this.entries.get(packageName)\n    if (entry) {\n      // Already have an entry; if the URL changed (e.g. LAN IP shifted), close\n      // and rebuild.\n      if (entry.url === url && (entry.state === \"connecting\" || entry.state === \"connected\")) return\n      this.teardownEntry(entry)\n    }\n    entry = {\n      state: \"idle\",\n      ws: null,\n      url,\n      attempts: 0,\n      ringBuffer: [],\n      ringBytes: 0,\n      reloadHandler: null,\n      reconnectTimer: null,\n    }\n    this.entries.set(packageName, entry)\n    this.openSocket(packageName, entry)\n  }\n\n  /** Close a bridge for good. Called from MiniappHost.unmount. */\n  public disconnect(packageName: string): void {\n    const entry = this.entries.get(packageName)\n    if (!entry) return\n    entry.state = \"closed\"\n    this.teardownEntry(entry)\n    this.entries.delete(packageName)\n  }\n\n  /**\n   * Forward a `log` envelope to the connected dev sidecar. Called from\n   * the JSContext side (`MentraJSRouter.__log` handler) AND the WebView\n   * side (`MentraUIRouter.routeFromWebView` for `type:\"log\"` frames).\n   *\n   * `source` distinguishes the two halves so the CLI can prefix lines\n   * `[UI]` vs `[MentraJS]`. Logs are silently dropped when no bridge\n   * exists for the package (no `mentra-miniapp dev` running) and\n   * buffered in the per-bridge ring while disconnected.\n   */\n  public forwardLog(\n    packageName: string,\n    level: string,\n    args: unknown[],\n    timestamp: number,\n    source: \"ui\" | \"background\",\n  ): void {\n    const entry = this.entries.get(packageName)\n    if (!entry) return\n    const message = JSON.stringify({type: \"log\", level, args, packageName, timestamp, source})\n    if (entry.state === \"connected\" && entry.ws) {\n      try {\n        entry.ws.send(message)\n        return\n      } catch {\n        // Fall through to buffer.\n      }\n    }\n    this.bufferLog(entry, {packageName, level, args, timestamp, source, size: message.length})\n  }\n\n  // -----------------------------------------------------------------------\n\n  private buildWsUrl(devHostUrl: string, devPort: number): string {\n    let host: string\n    try {\n      const parsed = new URL(devHostUrl)\n      host = parsed.hostname\n    } catch {\n      // devHostUrl might already be just an IP; best-effort.\n      host = devHostUrl.replace(/^https?:\\/\\//, \"\").split(\":\")[0].split(\"/\")[0]\n    }\n    return `ws://${host}:${devPort}/__mentra_dev`\n  }\n\n  private openSocket(packageName: string, entry: BridgeEntry): void {\n    if (entry.state === \"closed\") return\n    entry.state = \"connecting\"\n    const ws = new WebSocket(entry.url)\n    entry.ws = ws\n\n    let helloTimer: ReturnType<typeof setTimeout> | null = null\n    let helloAcked = false\n\n    const teardown = (reason: string): void => {\n      if (helloTimer) {\n        clearTimeout(helloTimer)\n        helloTimer = null\n      }\n      try {\n        ws.close()\n      } catch {\n        /* ignore */\n      }\n      if (entry.state === \"closed\") return\n      entry.state = \"disconnected\"\n      entry.ws = null\n      entry.attempts++\n      console.log(`${LOG_TAG}: ${packageName} disconnected (${reason}); reconnect in ${this.backoffMs(entry.attempts)}ms`)\n      this.scheduleReconnect(packageName, entry)\n    }\n\n    ws.onopen = () => {\n      // Send hello; wait for hello-ack to confirm we hit the right server.\n      try {\n        ws.send(JSON.stringify({type: \"hello\", protocol: PROTOCOL_VERSION}))\n      } catch {\n        teardown(\"hello send failed\")\n        return\n      }\n      helloTimer = setTimeout(() => {\n        if (!helloAcked) {\n          teardown(\"hello-ack timeout\")\n        }\n      }, HELLO_TIMEOUT_MS)\n    }\n\n    ws.onmessage = (ev) => {\n      const data = typeof ev.data === \"string\" ? ev.data : null\n      if (!data) return\n      let parsed: {type?: string; protocol?: string} | null = null\n      try {\n        parsed = JSON.parse(data)\n      } catch {\n        return\n      }\n      if (!parsed) return\n\n      if (parsed.type === \"hello-ack\") {\n        if (parsed.protocol !== PROTOCOL_VERSION) {\n          teardown(`protocol mismatch: server sent ${parsed.protocol}, expected ${PROTOCOL_VERSION}`)\n          return\n        }\n        helloAcked = true\n        if (helloTimer) {\n          clearTimeout(helloTimer)\n          helloTimer = null\n        }\n        entry.state = \"connected\"\n        entry.attempts = 0\n        console.log(`${LOG_TAG}: ${packageName} connected to ${entry.url}`)\n        this.flushRingBuffer(packageName, entry)\n        return\n      }\n\n      if (parsed.type === \"reload\") {\n        console.log(`${LOG_TAG}: ${packageName} received reload signal`)\n        this.globalReloadHandler?.(packageName)\n        return\n      }\n\n      // Two-layer dev signal: filesystem changes under src/background/\n      // trigger a full JSContext kill + respawn (not just a WebView\n      // reload). The host's MentraJSRouter listens here.\n      if (parsed.type === \"respawn-bg\") {\n        console.log(`${LOG_TAG}: ${packageName} received respawn-bg signal`)\n        this.globalRespawnBackgroundHandler?.(packageName)\n        return\n      }\n    }\n\n    ws.onerror = () => {\n      // onclose follows; defer all teardown to that path so we don't double-fire.\n    }\n\n    ws.onclose = () => {\n      teardown(helloAcked ? \"ws closed\" : \"ws closed before hello-ack\")\n    }\n  }\n\n  private scheduleReconnect(packageName: string, entry: BridgeEntry): void {\n    if (entry.state === \"closed\") return\n    if (entry.reconnectTimer) clearTimeout(entry.reconnectTimer)\n    const delay = this.backoffMs(entry.attempts)\n    entry.reconnectTimer = setTimeout(() => {\n      entry.reconnectTimer = null\n      // Verify still alive and still in the bridge map.\n      const current = this.entries.get(packageName)\n      if (!current || current !== entry || entry.state === \"closed\") return\n      this.openSocket(packageName, entry)\n    }, delay)\n  }\n\n  private backoffMs(attempts: number): number {\n    const exp = Math.min(BACKOFF_MAX_MS, BACKOFF_MIN_MS * Math.pow(2, Math.max(0, attempts - 1)))\n    const jitter = exp * (0.8 + Math.random() * 0.4)\n    return Math.round(jitter)\n  }\n\n  private bufferLog(entry: BridgeEntry, log: BufferedLog): void {\n    entry.ringBuffer.push(log)\n    entry.ringBytes += log.size\n    while (\n      entry.ringBuffer.length > RING_BUFFER_MAX_ENTRIES ||\n      entry.ringBytes > RING_BUFFER_MAX_BYTES\n    ) {\n      const dropped = entry.ringBuffer.shift()\n      if (dropped) entry.ringBytes -= dropped.size\n      if (entry.ringBuffer.length === 0) {\n        entry.ringBytes = 0\n        break\n      }\n    }\n  }\n\n  private flushRingBuffer(packageName: string, entry: BridgeEntry): void {\n    if (entry.ringBuffer.length === 0) return\n    const buffered = entry.ringBuffer\n    entry.ringBuffer = []\n    entry.ringBytes = 0\n    if (!entry.ws) return\n    for (const log of buffered) {\n      try {\n        entry.ws.send(\n          JSON.stringify({\n            type: \"log\",\n            level: log.level,\n            args: log.args,\n            packageName: log.packageName,\n            timestamp: log.timestamp,\n            source: log.source,\n          }),\n        )\n      } catch {\n        // Re-buffer on failure and bail.\n        entry.ringBuffer.unshift(log)\n        entry.ringBytes += log.size\n        return\n      }\n    }\n  }\n\n  private teardownEntry(entry: BridgeEntry): void {\n    if (entry.reconnectTimer) {\n      clearTimeout(entry.reconnectTimer)\n      entry.reconnectTimer = null\n    }\n    if (entry.ws) {\n      try {\n        entry.ws.close()\n      } catch {\n        /* ignore */\n      }\n      entry.ws = null\n    }\n  }\n}\n\nconst devServerBridge = new DevServerBridge()\nexport default devServerBridge\n"]}

package/build/services/DeviceEventRouter.d.ts

@@ -0,0 +1,3 @@
+export declare function startDeviceEventRouter(): void;
+export declare function stopDeviceEventRouter(): void;
+//# sourceMappingURL=DeviceEventRouter.d.ts.map

package/build/services/DeviceEventRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceEventRouter.d.ts","sourceRoot":"","sources":["../../src/services/DeviceEventRouter.ts"],"names":[],"mappings":"AAmCA,wBAAgB,sBAAsB,IAAI,IAAI,CAqM7C;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/build/services/DeviceEventRouter.js

@@ -0,0 +1,190 @@
+/**
+ * Device-event router — engine-owned. Subscribes to the inbound native BLE/device
+ * events and routes them into the engine runtime: device stores, the process event
+ * bus, the photo/stream coordinators, and local miniapps (via forwardEvent).
+ *
+ * Why this exists: engine owns the stores, coordinators, miniapp runtime, and facades,
+ * but it never *subscribed to the device* for most events — the host MantleManager was
+ * still the event router the whole runtime secretly depended on. So a bare OEM that
+ * imported engine + called engine.start() got a connected runtime with almost no device
+ * data flowing in (no miniapp input, dead gallery sync, starved coordinators). This
+ * service moves those inbound bridges into engine so ANY host gets them.
+ *
+ * Scope: the engine legs only. The Cloud V1 relays that used to live beside them in
+ * MantleManager (touch→cloud, the cloud-SDK stream/photo legs, etc.) were deleted with
+ * Cloud V1 app end-of-life.
+ *
+ * Started by `engine.start()`. Idempotent.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { shallow } from "zustand/shallow";
+import localMiniappRuntime from "./LocalMiniappRuntime";
+import localSttFallbackCoordinator from "./LocalSttFallbackCoordinator";
+import { phonePhotoCoordinator } from "./PhonePhotoCoordinator";
+import { phoneStreamCoordinator } from "./PhoneStreamCoordinator";
+import { isGlassesConnected } from "./GlassesReadiness";
+import { useGlassesStore } from "../stores/glasses";
+import { useSettingsStore } from "../stores/settings";
+import { useAppStatusStore } from "../stores/apps";
+import { retirePendingSelectionOnPromotion } from "./PairingIdentity";
+import GlobalEventEmitter from "../utils/GlobalEventEmitter";
+import { asgCameraApi } from "./asg/asgCameraApi";
+let subs = [];
+export function startDeviceEventRouter() {
+    if (subs.length)
+        return;
+    // --- device state → engine stores ---
+    // Standalone WiFi status → glasses store.
+    subs.push(BluetoothSdk.addListener("wifi_status_change", (event) => {
+        const { type: _type, ...wifi } = event;
+        useGlassesStore.getState().setGlassesInfo({ wifi });
+    }));
+    // Forward glasses Wi-Fi to miniapps (session.glasses.onWifi) from the STORE — the
+    // single source of truth — so every path converges here: wifi_status_change,
+    // onGlassesStatus, and BLE disconnect. Effective connectivity requires the glasses
+    // to be connected AND on Wi-Fi, so a disconnect correctly flips `connected` false.
+    subs.push({
+        remove: useGlassesStore.subscribe((s) => {
+            const connected = isGlassesConnected(s.connection) && s.wifi.state === "connected";
+            return {
+                connected,
+                ssid: s.wifi.state === "connected" ? s.wifi.ssid : undefined,
+                localIp: s.wifi.state === "connected" ? s.wifi.localIp : undefined,
+            };
+        }, (wifi) => localMiniappRuntime.forwardEvent("glasses_wifi", wifi), { equalityFn: shallow }),
+    });
+    // Incremental battery status → glasses store + local miniapps.
+    subs.push(BluetoothSdk.addListener("battery_status", (event) => {
+        const state = useGlassesStore.getState();
+        state.setBatteryInfo(event.level, event.charging, state.caseBatteryLevel, state.caseCharging);
+        localMiniappRuntime.forwardEvent("glasses_battery_update", {
+            type: "glasses_battery_update",
+            level: event.level,
+            charging: event.charging,
+            timestamp: event.timestamp ?? Date.now(),
+        });
+    }));
+    // Hotspot status → glasses store + event bus. engine's own gallerySyncService listens
+    // on the bus for these, so without this bridge engine's gallery sync is dead.
+    subs.push(BluetoothSdk.addListener("hotspot_status_change", (event) => {
+        const enabled = event.state === "enabled";
+        const ssid = enabled ? event.ssid : "";
+        const password = enabled ? event.password : "";
+        const localIp = enabled ? event.localIp : "";
+        useGlassesStore.getState().setHotspotInfo(enabled, ssid, password, localIp);
+        // Always retarget the ASG camera client: on disable (or an event with no
+        // IP) fall back to the localhost default so later calls fail fast instead
+        // of hitting the previous network's stale glasses IP.
+        asgCameraApi.setServer(localIp || "localhost", 8089);
+        GlobalEventEmitter.emit("hotspot_status_change", { enabled, ssid, password, local_ip: localIp });
+    }));
+    subs.push(BluetoothSdk.addListener("hotspot_error", (event) => {
+        GlobalEventEmitter.emit("hotspot_error", { error_message: event.errorMessage, timestamp: event.timestamp });
+    }));
+    // Glasses gallery content counts → event bus (consumed by gallerySyncService).
+    subs.push(BluetoothSdk.addListener("gallery_status", (event) => {
+        GlobalEventEmitter.emit("gallery_status", {
+            photos: event.photos,
+            videos: event.videos,
+            total: event.total,
+            has_content: event.hasContent,
+            camera_busy: event.cameraBusy,
+        });
+    }));
+    // Hardware-originated setting changes (user changes a setting ON the glasses) → store.
+    // The inbound complement to GlassesSettingsSync (which only pushes store→device).
+    subs.push(BluetoothSdk.addListener("save_setting", async (event) => {
+        const settings = useSettingsStore.getState();
+        // Damp the relay: native re-echoes some settings unconditionally (e.g.
+        // the identity block at every handleDeviceReady) — a same-value echo
+        // must not become a store write (persistence churn + change-push noise).
+        if (settings.getSetting(event.key) !== event.value) {
+            await settings.setSetting(event.key, event.value);
+        }
+        // Two-phase identity: a promoted default retires the pending selection
+        // marker. The rule lives with PairingIdentity (a no-op for other keys).
+        await retirePendingSelectionOnPromotion(event.key, event.value);
+    }));
+    // --- coordinators (owns()-gated) ---
+    // Phone-owned photo errors settle the in-flight long-poll fast (vs. timeout).
+    // Non-owned photo responses used to forward to the Cloud V1 photo pipeline via
+    // restComms; that relay was removed with Cloud V1 app end-of-life, so they drop.
+    // Wire v2 sends a short 4-hex BLE requestId; the coordinator maps it back to
+    // the cloud requestId (resolveCloudRequestId) before ownership checks.
+    subs.push(BluetoothSdk.addListener("photo_response", (event) => {
+        const cloudRequestId = event.requestId ? phonePhotoCoordinator.resolveCloudRequestId(event.requestId) : "";
+        if (cloudRequestId && phonePhotoCoordinator.owns(cloudRequestId)) {
+            if (event.state === "error") {
+                phonePhotoCoordinator.handlePhotoError(event.requestId ?? cloudRequestId, event.errorCode ?? "GLASSES_ERROR", event.errorMessage ?? "Glasses reported an error");
+            }
+        }
+    }));
+    // Phone-owned stream status / keep-alive → the stream coordinator. The Cloud V1 relay
+    // for non-owned streams was removed with Cloud V1 app end-of-life.
+    subs.push(BluetoothSdk.addListener("stream_status", (event) => {
+        if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {
+            phoneStreamCoordinator.handleGlassesStatus(event);
+        }
+    }));
+    subs.push(BluetoothSdk.addListener("keep_alive_ack", (event) => {
+        if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {
+            phoneStreamCoordinator.handleKeepAliveAck(event);
+        }
+    }));
+    // --- device input → local miniapps (forwardEvent is subscriber-gated; a no-op when
+    // no miniapp listens). The v1 SocketComms cloud legs for these were removed with
+    // the Cloud V1 ripout. ---
+    subs.push(BluetoothSdk.addListener("button_press", (event) => {
+        localMiniappRuntime.forwardEvent("button_press", event);
+    }));
+    subs.push(BluetoothSdk.addListener("touch_event", (event) => {
+        localMiniappRuntime.forwardEvent("touch_event", event);
+    }));
+    // G2 IMU accelerometer — payload already matches the miniapp AccelData shape.
+    subs.push(BluetoothSdk.addListener("accel_event", (event) => {
+        localMiniappRuntime.forwardEvent("accel_event", {
+            x: event.x,
+            y: event.y,
+            z: event.z,
+            timestamp: typeof event.timestamp === "number" ? event.timestamp : Date.now(),
+        });
+    }));
+    // Head position — translate native {up:boolean} → SDK {position:"up"|"down"}.
+    subs.push(BluetoothSdk.addListener("head_up", (event) => {
+        localMiniappRuntime.forwardEvent("head_up", { position: event.up ? "up" : "down", timestamp: Date.now() });
+    }));
+    // On-device STT transcripts → local miniapps only while the local engine is
+    // active (cloud fallback or an explicit forceLocal subscription). The runtime
+    // filters mixed local/cloud delivery per miniapp to avoid double-delivery.
+    // forwardEvent is subscriber-gated — a no-op when no miniapp listens.
+    // (Was MantleManager.handle_local_transcription; its offline-captions display branch
+    // went away with the pseudo captions renderer.)
+    subs.push(BluetoothSdk.addListener("local_transcription", (event) => {
+        if (!localSttFallbackCoordinator.isActive())
+            return;
+        const lang = event.transcribeLanguage ?? localSttFallbackCoordinator.getActiveLanguage() ?? "en-US";
+        localMiniappRuntime.forwardEvent(`transcription:${lang}`, event, "local");
+    }));
+    // --- glasses swipe-menu app launcher (G2) ---
+    subs.push(BluetoothSdk.addListener("miniapp_selected", (event) => {
+        const packageName = event.packageName;
+        if (!packageName)
+            return;
+        const app = useAppStatusStore.getState().apps.find((a) => a.packageName === packageName);
+        if (!app)
+            return;
+        // Toggle: stop if running, else start.
+        if (app.running) {
+            useAppStatusStore.getState().stop(packageName);
+        }
+        else {
+            useAppStatusStore.getState().start(app, { skipNavigation: true });
+        }
+    }));
+}
+export function stopDeviceEventRouter() {
+    for (const sub of subs)
+        sub.remove();
+    subs = [];
+}
+//# sourceMappingURL=DeviceEventRouter.js.map

package/build/services/DeviceEventRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceEventRouter.js","sourceRoot":"","sources":["../../src/services/DeviceEventRouter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Device-event router — engine-owned. Subscribes to the inbound native BLE/device\n * events and routes them into the engine runtime: device stores, the process event\n * bus, the photo/stream coordinators, and local miniapps (via forwardEvent).\n *\n * Why this exists: engine owns the stores, coordinators, miniapp runtime, and facades,\n * but it never *subscribed to the device* for most events — the host MantleManager was\n * still the event router the whole runtime secretly depended on. So a bare OEM that\n * imported engine + called engine.start() got a connected runtime with almost no device\n * data flowing in (no miniapp input, dead gallery sync, starved coordinators). This\n * service moves those inbound bridges into engine so ANY host gets them.\n *\n * Scope: the engine legs only. The Cloud V1 relays that used to live beside them in\n * MantleManager (touch→cloud, the cloud-SDK stream/photo legs, etc.) were deleted with\n * Cloud V1 app end-of-life.\n *\n * Started by `engine.start()`. Idempotent.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {shallow} from \"zustand/shallow\"\n\nimport localMiniappRuntime from \"./LocalMiniappRuntime\"\nimport localSttFallbackCoordinator from \"./LocalSttFallbackCoordinator\"\nimport {phonePhotoCoordinator} from \"./PhonePhotoCoordinator\"\nimport {phoneStreamCoordinator} from \"./PhoneStreamCoordinator\"\nimport {isGlassesConnected} from \"./GlassesReadiness\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {useSettingsStore} from \"../stores/settings\"\nimport {useAppStatusStore} from \"../stores/apps\"\nimport {retirePendingSelectionOnPromotion} from \"./PairingIdentity\"\nimport GlobalEventEmitter from \"../utils/GlobalEventEmitter\"\nimport {asgCameraApi} from \"./asg/asgCameraApi\"\n\nlet subs: Array<{remove: () => void}> = []\n\nexport function startDeviceEventRouter(): void {\n  if (subs.length) return\n\n  // --- device state → engine stores ---\n\n  // Standalone WiFi status → glasses store.\n  subs.push(\n    BluetoothSdk.addListener(\"wifi_status_change\", (event) => {\n      const {type: _type, ...wifi} = event\n      useGlassesStore.getState().setGlassesInfo({wifi})\n    }),\n  )\n\n  // Forward glasses Wi-Fi to miniapps (session.glasses.onWifi) from the STORE — the\n  // single source of truth — so every path converges here: wifi_status_change,\n  // onGlassesStatus, and BLE disconnect. Effective connectivity requires the glasses\n  // to be connected AND on Wi-Fi, so a disconnect correctly flips `connected` false.\n  subs.push({\n    remove: useGlassesStore.subscribe(\n      (s) => {\n        const connected = isGlassesConnected(s.connection) && s.wifi.state === \"connected\"\n        return {\n          connected,\n          ssid: s.wifi.state === \"connected\" ? s.wifi.ssid : undefined,\n          localIp: s.wifi.state === \"connected\" ? s.wifi.localIp : undefined,\n        }\n      },\n      (wifi) => localMiniappRuntime.forwardEvent(\"glasses_wifi\", wifi),\n      {equalityFn: shallow},\n    ),\n  })\n\n  // Incremental battery status → glasses store + local miniapps.\n  subs.push(\n    BluetoothSdk.addListener(\"battery_status\", (event) => {\n      const state = useGlassesStore.getState()\n      state.setBatteryInfo(event.level, event.charging, state.caseBatteryLevel, state.caseCharging)\n      localMiniappRuntime.forwardEvent(\"glasses_battery_update\", {\n        type: \"glasses_battery_update\",\n        level: event.level,\n        charging: event.charging,\n        timestamp: event.timestamp ?? Date.now(),\n      })\n    }),\n  )\n\n  // Hotspot status → glasses store + event bus. engine's own gallerySyncService listens\n  // on the bus for these, so without this bridge engine's gallery sync is dead.\n  subs.push(\n    BluetoothSdk.addListener(\"hotspot_status_change\", (event) => {\n      const enabled = event.state === \"enabled\"\n      const ssid = enabled ? event.ssid : \"\"\n      const password = enabled ? event.password : \"\"\n      const localIp = enabled ? event.localIp : \"\"\n      useGlassesStore.getState().setHotspotInfo(enabled, ssid, password, localIp)\n      // Always retarget the ASG camera client: on disable (or an event with no\n      // IP) fall back to the localhost default so later calls fail fast instead\n      // of hitting the previous network's stale glasses IP.\n      asgCameraApi.setServer(localIp || \"localhost\", 8089)\n      GlobalEventEmitter.emit(\"hotspot_status_change\", {enabled, ssid, password, local_ip: localIp})\n    }),\n  )\n  subs.push(\n    BluetoothSdk.addListener(\"hotspot_error\", (event) => {\n      GlobalEventEmitter.emit(\"hotspot_error\", {error_message: event.errorMessage, timestamp: event.timestamp})\n    }),\n  )\n\n  // Glasses gallery content counts → event bus (consumed by gallerySyncService).\n  subs.push(\n    BluetoothSdk.addListener(\"gallery_status\", (event) => {\n      GlobalEventEmitter.emit(\"gallery_status\", {\n        photos: event.photos,\n        videos: event.videos,\n        total: event.total,\n        has_content: event.hasContent,\n        camera_busy: event.cameraBusy,\n      })\n    }),\n  )\n\n  // Hardware-originated setting changes (user changes a setting ON the glasses) → store.\n  // The inbound complement to GlassesSettingsSync (which only pushes store→device).\n  subs.push(\n    BluetoothSdk.addListener(\"save_setting\", async (event) => {\n      const settings = useSettingsStore.getState()\n      // Damp the relay: native re-echoes some settings unconditionally (e.g.\n      // the identity block at every handleDeviceReady) — a same-value echo\n      // must not become a store write (persistence churn + change-push noise).\n      if (settings.getSetting(event.key) !== event.value) {\n        await settings.setSetting(event.key, event.value)\n      }\n      // Two-phase identity: a promoted default retires the pending selection\n      // marker. The rule lives with PairingIdentity (a no-op for other keys).\n      await retirePendingSelectionOnPromotion(event.key, event.value)\n    }),\n  )\n\n  // --- coordinators (owns()-gated) ---\n\n  // Phone-owned photo errors settle the in-flight long-poll fast (vs. timeout).\n  // Non-owned photo responses used to forward to the Cloud V1 photo pipeline via\n  // restComms; that relay was removed with Cloud V1 app end-of-life, so they drop.\n  // Wire v2 sends a short 4-hex BLE requestId; the coordinator maps it back to\n  // the cloud requestId (resolveCloudRequestId) before ownership checks.\n  subs.push(\n    BluetoothSdk.addListener(\"photo_response\", (event) => {\n      const cloudRequestId = event.requestId ? phonePhotoCoordinator.resolveCloudRequestId(event.requestId) : \"\"\n      if (cloudRequestId && phonePhotoCoordinator.owns(cloudRequestId)) {\n        if (event.state === \"error\") {\n          phonePhotoCoordinator.handlePhotoError(\n            event.requestId ?? cloudRequestId,\n            event.errorCode ?? \"GLASSES_ERROR\",\n            event.errorMessage ?? \"Glasses reported an error\",\n          )\n        }\n      }\n    }),\n  )\n\n  // Phone-owned stream status / keep-alive → the stream coordinator. The Cloud V1 relay\n  // for non-owned streams was removed with Cloud V1 app end-of-life.\n  subs.push(\n    BluetoothSdk.addListener(\"stream_status\", (event) => {\n      if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {\n        phoneStreamCoordinator.handleGlassesStatus(event)\n      }\n    }),\n  )\n  subs.push(\n    BluetoothSdk.addListener(\"keep_alive_ack\", (event) => {\n      if (event.streamId && phoneStreamCoordinator.owns(event.streamId)) {\n        phoneStreamCoordinator.handleKeepAliveAck(event)\n      }\n    }),\n  )\n\n  // --- device input → local miniapps (forwardEvent is subscriber-gated; a no-op when\n  // no miniapp listens). The v1 SocketComms cloud legs for these were removed with\n  // the Cloud V1 ripout. ---\n\n  subs.push(\n    BluetoothSdk.addListener(\"button_press\", (event) => {\n      localMiniappRuntime.forwardEvent(\"button_press\", event)\n    }),\n  )\n  subs.push(\n    BluetoothSdk.addListener(\"touch_event\", (event) => {\n      localMiniappRuntime.forwardEvent(\"touch_event\", event)\n    }),\n  )\n  // G2 IMU accelerometer — payload already matches the miniapp AccelData shape.\n  subs.push(\n    BluetoothSdk.addListener(\"accel_event\", (event) => {\n      localMiniappRuntime.forwardEvent(\"accel_event\", {\n        x: event.x,\n        y: event.y,\n        z: event.z,\n        timestamp: typeof event.timestamp === \"number\" ? event.timestamp : Date.now(),\n      })\n    }),\n  )\n  // Head position — translate native {up:boolean} → SDK {position:\"up\"|\"down\"}.\n  subs.push(\n    BluetoothSdk.addListener(\"head_up\", (event) => {\n      localMiniappRuntime.forwardEvent(\"head_up\", {position: event.up ? \"up\" : \"down\", timestamp: Date.now()})\n    }),\n  )\n  // On-device STT transcripts → local miniapps only while the local engine is\n  // active (cloud fallback or an explicit forceLocal subscription). The runtime\n  // filters mixed local/cloud delivery per miniapp to avoid double-delivery.\n  // forwardEvent is subscriber-gated — a no-op when no miniapp listens.\n  // (Was MantleManager.handle_local_transcription; its offline-captions display branch\n  // went away with the pseudo captions renderer.)\n  subs.push(\n    BluetoothSdk.addListener(\"local_transcription\", (event) => {\n      if (!localSttFallbackCoordinator.isActive()) return\n      const lang = event.transcribeLanguage ?? localSttFallbackCoordinator.getActiveLanguage() ?? \"en-US\"\n      localMiniappRuntime.forwardEvent(`transcription:${lang}`, event, \"local\")\n    }),\n  )\n\n  // --- glasses swipe-menu app launcher (G2) ---\n  subs.push(\n    BluetoothSdk.addListener(\"miniapp_selected\", (event) => {\n      const packageName = event.packageName as string\n      if (!packageName) return\n      const app = useAppStatusStore.getState().apps.find((a) => a.packageName === packageName)\n      if (!app) return\n      // Toggle: stop if running, else start.\n      if (app.running) {\n        useAppStatusStore.getState().stop(packageName)\n      } else {\n        useAppStatusStore.getState().start(app, {skipNavigation: true})\n      }\n    }),\n  )\n}\n\nexport function stopDeviceEventRouter(): void {\n  for (const sub of subs) sub.remove()\n  subs = []\n}\n"]}

package/build/services/DeviceStoreHydration.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Seed the native DeviceStore from the persisted settings. Single-flight: the
+ * first caller runs it, everyone else awaits the same promise. On failure the
+ * current awaiters see the rejection (and fail open — the pre-guard behavior,
+ * where the connect calls' own error handling was the last line of defense),
+ * and the memo clears so a LATER read can retry and heal.
+ */
+export declare function hydrateDeviceStore(): Promise<void>;
+/**
+ * Test-only: clear the hydration memo so each test starts from an unhydrated
+ * store instead of inheriting whichever hydration a previous test ran.
+ */
+export declare function resetDeviceStoreHydrationForTests(): void;
+/**
+ * Whether the SDK holds an actual default DEVICE to reconnect to — the
+ * hydration-aware two-state read. Distinct from the `default_wearable`
+ * setting (a model string that pending/orphaned states can hold without any
+ * paired device): `connectDefault()` throws without a device.
+ * Rejects if hydration failed; callers fail open.
+ */
+export declare function hasDefaultDevice(): Promise<boolean>;
+/**
+ * Boot repair for the orphaned-identity population: a persisted
+ * `default_wearable` whose native default device does not exist after a
+ * completed hydration. Two-phase writes stop NEW orphans from forming
+ * (identity is only promoted at pairing success); this demotes the ones
+ * already in the field — selection-time writes abandoned before pairing
+ * succeeded, and identity resurrected from the server before it stopped
+ * syncing — down to `pending_wearable`, which the host renders as a
+ * finish-pairing card instead of a connect button that would throw
+ * "Set a default glasses device before calling connectDefault".
+ *
+ * Runs after hydration on every start; converges because a demoted default
+ * can't re-trip the condition. Skips while the link layer is busy or
+ * connected (an in-flight pairing owns the identity right now).
+ */
+export declare function demoteOrphanedDefaultWearable(): Promise<void>;
+//# sourceMappingURL=DeviceStoreHydration.d.ts.map

package/build/services/DeviceStoreHydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceStoreHydration.d.ts","sourceRoot":"","sources":["../../src/services/DeviceStoreHydration.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBlD;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BnE"}

package/build/services/DeviceStoreHydration.js

@@ -0,0 +1,124 @@
+/**
+ * DeviceStoreHydration — the cold-start contract for the native DeviceStore.
+ *
+ * The Bluetooth SDK's DeviceStore is in-memory on BOTH platforms: every key
+ * (including the pairing identity `default_wearable` / `device_name` /
+ * `device_address`) initializes to "" at process start and only becomes real
+ * once JS pushes the persisted settings over `updateBluetoothSettings`. Until
+ * that seed lands, `BluetoothSdk.getDefaultDevice()` returns null for
+ * genuinely-paired users — the false "absent" that made the first
+ * hasDefaultDevice guard misfire at cold start (see the revert of the
+ * hasDefaultDevice pairing-route guards).
+ *
+ * This service makes that seed an explicit, awaited initialization step:
+ *   1. load the persisted settings store (idempotent),
+ *   2. push the full Bluetooth settings set (identity included) to native.
+ * `engine.start()` awaits it, so every post-start `getDefaultDevice()` read is
+ * a trustworthy two-state answer. `hasDefaultDevice()` also awaits it
+ * internally (belt-and-suspenders for reads that race start()).
+ *
+ * Failure surfaces as a REJECTION — never a false "absent". Callers guarding
+ * destructive or routing decisions must fail open (treat as "has a device"),
+ * matching the foreground-reconnect pattern.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { useSettingsStore, SETTINGS } from "../stores/settings";
+import { useGlassesStore } from "../stores/glasses";
+import { pushAllBluetoothSettings } from "./GlassesSettingsSync";
+import { demoteDefaultToPending } from "./PairingIdentity";
+import { DeviceTypes } from "../types";
+let hydrationPromise = null;
+/**
+ * Seed the native DeviceStore from the persisted settings. Single-flight: the
+ * first caller runs it, everyone else awaits the same promise. On failure the
+ * current awaiters see the rejection (and fail open — the pre-guard behavior,
+ * where the connect calls' own error handling was the last line of defense),
+ * and the memo clears so a LATER read can retry and heal.
+ */
+export function hydrateDeviceStore() {
+    if (!hydrationPromise) {
+        const startedAt = Date.now();
+        hydrationPromise = (async () => {
+            const loadResult = await useSettingsStore.getState().loadAllSettings();
+            if (loadResult.is_error()) {
+                throw new Error(`DeviceStoreHydration: settings load failed: ${loadResult.error}`);
+            }
+            await pushAllBluetoothSettings();
+            const settings = useSettingsStore.getState();
+            const model = settings.getSetting(SETTINGS.default_wearable.key);
+            const hasName = !!settings.getSetting(SETTINGS.device_name.key);
+            // Cold-start timing evidence: this line must appear BEFORE any
+            // RECONNECT/guard log for the hydration contract to hold on device.
+            console.log(`DeviceStoreHydration: native seed complete in ${Date.now() - startedAt}ms ` +
+                `(default_wearable=${model || "<none>"}, device_name present=${hasName})`);
+        })().catch((error) => {
+            hydrationPromise = null;
+            throw error;
+        });
+    }
+    return hydrationPromise;
+}
+/**
+ * Test-only: clear the hydration memo so each test starts from an unhydrated
+ * store instead of inheriting whichever hydration a previous test ran.
+ */
+export function resetDeviceStoreHydrationForTests() {
+    hydrationPromise = null;
+}
+/**
+ * Whether the SDK holds an actual default DEVICE to reconnect to — the
+ * hydration-aware two-state read. Distinct from the `default_wearable`
+ * setting (a model string that pending/orphaned states can hold without any
+ * paired device): `connectDefault()` throws without a device.
+ * Rejects if hydration failed; callers fail open.
+ */
+export async function hasDefaultDevice() {
+    await hydrateDeviceStore();
+    return !!(await BluetoothSdk.getDefaultDevice());
+}
+/**
+ * Boot repair for the orphaned-identity population: a persisted
+ * `default_wearable` whose native default device does not exist after a
+ * completed hydration. Two-phase writes stop NEW orphans from forming
+ * (identity is only promoted at pairing success); this demotes the ones
+ * already in the field — selection-time writes abandoned before pairing
+ * succeeded, and identity resurrected from the server before it stopped
+ * syncing — down to `pending_wearable`, which the host renders as a
+ * finish-pairing card instead of a connect button that would throw
+ * "Set a default glasses device before calling connectDefault".
+ *
+ * Runs after hydration on every start; converges because a demoted default
+ * can't re-trip the condition. Skips while the link layer is busy or
+ * connected (an in-flight pairing owns the identity right now).
+ */
+export async function demoteOrphanedDefaultWearable() {
+    // Never judge "native default absent" against an unseeded store: a valid
+    // pairing identity would read as an orphan and be demoted. Awaiting the
+    // (memoized) hydration makes the check safe regardless of call ordering;
+    // a failed hydration rejects here instead of demoting blind.
+    await hydrateDeviceStore();
+    const settings = useSettingsStore.getState();
+    const model = settings.getSetting(SETTINGS.default_wearable.key);
+    if (!model)
+        return;
+    // The simulated device is its own identity (name mirrors the model); it
+    // reconstructs a native default from settings alone and never orphans.
+    if (model.includes(DeviceTypes.SIMULATED))
+        return;
+    // "disconnected" is the only idle state — anything else (scanning /
+    // connecting / bonding / connected) means a pairing or link owns the
+    // identity right now.
+    if (useGlassesStore.getState().connection.state !== "disconnected")
+        return;
+    if (await BluetoothSdk.getDefaultDevice())
+        return;
+    console.log(`DeviceStoreHydration: demoting orphaned default_wearable "${model}" to pending_wearable`);
+    // The identity write set (latest-selection-wins backfill + identity-triplet
+    // clear) lives with PairingIdentity, the single writer of the JS-side
+    // identity keys; this boot repair owns only the guards above.
+    await demoteDefaultToPending(model);
+    // The hydration seed already landed the pre-demotion values in the native
+    // store; re-push so native mirrors the demoted identity too.
+    await pushAllBluetoothSettings();
+}
+//# sourceMappingURL=DeviceStoreHydration.js.map

package/build/services/DeviceStoreHydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceStoreHydration.js","sourceRoot":"","sources":["../../src/services/DeviceStoreHydration.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DeviceStoreHydration — the cold-start contract for the native DeviceStore.\n *\n * The Bluetooth SDK's DeviceStore is in-memory on BOTH platforms: every key\n * (including the pairing identity `default_wearable` / `device_name` /\n * `device_address`) initializes to \"\" at process start and only becomes real\n * once JS pushes the persisted settings over `updateBluetoothSettings`. Until\n * that seed lands, `BluetoothSdk.getDefaultDevice()` returns null for\n * genuinely-paired users — the false \"absent\" that made the first\n * hasDefaultDevice guard misfire at cold start (see the revert of the\n * hasDefaultDevice pairing-route guards).\n *\n * This service makes that seed an explicit, awaited initialization step:\n *   1. load the persisted settings store (idempotent),\n *   2. push the full Bluetooth settings set (identity included) to native.\n * `engine.start()` awaits it, so every post-start `getDefaultDevice()` read is\n * a trustworthy two-state answer. `hasDefaultDevice()` also awaits it\n * internally (belt-and-suspenders for reads that race start()).\n *\n * Failure surfaces as a REJECTION — never a false \"absent\". Callers guarding\n * destructive or routing decisions must fail open (treat as \"has a device\"),\n * matching the foreground-reconnect pattern.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {pushAllBluetoothSettings} from \"./GlassesSettingsSync\"\nimport {demoteDefaultToPending} from \"./PairingIdentity\"\nimport {DeviceTypes} from \"../types\"\n\nlet hydrationPromise: Promise<void> | null = null\n\n/**\n * Seed the native DeviceStore from the persisted settings. Single-flight: the\n * first caller runs it, everyone else awaits the same promise. On failure the\n * current awaiters see the rejection (and fail open — the pre-guard behavior,\n * where the connect calls' own error handling was the last line of defense),\n * and the memo clears so a LATER read can retry and heal.\n */\nexport function hydrateDeviceStore(): Promise<void> {\n  if (!hydrationPromise) {\n    const startedAt = Date.now()\n    hydrationPromise = (async () => {\n      const loadResult = await useSettingsStore.getState().loadAllSettings()\n      if (loadResult.is_error()) {\n        throw new Error(`DeviceStoreHydration: settings load failed: ${loadResult.error}`)\n      }\n      await pushAllBluetoothSettings()\n      const settings = useSettingsStore.getState()\n      const model = settings.getSetting(SETTINGS.default_wearable.key)\n      const hasName = !!settings.getSetting(SETTINGS.device_name.key)\n      // Cold-start timing evidence: this line must appear BEFORE any\n      // RECONNECT/guard log for the hydration contract to hold on device.\n      console.log(\n        `DeviceStoreHydration: native seed complete in ${Date.now() - startedAt}ms ` +\n          `(default_wearable=${model || \"<none>\"}, device_name present=${hasName})`,\n      )\n    })().catch((error) => {\n      hydrationPromise = null\n      throw error\n    })\n  }\n  return hydrationPromise\n}\n\n/**\n * Test-only: clear the hydration memo so each test starts from an unhydrated\n * store instead of inheriting whichever hydration a previous test ran.\n */\nexport function resetDeviceStoreHydrationForTests(): void {\n  hydrationPromise = null\n}\n\n/**\n * Whether the SDK holds an actual default DEVICE to reconnect to — the\n * hydration-aware two-state read. Distinct from the `default_wearable`\n * setting (a model string that pending/orphaned states can hold without any\n * paired device): `connectDefault()` throws without a device.\n * Rejects if hydration failed; callers fail open.\n */\nexport async function hasDefaultDevice(): Promise<boolean> {\n  await hydrateDeviceStore()\n  return !!(await BluetoothSdk.getDefaultDevice())\n}\n\n/**\n * Boot repair for the orphaned-identity population: a persisted\n * `default_wearable` whose native default device does not exist after a\n * completed hydration. Two-phase writes stop NEW orphans from forming\n * (identity is only promoted at pairing success); this demotes the ones\n * already in the field — selection-time writes abandoned before pairing\n * succeeded, and identity resurrected from the server before it stopped\n * syncing — down to `pending_wearable`, which the host renders as a\n * finish-pairing card instead of a connect button that would throw\n * \"Set a default glasses device before calling connectDefault\".\n *\n * Runs after hydration on every start; converges because a demoted default\n * can't re-trip the condition. Skips while the link layer is busy or\n * connected (an in-flight pairing owns the identity right now).\n */\nexport async function demoteOrphanedDefaultWearable(): Promise<void> {\n  // Never judge \"native default absent\" against an unseeded store: a valid\n  // pairing identity would read as an orphan and be demoted. Awaiting the\n  // (memoized) hydration makes the check safe regardless of call ordering;\n  // a failed hydration rejects here instead of demoting blind.\n  await hydrateDeviceStore()\n\n  const settings = useSettingsStore.getState()\n  const model = settings.getSetting(SETTINGS.default_wearable.key) as string | undefined\n  if (!model) return\n  // The simulated device is its own identity (name mirrors the model); it\n  // reconstructs a native default from settings alone and never orphans.\n  if (model.includes(DeviceTypes.SIMULATED)) return\n\n  // \"disconnected\" is the only idle state — anything else (scanning /\n  // connecting / bonding / connected) means a pairing or link owns the\n  // identity right now.\n  if (useGlassesStore.getState().connection.state !== \"disconnected\") return\n\n  if (await BluetoothSdk.getDefaultDevice()) return\n\n  console.log(`DeviceStoreHydration: demoting orphaned default_wearable \"${model}\" to pending_wearable`)\n  // The identity write set (latest-selection-wins backfill + identity-triplet\n  // clear) lives with PairingIdentity, the single writer of the JS-side\n  // identity keys; this boot repair owns only the guards above.\n  await demoteDefaultToPending(model)\n  // The hydration seed already landed the pre-demotion values in the native\n  // store; re-push so native mirrors the demoted identity too.\n  await pushAllBluetoothSettings()\n}\n"]}