@mentra/engine 3.2.1-dev.279 → 3.2.1-dev.283

package/build/services/micPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"micPolicy.js","sourceRoot":"","sources":["../../src/services/micPolicy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwCH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAyC;IACzE,UAAU,EAAE,EAAC,IAAI,EAAE,EAAE,EAAC;IACtB,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;IACnB,UAAU,EAAE,EAAE;CACf,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB,CAAC,iBAAiB,CAAC,CAAA;AAEzE,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,YAAY;CACb,CAAA;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAE5C,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAA0B,CAAC,YAAY,CAAC,CAAA;AAE1E;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAmC,EACnC,IAAqB;IAErB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;IAEnG,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,IAAI,IAAwB,CAAA;IAC5B,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,SAAQ;QAC1C,UAAU,GAAG,IAAI,CAAA;QACjB,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;QAChE,sEAAsE;QACtE,0BAA0B;QAC1B,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;YAClF,IAAI,GAAG,WAAW,CAAA;QACpB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;QAC5B,UAAU;QACV,SAAS,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC;KAC9C,CAAA;AACH,CAAC","sourcesContent":["/**\n * Microphone use-case policy.\n *\n * Applications say what they are doing (\"voice_call\"); the engine decides what\n * that requires of the hardware. Nothing above this file knows that a voice\n * call means ADC index 14, and no miniapp can ask for a gain directly.\n *\n * Pure: every function here is a function of the live session set. The lease\n * bookkeeping lives in MicSessionManager, the merge with OS preferences lives\n * in MicStateCoordinator, and the wire write lives below that again.\n */\n\n/** What an application is doing with the microphone. */\nexport type MicUseCase = \"voice_call\" | \"transcription\" | \"voice_assistant\" | \"diagnostic\"\n\n/** Which microphone the audio comes from. */\nexport type MicSource = \"glasses\" | \"phone\"\n\n/** Subset of the `mic_tuning` wire payload. Fields left out keep firmware defaults. */\nexport type MicTuningProfile = {\n  /** codec_adc_vol index, 0-15. */\n  gain?: number\n}\n\n/** A live microphone lease. */\nexport type MicSessionSpec = {\n  useCase: MicUseCase\n  source: MicSource\n}\n\n/** What the hardware should do, given every live session. */\nexport type ResolvedMicPolicy = {\n  /** Someone needs a continuous raw-PCM timeline, which also forces hardware VAD off. */\n  rawPcm: boolean\n  /** Pin the Bluetooth SDK to the glasses microphone. Only the glasses can be pinned. */\n  pinGlasses: boolean\n  /** Tuning override for the glasses, or null to leave the OS value in force. */\n  micTuning: MicTuningProfile | null\n}\n\n/** Platform facts the policy cannot infer from the sessions alone. */\nexport type MicPlatformCaps = {\n  /**\n   * Whether this platform can take the wearer's voice off the glasses as raw\n   * PCM over BLE LC3. False on iOS, which has no `setMicSourcePin` and never\n   * selects the `ble-lc3` uplink.\n   */\n  glassesPcmUplink: boolean\n}\n\n/**\n * Mentra Live ships CODEC_SADC_VOL = 15, the last entry of codec_adc_vol[] and\n * +32 dB. That table steps 2 dB at a time everywhere except the final step,\n * which jumps 6 dB from +26, so the default sits at the ceiling one oversized\n * step above everything else. It suits a wearer dictating to a transcription\n * miniapp across a room; it clips a wearer talking into a Teams call.\n *\n * Gain is the only knob here on purpose. A call forces hardware VAD off and\n * the Barrier is off by default, which puts the firmware gate in its `pass`\n * branch, so the RMS thresholds cannot affect a call.\n *\n * Index 14 is +26 dB: one step down, and the step that removes the table's\n * anomalous jump. A same-voice sweep showed 15 rails hard (2.5–4.2% clip);\n * 14/13/12 still kiss the rail on syllable tips. 13 is +24 dB, the middle\n * of that band, while we listen for loudness vs residual clip.\n */\nexport const MIC_USE_CASE_PROFILES: Record<MicUseCase, MicTuningProfile> = {\n  voice_call: {gain: 13},\n  transcription: {},\n  voice_assistant: {},\n  diagnostic: {},\n}\n\n/**\n * Packages allowed to hold a `voice_call` session.\n *\n * Which app may make a voice call is policy, so it lives beside the profiles\n * rather than in the request handler that enforces it.\n */\nexport const VOICE_CALL_PACKAGES: readonly string[] = [\"com.mentra.call\"]\n\n/** Every use case, for validating an inbound request. */\nexport const MIC_USE_CASES: readonly MicUseCase[] = [\n  \"voice_call\",\n  \"transcription\",\n  \"voice_assistant\",\n  \"diagnostic\",\n]\n\n/** Owners of engine-internal sessions. Miniapps cannot claim these use cases. */\nexport const ENGINE_OWNER_PREFIX = \"engine:\"\n\n/** Use cases only engine features may acquire. */\nexport const ENGINE_ONLY_USE_CASES: readonly MicUseCase[] = [\"diagnostic\"]\n\n/**\n * Resolve every live session into one hardware state.\n *\n * On a platform without a glasses PCM uplink a glasses session is a lease and\n * nothing more: it satisfies ownership checks so an iOS call can still be\n * modelled the same way, but it claims no PCM, pins nothing, and applies no\n * gain, because the wearer's voice does not reach the call through the BES\n * BLE path there.\n */\nexport function resolveMicPolicy(\n  sessions: readonly MicSessionSpec[],\n  caps: MicPlatformCaps,\n): ResolvedMicPolicy {\n  const effective = caps.glassesPcmUplink ? sessions : sessions.filter((s) => s.source !== \"glasses\")\n\n  let pinGlasses = false\n  let gain: number | undefined\n  for (const session of effective) {\n    if (session.source !== \"glasses\") continue\n    pinGlasses = true\n    const profileGain = MIC_USE_CASE_PROFILES[session.useCase]?.gain\n    // Lowest index wins: clipping is the irreversible failure, a slightly\n    // quiet assistant is not.\n    if (typeof profileGain === \"number\" && (gain === undefined || profileGain < gain)) {\n      gain = profileGain\n    }\n  }\n\n  return {\n    rawPcm: effective.length > 0,\n    pinGlasses,\n    micTuning: gain === undefined ? null : {gain},\n  }\n}\n"]}
+{"version":3,"file":"micPolicy.js","sourceRoot":"","sources":["../../src/services/micPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Microphone use-case policy.\n *\n * Applications say what they are doing (\"voice_call\"); the engine decides what\n * that requires of the hardware. Nothing above this file knows that a voice\n * call means ADC index 14, and no miniapp can ask for a gain directly.\n *\n * Pure: every function here is a function of the live session set. The lease\n * bookkeeping lives in MicSessionManager, the merge with OS preferences lives\n * in MicStateCoordinator, and the wire write lives below that again.\n */\n\n/** What an application is doing with the microphone. */\nexport type MicUseCase = \"voice_call\" | \"transcription\" | \"voice_assistant\" | \"diagnostic\"\n\n/** Which microphone the audio comes from. */\nexport type MicSource = \"glasses\" | \"phone\"\n\n/** Subset of the `mic_tuning` wire payload. Fields left out keep firmware defaults. */\nexport type MicTuningProfile = {\n  /** codec_adc_vol index, 0-15. */\n  gain?: number\n  /** Center-mic RMS to open the gate. */\n  open?: number\n  /** Center-mic RMS to close it again. */\n  close?: number\n  /** Open threshold while the speaker is elevated. */\n  sp_open?: number\n  /** Close threshold while the speaker is elevated. */\n  sp_close?: number\n}\n\n/** `codec_adc_vol[]`: index to dB. Index 0 is mute and is never offered. */\nexport const GAIN_DB = [-99, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 32]\n\n/**\n * Mirrored from `center_mic_vad_get_default_config` and `CODEC_SADC_VOL`.\n *\n * The four RMS numbers are measured *after* the ADC gain, so they are only\n * meaningful next to the gain they were calibrated at, which is index 15.\n */\nexport const MIC_TUNING_FIRMWARE_DEFAULTS = {\n  gain: 15,\n  open: 1350,\n  close: 945,\n  sp_open: 2900,\n  sp_close: 1600,\n} as const\n\n/**\n * Re-express the firmware's thresholds at a different gain.\n *\n * The gate compares post-gain RMS, so moving the gain without moving the\n * thresholds silently changes what the gate means: at -8 dB the wearer has to\n * be 2.5x louder to clear a number that was chosen for +32 dB. Scaling both by\n * the same factor keeps the *acoustic* trip point the profile was tuned for,\n * for the wearer and for speaker leak alike.\n */\nexport function scaleMicTuningToGain(gain: number): Required<MicTuningProfile> {\n  const index = Math.min(GAIN_DB.length - 1, Math.max(1, Math.round(gain)))\n  const factor = Math.pow(10, (GAIN_DB[index]! - GAIN_DB[MIC_TUNING_FIRMWARE_DEFAULTS.gain]!) / 20)\n  return {\n    gain: index,\n    open: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.open * factor),\n    close: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.close * factor),\n    sp_open: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.sp_open * factor),\n    sp_close: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.sp_close * factor),\n  }\n}\n\n/** A live microphone lease. */\nexport type MicSessionSpec = {\n  useCase: MicUseCase\n  source: MicSource\n}\n\n/** What the hardware should do, given every live session. */\nexport type ResolvedMicPolicy = {\n  /** Someone needs a continuous raw-PCM timeline, which also forces hardware VAD off. */\n  rawPcm: boolean\n  /** Pin the Bluetooth SDK to the glasses microphone. Only the glasses can be pinned. */\n  pinGlasses: boolean\n  /** Tuning override for the glasses, or null to leave the OS value in force. */\n  micTuning: MicTuningProfile | null\n  /** Run the center-mic loudness gate, or null to leave the OS value in force. */\n  loudnessGate: boolean | null\n}\n\n/** Platform facts the policy cannot infer from the sessions alone. */\nexport type MicPlatformCaps = {\n  /**\n   * Whether this platform can take the wearer's voice off the glasses as raw\n   * PCM over BLE LC3. False on iOS, which has no `setMicSourcePin` and never\n   * selects the `ble-lc3` uplink.\n   */\n  glassesPcmUplink: boolean\n}\n\n/**\n * Mentra Live ships CODEC_SADC_VOL = 15, the last entry of codec_adc_vol[] and\n * +32 dB. That table steps 2 dB at a time everywhere except the final step,\n * which jumps 6 dB from +26, so the default sits at the ceiling one oversized\n * step above everything else. It suits a wearer dictating to a transcription\n * miniapp across a room; it clips a wearer talking into a Teams call.\n *\n * Index 14 is +26 dB: one step down, and the step that removes the table's\n * anomalous jump. A same-voice sweep showed 15 rails hard (2.5–4.2% clip);\n * 14/13/12 still kiss the rail on syllable tips. 13 is +24 dB, the middle\n * of that band, while we listen for loudness vs residual clip.\n *\n * The thresholds ride along with the gain rather than being stated here, so\n * changing the index above cannot leave the gate calibrated for a level the\n * ADC no longer produces.\n */\nexport const MIC_USE_CASE_PROFILES: Record<MicUseCase, MicTuningProfile> = {\n  voice_call: scaleMicTuningToGain(13),\n  transcription: {},\n  voice_assistant: {},\n  diagnostic: {},\n}\n\n/**\n * Use cases that run the center-mic loudness gate (\"Barrier\").\n *\n * A voice call is the one place it earns its keep. There is no echo canceller\n * on the LC3 uplink — `MENTRA_LC3_SPEECH_PROCESSING` is 0 and the capture path\n * ignores the playback reference — so without a gate the far end hears itself\n * through the wearer's speaker. Barrier is the safe half of the firmware's two\n * gates: it zeroes a quiet frame but never stops transmitting, where VAD drops\n * the stream outright. Paired with the speaker-elevated thresholds above, that\n * suppresses leak while the far end is talking and costs the wearer nothing.\n */\nexport const MIC_USE_CASE_LOUDNESS_GATE: Record<MicUseCase, boolean> = {\n  voice_call: true,\n  transcription: false,\n  voice_assistant: false,\n  diagnostic: false,\n}\n\n/**\n * Packages allowed to hold a `voice_call` session.\n *\n * Which app may make a voice call is policy, so it lives beside the profiles\n * rather than in the request handler that enforces it.\n */\nexport const VOICE_CALL_PACKAGES: readonly string[] = [\"com.mentra.call\"]\n\n/** Every use case, for validating an inbound request. */\nexport const MIC_USE_CASES: readonly MicUseCase[] = [\n  \"voice_call\",\n  \"transcription\",\n  \"voice_assistant\",\n  \"diagnostic\",\n]\n\n/** Owners of engine-internal sessions. Miniapps cannot claim these use cases. */\nexport const ENGINE_OWNER_PREFIX = \"engine:\"\n\n/** Use cases only engine features may acquire. */\nexport const ENGINE_ONLY_USE_CASES: readonly MicUseCase[] = [\"diagnostic\"]\n\n/**\n * Resolve every live session into one hardware state.\n *\n * On a platform without a glasses PCM uplink a glasses session is a lease and\n * nothing more: it satisfies ownership checks so an iOS call can still be\n * modelled the same way, but it claims no PCM, pins nothing, and applies no\n * gain, because the wearer's voice does not reach the call through the BES\n * BLE path there.\n */\nexport function resolveMicPolicy(\n  sessions: readonly MicSessionSpec[],\n  caps: MicPlatformCaps,\n): ResolvedMicPolicy {\n  const effective = caps.glassesPcmUplink ? sessions : sessions.filter((s) => s.source !== \"glasses\")\n\n  let pinGlasses = false\n  let loudnessGate = false\n  let winning: MicTuningProfile | null = null\n  for (const session of effective) {\n    if (session.source !== \"glasses\") continue\n    pinGlasses = true\n    if (MIC_USE_CASE_LOUDNESS_GATE[session.useCase]) loudnessGate = true\n    const profile = MIC_USE_CASE_PROFILES[session.useCase]\n    if (typeof profile?.gain !== \"number\") continue\n    // Lowest index wins: clipping is the irreversible failure, a slightly\n    // quiet assistant is not. The whole profile travels with it, because its\n    // thresholds are only meaningful at its own gain.\n    if (winning === null || profile.gain < winning.gain!) winning = profile\n  }\n\n  return {\n    rawPcm: effective.length > 0,\n    pinGlasses,\n    micTuning: winning,\n    loudnessGate: pinGlasses ? loudnessGate : null,\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/engine",
-  "version": "3.2.1-dev.279",
+  "version": "3.2.1-dev.283",
   "description": "Mentra Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,13 +97,13 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/acs-meeting": "3.2.1-dev.279",
-    "@mentra/glasses-media": "3.2.1-dev.279",
-    "@mentra/bluetooth-sdk": "3.2.1-dev.279",
-    "@mentra/cloud-client": "3.2.1-dev.279",
-    "@mentra/cloud-protocol": "3.2.1-dev.279",
-    "@mentra/crust": "3.2.1-dev.279",
-    "@mentra/miniapp": "3.2.1-dev.279",
+    "@mentra/acs-meeting": "3.2.1-dev.283",
+    "@mentra/glasses-media": "3.2.1-dev.283",
+    "@mentra/bluetooth-sdk": "3.2.1-dev.283",
+    "@mentra/cloud-client": "3.2.1-dev.283",
+    "@mentra/cloud-protocol": "3.2.1-dev.283",
+    "@mentra/crust": "3.2.1-dev.283",
+    "@mentra/miniapp": "3.2.1-dev.283",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",

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.1",
-  "releaseIdentity": "3.2.1-dev.279",
-  "releaseSetId": "mentra-3.2.1-dev.279",
-  "sourceCommit": "b89b07413c06947f1a2f4a321ce23927eaebd4e4",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.279.json",
-  "otaManifestSha256": "725cccaec20e39be8f75dbe1e511092aa4812ab46cade44a583843282f0c0eb3"
+  "releaseIdentity": "3.2.1-dev.283",
+  "releaseSetId": "mentra-3.2.1-dev.283",
+  "sourceCommit": "da43fa96393855e1a19dedc923bc496c315d2da7",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.2.1/mentra-live-ota-3.2.1-dev.283.json",
+  "otaManifestSha256": "8a0b32bd78c4f7b58b67d9eddd854b70f6a417d698a52d38b1f5ead81910e068"
 })

package/src/services/AcsMeetingService.ts

@@ -11,6 +11,8 @@ import BluetoothSdk from "@mentra/bluetooth-sdk/internal"
 import audioPlaybackService from "./AudioPlaybackService"
 import {getCallGainSweep} from "./CallGainSweep"
 import micStateCoordinator from "./MicStateCoordinator"
+import micSessionManager, {type MicSession} from "./MicSessionManager"
+import {ENGINE_OWNER_PREFIX} from "./micPolicy"
 import {SETTINGS, useSettingsStore} from "../stores/settings"
 import {Pcm16LevelMeter, pcm16WindowStats} from "../utils/pcm16"
 import {softapTrace, softapTraceFailure, softapTraceId} from "../utils/softapTrace"
@@ -620,6 +622,17 @@ class AcsMeetingService {
   private callOrigin: AcsCallOrigin = "unknown"
   private micTransport: MicTransport = "whip"
   private micSub: {remove: () => void} | null = null
+  /** Backstop lease, held only while this call is actually reading the glasses mic. */
+  private micSession: MicSession | null = null
+  private micTuningSub: {remove: () => void} | null = null
+  private micRmsSub: {remove: () => void} | null = null
+  /** Only turn telemetry off again if this call is what turned it on. */
+  private micRmsEnabled = false
+  private gateSamples = 0
+  private gateClosed = 0
+  private gateElevated = 0
+  private gateClosedElevated = 0
+  private gateRmsMax = 0
   /** True between the pin/requirement being taken and released, so release is exactly once. */
   private micUplinkActive = false
   private micFramesForwarded = 0
@@ -1302,10 +1315,12 @@ class AcsMeetingService {
   /**
    * Start forwarding the glasses microphone into ACS for this call.
    *
-   * This class is a sink. The microphone is pinned, claimed and tuned by MicSessionManager on
-   * behalf of whoever leased it; all that happens here is reading the PCM that produces. Reaching
-   * past that to the Bluetooth SDK or MicStateCoordinator would put hardware policy back in the
-   * hands of one audio consumer.
+   * This class is a sink: it never names a gain, a pin or a setting. It does take a semantic
+   * voice_call lease first, because reading the glasses mic without one is what put this call on
+   * the OS default of VAD-on — a speech gate that drops the wearer's uplink whenever the GX8002
+   * disagrees, which during a call is most of the time the far end is talking. The lease is a
+   * backstop: when the miniapp already holds one this simply merges with it, and micPolicy still
+   * decides what voice_call means for the hardware.
    *
    * `generation` is captured by the listener so a frame that lands after this call ended is
    * dropped rather than pushed at a native session that has left the meeting.
@@ -1327,6 +1342,8 @@ class AcsMeetingService {
     this.micLevel.take()
     this.lastMicLevel = null
     try {
+      this.acquireMicSession()
+      this.startMicGateTelemetry()
       this.micUplinkActive = true
       this.micSub = BluetoothSdk.addListener("mic_pcm", (event: {pcm?: ArrayBuffer; sampleRate?: number; source?: string}) => {
         if (generation !== this.callGeneration) {
@@ -1378,13 +1395,14 @@ class AcsMeetingService {
   /**
    * Stop reading the glasses microphone. Safe to call when this call never started.
    *
-   * Only the subscription is dropped. The microphone itself belongs to whoever leased it through
-   * MicSessionManager, and unsubscribing here before that owner releases is what keeps a normal
-   * hang-up from looking like the wearer's microphone disappearing.
+   * Only this call's own backstop lease is dropped. A lease the miniapp took is its to release,
+   * and letting go of ours before that owner releases is what keeps a normal hang-up from looking
+   * like the wearer's microphone disappearing.
    */
   private stopGlassesMicUplink(): void {
     this.micSub?.remove()
     this.micSub = null
+    this.releaseMicSession()
     if (this.micUplinkActive) {
       this.micUplinkActive = false
       console.log("[AcsMeeting] phase=glasses-mic-uplink-stop", {
@@ -1393,11 +1411,113 @@ class AcsMeetingService {
         dropsNonGlasses: this.micDropsNonGlasses,
         gaps: this.micGaps,
         gapMsMax: this.micGapMsMax,
+        ...this.gateSummary(),
       })
     }
+    this.stopMicGateTelemetry()
     this.micTransport = "whip"
   }
 
+  /**
+   * Watch what the glasses are actually running for the length of the call.
+   *
+   * Two different questions, both unanswerable from this side otherwise. `mic_tuning_state` is
+   * the post-clamp reply, so it catches a profile the firmware rewrote rather than accepted.
+   * `mic_rms` carries the Barrier's own verdict per frame, which is the only way to tell a gate
+   * that is suppressing speaker leak from one that is suppressing the wearer.
+   */
+  private startMicGateTelemetry(): void {
+    this.gateSamples = 0
+    this.gateClosed = 0
+    this.gateElevated = 0
+    this.gateClosedElevated = 0
+    this.gateRmsMax = 0
+
+    try {
+      this.micTuningSub = BluetoothSdk.addListener("mic_tuning_state", (event: Record<string, unknown>) => {
+        console.log("[AcsMeeting] phase=glasses-mic-tuning-applied", event)
+      })
+      this.micRmsSub = BluetoothSdk.addListener(
+        "mic_rms",
+        (event: {rms?: number; gateOpen?: boolean; speakerElevated?: boolean}) => {
+          this.gateSamples += 1
+          if (event.gateOpen === false) this.gateClosed += 1
+          if (event.speakerElevated) {
+            this.gateElevated += 1
+            if (event.gateOpen === false) this.gateClosedElevated += 1
+          }
+          if (typeof event.rms === "number" && event.rms > this.gateRmsMax) this.gateRmsMax = event.rms
+        },
+      )
+      void Promise.resolve(BluetoothSdk.setMicRmsTelemetry?.(true))
+        .then(() => {
+          this.micRmsEnabled = true
+        })
+        .catch((error) => console.warn("[AcsMeeting] mic RMS telemetry unavailable", error))
+      void Promise.resolve(BluetoothSdk.requestMicTuningState?.()).catch(() => {})
+    } catch (error) {
+      console.warn("[AcsMeeting] mic gate telemetry unavailable", error)
+    }
+  }
+
+  private stopMicGateTelemetry(): void {
+    this.micTuningSub?.remove()
+    this.micTuningSub = null
+    this.micRmsSub?.remove()
+    this.micRmsSub = null
+    if (!this.micRmsEnabled) return
+    this.micRmsEnabled = false
+    // Super Mode may have the readout open behind this call; it re-requests on focus.
+    void Promise.resolve(BluetoothSdk.setMicRmsTelemetry?.(false)).catch(() => {})
+  }
+
+  /** Barrier's behaviour over the window, as percentages a listening test can be checked against. */
+  private gateSummary(): Record<string, number> {
+    if (this.gateSamples === 0) return {}
+    const pct = (n: number, of: number) => (of === 0 ? 0 : Math.round((n / of) * 1000) / 10)
+    return {
+      gateSamples: this.gateSamples,
+      gateClosedPct: pct(this.gateClosed, this.gateSamples),
+      speakerElevatedPct: pct(this.gateElevated, this.gateSamples),
+      // The number that matters: closed while the far end was quiet means the wearer was cut.
+      gateClosedQuietPct: pct(this.gateClosed - this.gateClosedElevated, this.gateSamples - this.gateElevated),
+      gateRmsMax: this.gateRmsMax,
+    }
+  }
+
+  /**
+   * Guarantee a voice_call session for as long as this call reads the glasses mic.
+   *
+   * The miniapp asking for one is the intended path; this covers the builds where it cannot,
+   * because a bundled Call that predates MIC_ACQUIRE joins anyway rather than failing. Without
+   * this the uplink runs under whatever the OS settings say, and the shipped default is VAD-on.
+   */
+  private acquireMicSession(): void {
+    if (this.micSession) return
+    try {
+      this.micSession = micSessionManager.acquire({
+        owner: `${ENGINE_OWNER_PREFIX}acs-uplink`,
+        source: "glasses",
+        useCase: "voice_call",
+      })
+    } catch (error) {
+      // A source conflict means something else already owns the microphone. Forwarding whatever
+      // it captures is still better than dropping the wearer from the call.
+      console.warn("[AcsMeeting] glasses mic session unavailable", error)
+    }
+  }
+
+  private releaseMicSession(): void {
+    const session = this.micSession
+    if (!session) return
+    this.micSession = null
+    try {
+      session.release()
+    } catch (error) {
+      console.warn("[AcsMeeting] releasing the glasses mic session failed", error)
+    }
+  }
+
   /**
    * Report a call whose pinned microphone stopped delivering. There is deliberately no fallback:
    * the wearer agreed to be heard from the glasses, and quietly switching to the phone in the
@@ -1448,32 +1568,14 @@ class AcsMeetingService {
       nearClip: stats.nearClip,
       nearClipPct: stats.nearClipPct,
       gain,
+      barrier: micStateCoordinator.getSessionLoudnessGate(),
       sweep: sweep.currentLabel(),
       dropsStale: this.micDropsStale,
       dropsNonGlasses: this.micDropsNonGlasses,
       gaps: this.micGaps,
       gapMsMax: this.micGapMsMax,
+      ...this.gateSummary(),
     })
-    // #region agent log
-    fetch("http://127.0.0.1:7905/ingest/5a9713c9-45ff-4d09-9435-2adc5db5e91d", {
-      method: "POST",
-      headers: {"Content-Type": "application/json", "X-Debug-Session-Id": "828181"},
-      body: JSON.stringify({
-        sessionId: "828181",
-        runId: "run1",
-        hypothesisId: "E",
-        location: "AcsMeetingService.ts:logMicUplink",
-        message: "phone decoded glasses PCM window",
-        data: {
-          fps: Math.round((this.micFramesWindow * 1000) / elapsed),
-          meanAbs: level.meanAbs,
-          peak: level.peak,
-          frames: this.micFramesForwarded,
-        },
-        timestamp: Date.now(),
-      }),
-    }).catch(() => {})
-    // #endregion
     this.micFramesWindow = 0
   }
 

package/src/services/MicSessionManager.ts

@@ -235,6 +235,9 @@ class MicSessionManager {
     }
 
     micStateCoordinator.setSessionRequirement(policy.rawPcm)
+    // Barrier is the only echo control left once the PCM claim turns hardware VAD off, so it
+    // rides with the claim rather than with the tuning a sweep may be rewriting.
+    micStateCoordinator.setSessionLoudnessGate(policy.loudnessGate)
 
     if (getCallGainSweep().isActive()) {
       const gain = getCallGainSweep().currentGain()

package/src/services/MicStateCoordinator.ts

@@ -20,6 +20,15 @@ import type {MicTuningProfile} from "./micPolicy"
 
 const LOG_TAG = "MIC_COORDINATOR"
 
+/** Field-wise compare, so a profile that moves a threshold without the gain still lands. */
+function sameProfile(a: MicTuningProfile | null, b: MicTuningProfile | null): boolean {
+  if (a === b) return true
+  if (!a || !b) return false
+  const keys = new Set([...Object.keys(a), ...Object.keys(b)]) as Set<keyof MicTuningProfile>
+  for (const key of keys) if (a[key] !== b[key]) return false
+  return true
+}
+
 type MicGate = "vad" | "loudnessGate"
 
 interface GateOverride {
@@ -41,6 +50,10 @@ const flushMicRequirementsPatch = createDebouncedPatchFlusher<Record<string, unk
     // gate override during the debounce window, and a captured stale value
     // must not win after that lifecycle transition.
     const runtimePatch = micStateCoordinator.applyEffectiveGatePolicy(patch)
+    // The merged patch, not the intent that produced it. Everything above this line is a
+    // preference; this is the only record of what the glasses were actually told, and the three
+    // keys a call depends on (VAD off, Barrier on, the tuning) are only decided here at flush.
+    console.log(`${LOG_TAG}: write`, runtimePatch)
     void Promise.resolve(BluetoothSdk.updateBluetoothSettings(runtimePatch)).catch((err) => {
       console.error(`${LOG_TAG}: failed to apply mic requirements:`, err)
     })
@@ -78,6 +91,10 @@ class MicStateCoordinator {
    * call from resurrecting the profile.
    */
   private sessionMicTuningWritten = false
+  /** Barrier required by the live sessions, or null when they have no opinion. */
+  private sessionLoudnessGate: boolean | null = null
+  /** Latched like the tuning, so the OS value is restated once a session has moved it. */
+  private sessionLoudnessGateWritten = false
   private readonly miniappVadOverrides = new Map<string, GateOverride>()
   private readonly miniappLoudnessGateOverrides = new Map<string, GateOverride>()
   private overrideSequence = 0
@@ -126,7 +143,7 @@ class MicStateCoordinator {
    * over the value that was queued.
    */
   public setSessionMicTuning(profile: MicTuningProfile | null): void {
-    if (profile?.gain === this.sessionMicTuning?.gain) return
+    if (sameProfile(profile, this.sessionMicTuning)) return
     this.sessionMicTuning = profile
     if (profile) this.sessionMicTuningWritten = true
     // Nothing was ever written, so there is nothing to restore.
@@ -140,6 +157,28 @@ class MicStateCoordinator {
     return this.sessionMicTuning
   }
 
+  /** Last session Barrier queued, or null when the OS value is in force. For call logging. */
+  public getSessionLoudnessGate(): boolean | null {
+    return this.sessionLoudnessGate
+  }
+
+  /**
+   * Run or stop the center-mic loudness gate on behalf of the live sessions.
+   *
+   * MicSessionManager only, and the counterpart to the PCM claim rather than a second opinion on
+   * it: raw PCM turns hardware VAD off, which leaves Barrier as the only thing standing between
+   * the far end and its own echo. Unlike VAD this never stops the stream, so the worst a wrong
+   * threshold costs is a zeroed frame instead of a dropped word.
+   */
+  public setSessionLoudnessGate(enabled: boolean | null): void {
+    if (this.sessionLoudnessGate === enabled) return
+    this.sessionLoudnessGate = enabled
+    if (enabled !== null) this.sessionLoudnessGateWritten = true
+    else if (!this.sessionLoudnessGateWritten) return
+    console.log(`${LOG_TAG}: session loudness gate ${enabled === null ? "cleared" : enabled}`)
+    this.applyUnion()
+  }
+
   /**
    * Super Mode sliders outrank a session profile. A live override means a gain
    * sweep would write to the coordinator and the glasses would ignore it.
@@ -169,6 +208,19 @@ class MicStateCoordinator {
     return {...this.sessionMicTuning} as Record<string, number>
   }
 
+  /**
+   * The session's Barrier, but only when it wins.
+   *
+   * Suppressed by a live Super Mode tuning value for the same reason the gain is: that screen is
+   * the manual override, and a gate running against hand-entered thresholds is the one case where
+   * the session's numbers are the wrong ones.
+   */
+  private winningSessionLoudnessGate(): boolean | undefined {
+    if (this.sessionLoudnessGate === null) return undefined
+    if (Object.keys(this.configuredMicTuning).length > 0) return undefined
+    return this.sessionLoudnessGate
+  }
+
   /**
    * Apply a miniapp-owned gate override without changing the OS preference.
    * Overrides are lifecycle-scoped and last-live-owner-wins independently for
@@ -262,8 +314,11 @@ class MicStateCoordinator {
     } else if (vadOverride) {
       runtimeSettings.voice_activity_detection_enabled = vadOverride.enabled
     }
+    const sessionGate = this.winningSessionLoudnessGate()
     if (loudnessOverride) {
       runtimeSettings.loudness_gate_enabled = loudnessOverride.enabled
+    } else if (sessionGate !== undefined) {
+      runtimeSettings.loudness_gate_enabled = sessionGate
     }
 
     // BES forgets mic_tuning on disconnect, so the on-connect replay is what
@@ -336,9 +391,15 @@ class MicStateCoordinator {
     else if (vadOverride) patch.voice_activity_detection_enabled = vadOverride.enabled
     else if (this.configuredVad !== undefined) patch.voice_activity_detection_enabled = this.configuredVad
 
+    const sessionGate = this.winningSessionLoudnessGate()
     if (loudnessOverride) patch.loudness_gate_enabled = loudnessOverride.enabled
+    else if (sessionGate !== undefined) patch.loudness_gate_enabled = sessionGate
     else if (this.configuredLoudnessGate !== undefined) {
       patch.loudness_gate_enabled = this.configuredLoudnessGate
+    } else if (this.sessionLoudnessGateWritten) {
+      // A session moved it and the device carries no preference, so restate the product default
+      // rather than leaving the call's gate running after it ended.
+      patch.loudness_gate_enabled = false
     }
 
     const sessionTuning = this.winningSessionMicTuning()
@@ -356,6 +417,7 @@ class MicStateCoordinator {
     this.localWantsLc3 = false
     this.sessionWantsPcm = false
     this.sessionMicTuning = null
+    this.sessionLoudnessGate = null
     this.applyUnion()
   }
 

package/src/services/micPolicy.ts

@@ -20,6 +20,52 @@ export type MicSource = "glasses" | "phone"
 export type MicTuningProfile = {
   /** codec_adc_vol index, 0-15. */
   gain?: number
+  /** Center-mic RMS to open the gate. */
+  open?: number
+  /** Center-mic RMS to close it again. */
+  close?: number
+  /** Open threshold while the speaker is elevated. */
+  sp_open?: number
+  /** Close threshold while the speaker is elevated. */
+  sp_close?: number
+}
+
+/** `codec_adc_vol[]`: index to dB. Index 0 is mute and is never offered. */
+export const GAIN_DB = [-99, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 32]
+
+/**
+ * Mirrored from `center_mic_vad_get_default_config` and `CODEC_SADC_VOL`.
+ *
+ * The four RMS numbers are measured *after* the ADC gain, so they are only
+ * meaningful next to the gain they were calibrated at, which is index 15.
+ */
+export const MIC_TUNING_FIRMWARE_DEFAULTS = {
+  gain: 15,
+  open: 1350,
+  close: 945,
+  sp_open: 2900,
+  sp_close: 1600,
+} as const
+
+/**
+ * Re-express the firmware's thresholds at a different gain.
+ *
+ * The gate compares post-gain RMS, so moving the gain without moving the
+ * thresholds silently changes what the gate means: at -8 dB the wearer has to
+ * be 2.5x louder to clear a number that was chosen for +32 dB. Scaling both by
+ * the same factor keeps the *acoustic* trip point the profile was tuned for,
+ * for the wearer and for speaker leak alike.
+ */
+export function scaleMicTuningToGain(gain: number): Required<MicTuningProfile> {
+  const index = Math.min(GAIN_DB.length - 1, Math.max(1, Math.round(gain)))
+  const factor = Math.pow(10, (GAIN_DB[index]! - GAIN_DB[MIC_TUNING_FIRMWARE_DEFAULTS.gain]!) / 20)
+  return {
+    gain: index,
+    open: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.open * factor),
+    close: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.close * factor),
+    sp_open: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.sp_open * factor),
+    sp_close: Math.round(MIC_TUNING_FIRMWARE_DEFAULTS.sp_close * factor),
+  }
 }
 
 /** A live microphone lease. */
@@ -36,6 +82,8 @@ export type ResolvedMicPolicy = {
   pinGlasses: boolean
   /** Tuning override for the glasses, or null to leave the OS value in force. */
   micTuning: MicTuningProfile | null
+  /** Run the center-mic loudness gate, or null to leave the OS value in force. */
+  loudnessGate: boolean | null
 }
 
 /** Platform facts the policy cannot infer from the sessions alone. */
@@ -55,22 +103,40 @@ export type MicPlatformCaps = {
  * step above everything else. It suits a wearer dictating to a transcription
  * miniapp across a room; it clips a wearer talking into a Teams call.
  *
- * Gain is the only knob here on purpose. A call forces hardware VAD off and
- * the Barrier is off by default, which puts the firmware gate in its `pass`
- * branch, so the RMS thresholds cannot affect a call.
- *
  * Index 14 is +26 dB: one step down, and the step that removes the table's
  * anomalous jump. A same-voice sweep showed 15 rails hard (2.5–4.2% clip);
  * 14/13/12 still kiss the rail on syllable tips. 13 is +24 dB, the middle
  * of that band, while we listen for loudness vs residual clip.
+ *
+ * The thresholds ride along with the gain rather than being stated here, so
+ * changing the index above cannot leave the gate calibrated for a level the
+ * ADC no longer produces.
  */
 export const MIC_USE_CASE_PROFILES: Record<MicUseCase, MicTuningProfile> = {
-  voice_call: {gain: 13},
+  voice_call: scaleMicTuningToGain(13),
   transcription: {},
   voice_assistant: {},
   diagnostic: {},
 }
 
+/**
+ * Use cases that run the center-mic loudness gate ("Barrier").
+ *
+ * A voice call is the one place it earns its keep. There is no echo canceller
+ * on the LC3 uplink — `MENTRA_LC3_SPEECH_PROCESSING` is 0 and the capture path
+ * ignores the playback reference — so without a gate the far end hears itself
+ * through the wearer's speaker. Barrier is the safe half of the firmware's two
+ * gates: it zeroes a quiet frame but never stops transmitting, where VAD drops
+ * the stream outright. Paired with the speaker-elevated thresholds above, that
+ * suppresses leak while the far end is talking and costs the wearer nothing.
+ */
+export const MIC_USE_CASE_LOUDNESS_GATE: Record<MicUseCase, boolean> = {
+  voice_call: true,
+  transcription: false,
+  voice_assistant: false,
+  diagnostic: false,
+}
+
 /**
  * Packages allowed to hold a `voice_call` session.
  *
@@ -109,21 +175,24 @@ export function resolveMicPolicy(
   const effective = caps.glassesPcmUplink ? sessions : sessions.filter((s) => s.source !== "glasses")
 
   let pinGlasses = false
-  let gain: number | undefined
+  let loudnessGate = false
+  let winning: MicTuningProfile | null = null
   for (const session of effective) {
     if (session.source !== "glasses") continue
     pinGlasses = true
-    const profileGain = MIC_USE_CASE_PROFILES[session.useCase]?.gain
+    if (MIC_USE_CASE_LOUDNESS_GATE[session.useCase]) loudnessGate = true
+    const profile = MIC_USE_CASE_PROFILES[session.useCase]
+    if (typeof profile?.gain !== "number") continue
     // Lowest index wins: clipping is the irreversible failure, a slightly
-    // quiet assistant is not.
-    if (typeof profileGain === "number" && (gain === undefined || profileGain < gain)) {
-      gain = profileGain
-    }
+    // quiet assistant is not. The whole profile travels with it, because its
+    // thresholds are only meaningful at its own gain.
+    if (winning === null || profile.gain < winning.gain!) winning = profile
   }
 
   return {
     rawPcm: effective.length > 0,
     pinGlasses,
-    micTuning: gain === undefined ? null : {gain},
+    micTuning: winning,
+    loudnessGate: pinGlasses ? loudnessGate : null,
   }
 }