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

package/build/services/MicSessionManager.d.ts

@@ -0,0 +1,83 @@
+/**
+ * MicSessionManager
+ *
+ * The engine's microphone ownership layer. Applications acquire a lease that
+ * says what they are doing; this class tracks the live leases, resolves them
+ * through `micPolicy`, and pushes the result to MicStateCoordinator.
+ *
+ * Everything above it is semantic ("I need a glasses microphone for a voice
+ * call"). Everything below it is hardware. Audio *sinks* — AcsMeetingService
+ * today, another transport later — are downstream of the PCM this produces and
+ * must not reach past it to the coordinator or the Bluetooth SDK.
+ */
+import { type MicPlatformCaps, type MicSource, type MicUseCase } from "./micPolicy";
+/** Raised when a second source is requested while another is already live. */
+export declare const MIC_SOURCE_CONFLICT = "MIC_SOURCE_CONFLICT";
+export interface MicSessionOptions {
+    /** Package name for a miniapp, or `engine:<name>` for an engine feature. */
+    owner: string;
+    source: MicSource;
+    useCase: MicUseCase;
+}
+export interface MicSession {
+    readonly id: number;
+    readonly owner: string;
+    readonly source: MicSource;
+    readonly useCase: MicUseCase;
+    /** Idempotent. Releasing a session that is already gone is a no-op. */
+    release(): void;
+}
+declare class MicSessionManager {
+    private static instance;
+    private readonly sessions;
+    private nextId;
+    private caps;
+    /** Last pin we asked for, so a no-op change does not re-enter native. */
+    private pinned;
+    /**
+     * One 15→14→15→13 walk per voice-call generation. Cleared when the last
+     * glasses voice_call session drops so the next join can measure again.
+     */
+    private sweepFinished;
+    /** One-shot A/B walk. Off now that 15/14/13 is measured; Super Mode can still start it. */
+    private sweepEnabled;
+    private constructor();
+    static getInstance(): MicSessionManager;
+    /** Test seam. Production reads the platform once at construction. */
+    setPlatformCaps(caps: MicPlatformCaps): void;
+    /**
+     * Take a microphone lease.
+     *
+     * Throws [MIC_SOURCE_CONFLICT] when a different source is already live: only
+     * the glasses can be pinned, so silently mixing sources would leave one
+     * consumer reading a microphone it did not ask for. That is the failure ACS
+     * already guards against frame by frame.
+     */
+    acquire(options: MicSessionOptions): MicSession;
+    /** Drop every lease an owner holds. The backstop for unregister / disconnect. */
+    releaseOwner(owner: string): boolean;
+    /**
+     * Whether an owner holds a glasses lease.
+     *
+     * Ownership only. Whether that lease has any hardware effect is
+     * [resolveMicPolicy]'s business, so on a platform without a glasses PCM
+     * uplink this still answers true while nothing is claimed.
+     */
+    hasGlassesSession(owner: string): boolean;
+    releaseAll(): void;
+    cleanup(): void;
+    /** Tests disable the auto-walk so acquire still means "policy 14". */
+    setCallGainSweepEnabled(enabled: boolean): void;
+    /**
+     * Start or restart the 15→14→15→13 comparison on a live voice_call session.
+     * Super Mode uses this so a call already in progress can be measured.
+     */
+    startCallGainSweep(): boolean;
+    private releaseId;
+    private hasVoiceCallGlasses;
+    private stopSweep;
+    private recompute;
+}
+declare const micSessionManager: MicSessionManager;
+export default micSessionManager;
+//# sourceMappingURL=MicSessionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MicSessionManager.d.ts","sourceRoot":"","sources":["../../src/services/MicSessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AAIpB,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AAExD,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,UAAU,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;IAC5B,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAA;CAChB;AAgBD,cAAM,iBAAiB;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,IAAI,CAAiC;IAC7C,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAQ;IACtB;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAQ;IAC7B,2FAA2F;IAC3F,OAAO,CAAC,YAAY,CAAQ;IAE5B,OAAO;WAEO,WAAW,IAAI,iBAAiB;IAO9C,qEAAqE;IAC9D,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAInD;;;;;;;OAOG;IACI,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAuBtD,iFAAiF;IAC1E,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAc3C;;;;;;OAMG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOzC,UAAU,IAAI,IAAI;IAUlB,OAAO,IAAI,IAAI;IAQtB,sEAAsE;IAC/D,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKtD;;;OAGG;IACI,kBAAkB,IAAI,OAAO;IAoBpC,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;CAkClB;AAED,QAAA,MAAM,iBAAiB,mBAAkC,CAAA;AACzD,eAAe,iBAAiB,CAAA"}

package/build/services/MicSessionManager.js

@@ -0,0 +1,198 @@
+/**
+ * MicSessionManager
+ *
+ * The engine's microphone ownership layer. Applications acquire a lease that
+ * says what they are doing; this class tracks the live leases, resolves them
+ * through `micPolicy`, and pushes the result to MicStateCoordinator.
+ *
+ * Everything above it is semantic ("I need a glasses microphone for a voice
+ * call"). Everything below it is hardware. Audio *sinks* — AcsMeetingService
+ * today, another transport later — are downstream of the PCM this produces and
+ * must not reach past it to the coordinator or the Bluetooth SDK.
+ */
+import { Platform } from "react-native";
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { getCallGainSweep } from "./CallGainSweep";
+import micStateCoordinator from "./MicStateCoordinator";
+import { resolveMicPolicy, } from "./micPolicy";
+const LOG_TAG = "MIC_SESSION";
+/** Raised when a second source is requested while another is already live. */
+export const MIC_SOURCE_CONFLICT = "MIC_SOURCE_CONFLICT";
+function defaultCaps() {
+    return {
+        // iOS has no `setMicSourcePin`, so it cannot promise the phone microphone
+        // stays shut, and `glassesLc3UplinkSupported` never selects the BLE LC3
+        // uplink there.
+        glassesPcmUplink: Platform.OS === "android" && typeof BluetoothSdk.setMicSourcePin === "function",
+    };
+}
+class MicSessionManager {
+    static instance = null;
+    sessions = new Map();
+    nextId = 1;
+    caps = defaultCaps();
+    /** Last pin we asked for, so a no-op change does not re-enter native. */
+    pinned = false;
+    /**
+     * One 15→14→15→13 walk per voice-call generation. Cleared when the last
+     * glasses voice_call session drops so the next join can measure again.
+     */
+    sweepFinished = false;
+    /** One-shot A/B walk. Off now that 15/14/13 is measured; Super Mode can still start it. */
+    sweepEnabled = false;
+    constructor() { }
+    static getInstance() {
+        if (!MicSessionManager.instance) {
+            MicSessionManager.instance = new MicSessionManager();
+        }
+        return MicSessionManager.instance;
+    }
+    /** Test seam. Production reads the platform once at construction. */
+    setPlatformCaps(caps) {
+        this.caps = caps;
+    }
+    /**
+     * Take a microphone lease.
+     *
+     * Throws [MIC_SOURCE_CONFLICT] when a different source is already live: only
+     * the glasses can be pinned, so silently mixing sources would leave one
+     * consumer reading a microphone it did not ask for. That is the failure ACS
+     * already guards against frame by frame.
+     */
+    acquire(options) {
+        const conflicting = [...this.sessions.values()].find((s) => s.source !== options.source);
+        if (conflicting) {
+            throw new Error(`${MIC_SOURCE_CONFLICT}: ${options.owner} asked for "${options.source}" while ` +
+                `${conflicting.owner} holds "${conflicting.source}"`);
+        }
+        const id = this.nextId++;
+        this.sessions.set(id, { id, owner: options.owner, source: options.source, useCase: options.useCase });
+        console.log(`${LOG_TAG}: acquire #${id} ${options.owner} ${options.useCase}/${options.source}`);
+        this.recompute();
+        return {
+            id,
+            owner: options.owner,
+            source: options.source,
+            useCase: options.useCase,
+            release: () => this.releaseId(id),
+        };
+    }
+    /** Drop every lease an owner holds. The backstop for unregister / disconnect. */
+    releaseOwner(owner) {
+        let removed = false;
+        for (const [id, session] of this.sessions) {
+            if (session.owner !== owner)
+                continue;
+            this.sessions.delete(id);
+            removed = true;
+        }
+        if (removed) {
+            console.log(`${LOG_TAG}: released all sessions for ${owner}`);
+            this.recompute();
+        }
+        return removed;
+    }
+    /**
+     * Whether an owner holds a glasses lease.
+     *
+     * Ownership only. Whether that lease has any hardware effect is
+     * [resolveMicPolicy]'s business, so on a platform without a glasses PCM
+     * uplink this still answers true while nothing is claimed.
+     */
+    hasGlassesSession(owner) {
+        for (const session of this.sessions.values()) {
+            if (session.owner === owner && session.source === "glasses")
+                return true;
+        }
+        return false;
+    }
+    releaseAll() {
+        if (this.sessions.size === 0) {
+            this.stopSweep("released_all");
+            return;
+        }
+        this.sessions.clear();
+        console.log(`${LOG_TAG}: released all sessions`);
+        this.recompute();
+    }
+    cleanup() {
+        this.stopSweep("cleanup");
+        this.sessions.clear();
+        this.pinned = false;
+        this.sweepFinished = false;
+        MicSessionManager.instance = null;
+    }
+    /** Tests disable the auto-walk so acquire still means "policy 14". */
+    setCallGainSweepEnabled(enabled) {
+        this.sweepEnabled = enabled;
+        if (!enabled)
+            this.stopSweep("disabled");
+    }
+    /**
+     * Start or restart the 15→14→15→13 comparison on a live voice_call session.
+     * Super Mode uses this so a call already in progress can be measured.
+     */
+    startCallGainSweep() {
+        if (!this.hasVoiceCallGlasses()) {
+            console.warn(`${LOG_TAG}: CALL_GAIN_SWEEP ignored — no live voice_call glasses session`);
+            return false;
+        }
+        if (micStateCoordinator.hasConfiguredMicTuning()) {
+            console.warn(`${LOG_TAG}: CALL_GAIN_SWEEP Super Mode mic-tuning is set; reset it or the glasses will ignore the sweep`);
+        }
+        this.sweepFinished = false;
+        return getCallGainSweep().restart((gain) => micStateCoordinator.setSessionMicTuning({ gain }), () => {
+            this.sweepFinished = true;
+            this.recompute();
+        });
+    }
+    releaseId(id) {
+        if (!this.sessions.delete(id))
+            return;
+        console.log(`${LOG_TAG}: release #${id}`);
+        this.recompute();
+    }
+    hasVoiceCallGlasses() {
+        if (!this.caps.glassesPcmUplink)
+            return false;
+        for (const session of this.sessions.values()) {
+            if (session.useCase === "voice_call" && session.source === "glasses")
+                return true;
+        }
+        return false;
+    }
+    stopSweep(reason) {
+        if (getCallGainSweep().isActive())
+            getCallGainSweep().stop(reason);
+    }
+    recompute() {
+        const policy = resolveMicPolicy([...this.sessions.values()], this.caps);
+        const voiceCall = this.hasVoiceCallGlasses();
+        if (!voiceCall) {
+            this.stopSweep("session_ended");
+            this.sweepFinished = false;
+        }
+        // Pin before claiming PCM, so the first frame the claim produces is
+        // already from the right microphone and the phone mic is never opened.
+        if (policy.pinGlasses !== this.pinned) {
+            this.pinned = policy.pinGlasses;
+            void Promise.resolve(BluetoothSdk.setMicSourcePin?.(policy.pinGlasses ? "glasses" : null)).catch((error) => {
+                console.warn(`${LOG_TAG}: setMicSourcePin failed`, error);
+            });
+        }
+        micStateCoordinator.setSessionRequirement(policy.rawPcm);
+        if (getCallGainSweep().isActive()) {
+            const gain = getCallGainSweep().currentGain();
+            micStateCoordinator.setSessionMicTuning(gain == null ? policy.micTuning : { gain });
+            return;
+        }
+        if (this.sweepEnabled && voiceCall && !this.sweepFinished) {
+            this.startCallGainSweep();
+            return;
+        }
+        micStateCoordinator.setSessionMicTuning(policy.micTuning);
+    }
+}
+const micSessionManager = MicSessionManager.getInstance();
+export default micSessionManager;
+//# sourceMappingURL=MicSessionManager.js.map

package/build/services/MicSessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicSessionManager.js","sourceRoot":"","sources":["../../src/services/MicSessionManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MicSessionManager\n *\n * The engine's microphone ownership layer. Applications acquire a lease that\n * says what they are doing; this class tracks the live leases, resolves them\n * through `micPolicy`, and pushes the result to MicStateCoordinator.\n *\n * Everything above it is semantic (\"I need a glasses microphone for a voice\n * call\"). Everything below it is hardware. Audio *sinks* — AcsMeetingService\n * today, another transport later — are downstream of the PCM this produces and\n * must not reach past it to the coordinator or the Bluetooth SDK.\n */\n\nimport {Platform} from \"react-native\"\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\n\nimport {getCallGainSweep} from \"./CallGainSweep\"\nimport micStateCoordinator from \"./MicStateCoordinator\"\nimport {\n  resolveMicPolicy,\n  type MicPlatformCaps,\n  type MicSessionSpec,\n  type MicSource,\n  type MicUseCase,\n} from \"./micPolicy\"\n\nconst LOG_TAG = \"MIC_SESSION\"\n\n/** Raised when a second source is requested while another is already live. */\nexport const MIC_SOURCE_CONFLICT = \"MIC_SOURCE_CONFLICT\"\n\nexport interface MicSessionOptions {\n  /** Package name for a miniapp, or `engine:<name>` for an engine feature. */\n  owner: string\n  source: MicSource\n  useCase: MicUseCase\n}\n\nexport interface MicSession {\n  readonly id: number\n  readonly owner: string\n  readonly source: MicSource\n  readonly useCase: MicUseCase\n  /** Idempotent. Releasing a session that is already gone is a no-op. */\n  release(): void\n}\n\ninterface LiveSession extends MicSessionSpec {\n  id: number\n  owner: string\n}\n\nfunction defaultCaps(): MicPlatformCaps {\n  return {\n    // iOS has no `setMicSourcePin`, so it cannot promise the phone microphone\n    // stays shut, and `glassesLc3UplinkSupported` never selects the BLE LC3\n    // uplink there.\n    glassesPcmUplink: Platform.OS === \"android\" && typeof BluetoothSdk.setMicSourcePin === \"function\",\n  }\n}\n\nclass MicSessionManager {\n  private static instance: MicSessionManager | null = null\n\n  private readonly sessions = new Map<number, LiveSession>()\n  private nextId = 1\n  private caps: MicPlatformCaps = defaultCaps()\n  /** Last pin we asked for, so a no-op change does not re-enter native. */\n  private pinned = false\n  /**\n   * One 15→14→15→13 walk per voice-call generation. Cleared when the last\n   * glasses voice_call session drops so the next join can measure again.\n   */\n  private sweepFinished = false\n  /** One-shot A/B walk. Off now that 15/14/13 is measured; Super Mode can still start it. */\n  private sweepEnabled = false\n\n  private constructor() {}\n\n  public static getInstance(): MicSessionManager {\n    if (!MicSessionManager.instance) {\n      MicSessionManager.instance = new MicSessionManager()\n    }\n    return MicSessionManager.instance\n  }\n\n  /** Test seam. Production reads the platform once at construction. */\n  public setPlatformCaps(caps: MicPlatformCaps): void {\n    this.caps = caps\n  }\n\n  /**\n   * Take a microphone lease.\n   *\n   * Throws [MIC_SOURCE_CONFLICT] when a different source is already live: only\n   * the glasses can be pinned, so silently mixing sources would leave one\n   * consumer reading a microphone it did not ask for. That is the failure ACS\n   * already guards against frame by frame.\n   */\n  public acquire(options: MicSessionOptions): MicSession {\n    const conflicting = [...this.sessions.values()].find((s) => s.source !== options.source)\n    if (conflicting) {\n      throw new Error(\n        `${MIC_SOURCE_CONFLICT}: ${options.owner} asked for \"${options.source}\" while ` +\n          `${conflicting.owner} holds \"${conflicting.source}\"`,\n      )\n    }\n\n    const id = this.nextId++\n    this.sessions.set(id, {id, owner: options.owner, source: options.source, useCase: options.useCase})\n    console.log(`${LOG_TAG}: acquire #${id} ${options.owner} ${options.useCase}/${options.source}`)\n    this.recompute()\n\n    return {\n      id,\n      owner: options.owner,\n      source: options.source,\n      useCase: options.useCase,\n      release: () => this.releaseId(id),\n    }\n  }\n\n  /** Drop every lease an owner holds. The backstop for unregister / disconnect. */\n  public releaseOwner(owner: string): boolean {\n    let removed = false\n    for (const [id, session] of this.sessions) {\n      if (session.owner !== owner) continue\n      this.sessions.delete(id)\n      removed = true\n    }\n    if (removed) {\n      console.log(`${LOG_TAG}: released all sessions for ${owner}`)\n      this.recompute()\n    }\n    return removed\n  }\n\n  /**\n   * Whether an owner holds a glasses lease.\n   *\n   * Ownership only. Whether that lease has any hardware effect is\n   * [resolveMicPolicy]'s business, so on a platform without a glasses PCM\n   * uplink this still answers true while nothing is claimed.\n   */\n  public hasGlassesSession(owner: string): boolean {\n    for (const session of this.sessions.values()) {\n      if (session.owner === owner && session.source === \"glasses\") return true\n    }\n    return false\n  }\n\n  public releaseAll(): void {\n    if (this.sessions.size === 0) {\n      this.stopSweep(\"released_all\")\n      return\n    }\n    this.sessions.clear()\n    console.log(`${LOG_TAG}: released all sessions`)\n    this.recompute()\n  }\n\n  public cleanup(): void {\n    this.stopSweep(\"cleanup\")\n    this.sessions.clear()\n    this.pinned = false\n    this.sweepFinished = false\n    MicSessionManager.instance = null\n  }\n\n  /** Tests disable the auto-walk so acquire still means \"policy 14\". */\n  public setCallGainSweepEnabled(enabled: boolean): void {\n    this.sweepEnabled = enabled\n    if (!enabled) this.stopSweep(\"disabled\")\n  }\n\n  /**\n   * Start or restart the 15→14→15→13 comparison on a live voice_call session.\n   * Super Mode uses this so a call already in progress can be measured.\n   */\n  public startCallGainSweep(): boolean {\n    if (!this.hasVoiceCallGlasses()) {\n      console.warn(`${LOG_TAG}: CALL_GAIN_SWEEP ignored — no live voice_call glasses session`)\n      return false\n    }\n    if (micStateCoordinator.hasConfiguredMicTuning()) {\n      console.warn(\n        `${LOG_TAG}: CALL_GAIN_SWEEP Super Mode mic-tuning is set; reset it or the glasses will ignore the sweep`,\n      )\n    }\n    this.sweepFinished = false\n    return getCallGainSweep().restart(\n      (gain) => micStateCoordinator.setSessionMicTuning({gain}),\n      () => {\n        this.sweepFinished = true\n        this.recompute()\n      },\n    )\n  }\n\n  private releaseId(id: number): void {\n    if (!this.sessions.delete(id)) return\n    console.log(`${LOG_TAG}: release #${id}`)\n    this.recompute()\n  }\n\n  private hasVoiceCallGlasses(): boolean {\n    if (!this.caps.glassesPcmUplink) return false\n    for (const session of this.sessions.values()) {\n      if (session.useCase === \"voice_call\" && session.source === \"glasses\") return true\n    }\n    return false\n  }\n\n  private stopSweep(reason: string): void {\n    if (getCallGainSweep().isActive()) getCallGainSweep().stop(reason)\n  }\n\n  private recompute(): void {\n    const policy = resolveMicPolicy([...this.sessions.values()], this.caps)\n    const voiceCall = this.hasVoiceCallGlasses()\n    if (!voiceCall) {\n      this.stopSweep(\"session_ended\")\n      this.sweepFinished = false\n    }\n\n    // Pin before claiming PCM, so the first frame the claim produces is\n    // already from the right microphone and the phone mic is never opened.\n    if (policy.pinGlasses !== this.pinned) {\n      this.pinned = policy.pinGlasses\n      void Promise.resolve(BluetoothSdk.setMicSourcePin?.(policy.pinGlasses ? \"glasses\" : null)).catch(\n        (error) => {\n          console.warn(`${LOG_TAG}: setMicSourcePin failed`, error)\n        },\n      )\n    }\n\n    micStateCoordinator.setSessionRequirement(policy.rawPcm)\n\n    if (getCallGainSweep().isActive()) {\n      const gain = getCallGainSweep().currentGain()\n      micStateCoordinator.setSessionMicTuning(gain == null ? policy.micTuning : {gain})\n      return\n    }\n\n    if (this.sweepEnabled && voiceCall && !this.sweepFinished) {\n      this.startCallGainSweep()\n      return\n    }\n\n    micStateCoordinator.setSessionMicTuning(policy.micTuning)\n  }\n}\n\nconst micSessionManager = MicSessionManager.getInstance()\nexport default micSessionManager\n"]}

package/build/services/MicStateCoordinator.d.ts

@@ -6,26 +6,46 @@
  * Local miniapps subscribe to audio_chunk / transcription streams.
  * This coordinator pushes the aggregate local requirement set to BluetoothSdk
  * so the mic runs whenever at least one local consumer needs it.
+ *
+ * It also merges what the live microphone sessions require (MicSessionManager,
+ * via `setSessionRequirement` / `setSessionMicTuning`) with the OS preferences
+ * the settings store derives. Applications go through MicSessionManager; this
+ * class is an engine implementation detail.
  */
+import type { MicTuningProfile } from "./micPolicy";
 type MicGate = "vad" | "loudnessGate";
 interface ConfiguredMicGates {
     vadEnabled?: boolean | null;
     loudnessGateEnabled?: boolean | null;
+    micTuning?: Record<string, number> | null;
 }
 declare class MicStateCoordinator {
     private static instance;
     private localWantsPcm;
     private localWantsLc3;
     /**
-     * A live ACS call taking the wearer's voice off the glasses over BLE LC3.
+     * A live microphone session held through MicSessionManager — a voice call today.
      *
      * Tracked separately from the miniapp requirement because the two have independent lifetimes:
      * the call miniapp does not subscribe to `audio_chunk`, and a captions miniapp that stops mid-call
      * must not take the call's microphone with it.
      */
-    private callWantsPcm;
+    private sessionWantsPcm;
     private configuredVad;
     private configuredLoudnessGate;
+    /** `mic_tuning` as the settings store last derived it: `super_mode ? desired : {}`. */
+    private configuredMicTuning;
+    /** Tuning required by the live sessions, resolved by micPolicy. */
+    private sessionMicTuning;
+    /**
+     * Latched once a session profile has actually been written.
+     *
+     * Before that, `mic_tuning` stays out of every patch, so a device that never
+     * runs a profile does not carry the key on unrelated mic writes. After it,
+     * the OS value keeps being restated, which is what stops a reconnect after a
+     * call from resurrecting the profile.
+     */
+    private sessionMicTuningWritten;
     private readonly miniappVadOverrides;
     private readonly miniappLoudnessGateOverrides;
     private overrideSequence;
@@ -40,19 +60,42 @@ declare class MicStateCoordinator {
         lc3: boolean;
     } & ConfiguredMicGates): void;
     /**
-     * Claim or release raw PCM on behalf of an active call.
+     * Claim or release raw PCM on behalf of the live microphone sessions.
      *
-     * Called by AcsMeetingService around a call whose uplink is the glasses microphone over BLE LC3.
+     * MicSessionManager only. Applications acquire a session; they do not reach past it to here.
      * Releasing is a claim release, not a mic shutdown: if a captions miniapp still wants PCM the
      * microphone stays on, which is the whole reason this is a separate flag rather than a setter on
      * the local requirement.
      */
-    setCallRequirement(pcm: boolean): void;
+    setSessionRequirement(pcm: boolean): void;
+    /**
+     * Apply or drop the tuning the live sessions require.
+     *
+     * MicSessionManager only. Rides `applyUnion` so the profile and the PCM claim land in one
+     * debounced write, resolved at flush time: a session released inside the debounce window wins
+     * over the value that was queued.
+     */
+    setSessionMicTuning(profile: MicTuningProfile | null): void;
+    /** Last session profile queued, or null when the OS value is in force. */
+    getSessionMicTuning(): MicTuningProfile | null;
+    /**
+     * 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.
+     */
+    hasConfiguredMicTuning(): boolean;
     /**
      * Whether anything on this device needs a continuous raw-PCM timeline. Also the condition that
      * forces hardware VAD off: a gate that drops silence turns a call into clipped half-words.
      */
     private get wantsRawPcm();
+    /**
+     * The session profile, but only when it wins.
+     *
+     * A live Super Mode tuning value outranks it: that screen is how a profile's numbers get found
+     * on a real call in the first place. Emptiness is by key count — the settings store hands back a
+     * fresh `{}` every time, so reference checks would never match.
+     */
+    private winningSessionMicTuning;
     /**
      * Apply a miniapp-owned gate override without changing the OS preference.
      * Overrides are lifecycle-scoped and last-live-owner-wins independently for

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

@@ -1 +1 @@
-{"version":3,"file":"MicStateCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/MicStateCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,KAAK,OAAO,GAAG,KAAK,GAAG,cAAc,CAAA;AAOrC,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3B,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CACrC;AAkBD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAG1D,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,aAAa,CAAQ;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,sBAAsB,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAkC;IAC/E,OAAO,CAAC,gBAAgB,CAAI;IAE5B,OAAO;WAEO,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,oBAAoB,CAAC,GAAG,EAAE;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAC,GAAG,kBAAkB,GAAG,IAAI;IAQzF;;;;;;;OAOG;IACI,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAO7C;;;OAGG;IACH,OAAO,KAAK,WAAW,GAEtB;IAED;;;;OAIG;IACU,sBAAsB,CACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,UAAU,GAAE,kBAAuB,GAClC,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;OAGG;IACI,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAM9D,sEAAsE;IACzD,uBAAuB,CAAC,UAAU,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxF;;;;;OAKG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAaxF;;;;OAIG;IACI,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO3F,OAAO,CAAC,2BAA2B;IAiBnC;;;OAGG;IACH,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACI,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;CAOvB;AAED,QAAA,MAAM,mBAAmB,qBAAoC,CAAA;AAC7D,eAAe,mBAAmB,CAAA"}
+{"version":3,"file":"MicStateCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/MicStateCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,aAAa,CAAA;AAIjD,KAAK,OAAO,GAAG,KAAK,GAAG,cAAc,CAAA;AAOrC,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3B,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;CAC1C;AAkBD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAG1D,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,aAAa,CAAQ;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,sBAAsB,CAAqB;IACnD,uFAAuF;IACvF,OAAO,CAAC,mBAAmB,CAA6B;IACxD,mEAAmE;IACnE,OAAO,CAAC,gBAAgB,CAAgC;IACxD;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAkC;IAC/E,OAAO,CAAC,gBAAgB,CAAI;IAE5B,OAAO;WAEO,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,oBAAoB,CAAC,GAAG,EAAE;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAC,GAAG,kBAAkB,GAAG,IAAI;IAQzF;;;;;;;OAOG;IACI,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAOhD;;;;;;OAMG;IACI,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAUlE,0EAA0E;IACnE,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAIrD;;;OAGG;IACI,sBAAsB,IAAI,OAAO;IAIxC;;;OAGG;IACH,OAAO,KAAK,WAAW,GAEtB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAM/B;;;;OAIG;IACU,sBAAsB,CACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,UAAU,GAAE,kBAAuB,GAClC,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;OAGG;IACI,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAM9D,sEAAsE;IACzD,uBAAuB,CAAC,UAAU,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxF;;;;;OAKG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBxF;;;;OAIG;IACI,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO3F,OAAO,CAAC,2BAA2B;IAuBnC;;;OAGG;IACH,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACI,KAAK,IAAI,IAAI;IAQb,OAAO,IAAI,IAAI;CAOvB;AAED,QAAA,MAAM,mBAAmB,qBAAoC,CAAA;AAC7D,eAAe,mBAAmB,CAAA"}

package/build/services/MicStateCoordinator.js

@@ -6,6 +6,11 @@
  * Local miniapps subscribe to audio_chunk / transcription streams.
  * This coordinator pushes the aggregate local requirement set to BluetoothSdk
  * so the mic runs whenever at least one local consumer needs it.
+ *
+ * It also merges what the live microphone sessions require (MicSessionManager,
+ * via `setSessionRequirement` / `setSessionMicTuning`) with the OS preferences
+ * the settings store derives. Applications go through MicSessionManager; this
+ * class is an engine implementation detail.
  */
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
 import { createDebouncedPatchFlusher } from "../utils/debouncedPatch";
@@ -32,15 +37,28 @@ class MicStateCoordinator {
     localWantsPcm = false;
     localWantsLc3 = false;
     /**
-     * A live ACS call taking the wearer's voice off the glasses over BLE LC3.
+     * A live microphone session held through MicSessionManager — a voice call today.
      *
      * Tracked separately from the miniapp requirement because the two have independent lifetimes:
      * the call miniapp does not subscribe to `audio_chunk`, and a captions miniapp that stops mid-call
      * must not take the call's microphone with it.
      */
-    callWantsPcm = false;
+    sessionWantsPcm = false;
     configuredVad;
     configuredLoudnessGate;
+    /** `mic_tuning` as the settings store last derived it: `super_mode ? desired : {}`. */
+    configuredMicTuning = {};
+    /** Tuning required by the live sessions, resolved by micPolicy. */
+    sessionMicTuning = null;
+    /**
+     * Latched once a session profile has actually been written.
+     *
+     * Before that, `mic_tuning` stays out of every patch, so a device that never
+     * runs a profile does not carry the key on unrelated mic writes. After it,
+     * the OS value keeps being restated, which is what stops a reconnect after a
+     * call from resurrecting the profile.
+     */
+    sessionMicTuningWritten = false;
     miniappVadOverrides = new Map();
     miniappLoudnessGateOverrides = new Map();
     overrideSequence = 0;
@@ -63,26 +81,70 @@ class MicStateCoordinator {
         this.applyUnion();
     }
     /**
-     * Claim or release raw PCM on behalf of an active call.
+     * Claim or release raw PCM on behalf of the live microphone sessions.
      *
-     * Called by AcsMeetingService around a call whose uplink is the glasses microphone over BLE LC3.
+     * MicSessionManager only. Applications acquire a session; they do not reach past it to here.
      * Releasing is a claim release, not a mic shutdown: if a captions miniapp still wants PCM the
      * microphone stays on, which is the whole reason this is a separate flag rather than a setter on
      * the local requirement.
      */
-    setCallRequirement(pcm) {
-        if (this.callWantsPcm === pcm)
+    setSessionRequirement(pcm) {
+        if (this.sessionWantsPcm === pcm)
             return;
-        this.callWantsPcm = pcm;
-        console.log(`${LOG_TAG}: call requirement updated — pcm=${pcm}`);
+        this.sessionWantsPcm = pcm;
+        console.log(`${LOG_TAG}: session requirement updated — pcm=${pcm}`);
         this.applyUnion();
     }
+    /**
+     * Apply or drop the tuning the live sessions require.
+     *
+     * MicSessionManager only. Rides `applyUnion` so the profile and the PCM claim land in one
+     * debounced write, resolved at flush time: a session released inside the debounce window wins
+     * over the value that was queued.
+     */
+    setSessionMicTuning(profile) {
+        if (profile?.gain === this.sessionMicTuning?.gain)
+            return;
+        this.sessionMicTuning = profile;
+        if (profile)
+            this.sessionMicTuningWritten = true;
+        // Nothing was ever written, so there is nothing to restore.
+        else if (!this.sessionMicTuningWritten)
+            return;
+        console.log(`${LOG_TAG}: session mic tuning ${profile ? JSON.stringify(profile) : "cleared"}`);
+        this.applyUnion();
+    }
+    /** Last session profile queued, or null when the OS value is in force. */
+    getSessionMicTuning() {
+        return this.sessionMicTuning;
+    }
+    /**
+     * 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.
+     */
+    hasConfiguredMicTuning() {
+        return Object.keys(this.configuredMicTuning).length > 0;
+    }
     /**
      * Whether anything on this device needs a continuous raw-PCM timeline. Also the condition that
      * forces hardware VAD off: a gate that drops silence turns a call into clipped half-words.
      */
     get wantsRawPcm() {
-        return this.localWantsPcm || this.callWantsPcm;
+        return this.localWantsPcm || this.sessionWantsPcm;
+    }
+    /**
+     * The session profile, but only when it wins.
+     *
+     * A live Super Mode tuning value outranks it: that screen is how a profile's numbers get found
+     * on a real call in the first place. Emptiness is by key count — the settings store hands back a
+     * fresh `{}` every time, so reference checks would never match.
+     */
+    winningSessionMicTuning() {
+        if (!this.sessionMicTuning)
+            return undefined;
+        if (Object.keys(this.configuredMicTuning).length > 0)
+            return undefined;
+        return { ...this.sessionMicTuning };
     }
     /**
      * Apply a miniapp-owned gate override without changing the OS preference.
@@ -139,6 +201,9 @@ class MicStateCoordinator {
                 ? settings.voice_activity_detection_enabled
                 : undefined,
             loudnessGateEnabled: typeof settings.loudness_gate_enabled === "boolean" ? settings.loudness_gate_enabled : undefined,
+            micTuning: settings.mic_tuning && typeof settings.mic_tuning === "object"
+                ? settings.mic_tuning
+                : undefined,
         });
         return this.applyActiveRuntimeOverrides(settings);
     }
@@ -166,6 +231,13 @@ class MicStateCoordinator {
         if (loudnessOverride) {
             runtimeSettings.loudness_gate_enabled = loudnessOverride.enabled;
         }
+        // BES forgets mic_tuning on disconnect, so the on-connect replay is what
+        // puts a live session's profile back.
+        const sessionTuning = this.winningSessionMicTuning();
+        if (sessionTuning)
+            runtimeSettings.mic_tuning = sessionTuning;
+        else if (this.sessionMicTuningWritten)
+            runtimeSettings.mic_tuning = this.configuredMicTuning;
         return runtimeSettings;
     }
     /**
@@ -197,6 +269,9 @@ class MicStateCoordinator {
         if (configured.loudnessGateEnabled !== undefined) {
             this.configuredLoudnessGate = configured.loudnessGateEnabled ?? undefined;
         }
+        if (configured.micTuning !== undefined) {
+            this.configuredMicTuning = configured.micTuning ?? {};
+        }
     }
     overridesFor(gate) {
         return gate === "vad" ? this.miniappVadOverrides : this.miniappLoudnessGateOverrides;
@@ -226,6 +301,11 @@ class MicStateCoordinator {
         else if (this.configuredLoudnessGate !== undefined) {
             patch.loudness_gate_enabled = this.configuredLoudnessGate;
         }
+        const sessionTuning = this.winningSessionMicTuning();
+        if (sessionTuning)
+            patch.mic_tuning = sessionTuning;
+        else if (this.sessionMicTuningWritten)
+            patch.mic_tuning = this.configuredMicTuning;
         return patch;
     }
     /**
@@ -234,7 +314,8 @@ class MicStateCoordinator {
     reset() {
         this.localWantsPcm = false;
         this.localWantsLc3 = false;
-        this.callWantsPcm = false;
+        this.sessionWantsPcm = false;
+        this.sessionMicTuning = null;
         this.applyUnion();
     }
     cleanup() {