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

package/build/services/LocalMiniappStorage.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Phone-local SimpleStorage for bundled miniapps.
+ *
+ * Keys are scoped to the stable Mentra user id and package name. Access tokens
+ * must never be part of the namespace: Core access tokens rotate and are held
+ * in memory only, so using one makes every app restart look like a new user.
+ */
+export interface LocalMiniappStorageBackend {
+    get(key: string): unknown | null;
+    has(key: string): boolean;
+    set(key: string, value: unknown): void;
+    remove(key: string): void;
+    keys(): string[];
+}
+export interface LocalMiniappStorageHooks {
+    getUserId: () => Promise<string>;
+    backend: LocalMiniappStorageBackend;
+}
+export declare class LocalMiniappStorage {
+    private readonly hooks;
+    constructor(hooks: LocalMiniappStorageHooks);
+    get(packageName: string, key: string): Promise<unknown | null>;
+    set(packageName: string, key: string, value: unknown): Promise<void>;
+    delete(packageName: string, key: string): Promise<void>;
+    keys(packageName: string): Promise<string[]>;
+    clear(packageName: string): Promise<void>;
+    has(packageName: string, key: string): Promise<boolean>;
+    getAll(packageName: string): Promise<Record<string, string>>;
+    setMultiple(packageName: string, values: Record<string, unknown>): Promise<void>;
+    private prefix;
+}
+//# sourceMappingURL=LocalMiniappStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalMiniappStorage.d.ts","sourceRoot":"","sources":["../../src/services/LocalMiniappStorage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,IAAI,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAChC,OAAO,EAAE,0BAA0B,CAAA;CACpC;AAID,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,wBAAwB;IAEtD,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI9D,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ5C,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAY5D,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAOxE,MAAM;CAKrB"}

package/build/services/LocalMiniappStorage.js

@@ -0,0 +1,66 @@
+/**
+ * Phone-local SimpleStorage for bundled miniapps.
+ *
+ * Keys are scoped to the stable Mentra user id and package name. Access tokens
+ * must never be part of the namespace: Core access tokens rotate and are held
+ * in memory only, so using one makes every app restart look like a new user.
+ */
+const KEY_ROOT = "mentraos_localstorage_";
+export class LocalMiniappStorage {
+    hooks;
+    constructor(hooks) {
+        this.hooks = hooks;
+    }
+    async get(packageName, key) {
+        return this.hooks.backend.get((await this.prefix(packageName)) + key);
+    }
+    async set(packageName, key, value) {
+        this.hooks.backend.set((await this.prefix(packageName)) + key, value);
+    }
+    async delete(packageName, key) {
+        this.hooks.backend.remove((await this.prefix(packageName)) + key);
+    }
+    async keys(packageName) {
+        const prefix = await this.prefix(packageName);
+        return this.hooks.backend
+            .keys()
+            .filter((key) => key.startsWith(prefix))
+            .map((key) => key.slice(prefix.length));
+    }
+    async clear(packageName) {
+        const prefix = await this.prefix(packageName);
+        for (const key of this.hooks.backend.keys()) {
+            if (key.startsWith(prefix))
+                this.hooks.backend.remove(key);
+        }
+    }
+    async has(packageName, key) {
+        return this.hooks.backend.has((await this.prefix(packageName)) + key);
+    }
+    async getAll(packageName) {
+        const prefix = await this.prefix(packageName);
+        const values = {};
+        for (const key of this.hooks.backend.keys()) {
+            if (!key.startsWith(prefix))
+                continue;
+            if (!this.hooks.backend.has(key))
+                continue;
+            const value = this.hooks.backend.get(key);
+            values[key.slice(prefix.length)] = typeof value === "string" ? value : String(value ?? "");
+        }
+        return values;
+    }
+    async setMultiple(packageName, values) {
+        const prefix = await this.prefix(packageName);
+        for (const [key, value] of Object.entries(values)) {
+            this.hooks.backend.set(prefix + key, value ?? null);
+        }
+    }
+    async prefix(packageName) {
+        const userId = (await this.hooks.getUserId()).trim();
+        if (!userId)
+            throw new Error("Mentra user identity is unavailable");
+        return `${KEY_ROOT}${userId}_${packageName}_`;
+    }
+}
+//# sourceMappingURL=LocalMiniappStorage.js.map

package/build/services/LocalMiniappStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalMiniappStorage.js","sourceRoot":"","sources":["../../src/services/LocalMiniappStorage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Phone-local SimpleStorage for bundled miniapps.\n *\n * Keys are scoped to the stable Mentra user id and package name. Access tokens\n * must never be part of the namespace: Core access tokens rotate and are held\n * in memory only, so using one makes every app restart look like a new user.\n */\n\nexport interface LocalMiniappStorageBackend {\n  get(key: string): unknown | null\n  has(key: string): boolean\n  set(key: string, value: unknown): void\n  remove(key: string): void\n  keys(): string[]\n}\n\nexport interface LocalMiniappStorageHooks {\n  getUserId: () => Promise<string>\n  backend: LocalMiniappStorageBackend\n}\n\nconst KEY_ROOT = \"mentraos_localstorage_\"\n\nexport class LocalMiniappStorage {\n  constructor(private readonly hooks: LocalMiniappStorageHooks) {}\n\n  async get(packageName: string, key: string): Promise<unknown | null> {\n    return this.hooks.backend.get((await this.prefix(packageName)) + key)\n  }\n\n  async set(packageName: string, key: string, value: unknown): Promise<void> {\n    this.hooks.backend.set((await this.prefix(packageName)) + key, value)\n  }\n\n  async delete(packageName: string, key: string): Promise<void> {\n    this.hooks.backend.remove((await this.prefix(packageName)) + key)\n  }\n\n  async keys(packageName: string): Promise<string[]> {\n    const prefix = await this.prefix(packageName)\n    return this.hooks.backend\n      .keys()\n      .filter((key) => key.startsWith(prefix))\n      .map((key) => key.slice(prefix.length))\n  }\n\n  async clear(packageName: string): Promise<void> {\n    const prefix = await this.prefix(packageName)\n    for (const key of this.hooks.backend.keys()) {\n      if (key.startsWith(prefix)) this.hooks.backend.remove(key)\n    }\n  }\n\n  async has(packageName: string, key: string): Promise<boolean> {\n    return this.hooks.backend.has((await this.prefix(packageName)) + key)\n  }\n\n  async getAll(packageName: string): Promise<Record<string, string>> {\n    const prefix = await this.prefix(packageName)\n    const values: Record<string, string> = {}\n    for (const key of this.hooks.backend.keys()) {\n      if (!key.startsWith(prefix)) continue\n      if (!this.hooks.backend.has(key)) continue\n      const value = this.hooks.backend.get(key)\n      values[key.slice(prefix.length)] = typeof value === \"string\" ? value : String(value ?? \"\")\n    }\n    return values\n  }\n\n  async setMultiple(packageName: string, values: Record<string, unknown>): Promise<void> {\n    const prefix = await this.prefix(packageName)\n    for (const [key, value] of Object.entries(values)) {\n      this.hooks.backend.set(prefix + key, value ?? null)\n    }\n  }\n\n  private async prefix(packageName: string): Promise<string> {\n    const userId = (await this.hooks.getUserId()).trim()\n    if (!userId) throw new Error(\"Mentra user identity is unavailable\")\n    return `${KEY_ROOT}${userId}_${packageName}_`\n  }\n}\n"]}

package/build/services/LocalMiniappUserIdentity.d.ts

@@ -0,0 +1,20 @@
+export interface LocalMiniappUserIdentityBackend {
+    get(): string | null;
+    set(userId: string): void;
+    remove(): void;
+}
+/**
+ * Keeps the stable Mentra user id available to local miniapps across process
+ * restarts. The id is non-secret and is deliberately stored separately from
+ * the short-lived Core access token.
+ */
+export declare class LocalMiniappUserIdentity {
+    private readonly backend;
+    private current;
+    constructor(backend: LocalMiniappUserIdentityBackend);
+    resolve(resolveOnline: () => Promise<string>): Promise<string>;
+    get(): string | null;
+    remember(userId: string): void;
+    forget(): void;
+}
+//# sourceMappingURL=LocalMiniappUserIdentity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalMiniappUserIdentity.d.ts","sourceRoot":"","sources":["../../src/services/LocalMiniappUserIdentity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,+BAA+B;IAC9C,GAAG,IAAI,MAAM,GAAG,IAAI,CAAA;IACpB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,IAAI,IAAI,CAAA;CACf;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAsB;gBAER,OAAO,EAAE,+BAA+B;IAE/D,OAAO,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpE,GAAG,IAAI,MAAM,GAAG,IAAI;IAQpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO9B,MAAM,IAAI,IAAI;CAIf"}

package/build/services/LocalMiniappUserIdentity.js

@@ -0,0 +1,43 @@
+/**
+ * Keeps the stable Mentra user id available to local miniapps across process
+ * restarts. The id is non-secret and is deliberately stored separately from
+ * the short-lived Core access token.
+ */
+export class LocalMiniappUserIdentity {
+    backend;
+    current = null;
+    constructor(backend) {
+        this.backend = backend;
+    }
+    async resolve(resolveOnline) {
+        const available = this.get();
+        if (available)
+            return available;
+        const resolved = (await resolveOnline()).trim();
+        if (!resolved)
+            throw new Error("Mentra user identity is unavailable");
+        this.remember(resolved);
+        return resolved;
+    }
+    get() {
+        if (this.current)
+            return this.current;
+        const cached = this.backend.get()?.trim() ?? "";
+        if (!cached)
+            return null;
+        this.current = cached;
+        return cached;
+    }
+    remember(userId) {
+        const resolved = userId.trim();
+        if (!resolved)
+            throw new Error("Mentra user identity is unavailable");
+        this.backend.set(resolved);
+        this.current = resolved;
+    }
+    forget() {
+        this.current = null;
+        this.backend.remove();
+    }
+}
+//# sourceMappingURL=LocalMiniappUserIdentity.js.map

package/build/services/LocalMiniappUserIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalMiniappUserIdentity.js","sourceRoot":"","sources":["../../src/services/LocalMiniappUserIdentity.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAGN;IAFrB,OAAO,GAAkB,IAAI,CAAA;IAErC,YAA6B,OAAwC;QAAxC,YAAO,GAAP,OAAO,CAAiC;IAAG,CAAC;IAEzE,KAAK,CAAC,OAAO,CAAC,aAAoC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,IAAI,SAAS;YAAE,OAAO,SAAS,CAAA;QAE/B,MAAM,QAAQ,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QAC/C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACrE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACvB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAA;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,OAAO,MAAM,CAAA;IACf,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;QAC9B,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACrE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC1B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAA;IACzB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IACvB,CAAC;CACF","sourcesContent":["export interface LocalMiniappUserIdentityBackend {\n  get(): string | null\n  set(userId: string): void\n  remove(): void\n}\n\n/**\n * Keeps the stable Mentra user id available to local miniapps across process\n * restarts. The id is non-secret and is deliberately stored separately from\n * the short-lived Core access token.\n */\nexport class LocalMiniappUserIdentity {\n  private current: string | null = null\n\n  constructor(private readonly backend: LocalMiniappUserIdentityBackend) {}\n\n  async resolve(resolveOnline: () => Promise<string>): Promise<string> {\n    const available = this.get()\n    if (available) return available\n\n    const resolved = (await resolveOnline()).trim()\n    if (!resolved) throw new Error(\"Mentra user identity is unavailable\")\n    this.remember(resolved)\n    return resolved\n  }\n\n  get(): string | null {\n    if (this.current) return this.current\n    const cached = this.backend.get()?.trim() ?? \"\"\n    if (!cached) return null\n    this.current = cached\n    return cached\n  }\n\n  remember(userId: string): void {\n    const resolved = userId.trim()\n    if (!resolved) throw new Error(\"Mentra user identity is unavailable\")\n    this.backend.set(resolved)\n    this.current = resolved\n  }\n\n  forget(): void {\n    this.current = null\n    this.backend.remove()\n  }\n}\n"]}

package/build/services/MicStateCoordinator.d.ts

@@ -7,10 +7,20 @@
  * This coordinator pushes the aggregate local requirement set to BluetoothSdk
  * so the mic runs whenever at least one local consumer needs it.
  */
+type MicGate = "vad" | "loudnessGate";
+interface ConfiguredMicGates {
+    vadEnabled?: boolean | null;
+    loudnessGateEnabled?: boolean | null;
+}
 declare class MicStateCoordinator {
     private static instance;
     private localWantsPcm;
     private localWantsLc3;
+    private configuredVad;
+    private configuredLoudnessGate;
+    private readonly miniappVadOverrides;
+    private readonly miniappLoudnessGateOverrides;
+    private overrideSequence;
     private constructor();
     static getInstance(): MicStateCoordinator;
     /**
@@ -20,12 +30,43 @@ declare class MicStateCoordinator {
     setLocalRequirements(req: {
         pcm: boolean;
         lc3: boolean;
-    }): void;
+    } & ConfiguredMicGates): void;
+    /**
+     * Apply a miniapp-owned gate override without changing the OS preference.
+     * Overrides are lifecycle-scoped and last-live-owner-wins independently for
+     * VAD and Barrier.
+     */
+    setMiniappGateOverride(packageName: string, gate: MicGate, enabled: boolean, configured?: ConfiguredMicGates): Promise<void>;
+    /**
+     * Remove every gate override owned by a miniapp. This is synchronous so
+     * unregister can drop ownership before recomputing aggregate mic state.
+     */
+    clearMiniappGateOverrides(packageName: string): boolean;
+    /** Re-apply the current runtime policy after an owner is released. */
+    syncEffectiveGatePolicy(configured?: ConfiguredMicGates): Promise<void>;
+    /**
+     * Preserve the runtime microphone contract when the persisted device
+     * settings are replayed (for example after a glasses reconnect). Active
+     * miniapp gate overrides replace the OS values, and raw PCM keeps VAD off
+     * until the last raw-audio consumer unsubscribes.
+     */
+    applyRuntimeOverrides(settings: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Apply the complete current gate policy without treating the input as an OS
+     * preference update. Used by debounced mic-requirement writes, whose queued
+     * gate values may be stale after an override is acquired or released.
+     */
+    applyEffectiveGatePolicy(settings: Record<string, unknown>): Record<string, unknown>;
+    private applyActiveRuntimeOverrides;
     /**
      * Push local requirements to BluetoothSdk. `should_send_pcm` is strictly for
      * on-device PCM consumers; cloud audio uses LC3 through AudioCloudUplink.
      */
     private applyUnion;
+    private rememberConfiguredGates;
+    private overridesFor;
+    private latestOverride;
+    private effectiveGatePatch;
     /**
      * Reset all requirements to off. Called during cleanup.
      */

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;AAoBH,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAG1D,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,aAAa,CAAQ;IAE7B,OAAO;WAEO,WAAW,IAAI,mBAAmB;IAOhD;;;OAGG;IACI,oBAAoB,CAAC,GAAG,EAAE;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAC,GAAG,IAAI;IAOpE;;;OAGG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACI,KAAK,IAAI,IAAI;IAMb,OAAO,IAAI,IAAI;CAKvB;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;;;;;;;;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,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;;;;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;IAMb,OAAO,IAAI,IAAI;CAOvB;AAED,QAAA,MAAM,mBAAmB,qBAAoC,CAAA;AAC7D,eAAe,mBAAmB,CAAA"}

package/build/services/MicStateCoordinator.js

@@ -14,7 +14,11 @@ const LOG_TAG = "MIC_COORDINATOR";
  *  (wire v2 keeps BLE JSON small and infrequent). */
 const flushMicRequirementsPatch = createDebouncedPatchFlusher((patch) => {
     try {
-        void Promise.resolve(BluetoothSdk.updateBluetoothSettings(patch)).catch((err) => {
+        // Resolve runtime overrides at flush time. A miniapp can acquire/release a
+        // gate override during the debounce window, and a captured stale value
+        // must not win after that lifecycle transition.
+        const runtimePatch = micStateCoordinator.applyEffectiveGatePolicy(patch);
+        void Promise.resolve(BluetoothSdk.updateBluetoothSettings(runtimePatch)).catch((err) => {
             console.error(`${LOG_TAG}: failed to apply mic requirements:`, err);
         });
     }
@@ -27,6 +31,11 @@ class MicStateCoordinator {
     // Local miniapp requirements (set when miniapps subscribe to audio streams)
     localWantsPcm = false;
     localWantsLc3 = false;
+    configuredVad;
+    configuredLoudnessGate;
+    miniappVadOverrides = new Map();
+    miniappLoudnessGateOverrides = new Map();
+    overrideSequence = 0;
     constructor() { }
     static getInstance() {
         if (!MicStateCoordinator.instance) {
@@ -41,9 +50,94 @@ class MicStateCoordinator {
     setLocalRequirements(req) {
         this.localWantsPcm = req.pcm;
         this.localWantsLc3 = req.lc3;
+        this.rememberConfiguredGates(req);
         console.log(`${LOG_TAG}: local requirements updated — pcm=${req.pcm} lc3=${req.lc3}`);
         this.applyUnion();
     }
+    /**
+     * Apply a miniapp-owned gate override without changing the OS preference.
+     * Overrides are lifecycle-scoped and last-live-owner-wins independently for
+     * VAD and Barrier.
+     */
+    async setMiniappGateOverride(packageName, gate, enabled, configured = {}) {
+        this.rememberConfiguredGates(configured);
+        const overrides = this.overridesFor(gate);
+        const previous = overrides.get(packageName);
+        const next = { enabled, order: ++this.overrideSequence };
+        overrides.set(packageName, next);
+        try {
+            await BluetoothSdk.updateBluetoothSettings(this.effectiveGatePatch());
+        }
+        catch (error) {
+            // Do not roll back a newer request from the same package that landed
+            // while this native write was in flight.
+            if (overrides.get(packageName) === next) {
+                if (previous)
+                    overrides.set(packageName, previous);
+                else
+                    overrides.delete(packageName);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Remove every gate override owned by a miniapp. This is synchronous so
+     * unregister can drop ownership before recomputing aggregate mic state.
+     */
+    clearMiniappGateOverrides(packageName) {
+        const removedVad = this.miniappVadOverrides.delete(packageName);
+        const removedLoudness = this.miniappLoudnessGateOverrides.delete(packageName);
+        return removedVad || removedLoudness;
+    }
+    /** Re-apply the current runtime policy after an owner is released. */
+    async syncEffectiveGatePolicy(configured = {}) {
+        this.rememberConfiguredGates(configured);
+        const patch = this.effectiveGatePatch();
+        if (Object.keys(patch).length === 0)
+            return;
+        await BluetoothSdk.updateBluetoothSettings(patch);
+    }
+    /**
+     * Preserve the runtime microphone contract when the persisted device
+     * settings are replayed (for example after a glasses reconnect). Active
+     * miniapp gate overrides replace the OS values, and raw PCM keeps VAD off
+     * until the last raw-audio consumer unsubscribes.
+     */
+    applyRuntimeOverrides(settings) {
+        this.rememberConfiguredGates({
+            vadEnabled: typeof settings.voice_activity_detection_enabled === "boolean"
+                ? settings.voice_activity_detection_enabled
+                : undefined,
+            loudnessGateEnabled: typeof settings.loudness_gate_enabled === "boolean" ? settings.loudness_gate_enabled : undefined,
+        });
+        return this.applyActiveRuntimeOverrides(settings);
+    }
+    /**
+     * Apply the complete current gate policy without treating the input as an OS
+     * preference update. Used by debounced mic-requirement writes, whose queued
+     * gate values may be stale after an override is acquired or released.
+     */
+    applyEffectiveGatePolicy(settings) {
+        return {
+            ...settings,
+            ...this.effectiveGatePatch(),
+        };
+    }
+    applyActiveRuntimeOverrides(settings) {
+        const runtimeSettings = { ...settings };
+        const vadOverride = this.latestOverride(this.miniappVadOverrides);
+        const loudnessOverride = this.latestOverride(this.miniappLoudnessGateOverrides);
+        if (this.localWantsPcm) {
+            runtimeSettings.voice_activity_detection_enabled = false;
+        }
+        else if (vadOverride) {
+            runtimeSettings.voice_activity_detection_enabled = vadOverride.enabled;
+        }
+        if (loudnessOverride) {
+            runtimeSettings.loudness_gate_enabled = loudnessOverride.enabled;
+        }
+        return runtimeSettings;
+    }
     /**
      * Push local requirements to BluetoothSdk. `should_send_pcm` is strictly for
      * on-device PCM consumers; cloud audio uses LC3 through AudioCloudUplink.
@@ -56,11 +150,53 @@ class MicStateCoordinator {
         // )
         // The mic control plane is a direct btsdk call now (was a host setMicRequirements
         // hook) so a bare OEM streams audio without wiring it.
-        flushMicRequirementsPatch({
+        const patch = {
             should_send_pcm: shouldSendPcm,
             should_send_lc3: shouldSendLc3,
             should_send_transcript: false,
-        });
+            ...this.effectiveGatePatch(),
+        };
+        flushMicRequirementsPatch(patch);
+    }
+    rememberConfiguredGates(configured) {
+        // null means the connected device intentionally omits that setting.
+        // undefined means the caller is not updating the remembered preference.
+        if (configured.vadEnabled !== undefined) {
+            this.configuredVad = configured.vadEnabled ?? undefined;
+        }
+        if (configured.loudnessGateEnabled !== undefined) {
+            this.configuredLoudnessGate = configured.loudnessGateEnabled ?? undefined;
+        }
+    }
+    overridesFor(gate) {
+        return gate === "vad" ? this.miniappVadOverrides : this.miniappLoudnessGateOverrides;
+    }
+    latestOverride(overrides) {
+        let latest;
+        for (const entry of overrides.values()) {
+            if (!latest || entry.order > latest.order)
+                latest = entry;
+        }
+        return latest;
+    }
+    effectiveGatePatch() {
+        const patch = {};
+        const vadOverride = this.latestOverride(this.miniappVadOverrides);
+        const loudnessOverride = this.latestOverride(this.miniappLoudnessGateOverrides);
+        // Hardware VAD suppresses silence. Raw-audio consumers need a continuous
+        // timeline, so their requirement wins over both OS and miniapp VAD values.
+        if (this.localWantsPcm)
+            patch.voice_activity_detection_enabled = false;
+        else if (vadOverride)
+            patch.voice_activity_detection_enabled = vadOverride.enabled;
+        else if (this.configuredVad !== undefined)
+            patch.voice_activity_detection_enabled = this.configuredVad;
+        if (loudnessOverride)
+            patch.loudness_gate_enabled = loudnessOverride.enabled;
+        else if (this.configuredLoudnessGate !== undefined) {
+            patch.loudness_gate_enabled = this.configuredLoudnessGate;
+        }
+        return patch;
     }
     /**
      * Reset all requirements to off. Called during cleanup.
@@ -72,6 +208,8 @@ class MicStateCoordinator {
     }
     cleanup() {
         console.log(`${LOG_TAG}: cleanup()`);
+        this.miniappVadOverrides.clear();
+        this.miniappLoudnessGateOverrides.clear();
         this.reset();
         MicStateCoordinator.instance = null;
     }

package/build/services/MicStateCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"MicStateCoordinator.js","sourceRoot":"","sources":["../../src/services/MicStateCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AAEzD,OAAO,EAAC,2BAA2B,EAAC,MAAM,yBAAyB,CAAA;AAEnE,MAAM,OAAO,GAAG,iBAAiB,CAAA;AAEjC;qDACqD;AACrD,MAAM,yBAAyB,GAAG,2BAA2B,CAA0B,CAAC,KAAK,EAAE,EAAE;IAC/F,IAAI,CAAC;QACH,KAAK,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9E,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,qCAAqC,EAAE,GAAG,CAAC,CAAA;QACrE,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,qCAAqC,EAAE,GAAG,CAAC,CAAA;IACrE,CAAC;AACH,CAAC,EAAE,GAAG,CAAC,CAAA;AAEP,MAAM,mBAAmB;IACf,MAAM,CAAC,QAAQ,GAA+B,IAAI,CAAA;IAE1D,4EAA4E;IACpE,aAAa,GAAG,KAAK,CAAA;IACrB,aAAa,GAAG,KAAK,CAAA;IAE7B,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YAClC,mBAAmB,CAAC,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAA;QAC1D,CAAC;QACD,OAAO,mBAAmB,CAAC,QAAQ,CAAA;IACrC,CAAC;IAED;;;OAGG;IACI,oBAAoB,CAAC,GAAiC;QAC3D,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,CAAA;QAC5B,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,CAAA;QAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,sCAAsC,GAAG,CAAC,GAAG,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;QACrF,IAAI,CAAC,UAAU,EAAE,CAAA;IACnB,CAAC;IAED;;;OAGG;IACK,UAAU;QAChB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;QACxC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;QAExC,eAAe;QACf,qFAAqF;QACrF,IAAI;QAEJ,kFAAkF;QAClF,uDAAuD;QACvD,yBAAyB,CAAC;YACxB,eAAe,EAAE,aAAa;YAC9B,eAAe,EAAE,aAAa;YAC9B,sBAAsB,EAAE,KAAK;SAC9B,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC1B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC1B,IAAI,CAAC,UAAU,EAAE,CAAA;IACnB,CAAC;IAEM,OAAO;QACZ,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,aAAa,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,mBAAmB,CAAC,QAAQ,GAAG,IAAI,CAAA;IACrC,CAAC;;AAGH,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAA;AAC7D,eAAe,mBAAmB,CAAA","sourcesContent":["/**\n * MicStateCoordinator\n *\n * Owns local-miniapp-driven microphone requirements.\n *\n * Local miniapps subscribe to audio_chunk / transcription streams.\n * This coordinator pushes the aggregate local requirement set to BluetoothSdk\n * so the mic runs whenever at least one local consumer needs it.\n */\n\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\n\nimport {createDebouncedPatchFlusher} from \"../utils/debouncedPatch\"\n\nconst LOG_TAG = \"MIC_COORDINATOR\"\n\n/** Mic-requirement flips are debounced (300ms) and merged into one BLE write\n *  (wire v2 keeps BLE JSON small and infrequent). */\nconst flushMicRequirementsPatch = createDebouncedPatchFlusher<Record<string, unknown>>((patch) => {\n  try {\n    void Promise.resolve(BluetoothSdk.updateBluetoothSettings(patch)).catch((err) => {\n      console.error(`${LOG_TAG}: failed to apply mic requirements:`, err)\n    })\n  } catch (err) {\n    console.error(`${LOG_TAG}: failed to apply mic requirements:`, err)\n  }\n}, 300)\n\nclass MicStateCoordinator {\n  private static instance: MicStateCoordinator | null = null\n\n  // Local miniapp requirements (set when miniapps subscribe to audio streams)\n  private localWantsPcm = false\n  private localWantsLc3 = false\n\n  private constructor() {}\n\n  public static getInstance(): MicStateCoordinator {\n    if (!MicStateCoordinator.instance) {\n      MicStateCoordinator.instance = new MicStateCoordinator()\n    }\n    return MicStateCoordinator.instance\n  }\n\n  /**\n   * Update local miniapp requirements. Called by LocalMiniappRuntime when\n   * the aggregated set of local subscriptions changes.\n   */\n  public setLocalRequirements(req: {pcm: boolean; lc3: boolean}): void {\n    this.localWantsPcm = req.pcm\n    this.localWantsLc3 = req.lc3\n    console.log(`${LOG_TAG}: local requirements updated — pcm=${req.pcm} lc3=${req.lc3}`)\n    this.applyUnion()\n  }\n\n  /**\n   * Push local requirements to BluetoothSdk. `should_send_pcm` is strictly for\n   * on-device PCM consumers; cloud audio uses LC3 through AudioCloudUplink.\n   */\n  private applyUnion(): void {\n    const shouldSendPcm = this.localWantsPcm\n    const shouldSendLc3 = this.localWantsLc3\n\n    // console.log(\n    //   `${LOG_TAG}: applying requirements — pcm=${shouldSendPcm} lc3=${shouldSendLc3}`,\n    // )\n\n    // The mic control plane is a direct btsdk call now (was a host setMicRequirements\n    // hook) so a bare OEM streams audio without wiring it.\n    flushMicRequirementsPatch({\n      should_send_pcm: shouldSendPcm,\n      should_send_lc3: shouldSendLc3,\n      should_send_transcript: false,\n    })\n  }\n\n  /**\n   * Reset all requirements to off. Called during cleanup.\n   */\n  public reset(): void {\n    this.localWantsPcm = false\n    this.localWantsLc3 = false\n    this.applyUnion()\n  }\n\n  public cleanup(): void {\n    console.log(`${LOG_TAG}: cleanup()`)\n    this.reset()\n    MicStateCoordinator.instance = null\n  }\n}\n\nconst micStateCoordinator = MicStateCoordinator.getInstance()\nexport default micStateCoordinator\n"]}
+{"version":3,"file":"MicStateCoordinator.js","sourceRoot":"","sources":["../../src/services/MicStateCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MicStateCoordinator\n *\n * Owns local-miniapp-driven microphone requirements.\n *\n * Local miniapps subscribe to audio_chunk / transcription streams.\n * This coordinator pushes the aggregate local requirement set to BluetoothSdk\n * so the mic runs whenever at least one local consumer needs it.\n */\n\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\n\nimport {createDebouncedPatchFlusher} from \"../utils/debouncedPatch\"\n\nconst LOG_TAG = \"MIC_COORDINATOR\"\n\ntype MicGate = \"vad\" | \"loudnessGate\"\n\ninterface GateOverride {\n  enabled: boolean\n  order: number\n}\n\ninterface ConfiguredMicGates {\n  vadEnabled?: boolean | null\n  loudnessGateEnabled?: boolean | null\n}\n\n/** Mic-requirement flips are debounced (300ms) and merged into one BLE write\n *  (wire v2 keeps BLE JSON small and infrequent). */\nconst flushMicRequirementsPatch = createDebouncedPatchFlusher<Record<string, unknown>>((patch) => {\n  try {\n    // Resolve runtime overrides at flush time. A miniapp can acquire/release a\n    // gate override during the debounce window, and a captured stale value\n    // must not win after that lifecycle transition.\n    const runtimePatch = micStateCoordinator.applyEffectiveGatePolicy(patch)\n    void Promise.resolve(BluetoothSdk.updateBluetoothSettings(runtimePatch)).catch((err) => {\n      console.error(`${LOG_TAG}: failed to apply mic requirements:`, err)\n    })\n  } catch (err) {\n    console.error(`${LOG_TAG}: failed to apply mic requirements:`, err)\n  }\n}, 300)\n\nclass MicStateCoordinator {\n  private static instance: MicStateCoordinator | null = null\n\n  // Local miniapp requirements (set when miniapps subscribe to audio streams)\n  private localWantsPcm = false\n  private localWantsLc3 = false\n  private configuredVad: boolean | undefined\n  private configuredLoudnessGate: boolean | undefined\n  private readonly miniappVadOverrides = new Map<string, GateOverride>()\n  private readonly miniappLoudnessGateOverrides = new Map<string, GateOverride>()\n  private overrideSequence = 0\n\n  private constructor() {}\n\n  public static getInstance(): MicStateCoordinator {\n    if (!MicStateCoordinator.instance) {\n      MicStateCoordinator.instance = new MicStateCoordinator()\n    }\n    return MicStateCoordinator.instance\n  }\n\n  /**\n   * Update local miniapp requirements. Called by LocalMiniappRuntime when\n   * the aggregated set of local subscriptions changes.\n   */\n  public setLocalRequirements(req: {pcm: boolean; lc3: boolean} & ConfiguredMicGates): void {\n    this.localWantsPcm = req.pcm\n    this.localWantsLc3 = req.lc3\n    this.rememberConfiguredGates(req)\n    console.log(`${LOG_TAG}: local requirements updated — pcm=${req.pcm} lc3=${req.lc3}`)\n    this.applyUnion()\n  }\n\n  /**\n   * Apply a miniapp-owned gate override without changing the OS preference.\n   * Overrides are lifecycle-scoped and last-live-owner-wins independently for\n   * VAD and Barrier.\n   */\n  public async setMiniappGateOverride(\n    packageName: string,\n    gate: MicGate,\n    enabled: boolean,\n    configured: ConfiguredMicGates = {},\n  ): Promise<void> {\n    this.rememberConfiguredGates(configured)\n    const overrides = this.overridesFor(gate)\n    const previous = overrides.get(packageName)\n    const next = {enabled, order: ++this.overrideSequence}\n    overrides.set(packageName, next)\n\n    try {\n      await BluetoothSdk.updateBluetoothSettings(this.effectiveGatePatch())\n    } catch (error) {\n      // Do not roll back a newer request from the same package that landed\n      // while this native write was in flight.\n      if (overrides.get(packageName) === next) {\n        if (previous) overrides.set(packageName, previous)\n        else overrides.delete(packageName)\n      }\n      throw error\n    }\n  }\n\n  /**\n   * Remove every gate override owned by a miniapp. This is synchronous so\n   * unregister can drop ownership before recomputing aggregate mic state.\n   */\n  public clearMiniappGateOverrides(packageName: string): boolean {\n    const removedVad = this.miniappVadOverrides.delete(packageName)\n    const removedLoudness = this.miniappLoudnessGateOverrides.delete(packageName)\n    return removedVad || removedLoudness\n  }\n\n  /** Re-apply the current runtime policy after an owner is released. */\n  public async syncEffectiveGatePolicy(configured: ConfiguredMicGates = {}): Promise<void> {\n    this.rememberConfiguredGates(configured)\n    const patch = this.effectiveGatePatch()\n    if (Object.keys(patch).length === 0) return\n    await BluetoothSdk.updateBluetoothSettings(patch)\n  }\n\n  /**\n   * Preserve the runtime microphone contract when the persisted device\n   * settings are replayed (for example after a glasses reconnect). Active\n   * miniapp gate overrides replace the OS values, and raw PCM keeps VAD off\n   * until the last raw-audio consumer unsubscribes.\n   */\n  public applyRuntimeOverrides(settings: Record<string, unknown>): Record<string, unknown> {\n    this.rememberConfiguredGates({\n      vadEnabled:\n        typeof settings.voice_activity_detection_enabled === \"boolean\"\n          ? settings.voice_activity_detection_enabled\n          : undefined,\n      loudnessGateEnabled:\n        typeof settings.loudness_gate_enabled === \"boolean\" ? settings.loudness_gate_enabled : undefined,\n    })\n\n    return this.applyActiveRuntimeOverrides(settings)\n  }\n\n  /**\n   * Apply the complete current gate policy without treating the input as an OS\n   * preference update. Used by debounced mic-requirement writes, whose queued\n   * gate values may be stale after an override is acquired or released.\n   */\n  public applyEffectiveGatePolicy(settings: Record<string, unknown>): Record<string, unknown> {\n    return {\n      ...settings,\n      ...this.effectiveGatePatch(),\n    }\n  }\n\n  private applyActiveRuntimeOverrides(settings: Record<string, unknown>): Record<string, unknown> {\n    const runtimeSettings = {...settings}\n    const vadOverride = this.latestOverride(this.miniappVadOverrides)\n    const loudnessOverride = this.latestOverride(this.miniappLoudnessGateOverrides)\n\n    if (this.localWantsPcm) {\n      runtimeSettings.voice_activity_detection_enabled = false\n    } else if (vadOverride) {\n      runtimeSettings.voice_activity_detection_enabled = vadOverride.enabled\n    }\n    if (loudnessOverride) {\n      runtimeSettings.loudness_gate_enabled = loudnessOverride.enabled\n    }\n\n    return runtimeSettings\n  }\n\n  /**\n   * Push local requirements to BluetoothSdk. `should_send_pcm` is strictly for\n   * on-device PCM consumers; cloud audio uses LC3 through AudioCloudUplink.\n   */\n  private applyUnion(): void {\n    const shouldSendPcm = this.localWantsPcm\n    const shouldSendLc3 = this.localWantsLc3\n\n    // console.log(\n    //   `${LOG_TAG}: applying requirements — pcm=${shouldSendPcm} lc3=${shouldSendLc3}`,\n    // )\n\n    // The mic control plane is a direct btsdk call now (was a host setMicRequirements\n    // hook) so a bare OEM streams audio without wiring it.\n    const patch: Record<string, unknown> = {\n      should_send_pcm: shouldSendPcm,\n      should_send_lc3: shouldSendLc3,\n      should_send_transcript: false,\n      ...this.effectiveGatePatch(),\n    }\n\n    flushMicRequirementsPatch(patch)\n  }\n\n  private rememberConfiguredGates(configured: ConfiguredMicGates): void {\n    // null means the connected device intentionally omits that setting.\n    // undefined means the caller is not updating the remembered preference.\n    if (configured.vadEnabled !== undefined) {\n      this.configuredVad = configured.vadEnabled ?? undefined\n    }\n    if (configured.loudnessGateEnabled !== undefined) {\n      this.configuredLoudnessGate = configured.loudnessGateEnabled ?? undefined\n    }\n  }\n\n  private overridesFor(gate: MicGate): Map<string, GateOverride> {\n    return gate === \"vad\" ? this.miniappVadOverrides : this.miniappLoudnessGateOverrides\n  }\n\n  private latestOverride(overrides: Map<string, GateOverride>): GateOverride | undefined {\n    let latest: GateOverride | undefined\n    for (const entry of overrides.values()) {\n      if (!latest || entry.order > latest.order) latest = entry\n    }\n    return latest\n  }\n\n  private effectiveGatePatch(): Record<string, unknown> {\n    const patch: Record<string, unknown> = {}\n    const vadOverride = this.latestOverride(this.miniappVadOverrides)\n    const loudnessOverride = this.latestOverride(this.miniappLoudnessGateOverrides)\n\n    // Hardware VAD suppresses silence. Raw-audio consumers need a continuous\n    // timeline, so their requirement wins over both OS and miniapp VAD values.\n    if (this.localWantsPcm) patch.voice_activity_detection_enabled = false\n    else if (vadOverride) patch.voice_activity_detection_enabled = vadOverride.enabled\n    else if (this.configuredVad !== undefined) patch.voice_activity_detection_enabled = this.configuredVad\n\n    if (loudnessOverride) patch.loudness_gate_enabled = loudnessOverride.enabled\n    else if (this.configuredLoudnessGate !== undefined) {\n      patch.loudness_gate_enabled = this.configuredLoudnessGate\n    }\n\n    return patch\n  }\n\n  /**\n   * Reset all requirements to off. Called during cleanup.\n   */\n  public reset(): void {\n    this.localWantsPcm = false\n    this.localWantsLc3 = false\n    this.applyUnion()\n  }\n\n  public cleanup(): void {\n    console.log(`${LOG_TAG}: cleanup()`)\n    this.miniappVadOverrides.clear()\n    this.miniappLoudnessGateOverrides.clear()\n    this.reset()\n    MicStateCoordinator.instance = null\n  }\n}\n\nconst micStateCoordinator = MicStateCoordinator.getInstance()\nexport default micStateCoordinator\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"MiniappLauncher.d.ts","sourceRoot":"","sources":["../../src/services/MiniappLauncher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAA4B,EAAC,KAAK,wBAAwB,EAAC,MAAM,uBAAuB,CAAA;AACxF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAEpD,UAAU,YAAY;IACpB,oEAAoE;IACpE,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;IAC5C,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAA4B;IAExC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE,uEAAuE;IACvE,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAInC,OAAO,CAAC,aAAa;IAOrB,yEAAyE;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAmF7F;;;;;;;;;;OAUG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBpF,iFAAiF;YACnE,KAAK;IAiCnB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB7C;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzG,mDAAmD;IAC7C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C,OAAO,CAAC,YAAY;IAKpB,4EAA4E;IAC5E,OAAO,CAAC,cAAc;CASvB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAA"}
+{"version":3,"file":"MiniappLauncher.d.ts","sourceRoot":"","sources":["../../src/services/MiniappLauncher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAA4B,EAAC,KAAK,wBAAwB,EAAC,MAAM,uBAAuB,CAAA;AACxF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAEpD,UAAU,YAAY;IACpB,oEAAoE;IACpE,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;IAC5C,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAA4B;IAExC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE,uEAAuE;IACvE,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAInC,OAAO,CAAC,aAAa;IAOrB,yEAAyE;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8G7F;;;;;;;;;;OAUG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBpF,iFAAiF;YACnE,KAAK;IAiCnB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB7C;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzG,mDAAmD;IAC7C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C,OAAO,CAAC,YAAY;IAKpB,4EAA4E;IAC5E,OAAO,CAAC,cAAc;CASvB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAA"}

package/build/services/MiniappLauncher.js

@@ -70,7 +70,9 @@ class MiniappLauncher {
             const entry = manifest.entry;
             if (!entry?.background)
                 return null;
-            const base = devUrl.replace(/\/$/, "");
+            // Use the host that actually answered — may differ from the stored IP
+            // after a laptop Wi-Fi change (mDNS / Metro failover inside decideDevLaunchRoute).
+            const base = route.resolvedUrl.replace(/\/$/, "");
             // entry.* are bundle-root paths (dist/ stripped); the dev server serves
             // files relative to cwd, so prepend dist/.
             const bgUrl = `${base}/dist/${entry.background.replace(/^\.?\/+/, "")}`;
@@ -80,9 +82,16 @@ class MiniappLauncher {
                 .map((p) => (typeof p === "string" ? p : p?.type))
                 .filter((t) => typeof t === "string");
             const installedManifest = {
+                packageName: typeof manifest.packageName === "string" ? manifest.packageName : packageName,
                 name: manifest.name,
+                version: typeof manifest.version === "string" ? manifest.version : undefined,
+                sdkVersion: typeof manifest.sdkVersion === "string" ? manifest.sdkVersion : undefined,
+                minHostVersion: typeof manifest.minHostVersion === "string" ? manifest.minHostVersion : undefined,
+                type: typeof manifest.type === "string" ? manifest.type : undefined,
+                entry: manifest.entry,
                 permissions: manifest.permissions,
                 hardwareRequirements: manifest.hardwareRequirements,
+                actions: manifest.actions,
             };
             let bgSource;
             try {
@@ -100,7 +109,7 @@ class MiniappLauncher {
                 uiBaseDir: uiUri ? uiUri.replace(/\/[^/]+$/, "/") : null,
                 declaredPermissions,
                 installedManifest,
-                devUrl,
+                devUrl: route.resolvedUrl,
                 devPort: this.resolveDevPort(hints?.devPort, packageName),
             };
         }
@@ -116,7 +125,18 @@ class MiniappLauncher {
             .map((p) => p.type)
             .filter((t) => typeof t === "string");
         const installedManifest = manifest
-            ? { name: manifest.name, permissions: manifest.permissions, hardwareRequirements: manifest.hardwareRequirements }
+            ? {
+                packageName: manifest.packageName ?? packageName,
+                name: manifest.name,
+                version: manifest.version ?? version,
+                sdkVersion: manifest.sdkVersion,
+                minHostVersion: manifest.minHostVersion,
+                type: manifest.type,
+                entry: manifest.entry,
+                permissions: manifest.permissions,
+                hardwareRequirements: manifest.hardwareRequirements,
+                actions: manifest.actions,
+            }
             : undefined;
         let bgSource;
         try {