@mentra/engine 0.1.0-beta.0 → 0.1.0-dev.1

package/build/utils/devMiniappLaunch.js

@@ -12,21 +12,28 @@
  *      get it in the same round trip — no second fetch.
  *
  * Pre-flighting at the call site keeps /applet/local a pure mount route.
+ *
+ * When the laptop's Wi-Fi IP changes, the URL stored from the last QR scan
+ * goes stale. We then retry alternate hosts (Metro / EXPO_PUBLIC_LOCAL_MINIAPP_HOST,
+ * plus an mDNS name captured at scan time) and persist the working URL so
+ * the next launch doesn't need a re-scan.
  */
+import { configuredDevHost } from "./configuredDevHost";
 import { storage } from "./storage/storage";
 const REACHABILITY_TIMEOUT_MS = 1500;
-/**
- * GET <devUrl>/miniapp.json with a hard timeout. Returns the parsed
- * manifest on success ("live") or null ("offline").
- *
- * Side effect: on success, writes <packageName>_dev_last_reachable so
- * the dev-offline screen can show "Last reached: N min ago" the next
- * time the user lands there.
- *
- * The fetch doubles as the reachability probe AND the manifest source —
- * one request per launch attempt instead of two.
- */
-export async function decideDevLaunchRoute(packageName, devUrl) {
+// A single dropped DNS lookup or momentary Wi-Fi blip (AP roam, DHCP renewal,
+// phone hopping to cellular for a beat) looks identical to a dead dev server —
+// both throw out of fetch(). Retrying once absorbs that transient case instead
+// of bouncing straight to the offline screen. We do NOT retry a real HTTP
+// response (res.ok === false): that's the server telling us something
+// definitive, not a network-layer hiccup.
+const REACHABILITY_MAX_ATTEMPTS = 2;
+const REACHABILITY_RETRY_DELAY_MS = 400;
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Single GET <devUrl>/miniapp.json attempt with a hard timeout. */
+async function fetchManifestOnce(devUrl) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), REACHABILITY_TIMEOUT_MS);
     try {
@@ -35,18 +42,134 @@ export async function decideDevLaunchRoute(packageName, devUrl) {
             signal: controller.signal,
         });
         if (!res.ok)
-            return { decision: "offline", manifest: null };
-        const manifest = (await res.json());
-        if (packageName) {
-            storage.save(`${packageName}_dev_last_reachable`, Date.now());
-        }
-        return { decision: "live", manifest };
-    }
-    catch {
-        return { decision: "offline", manifest: null };
+            return null;
+        return (await res.json());
     }
     finally {
         clearTimeout(timer);
     }
 }
+function rewriteHost(devUrl, host) {
+    const trimmed = host.trim();
+    if (!trimmed)
+        return null;
+    try {
+        const url = new URL(devUrl);
+        if (url.hostname === trimmed)
+            return null;
+        url.hostname = trimmed;
+        return url.toString().replace(/\/$/, "");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Point an http(s) icon at the host that actually answered. Cached dev icons are
+ * local `file://` paths and third-party icons live on unrelated hosts, so only
+ * icons still served by the stale dev host are rewritten.
+ */
+function rewriteIconHost(iconUrl, staleDevUrl, resolvedDevUrl) {
+    try {
+        const icon = new URL(iconUrl);
+        if (icon.protocol !== "http:" && icon.protocol !== "https:")
+            return null;
+        const stale = new URL(staleDevUrl);
+        const resolved = new URL(resolvedDevUrl);
+        // Compare host (hostname+port) so an icon on the same hostname but a
+        // different service port is left alone.
+        if (icon.host !== stale.host)
+            return null;
+        icon.host = resolved.host;
+        return icon.toString();
+    }
+    catch {
+        return null;
+    }
+}
+function collectAlternateHosts(packageName, extra) {
+    const hosts = [];
+    const push = (h) => {
+        const v = h?.trim();
+        if (v && !hosts.includes(v))
+            hosts.push(v);
+    };
+    push(configuredDevHost());
+    if (packageName) {
+        const mdns = storage.load(`${packageName}_dev_mdns`);
+        if (mdns.is_ok())
+            push(mdns.value);
+    }
+    for (const h of extra ?? [])
+        push(h);
+    return hosts;
+}
+async function probeUrl(devUrl) {
+    for (let attempt = 1; attempt <= REACHABILITY_MAX_ATTEMPTS; attempt++) {
+        try {
+            const manifest = await fetchManifestOnce(devUrl);
+            // Definitive HTTP failure — do not retry this URL further.
+            if (!manifest)
+                return null;
+            return manifest;
+        }
+        catch {
+            if (attempt < REACHABILITY_MAX_ATTEMPTS) {
+                await delay(REACHABILITY_RETRY_DELAY_MS);
+                continue;
+            }
+            return "network-error";
+        }
+    }
+    return "network-error";
+}
+/**
+ * GET <devUrl>/miniapp.json with a hard timeout, retrying once on a
+ * network-layer failure (DNS/connection/abort) before trying alternate
+ * hosts (Metro laptop IP, mDNS name from the QR). Returns the parsed
+ * manifest on success ("live") or null ("offline").
+ *
+ * Side effects on success:
+ *   - writes <packageName>_dev_last_reachable
+ *   - if an alternate host worked, rewrites <packageName>_dev_url so the
+ *     next launch skips the stale IP
+ */
+export async function decideDevLaunchRoute(packageName, devUrl, options) {
+    const candidates = [devUrl];
+    for (const host of collectAlternateHosts(packageName, options?.alternateHosts)) {
+        const rewritten = rewriteHost(devUrl, host);
+        if (rewritten && !candidates.includes(rewritten))
+            candidates.push(rewritten);
+    }
+    for (const candidate of candidates) {
+        const result = await probeUrl(candidate);
+        if (result === "network-error" || result === null)
+            continue;
+        if (packageName) {
+            storage.save(`${packageName}_dev_last_reachable`, Date.now());
+            if (candidate !== devUrl) {
+                storage.save(`${packageName}_dev_url`, candidate);
+                // Keep _dev_meta.devUrl in sync when present so home-tile reads match.
+                const metaRes = storage.load(`${packageName}_dev_meta`);
+                if (metaRes.is_ok()) {
+                    try {
+                        const meta = JSON.parse(metaRes.value);
+                        meta.devUrl = candidate;
+                        if (typeof meta.iconUrl === "string") {
+                            const rewritten = rewriteIconHost(meta.iconUrl, devUrl, candidate);
+                            if (rewritten)
+                                meta.iconUrl = rewritten;
+                        }
+                        storage.save(`${packageName}_dev_meta`, JSON.stringify(meta));
+                    }
+                    catch {
+                        /* ignore malformed meta */
+                    }
+                }
+            }
+        }
+        return { decision: "live", manifest: result, resolvedUrl: candidate };
+    }
+    return { decision: "offline", manifest: null };
+}
 //# sourceMappingURL=devMiniappLaunch.js.map

package/build/utils/devMiniappLaunch.js.map

@@ -1 +1 @@
-{"version":3,"file":"devMiniappLaunch.js","sourceRoot":"","sources":["../../src/utils/devMiniappLaunch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AAEzC,MAAM,uBAAuB,GAAG,IAAI,CAAA;AAgBpC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,MAAc;IAEd,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAA;IAC3E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,EAAE;YACnE,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAA;QAClD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,qBAAqB,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QAC/D,CAAC;QACD,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAC,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAA;IAC9C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC","sourcesContent":["/**\n * decideDevLaunchRoute — pre-flight reachability + manifest fetch for dev\n * miniapp launches.\n *\n * Every entry point that wants to launch a dev miniapp (home tile, QR\n * scan, URL screen, dev-offline \"Try again\" button) calls this BEFORE\n * navigating, so:\n *\n *   1. We land on the right destination in a single transition\n *      (live mount vs offline takeover) — no flash through /applet/local.\n *   2. Callers that need the manifest (permission gate, name/icon read)\n *      get it in the same round trip — no second fetch.\n *\n * Pre-flighting at the call site keeps /applet/local a pure mount route.\n */\n\nimport {storage} from \"./storage/storage\"\n\nconst REACHABILITY_TIMEOUT_MS = 1500\n\nexport type DevManifest = {\n  packageName?: string\n  name?: string\n  /** First-found of `icon` / `iconUrl` / `logoUrl` (relative or absolute). */\n  icon?: string\n  permissions?: unknown\n  hardwareRequirements?: unknown\n  [key: string]: unknown\n}\n\nexport type DevLaunchResult =\n  | {decision: \"live\"; manifest: DevManifest}\n  | {decision: \"offline\"; manifest: null}\n\n/**\n * GET <devUrl>/miniapp.json with a hard timeout. Returns the parsed\n * manifest on success (\"live\") or null (\"offline\").\n *\n * Side effect: on success, writes <packageName>_dev_last_reachable so\n * the dev-offline screen can show \"Last reached: N min ago\" the next\n * time the user lands there.\n *\n * The fetch doubles as the reachability probe AND the manifest source —\n * one request per launch attempt instead of two.\n */\nexport async function decideDevLaunchRoute(\n  packageName: string,\n  devUrl: string,\n): Promise<DevLaunchResult> {\n  const controller = new AbortController()\n  const timer = setTimeout(() => controller.abort(), REACHABILITY_TIMEOUT_MS)\n  try {\n    const res = await fetch(`${devUrl.replace(/\\/$/, \"\")}/miniapp.json`, {\n      method: \"GET\",\n      signal: controller.signal,\n    })\n    if (!res.ok) return {decision: \"offline\", manifest: null}\n    const manifest = (await res.json()) as DevManifest\n    if (packageName) {\n      storage.save(`${packageName}_dev_last_reachable`, Date.now())\n    }\n    return {decision: \"live\", manifest}\n  } catch {\n    return {decision: \"offline\", manifest: null}\n  } finally {\n    clearTimeout(timer)\n  }\n}\n"]}
+{"version":3,"file":"devMiniappLaunch.js","sourceRoot":"","sources":["../../src/utils/devMiniappLaunch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * decideDevLaunchRoute — pre-flight reachability + manifest fetch for dev\n * miniapp launches.\n *\n * Every entry point that wants to launch a dev miniapp (home tile, QR\n * scan, URL screen, dev-offline \"Try again\" button) calls this BEFORE\n * navigating, so:\n *\n *   1. We land on the right destination in a single transition\n *      (live mount vs offline takeover) — no flash through /applet/local.\n *   2. Callers that need the manifest (permission gate, name/icon read)\n *      get it in the same round trip — no second fetch.\n *\n * Pre-flighting at the call site keeps /applet/local a pure mount route.\n *\n * When the laptop's Wi-Fi IP changes, the URL stored from the last QR scan\n * goes stale. We then retry alternate hosts (Metro / EXPO_PUBLIC_LOCAL_MINIAPP_HOST,\n * plus an mDNS name captured at scan time) and persist the working URL so\n * the next launch doesn't need a re-scan.\n */\n\nimport {configuredDevHost} from \"./configuredDevHost\"\nimport {storage} from \"./storage/storage\"\n\nconst REACHABILITY_TIMEOUT_MS = 1500\n\n// A single dropped DNS lookup or momentary Wi-Fi blip (AP roam, DHCP renewal,\n// phone hopping to cellular for a beat) looks identical to a dead dev server —\n// both throw out of fetch(). Retrying once absorbs that transient case instead\n// of bouncing straight to the offline screen. We do NOT retry a real HTTP\n// response (res.ok === false): that's the server telling us something\n// definitive, not a network-layer hiccup.\nconst REACHABILITY_MAX_ATTEMPTS = 2\nconst REACHABILITY_RETRY_DELAY_MS = 400\n\nexport type DevManifest = {\n  packageName?: string\n  name?: string\n  /** First-found of `icon` / `iconUrl` / `logoUrl` (relative or absolute). */\n  icon?: string\n  permissions?: unknown\n  hardwareRequirements?: unknown\n  [key: string]: unknown\n}\n\nexport type DevLaunchResult =\n  | {decision: \"live\"; manifest: DevManifest; resolvedUrl: string}\n  | {decision: \"offline\"; manifest: null; resolvedUrl?: undefined}\n\nexport type DecideDevLaunchOptions = {\n  /** Extra hostnames / IPs to try if `devUrl` is unreachable (no scheme/port). */\n  alternateHosts?: string[]\n}\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/** Single GET <devUrl>/miniapp.json attempt with a hard timeout. */\nasync function fetchManifestOnce(devUrl: string): Promise<DevManifest | null> {\n  const controller = new AbortController()\n  const timer = setTimeout(() => controller.abort(), REACHABILITY_TIMEOUT_MS)\n  try {\n    const res = await fetch(`${devUrl.replace(/\\/$/, \"\")}/miniapp.json`, {\n      method: \"GET\",\n      signal: controller.signal,\n    })\n    if (!res.ok) return null\n    return (await res.json()) as DevManifest\n  } finally {\n    clearTimeout(timer)\n  }\n}\n\nfunction rewriteHost(devUrl: string, host: string): string | null {\n  const trimmed = host.trim()\n  if (!trimmed) return null\n  try {\n    const url = new URL(devUrl)\n    if (url.hostname === trimmed) return null\n    url.hostname = trimmed\n    return url.toString().replace(/\\/$/, \"\")\n  } catch {\n    return null\n  }\n}\n\n/**\n * Point an http(s) icon at the host that actually answered. Cached dev icons are\n * local `file://` paths and third-party icons live on unrelated hosts, so only\n * icons still served by the stale dev host are rewritten.\n */\nfunction rewriteIconHost(iconUrl: string, staleDevUrl: string, resolvedDevUrl: string): string | null {\n  try {\n    const icon = new URL(iconUrl)\n    if (icon.protocol !== \"http:\" && icon.protocol !== \"https:\") return null\n    const stale = new URL(staleDevUrl)\n    const resolved = new URL(resolvedDevUrl)\n    // Compare host (hostname+port) so an icon on the same hostname but a\n    // different service port is left alone.\n    if (icon.host !== stale.host) return null\n    icon.host = resolved.host\n    return icon.toString()\n  } catch {\n    return null\n  }\n}\n\nfunction collectAlternateHosts(packageName: string, extra?: string[]): string[] {\n  const hosts: string[] = []\n  const push = (h: string | undefined | null) => {\n    const v = h?.trim()\n    if (v && !hosts.includes(v)) hosts.push(v)\n  }\n\n  push(configuredDevHost())\n\n  if (packageName) {\n    const mdns = storage.load<string>(`${packageName}_dev_mdns`)\n    if (mdns.is_ok()) push(mdns.value)\n  }\n\n  for (const h of extra ?? []) push(h)\n  return hosts\n}\n\nasync function probeUrl(devUrl: string): Promise<DevManifest | null | \"network-error\"> {\n  for (let attempt = 1; attempt <= REACHABILITY_MAX_ATTEMPTS; attempt++) {\n    try {\n      const manifest = await fetchManifestOnce(devUrl)\n      // Definitive HTTP failure — do not retry this URL further.\n      if (!manifest) return null\n      return manifest\n    } catch {\n      if (attempt < REACHABILITY_MAX_ATTEMPTS) {\n        await delay(REACHABILITY_RETRY_DELAY_MS)\n        continue\n      }\n      return \"network-error\"\n    }\n  }\n  return \"network-error\"\n}\n\n/**\n * GET <devUrl>/miniapp.json with a hard timeout, retrying once on a\n * network-layer failure (DNS/connection/abort) before trying alternate\n * hosts (Metro laptop IP, mDNS name from the QR). Returns the parsed\n * manifest on success (\"live\") or null (\"offline\").\n *\n * Side effects on success:\n *   - writes <packageName>_dev_last_reachable\n *   - if an alternate host worked, rewrites <packageName>_dev_url so the\n *     next launch skips the stale IP\n */\nexport async function decideDevLaunchRoute(\n  packageName: string,\n  devUrl: string,\n  options?: DecideDevLaunchOptions,\n): Promise<DevLaunchResult> {\n  const candidates: string[] = [devUrl]\n  for (const host of collectAlternateHosts(packageName, options?.alternateHosts)) {\n    const rewritten = rewriteHost(devUrl, host)\n    if (rewritten && !candidates.includes(rewritten)) candidates.push(rewritten)\n  }\n\n  for (const candidate of candidates) {\n    const result = await probeUrl(candidate)\n    if (result === \"network-error\" || result === null) continue\n\n    if (packageName) {\n      storage.save(`${packageName}_dev_last_reachable`, Date.now())\n      if (candidate !== devUrl) {\n        storage.save(`${packageName}_dev_url`, candidate)\n        // Keep _dev_meta.devUrl in sync when present so home-tile reads match.\n        const metaRes = storage.load<string>(`${packageName}_dev_meta`)\n        if (metaRes.is_ok()) {\n          try {\n            const meta = JSON.parse(metaRes.value) as {devUrl?: string; iconUrl?: string}\n            meta.devUrl = candidate\n            if (typeof meta.iconUrl === \"string\") {\n              const rewritten = rewriteIconHost(meta.iconUrl, devUrl, candidate)\n              if (rewritten) meta.iconUrl = rewritten\n            }\n            storage.save(`${packageName}_dev_meta`, JSON.stringify(meta))\n          } catch {\n            /* ignore malformed meta */\n          }\n        }\n      }\n    }\n    return {decision: \"live\", manifest: result, resolvedUrl: candidate}\n  }\n\n  return {decision: \"offline\", manifest: null}\n}\n"]}

package/build/utils/diagnosticContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnosticContext.d.ts","sourceRoot":"","sources":["../../src/utils/diagnosticContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAA;AAyBvD,wBAAsB,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA6HrG"}
+{"version":3,"file":"diagnosticContext.d.ts","sourceRoot":"","sources":["../../src/utils/diagnosticContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAA;AA4BvD,wBAAsB,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA0HrG"}

package/build/utils/diagnosticContext.js

@@ -2,11 +2,14 @@ import NetInfo from "@react-native-community/netinfo";
 import Constants from "expo-constants";
 import * as Location from "expo-location";
 import { Platform } from "react-native";
-import { useAppStatusStore } from "../stores/apps";
+import appRegistry from "../services/AppRegistry";
+import localMiniappRuntime from "../services/LocalMiniappRuntime";
+import { getLastOpenTime, useAppStatusStore } from "../stores/apps";
 import { useConnectionStore } from "../stores/connection";
 import { useCoreStore } from "../stores/core";
 import { useGlassesStore } from "../stores/glasses";
 import { SETTINGS, useSettingsStore } from "../stores/settings";
+import { buildMiniappDiagnosticContext } from "./miniappDiagnostics";
 const SENSITIVE_SETTINGS_KEYS = ["core_token", "auth_token", "auth_email"];
 const SENSITIVE_GLASSES_KEYS = ["hotspotPassword"];
 /**
@@ -72,17 +75,15 @@ export async function collectDiagnosticContext(extra) {
     }
     const offlineMode = await useSettingsStore.getState().getSetting(SETTINGS.offline_mode.key);
     const defaultWearable = await useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key);
-    const apps = appletState.apps.map((app) => ({
-        packageName: app.packageName,
-        name: app.name,
-        running: app.running,
-        loading: app.loading,
-        healthy: app.healthy,
-        hidden: app.hidden,
-        type: app.type,
-        offline: app.offline,
-        local: app.local,
-    }));
+    const miniappRuntime = localMiniappRuntime.getDiagnosticSnapshot();
+    const miniapps = buildMiniappDiagnosticContext({
+        apps: appletState.apps,
+        foregroundedPackage: appletState.foregroundedPackage,
+        runtime: miniappRuntime,
+        getLastOpenedAtMs: (app) => getLastOpenTime(app.packageName),
+        getManifest: (app) => app.local && app.version ? appRegistry.getMiniappManifest(app.packageName, app.version) : undefined,
+        getReleaseIdentity: (app) => app.local && app.version ? appRegistry.getReleaseIdentity(app.packageName, app.version) : undefined,
+    });
     return {
         app: {
             appVersion: process.env.EXPO_PUBLIC_MENTRAOS_VERSION || "version",
@@ -102,12 +103,9 @@ export async function collectDiagnosticContext(extra) {
         runtime: {
             core: coreState,
             connection: connectionState,
+            miniapps: miniappRuntime,
         },
-        apps: {
-            apps,
-            installed: apps.map((app) => app.packageName),
-            running: apps.filter((app) => app.running).map((app) => app.packageName),
-        },
+        apps: miniapps,
         settings: {
             ...filteredSettings,
             offlineMode: !!offlineMode,

package/build/utils/diagnosticContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnosticContext.js","sourceRoot":"","sources":["../../src/utils/diagnosticContext.ts"],"names":[],"mappings":"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","sourcesContent":["import NetInfo from \"@react-native-community/netinfo\"\nimport Constants from \"expo-constants\"\nimport * as Location from \"expo-location\"\nimport {Platform} from \"react-native\"\nimport type {ReportContext} from \"@mentra/cloud-client\"\n\nimport {useAppStatusStore} from \"../stores/apps\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\n\nconst SENSITIVE_SETTINGS_KEYS = [\"core_token\", \"auth_token\", \"auth_email\"] as const\nconst SENSITIVE_GLASSES_KEYS = [\"hotspotPassword\"] as const\n\n/**\n * The glasses store keeps hotspot credentials NESTED (`hotspot: {state, ssid,\n * password, localIp}`), not just on the legacy top-level `hotspotPassword` key —\n * strip the password before the state is attached to a report.\n */\nfunction redactNestedCredentials(glasses: Record<string, unknown>): Record<string, unknown> {\n  const hotspot = glasses.hotspot\n  if (hotspot && typeof hotspot === \"object\" && \"password\" in hotspot) {\n    const {password: _password, ...rest} = hotspot as Record<string, unknown>\n    return {...glasses, hotspot: {...rest, password: \"[REDACTED]\"}}\n  }\n  return glasses\n}\n\nexport async function collectDiagnosticContext(extra?: Partial<ReportContext>): Promise<ReportContext> {\n  const appletState = useAppStatusStore.getState()\n  const settingsState = useSettingsStore.getState()\n  const {setCoreInfo: _setCoreInfo, reset: _resetBluetooth, ...coreState} = useCoreStore.getState()\n  const {\n    setStatus: _setConnectionStatus,\n    setUrl: _setConnectionUrl,\n    setError: _setConnectionError,\n    incrementReconnectAttempts: _incrementReconnectAttempts,\n    resetReconnectAttempts: _resetReconnectAttempts,\n    reset: _resetConnection,\n    ...connectionState\n  } = useConnectionStore.getState()\n  const {\n    setGlassesInfo: _setGlassesInfo,\n    setBatteryInfo: _setBatteryInfo,\n    setWifiInfo: _setWifiInfo,\n    setHotspotInfo: _setHotspotInfo,\n    setOtaUpdateAvailable: _setOtaUpdateAvailable,\n    setOtaProgress: _setOtaProgress,\n    setOtaInProgress: _setOtaInProgress,\n    setMtkUpdatedThisSession: _setMtkUpdatedThisSession,\n    clearOtaState: _clearOtaState,\n    reset: _resetGlasses,\n    ...glassesState\n  } = useGlassesStore.getState()\n\n  const filteredGlasses = redactNestedCredentials(\n    Object.fromEntries(\n      Object.entries(glassesState).filter(\n        ([key]) => !SENSITIVE_GLASSES_KEYS.includes(key as (typeof SENSITIVE_GLASSES_KEYS)[number]),\n      ),\n    ),\n  )\n  const filteredSettings = Object.fromEntries(\n    Object.entries(settingsState.settings || {}).filter(\n      ([key]) => !SENSITIVE_SETTINGS_KEYS.includes(key as (typeof SENSITIVE_SETTINGS_KEYS)[number]),\n    ),\n  )\n\n  let networkInfo: Record<string, unknown> = {type: \"unknown\", isConnected: false, isInternetReachable: false}\n  try {\n    const netState = await NetInfo.fetch()\n    networkInfo = {\n      type: netState.type,\n      isConnected: netState.isConnected ?? false,\n      isInternetReachable: netState.isInternetReachable ?? false,\n    }\n  } catch (error) {\n    console.log(\"diagnosticContext: failed to get network info:\", error)\n  }\n\n  let locationInfo: Record<string, unknown> | undefined\n  try {\n    const {status} = await Location.getForegroundPermissionsAsync()\n    if (status === \"granted\") {\n      const location = await Location.getLastKnownPositionAsync()\n      if (location) {\n        locationInfo = {\n          latitude: Number(location.coords.latitude.toFixed(4)),\n          longitude: Number(location.coords.longitude.toFixed(4)),\n        }\n        try {\n          const [place] = await Location.reverseGeocodeAsync({\n            latitude: location.coords.latitude,\n            longitude: location.coords.longitude,\n          })\n          if (place) {\n            locationInfo.place = [place.city, place.region, place.country].filter(Boolean).join(\", \")\n          }\n        } catch (error) {\n          console.log(\"diagnosticContext: failed to reverse geocode:\", error)\n        }\n      }\n    }\n  } catch (error) {\n    console.log(\"diagnosticContext: failed to get location:\", error)\n  }\n\n  const offlineMode = await useSettingsStore.getState().getSetting(SETTINGS.offline_mode.key)\n  const defaultWearable = await useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key)\n  const apps = appletState.apps.map((app) => ({\n    packageName: app.packageName,\n    name: app.name,\n    running: app.running,\n    loading: app.loading,\n    healthy: app.healthy,\n    hidden: app.hidden,\n    type: app.type,\n    offline: app.offline,\n    local: app.local,\n  }))\n\n  return {\n    app: {\n      appVersion: process.env.EXPO_PUBLIC_MENTRAOS_VERSION || \"version\",\n      buildCommit: process.env.EXPO_PUBLIC_BUILD_COMMIT || \"commit\",\n      buildBranch: process.env.EXPO_PUBLIC_BUILD_BRANCH || \"branch\",\n      buildTime: process.env.EXPO_PUBLIC_BUILD_TIME || \"time\",\n      buildUser: process.env.EXPO_PUBLIC_BUILD_USER || \"user\",\n    },\n    phone: {\n      deviceName: Constants.deviceName || \"deviceName\",\n      osVersion: `${Platform.OS} ${Platform.Version}`,\n      platform: Platform.OS,\n      network: networkInfo,\n      location: locationInfo,\n    },\n    glasses: filteredGlasses,\n    runtime: {\n      core: coreState,\n      connection: connectionState,\n    },\n    apps: {\n      apps,\n      installed: apps.map((app) => app.packageName),\n      running: apps.filter((app) => app.running).map((app) => app.packageName),\n    },\n    settings: {\n      ...filteredSettings,\n      offlineMode: !!offlineMode,\n      defaultWearable,\n    },\n    ...extra,\n  }\n}\n"]}
+{"version":3,"file":"diagnosticContext.js","sourceRoot":"","sources":["../../src/utils/diagnosticContext.ts"],"names":[],"mappings":"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","sourcesContent":["import NetInfo from \"@react-native-community/netinfo\"\nimport Constants from \"expo-constants\"\nimport * as Location from \"expo-location\"\nimport {Platform} from \"react-native\"\nimport type {ReportContext} from \"@mentra/cloud-client\"\n\nimport appRegistry from \"../services/AppRegistry\"\nimport localMiniappRuntime from \"../services/LocalMiniappRuntime\"\nimport {getLastOpenTime, useAppStatusStore} from \"../stores/apps\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\nimport {buildMiniappDiagnosticContext} from \"./miniappDiagnostics\"\n\nconst SENSITIVE_SETTINGS_KEYS = [\"core_token\", \"auth_token\", \"auth_email\"] as const\nconst SENSITIVE_GLASSES_KEYS = [\"hotspotPassword\"] as const\n\n/**\n * The glasses store keeps hotspot credentials NESTED (`hotspot: {state, ssid,\n * password, localIp}`), not just on the legacy top-level `hotspotPassword` key —\n * strip the password before the state is attached to a report.\n */\nfunction redactNestedCredentials(glasses: Record<string, unknown>): Record<string, unknown> {\n  const hotspot = glasses.hotspot\n  if (hotspot && typeof hotspot === \"object\" && \"password\" in hotspot) {\n    const {password: _password, ...rest} = hotspot as Record<string, unknown>\n    return {...glasses, hotspot: {...rest, password: \"[REDACTED]\"}}\n  }\n  return glasses\n}\n\nexport async function collectDiagnosticContext(extra?: Partial<ReportContext>): Promise<ReportContext> {\n  const appletState = useAppStatusStore.getState()\n  const settingsState = useSettingsStore.getState()\n  const {setCoreInfo: _setCoreInfo, reset: _resetBluetooth, ...coreState} = useCoreStore.getState()\n  const {\n    setStatus: _setConnectionStatus,\n    setUrl: _setConnectionUrl,\n    setError: _setConnectionError,\n    incrementReconnectAttempts: _incrementReconnectAttempts,\n    resetReconnectAttempts: _resetReconnectAttempts,\n    reset: _resetConnection,\n    ...connectionState\n  } = useConnectionStore.getState()\n  const {\n    setGlassesInfo: _setGlassesInfo,\n    setBatteryInfo: _setBatteryInfo,\n    setWifiInfo: _setWifiInfo,\n    setHotspotInfo: _setHotspotInfo,\n    setOtaUpdateAvailable: _setOtaUpdateAvailable,\n    setOtaProgress: _setOtaProgress,\n    setOtaInProgress: _setOtaInProgress,\n    setMtkUpdatedThisSession: _setMtkUpdatedThisSession,\n    clearOtaState: _clearOtaState,\n    reset: _resetGlasses,\n    ...glassesState\n  } = useGlassesStore.getState()\n\n  const filteredGlasses = redactNestedCredentials(\n    Object.fromEntries(\n      Object.entries(glassesState).filter(\n        ([key]) => !SENSITIVE_GLASSES_KEYS.includes(key as (typeof SENSITIVE_GLASSES_KEYS)[number]),\n      ),\n    ),\n  )\n  const filteredSettings = Object.fromEntries(\n    Object.entries(settingsState.settings || {}).filter(\n      ([key]) => !SENSITIVE_SETTINGS_KEYS.includes(key as (typeof SENSITIVE_SETTINGS_KEYS)[number]),\n    ),\n  )\n\n  let networkInfo: Record<string, unknown> = {type: \"unknown\", isConnected: false, isInternetReachable: false}\n  try {\n    const netState = await NetInfo.fetch()\n    networkInfo = {\n      type: netState.type,\n      isConnected: netState.isConnected ?? false,\n      isInternetReachable: netState.isInternetReachable ?? false,\n    }\n  } catch (error) {\n    console.log(\"diagnosticContext: failed to get network info:\", error)\n  }\n\n  let locationInfo: Record<string, unknown> | undefined\n  try {\n    const {status} = await Location.getForegroundPermissionsAsync()\n    if (status === \"granted\") {\n      const location = await Location.getLastKnownPositionAsync()\n      if (location) {\n        locationInfo = {\n          latitude: Number(location.coords.latitude.toFixed(4)),\n          longitude: Number(location.coords.longitude.toFixed(4)),\n        }\n        try {\n          const [place] = await Location.reverseGeocodeAsync({\n            latitude: location.coords.latitude,\n            longitude: location.coords.longitude,\n          })\n          if (place) {\n            locationInfo.place = [place.city, place.region, place.country].filter(Boolean).join(\", \")\n          }\n        } catch (error) {\n          console.log(\"diagnosticContext: failed to reverse geocode:\", error)\n        }\n      }\n    }\n  } catch (error) {\n    console.log(\"diagnosticContext: failed to get location:\", error)\n  }\n\n  const offlineMode = await useSettingsStore.getState().getSetting(SETTINGS.offline_mode.key)\n  const defaultWearable = await useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key)\n  const miniappRuntime = localMiniappRuntime.getDiagnosticSnapshot()\n  const miniapps = buildMiniappDiagnosticContext({\n    apps: appletState.apps,\n    foregroundedPackage: appletState.foregroundedPackage,\n    runtime: miniappRuntime,\n    getLastOpenedAtMs: (app) => getLastOpenTime(app.packageName),\n    getManifest: (app) =>\n      app.local && app.version ? appRegistry.getMiniappManifest(app.packageName, app.version) : undefined,\n    getReleaseIdentity: (app) =>\n      app.local && app.version ? appRegistry.getReleaseIdentity(app.packageName, app.version) : undefined,\n  })\n\n  return {\n    app: {\n      appVersion: process.env.EXPO_PUBLIC_MENTRAOS_VERSION || \"version\",\n      buildCommit: process.env.EXPO_PUBLIC_BUILD_COMMIT || \"commit\",\n      buildBranch: process.env.EXPO_PUBLIC_BUILD_BRANCH || \"branch\",\n      buildTime: process.env.EXPO_PUBLIC_BUILD_TIME || \"time\",\n      buildUser: process.env.EXPO_PUBLIC_BUILD_USER || \"user\",\n    },\n    phone: {\n      deviceName: Constants.deviceName || \"deviceName\",\n      osVersion: `${Platform.OS} ${Platform.Version}`,\n      platform: Platform.OS,\n      network: networkInfo,\n      location: locationInfo,\n    },\n    glasses: filteredGlasses,\n    runtime: {\n      core: coreState,\n      connection: connectionState,\n      miniapps: miniappRuntime,\n    },\n    apps: miniapps,\n    settings: {\n      ...filteredSettings,\n      offlineMode: !!offlineMode,\n      defaultWearable,\n    },\n    ...extra,\n  }\n}\n"]}

package/build/utils/hardware/hardware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hardware.d.ts","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,mBAAmB,EAIpB,MAAM,aAAa,CAAA;AAGpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,oBAAoB,EAAE,mBAAmB,EAAE,EAC3C,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,mBAAmB;IAkCtB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAuCrC;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM;IAkBnE;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE;CA0BlE"}
+{"version":3,"file":"hardware.d.ts","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAe,mBAAmB,EAA2D,MAAM,aAAa,CAAA;AAEpI;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,eAAe,EAAE,mBAAmB,EAAE,CAAA;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,oBAAoB,EAAE,mBAAmB,EAAE,EAC3C,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,mBAAmB;IAkCtB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA4CrC;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM;IAkBnE;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE;CA0BlE"}

package/build/utils/hardware/hardware.js

@@ -1,5 +1,4 @@
-import { HardwareType, HardwareRequirementLevel, DeviceTypes, } from "../../types";
-import { simulatedGlasses } from "../../types";
+import { DeviceTypes, HardwareRequirementLevel, HardwareType, simulatedGlasses } from "../../types";
 /**
  * Service for checking hardware compatibility between apps and glasses
  */
@@ -59,7 +58,12 @@ export class HardwareCompatibility {
             case HardwareType.DISPLAY:
                 return capabilities.hasDisplay;
             case HardwareType.MICROPHONE:
-                return capabilities.hasMicrophone;
+                // MentraOS always provides an audio-input path. When the connected
+                // glasses do not have an onboard microphone, the engine falls back to
+                // the phone microphone. Keep `capabilities.hasMicrophone` reserved for
+                // physical-device/source selection; app compatibility is about whether
+                // the requested input is available to the miniapp.
+                return true;
             case HardwareType.SPEAKER:
                 return capabilities.hasSpeaker;
             case HardwareType.IMU:

package/build/utils/hardware/hardware.js.map

@@ -1 +1 @@
-{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Capabilities,\n  HardwareRequirement,\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n} from \"../../types\"\nimport {simulatedGlasses} from \"../../types\"\n\n/**\n * Result of a hardware compatibility check\n */\nexport interface CompatibilityResult {\n  isCompatible: boolean\n  missingRequired: HardwareRequirement[]\n  missingOptional: HardwareRequirement[]\n  warnings: string[]\n}\n\n/**\n * Service for checking hardware compatibility between apps and glasses\n */\nexport class HardwareCompatibility {\n  /**\n   * Check if app is compatible with given device capabilities\n   * @param app The app to check\n   * @param capabilities The device capabilities (null if no device connected)\n   * @returns Detailed compatibility result\n   */\n  static checkCompatibility(\n    hardwareRequirements: HardwareRequirement[],\n    capabilities: Capabilities | null,\n  ): CompatibilityResult {\n    const result: CompatibilityResult = {\n      isCompatible: true,\n      missingRequired: [],\n      missingOptional: [],\n      warnings: [],\n    }\n\n    // If no hardware requirements specified, app is compatible with any hardware\n    if (hardwareRequirements.length === 0) {\n      return result\n    }\n\n    // If no capabilities available assume simulated glasses:\n    if (!capabilities) {\n      capabilities = simulatedGlasses\n    }\n\n    // Check each hardware requirement\n    for (const requirement of hardwareRequirements) {\n      const hasHardware = this.checkHardwareAvailable(requirement.type, capabilities!)\n      if (!hasHardware) {\n        if (requirement.level === HardwareRequirementLevel.REQUIRED) {\n          result.missingRequired.push(requirement)\n          result.isCompatible = false\n        } else {\n          result.missingOptional.push(requirement)\n        }\n      }\n    }\n\n    return result\n  }\n\n  /**\n   * Check if specific hardware is available in capabilities\n   * @param hardwareType The type of hardware to check\n   * @param capabilities The device capabilities\n   * @returns true if hardware is available\n   */\n  private static checkHardwareAvailable(hardwareType: HardwareType, capabilities: Capabilities): boolean {\n    if (hardwareType === HardwareType.EXIST) {\n      if (capabilities.modelName === DeviceTypes.NONE) {\n        return false\n      }\n      return true\n    }\n\n    switch (hardwareType) {\n      case HardwareType.CAMERA:\n        return capabilities.hasCamera\n\n      case HardwareType.DISPLAY:\n        return capabilities.hasDisplay\n\n      case HardwareType.MICROPHONE:\n        return capabilities.hasMicrophone\n\n      case HardwareType.SPEAKER:\n        return capabilities.hasSpeaker\n\n      case HardwareType.IMU:\n        return capabilities.hasIMU\n\n      case HardwareType.BUTTON:\n        return capabilities.hasButton\n\n      case HardwareType.LIGHT:\n        return capabilities.hasLight\n\n      case HardwareType.WIFI:\n        return capabilities.hasWifi\n\n      default:\n        // Unknown hardware type - assume not available\n        return false\n    }\n  }\n\n  /**\n   * Get human-readable compatibility message\n   * @param result The compatibility check result\n   * @returns User-friendly message about compatibility\n   */\n  static getCompatibilityMessage(result: CompatibilityResult): string {\n    if (result.isCompatible) {\n      if (result.missingOptional.length > 0) {\n        const optionalHardware = result.missingOptional.map((req) => req.type.toLowerCase()).join(\", \")\n        return `This app works with your glasses but has optional features that require: ${optionalHardware}`\n      }\n      return \"This app is fully compatible with your glasses\"\n    }\n\n    const requiredHardware = result.missingRequired.map((req) => req.type.toLowerCase()).join(\", \")\n\n    if (result.missingRequired.length === 1) {\n      return `This app requires a ${requiredHardware} which is not available on your connected glasses`\n    } else {\n      return `This app requires the following hardware which is not available on your connected glasses: ${requiredHardware}`\n    }\n  }\n\n  /**\n   * Get detailed compatibility messages including descriptions\n   * @param result The compatibility check result\n   * @returns Array of detailed messages\n   */\n  static getDetailedMessages(result: CompatibilityResult): string[] {\n    const messages: string[] = []\n\n    // Add warnings first\n    messages.push(...result.warnings)\n\n    // Add missing required hardware\n    for (const req of result.missingRequired) {\n      let message = `❌ Missing required ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    // Add missing optional hardware\n    for (const req of result.missingOptional) {\n      let message = `⚠️ Missing optional ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    return messages\n  }\n}\n"]}
+{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAuB,wBAAwB,EAAE,YAAY,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAA;AAYpI;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,oBAA2C,EAC3C,YAAiC;QAEjC,MAAM,MAAM,GAAwB;YAClC,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,EAAE;YACnB,eAAe,EAAE,EAAE;YACnB,QAAQ,EAAE,EAAE;SACb,CAAA;QAED,6EAA6E;QAC7E,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,yDAAyD;QACzD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,gBAAgB,CAAA;QACjC,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,IAAI,EAAE,YAAa,CAAC,CAAA;YAChF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,WAAW,CAAC,KAAK,KAAK,wBAAwB,CAAC,QAAQ,EAAE,CAAC;oBAC5D,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;oBACxC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAA;gBAC7B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,sBAAsB,CAAC,YAA0B,EAAE,YAA0B;QAC1F,IAAI,YAAY,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;YACxC,IAAI,YAAY,CAAC,SAAS,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;gBAChD,OAAO,KAAK,CAAA;YACd,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QAED,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,YAAY,CAAC,MAAM;gBACtB,OAAO,YAAY,CAAC,SAAS,CAAA;YAE/B,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,YAAY,CAAC,UAAU,CAAA;YAEhC,KAAK,YAAY,CAAC,UAAU;gBAC1B,mEAAmE;gBACnE,sEAAsE;gBACtE,uEAAuE;gBACvE,uEAAuE;gBACvE,mDAAmD;gBACnD,OAAO,IAAI,CAAA;YAEb,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,YAAY,CAAC,UAAU,CAAA;YAEhC,KAAK,YAAY,CAAC,GAAG;gBACnB,OAAO,YAAY,CAAC,MAAM,CAAA;YAE5B,KAAK,YAAY,CAAC,MAAM;gBACtB,OAAO,YAAY,CAAC,SAAS,CAAA;YAE/B,KAAK,YAAY,CAAC,KAAK;gBACrB,OAAO,YAAY,CAAC,QAAQ,CAAA;YAE9B,KAAK,YAAY,CAAC,IAAI;gBACpB,OAAO,YAAY,CAAC,OAAO,CAAA;YAE7B;gBACE,+CAA+C;gBAC/C,OAAO,KAAK,CAAA;QAChB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAA2B;QACxD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC/F,OAAO,4EAA4E,gBAAgB,EAAE,CAAA;YACvG,CAAC;YACD,OAAO,gDAAgD,CAAA;QACzD,CAAC;QAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE/F,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO,uBAAuB,gBAAgB,mDAAmD,CAAA;QACnG,CAAC;aAAM,CAAC;YACN,OAAO,8FAA8F,gBAAgB,EAAE,CAAA;QACzH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAA2B;QACpD,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,qBAAqB;QACrB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;QAEjC,gCAAgC;QAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACzC,IAAI,OAAO,GAAG,sBAAsB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;YAC5D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,CAAA;YACnC,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QAED,gCAAgC;QAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACzC,IAAI,OAAO,GAAG,uBAAuB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;YAC7D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,CAAA;YACnC,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF","sourcesContent":["import {Capabilities, DeviceTypes, HardwareRequirement, HardwareRequirementLevel, HardwareType, simulatedGlasses} from \"../../types\"\n\n/**\n * Result of a hardware compatibility check\n */\nexport interface CompatibilityResult {\n  isCompatible: boolean\n  missingRequired: HardwareRequirement[]\n  missingOptional: HardwareRequirement[]\n  warnings: string[]\n}\n\n/**\n * Service for checking hardware compatibility between apps and glasses\n */\nexport class HardwareCompatibility {\n  /**\n   * Check if app is compatible with given device capabilities\n   * @param app The app to check\n   * @param capabilities The device capabilities (null if no device connected)\n   * @returns Detailed compatibility result\n   */\n  static checkCompatibility(\n    hardwareRequirements: HardwareRequirement[],\n    capabilities: Capabilities | null,\n  ): CompatibilityResult {\n    const result: CompatibilityResult = {\n      isCompatible: true,\n      missingRequired: [],\n      missingOptional: [],\n      warnings: [],\n    }\n\n    // If no hardware requirements specified, app is compatible with any hardware\n    if (hardwareRequirements.length === 0) {\n      return result\n    }\n\n    // If no capabilities available assume simulated glasses:\n    if (!capabilities) {\n      capabilities = simulatedGlasses\n    }\n\n    // Check each hardware requirement\n    for (const requirement of hardwareRequirements) {\n      const hasHardware = this.checkHardwareAvailable(requirement.type, capabilities!)\n      if (!hasHardware) {\n        if (requirement.level === HardwareRequirementLevel.REQUIRED) {\n          result.missingRequired.push(requirement)\n          result.isCompatible = false\n        } else {\n          result.missingOptional.push(requirement)\n        }\n      }\n    }\n\n    return result\n  }\n\n  /**\n   * Check if specific hardware is available in capabilities\n   * @param hardwareType The type of hardware to check\n   * @param capabilities The device capabilities\n   * @returns true if hardware is available\n   */\n  private static checkHardwareAvailable(hardwareType: HardwareType, capabilities: Capabilities): boolean {\n    if (hardwareType === HardwareType.EXIST) {\n      if (capabilities.modelName === DeviceTypes.NONE) {\n        return false\n      }\n      return true\n    }\n\n    switch (hardwareType) {\n      case HardwareType.CAMERA:\n        return capabilities.hasCamera\n\n      case HardwareType.DISPLAY:\n        return capabilities.hasDisplay\n\n      case HardwareType.MICROPHONE:\n        // MentraOS always provides an audio-input path. When the connected\n        // glasses do not have an onboard microphone, the engine falls back to\n        // the phone microphone. Keep `capabilities.hasMicrophone` reserved for\n        // physical-device/source selection; app compatibility is about whether\n        // the requested input is available to the miniapp.\n        return true\n\n      case HardwareType.SPEAKER:\n        return capabilities.hasSpeaker\n\n      case HardwareType.IMU:\n        return capabilities.hasIMU\n\n      case HardwareType.BUTTON:\n        return capabilities.hasButton\n\n      case HardwareType.LIGHT:\n        return capabilities.hasLight\n\n      case HardwareType.WIFI:\n        return capabilities.hasWifi\n\n      default:\n        // Unknown hardware type - assume not available\n        return false\n    }\n  }\n\n  /**\n   * Get human-readable compatibility message\n   * @param result The compatibility check result\n   * @returns User-friendly message about compatibility\n   */\n  static getCompatibilityMessage(result: CompatibilityResult): string {\n    if (result.isCompatible) {\n      if (result.missingOptional.length > 0) {\n        const optionalHardware = result.missingOptional.map((req) => req.type.toLowerCase()).join(\", \")\n        return `This app works with your glasses but has optional features that require: ${optionalHardware}`\n      }\n      return \"This app is fully compatible with your glasses\"\n    }\n\n    const requiredHardware = result.missingRequired.map((req) => req.type.toLowerCase()).join(\", \")\n\n    if (result.missingRequired.length === 1) {\n      return `This app requires a ${requiredHardware} which is not available on your connected glasses`\n    } else {\n      return `This app requires the following hardware which is not available on your connected glasses: ${requiredHardware}`\n    }\n  }\n\n  /**\n   * Get detailed compatibility messages including descriptions\n   * @param result The compatibility check result\n   * @returns Array of detailed messages\n   */\n  static getDetailedMessages(result: CompatibilityResult): string[] {\n    const messages: string[] = []\n\n    // Add warnings first\n    messages.push(...result.warnings)\n\n    // Add missing required hardware\n    for (const req of result.missingRequired) {\n      let message = `❌ Missing required ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    // Add missing optional hardware\n    for (const req of result.missingOptional) {\n      let message = `⚠️ Missing optional ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    return messages\n  }\n}\n"]}

package/build/utils/miniappDiagnostics.d.ts

@@ -0,0 +1,64 @@
+import type { ClientApp } from "../types/applet";
+export interface MiniappManifestSnapshot {
+    packageName: string;
+    name?: string;
+    version?: string;
+    sdkVersion?: string;
+    minHostVersion?: string;
+    type?: string;
+    entry?: {
+        background?: string;
+        ui?: string;
+    };
+    permissions: Array<{
+        type: string;
+        required?: boolean;
+    }>;
+    hardwareRequirements: Array<{
+        type: string;
+        level: string;
+    }>;
+    actionIds: string[];
+}
+export interface MiniappRuntimeAppSnapshot {
+    packageName: string;
+    handshakeComplete: boolean;
+    subscriptions: string[];
+    lastMessageAgeMs: number;
+    requestedLocationRate: string | null;
+    hasActiveSpeakerStream: boolean;
+    manifest?: MiniappManifestSnapshot;
+}
+export interface MiniappRuntimeDiagnosticSnapshot {
+    connectedApps: MiniappRuntimeAppSnapshot[];
+    subscriptionsByStream: Record<string, string[]>;
+    resources: {
+        display: Record<string, unknown>;
+        camera: Record<string, unknown>;
+        video: Record<string, unknown>;
+        stream: Record<string, unknown>;
+        cameraFov: Record<string, unknown>;
+    };
+}
+type ManifestFallback = {
+    packageName: string;
+    name?: string;
+    version?: string;
+    type?: string;
+};
+/**
+ * Keep the routing/build fields from miniapp.json while excluding arbitrary
+ * free-form manifest content from reports. Descriptions, URLs, and unknown
+ * extension fields are intentionally omitted.
+ */
+export declare function buildMiniappManifestSnapshot(raw: unknown, fallback: ManifestFallback): MiniappManifestSnapshot;
+export declare function buildMiniappDiagnosticContext(input: {
+    apps: ClientApp[];
+    foregroundedPackage: string | null;
+    runtime: MiniappRuntimeDiagnosticSnapshot;
+    getLastOpenedAtMs: (app: ClientApp) => number;
+    getManifest: (app: ClientApp) => unknown;
+    getReleaseIdentity: (app: ClientApp) => unknown;
+}): Record<string, unknown>;
+export {};
+//# sourceMappingURL=miniappDiagnostics.d.ts.map

package/build/utils/miniappDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniappDiagnostics.d.ts","sourceRoot":"","sources":["../../src/utils/miniappDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAA;AAM9C,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,EAAE,CAAC,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,WAAW,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAA;IACtD,oBAAoB,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,EAAE,uBAAuB,CAAA;CACnC;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,yBAAyB,EAAE,CAAA;IAC1C,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,CAAA;CACF;AAED,KAAK,gBAAgB,GAAG;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAsDD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,uBAAuB,CAsB9G;AAoBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,gCAAgC,CAAA;IACzC,iBAAiB,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,CAAA;IAC7C,WAAW,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAA;IACxC,kBAAkB,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAA;CAChD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoE1B"}