@mentra/engine 3.2.0-dev.115 → 3.2.0-dev.120

package/build/services/acsAudioSource.js

@@ -0,0 +1,37 @@
+/**
+ * Single switch for Mentra Call ACS uplink.
+ * `"phone"` = AudioRecord / iOS input tap → RawOutgoingAudioStream (no Cloudflare audio).
+ * `"glasses"` = today's glasses WHIP → Cloudflare → WHEP PCM → ACS path.
+ * preferred_mic does not govern this call.
+ */
+export const ACS_CALL_MIC = "glasses";
+function mapMic(value) {
+    if (value === "phone" || value === "bluetooth" || value === "bluetoothClassic")
+        return "phone";
+    if (value === "glasses")
+        return "glasses";
+    return null;
+}
+/**
+ * Pure preferred_mic → ACS source mapping. Store reads stay in the thin wrapper
+ * so this table can be unit tested without zustand.
+ */
+export function resolveAudioSource(input) {
+    const preferred = input.preferred || "auto";
+    if (preferred === "phone" || preferred === "bluetooth") {
+        return { source: "phone", reason: "explicit" };
+    }
+    if (preferred === "glasses") {
+        return { source: "glasses", reason: "explicit" };
+    }
+    const fromCurrent = mapMic(input.currentMic);
+    if (fromCurrent)
+        return { source: fromCurrent, reason: "current-mic" };
+    const fromRank = mapMic(input.micRanking[0]);
+    if (fromRank)
+        return { source: fromRank, reason: "ranking" };
+    return input.glassesConnected
+        ? { source: "glasses", reason: "fallback-glasses-connected" }
+        : { source: "phone", reason: "fallback-no-glasses" };
+}
+//# sourceMappingURL=acsAudioSource.js.map

package/build/services/acsAudioSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acsAudioSource.js","sourceRoot":"","sources":["../../src/services/acsAudioSource.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAmB,SAAS,CAAA;AAOrD,SAAS,MAAM,CAAC,KAAgC;IAC9C,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,kBAAkB;QAAE,OAAO,OAAO,CAAA;IAC9F,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAKlC;IACC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,MAAM,CAAA;IAC3C,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QACvD,OAAO,EAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAC,CAAA;IAC9C,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAC,CAAA;IAChD,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAC5C,IAAI,WAAW;QAAE,OAAO,EAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAC,CAAA;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,IAAI,QAAQ;QAAE,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAC,CAAA;IAC1D,OAAO,KAAK,CAAC,gBAAgB;QAC3B,CAAC,CAAC,EAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,4BAA4B,EAAC;QAC3D,CAAC,CAAC,EAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAC,CAAA;AACtD,CAAC","sourcesContent":["export type SourceReason =\n  | \"explicit\"\n  | \"current-mic\"\n  | \"ranking\"\n  | \"fallback-glasses-connected\"\n  | \"fallback-no-glasses\"\n\nexport type AcsAudioSource = \"glasses\" | \"phone\"\n\n/**\n * Single switch for Mentra Call ACS uplink.\n * `\"phone\"` = AudioRecord / iOS input tap → RawOutgoingAudioStream (no Cloudflare audio).\n * `\"glasses\"` = today's glasses WHIP → Cloudflare → WHEP PCM → ACS path.\n * preferred_mic does not govern this call.\n */\nexport const ACS_CALL_MIC: AcsAudioSource = \"glasses\"\n\nexport type ResolvedAudioSource = {\n  source: AcsAudioSource\n  reason: SourceReason\n}\n\nfunction mapMic(value: string | null | undefined): AcsAudioSource | null {\n  if (value === \"phone\" || value === \"bluetooth\" || value === \"bluetoothClassic\") return \"phone\"\n  if (value === \"glasses\") return \"glasses\"\n  return null\n}\n\n/**\n * Pure preferred_mic → ACS source mapping. Store reads stay in the thin wrapper\n * so this table can be unit tested without zustand.\n */\nexport function resolveAudioSource(input: {\n  preferred: string\n  currentMic: string | null\n  micRanking: string[]\n  glassesConnected: boolean\n}): ResolvedAudioSource {\n  const preferred = input.preferred || \"auto\"\n  if (preferred === \"phone\" || preferred === \"bluetooth\") {\n    return {source: \"phone\", reason: \"explicit\"}\n  }\n  if (preferred === \"glasses\") {\n    return {source: \"glasses\", reason: \"explicit\"}\n  }\n  const fromCurrent = mapMic(input.currentMic)\n  if (fromCurrent) return {source: fromCurrent, reason: \"current-mic\"}\n  const fromRank = mapMic(input.micRanking[0])\n  if (fromRank) return {source: fromRank, reason: \"ranking\"}\n  return input.glassesConnected\n    ? {source: \"glasses\", reason: \"fallback-glasses-connected\"}\n    : {source: \"phone\", reason: \"fallback-no-glasses\"}\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"devMiniappLaunch.d.ts","sourceRoot":"","sources":["../../src/utils/devMiniappLaunch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,GACvB;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,GAC9D;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,CAAA;CAAC,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG;IACnC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AA4FD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAoC1B"}
+{"version":3,"file":"devMiniappLaunch.d.ts","sourceRoot":"","sources":["../../src/utils/devMiniappLaunch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,GACvB;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,GAC9D;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,CAAA;CAAC,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG;IACnC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAgGD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAoC1B"}

package/build/utils/devMiniappLaunch.js

@@ -102,6 +102,10 @@ function collectAlternateHosts(packageName, extra) {
     }
     for (const h of extra ?? [])
         push(h);
+    // USB `adb reverse` publishes the laptop on the phone's loopback. Mentra
+    // Call's QR still advertises the Wi-Fi IP, which AP isolation drops. Try
+    // loopback last so LAN/mDNS keep winning when they work.
+    push("127.0.0.1");
     return hosts;
 }
 async function probeUrl(devUrl) {

package/build/utils/devMiniappLaunch.js.map

@@ -1 +1 @@
-{"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"]}
+{"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  // USB `adb reverse` publishes the laptop on the phone's loopback. Mentra\n  // Call's QR still advertises the Wi-Fi IP, which AP isolation drops. Try\n  // loopback last so LAN/mDNS keep winning when they work.\n  push(\"127.0.0.1\")\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/engine",
-  "version": "3.2.0-dev.115",
+  "version": "3.2.0-dev.120",
   "description": "Mentra Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -90,18 +90,19 @@
     "url": "https://github.com/Mentra-Community/MentraOS/issues"
   },
   "author": "Mentra Community",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "homepage": "https://github.com/Mentra-Community/MentraOS/tree/dev/mobile/modules/engine#readme",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/bluetooth-sdk": "3.2.0-dev.115",
-    "@mentra/cloud-client": "3.2.0-dev.115",
-    "@mentra/cloud-protocol": "3.2.0-dev.115",
-    "@mentra/crust": "3.2.0-dev.115",
-    "@mentra/miniapp": "3.2.0-dev.115",
+    "@mentra/acs-meeting": "3.2.0-dev.120",
+    "@mentra/bluetooth-sdk": "3.2.0-dev.120",
+    "@mentra/cloud-client": "3.2.0-dev.120",
+    "@mentra/cloud-protocol": "3.2.0-dev.120",
+    "@mentra/crust": "3.2.0-dev.120",
+    "@mentra/miniapp": "3.2.0-dev.120",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",

package/src/engine.ts

@@ -12,7 +12,11 @@ import {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams
 import {cloudClientService} from "./services/CloudClientService"
 import {hydrateDeviceStore, demoteOrphanedDefaultWearable} from "./services/DeviceStoreHydration"
 import {startGlassesSettingsSync, stopGlassesSettingsSync} from "./services/GlassesSettingsSync"
-import {startGlassesStatusProjection, stopGlassesStatusProjection} from "./services/GlassesStatusProjection"
+import {
+  startGlassesStatusProjection,
+  stopGlassesStatusProjection,
+  toMiniappConnectionData,
+} from "./services/GlassesStatusProjection"
 import {startOtaService, stopOtaService} from "./services/OtaService"
 import {startAudioCloudUplink, stopAudioCloudUplink} from "./services/AudioCloudUplink"
 import {startSupportProfileSync, stopSupportProfileSync} from "./services/SupportProfileSync"
@@ -62,7 +66,11 @@ export const engine = {
     // Project native device status -> the engine stores (the inbound feed the rest
     // of the runtime reads). Established first so the stores are live before the
     // syncs below react to them.
-    startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent("glasses_connection_state", changed))
+    startGlassesStatusProjection((changed) => {
+      const connection = toMiniappConnectionData(changed)
+      if (!connection) return
+      localMiniappRuntime.forwardEvent("glasses_connection_state", connection)
+    })
     // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,
     // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->
     // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.2.0",
-  "releaseIdentity": "3.2.0-dev.115",
-  "releaseSetId": "mentra-3.2.0-dev.115",
-  "sourceCommit": "2b72679767cc618eeeaa2a6fc2cc14f615a78f78",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.115.json",
-  "otaManifestSha256": "f69762562177f8646784b4a7abb5815c84e2775059faaa31a9655b93d793dc1b"
+  "releaseIdentity": "3.2.0-dev.120",
+  "releaseSetId": "mentra-3.2.0-dev.120",
+  "sourceCommit": "1b8b39b87dc44799c88f414f088629df0f013850",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.120.json",
+  "otaManifestSha256": "4a5e13392f0d395a33867331fed19e9e5980526bc1b7e78f6ba2711c9e9ae1df"
 })

package/src/runtime/streamConfig.ts

@@ -32,3 +32,16 @@ export const normalizeStreamAudioConfig = (value: unknown): StreamAudioConfig |
   if (typeof value.noiseSuppression === "boolean") config.noiseSuppression = value.noiseSuppression
   return Object.keys(config).length > 0 ? config : undefined
 }
+
+/** Absent or non-boolean values keep the caller-supplied fallback (default true). */
+export const normalizeCaptureAudio = (value: unknown, fallback = true): boolean =>
+  typeof value === "boolean" ? value : fallback
+
+/**
+ * Glasses capture is locked to the ACS source for the WHIP session.
+ * Phone/bluetooth never encode the glasses mic, even if a miniapp asks for it.
+ */
+export const resolveCaptureAudio = (
+  payload: unknown,
+  source: "glasses" | "phone",
+): boolean => source === "glasses" && normalizeCaptureAudio(payload, true)