@mentra/acs-meeting 3.2.0-dev.217 → 3.2.0-dev.222

package/build/AcsMeetingModule.d.ts

@@ -2,12 +2,35 @@ import { NativeModule } from "expo";
 import type { AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState } from "./AcsMeeting.types";
 declare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {
     join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>;
+    /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */
+    prepareAgent(options: {
+        token: string;
+        displayName?: string;
+    }): Promise<AcsMeetingState>;
     leave(): Promise<void>;
+    /**
+     * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have
+     * finished. `leave()` only queues that work, so awaiting it proves nothing about cleanup.
+     */
+    leaveAndAwait(options: {
+        timeoutMs: number;
+    }): Promise<{
+        completed: boolean;
+    }>;
     setMuted(muted: boolean): Promise<AcsMeetingState>;
     setAudioSource(source: "glasses" | "phone"): Promise<AcsMeetingState>;
     updateVideoSource(whepUrl: string): Promise<void>;
     /** Force a WHEP rebuild on the current URL (phone changed networks). */
     restartVideoSource(): Promise<void>;
+    /** SoftAP: join the glasses hotspot as a scoped network; resolves to the phone's IPv4 on it. Android only. */
+    joinScopedNetwork(ssid: string, passphrase: string): Promise<string>;
+    beginTrace(traceId: string): Promise<void>;
+    leaveScopedNetwork(): Promise<void>;
+    /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */
+    probeScopedGateway(): Promise<{
+        reachable: boolean;
+        detail: string;
+    }>;
     getState(): Promise<AcsMeetingState>;
 }
 declare const _default: AcsMeetingNativeModule;

package/build/AcsMeetingModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,KAAK,EAAC,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAEtG,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAC/E,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CACrC;;AAED,wBAA8E"}
+{"version":3,"file":"AcsMeetingModule.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAsB,MAAM,MAAM,CAAA;AAEtD,OAAO,KAAK,EAAC,qBAAqB,EAAE,sBAAsB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;AAEtG,OAAO,OAAO,sBAAuB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAC/E,IAAI,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9D,iFAAiF;IACjF,YAAY,CAAC,OAAO,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IACrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,wEAAwE;IACxE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,8GAA8G;IAC9G,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,qEAAqE;IACrE,kBAAkB,IAAI,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACnE,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;CACrC;;AAED,wBAA8E"}

package/build/AcsMeetingModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.js","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AAetD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} from \"./AcsMeeting.types\"\n\ndeclare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {\n  join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>\n  leave(): Promise<void>\n  setMuted(muted: boolean): Promise<AcsMeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<AcsMeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL (phone changed networks). */\n  restartVideoSource(): Promise<void>\n  getState(): Promise<AcsMeetingState>\n}\n\nexport default requireNativeModule<AcsMeetingNativeModule>(\"MentraAcsMeeting\")\n"]}
+{"version":3,"file":"AcsMeetingModule.js","sourceRoot":"","sources":["../src/AcsMeetingModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,mBAAmB,EAAC,MAAM,MAAM,CAAA;AA4BtD,eAAe,mBAAmB,CAAyB,kBAAkB,CAAC,CAAA","sourcesContent":["import {NativeModule, requireNativeModule} from \"expo\"\n\nimport type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} from \"./AcsMeeting.types\"\n\ndeclare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {\n  join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>\n  /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */\n  prepareAgent(options: {token: string; displayName?: string}): Promise<AcsMeetingState>\n  leave(): Promise<void>\n  /**\n   * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have\n   * finished. `leave()` only queues that work, so awaiting it proves nothing about cleanup.\n   */\n  leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>\n  setMuted(muted: boolean): Promise<AcsMeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<AcsMeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL (phone changed networks). */\n  restartVideoSource(): Promise<void>\n  /** SoftAP: join the glasses hotspot as a scoped network; resolves to the phone's IPv4 on it. Android only. */\n  joinScopedNetwork(ssid: string, passphrase: string): Promise<string>\n  beginTrace(traceId: string): Promise<void>\n  leaveScopedNetwork(): Promise<void>\n  /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */\n  probeScopedGateway(): Promise<{reachable: boolean; detail: string}>\n  getState(): Promise<AcsMeetingState>\n}\n\nexport default requireNativeModule<AcsMeetingNativeModule>(\"MentraAcsMeeting\")\n"]}

package/build/AcsMeetingModule.web.d.ts

@@ -1,11 +1,26 @@
 import type { AcsMeetingJoinOptions, AcsMeetingState } from "./AcsMeeting.types";
 declare const _default: {
     join(_options: AcsMeetingJoinOptions): Promise<AcsMeetingState>;
+    prepareAgent(_options: {
+        token: string;
+        displayName?: string;
+    }): Promise<AcsMeetingState>;
     leave(): Promise<void>;
+    leaveAndAwait(_options: {
+        timeoutMs: number;
+    }): Promise<{
+        completed: boolean;
+    }>;
     setMuted(_muted: boolean): Promise<AcsMeetingState>;
     setAudioSource(_source: "glasses" | "phone"): Promise<AcsMeetingState>;
     updateVideoSource(_whepUrl: string): Promise<void>;
     restartVideoSource(): Promise<void>;
+    joinScopedNetwork(_ssid: string, _passphrase: string): Promise<string>;
+    leaveScopedNetwork(): Promise<void>;
+    probeScopedGateway(): Promise<{
+        reachable: boolean;
+        detail: string;
+    }>;
     getState(): Promise<AcsMeetingState>;
     addListener(): {
         remove(): void;

package/build/AcsMeetingModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.web.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;;mBAOvD,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;aAGtD,OAAO,CAAC,IAAI,CAAC;qBAGL,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;4BAG3B,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;gCAG1C,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAG5B,OAAO,CAAC,IAAI,CAAC;gBAGvB,OAAO,CAAC,eAAe,CAAC;;;;;;AAnB5C,wBA0BC"}
+{"version":3,"file":"AcsMeetingModule.web.d.ts","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAA;;mBAOvD,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;2BAGxC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,eAAe,CAAC;aAG9E,OAAO,CAAC,IAAI,CAAC;4BAGE;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAC,CAAC;qBAG1D,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;4BAG3B,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;gCAG1C,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAG5B,OAAO,CAAC,IAAI,CAAC;6BAGV,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;0BAGhD,OAAO,CAAC,IAAI,CAAC;0BACb,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;gBAGvD,OAAO,CAAC,eAAe,CAAC;;;;;;AAhC5C,wBAuCC"}

package/build/AcsMeetingModule.web.js

@@ -5,9 +5,15 @@ export default {
     async join(_options) {
         unavailable();
     },
+    async prepareAgent(_options) {
+        unavailable();
+    },
     async leave() {
         unavailable();
     },
+    async leaveAndAwait(_options) {
+        unavailable();
+    },
     async setMuted(_muted) {
         unavailable();
     },
@@ -20,6 +26,13 @@ export default {
     async restartVideoSource() {
         unavailable();
     },
+    async joinScopedNetwork(_ssid, _passphrase) {
+        unavailable();
+    },
+    async leaveScopedNetwork() { },
+    async probeScopedGateway() {
+        return { reachable: false, detail: "no scoped network on web" };
+    },
     async getState() {
         return { state: "idle", muted: false };
     },

package/build/AcsMeetingModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcsMeetingModule.web.js","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW;IAClB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;AACxD,CAAC;AAED,eAAe;IACb,KAAK,CAAC,IAAI,CAAC,QAA+B;QACxC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,KAAK;QACT,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,MAAe;QAC5B,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,OAA4B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB;QACtB,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAC,CAAA;IACtC,CAAC;IACD,WAAW;QACT,OAAO,EAAC,MAAM,KAAI,CAAC,EAAC,CAAA;IACtB,CAAC;IACD,eAAe,KAAI,CAAC;CACrB,CAAA","sourcesContent":["import type {AcsMeetingJoinOptions, AcsMeetingState} from \"./AcsMeeting.types\"\n\nfunction unavailable(): never {\n  throw new Error(\"ACS meeting is not available on web\")\n}\n\nexport default {\n  async join(_options: AcsMeetingJoinOptions): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async leave(): Promise<void> {\n    unavailable()\n  },\n  async setMuted(_muted: boolean): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async setAudioSource(_source: \"glasses\" | \"phone\"): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async updateVideoSource(_whepUrl: string): Promise<void> {\n    unavailable()\n  },\n  async restartVideoSource(): Promise<void> {\n    unavailable()\n  },\n  async getState(): Promise<AcsMeetingState> {\n    return {state: \"idle\", muted: false}\n  },\n  addListener() {\n    return {remove() {}}\n  },\n  removeListeners() {},\n}\n"]}
+{"version":3,"file":"AcsMeetingModule.web.js","sourceRoot":"","sources":["../src/AcsMeetingModule.web.ts"],"names":[],"mappings":"AAEA,SAAS,WAAW;IAClB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;AACxD,CAAC;AAED,eAAe;IACb,KAAK,CAAC,IAAI,CAAC,QAA+B;QACxC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,QAA+C;QAChE,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,KAAK;QACT,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,aAAa,CAAC,QAA6B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,MAAe;QAC5B,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,OAA4B;QAC/C,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB;QACtB,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,iBAAiB,CAAC,KAAa,EAAE,WAAmB;QACxD,WAAW,EAAE,CAAA;IACf,CAAC;IACD,KAAK,CAAC,kBAAkB,KAAmB,CAAC;IAC5C,KAAK,CAAC,kBAAkB;QACtB,OAAO,EAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAC,CAAA;IAC/D,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAC,CAAA;IACtC,CAAC;IACD,WAAW;QACT,OAAO,EAAC,MAAM,KAAI,CAAC,EAAC,CAAA;IACtB,CAAC;IACD,eAAe,KAAI,CAAC;CACrB,CAAA","sourcesContent":["import type {AcsMeetingJoinOptions, AcsMeetingState} from \"./AcsMeeting.types\"\n\nfunction unavailable(): never {\n  throw new Error(\"ACS meeting is not available on web\")\n}\n\nexport default {\n  async join(_options: AcsMeetingJoinOptions): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async prepareAgent(_options: {token: string; displayName?: string}): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async leave(): Promise<void> {\n    unavailable()\n  },\n  async leaveAndAwait(_options: {timeoutMs: number}): Promise<{completed: boolean}> {\n    unavailable()\n  },\n  async setMuted(_muted: boolean): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async setAudioSource(_source: \"glasses\" | \"phone\"): Promise<AcsMeetingState> {\n    unavailable()\n  },\n  async updateVideoSource(_whepUrl: string): Promise<void> {\n    unavailable()\n  },\n  async restartVideoSource(): Promise<void> {\n    unavailable()\n  },\n  async joinScopedNetwork(_ssid: string, _passphrase: string): Promise<string> {\n    unavailable()\n  },\n  async leaveScopedNetwork(): Promise<void> {},\n  async probeScopedGateway(): Promise<{reachable: boolean; detail: string}> {\n    return {reachable: false, detail: \"no scoped network on web\"}\n  },\n  async getState(): Promise<AcsMeetingState> {\n    return {state: \"idle\", muted: false}\n  },\n  addListener() {\n    return {remove() {}}\n  },\n  removeListeners() {},\n}\n"]}

package/ios/AcsMeetingModule.swift

@@ -14,7 +14,7 @@ public class AcsMeetingModule: Module {
         AsyncFunction("join") { (options: [String: Any]) in
             let token = try requireString(options, "token")
             let meetingUrl = try requireString(options, "meetingUrl")
-            let whepUrl = try requireString(options, "whepUrl")
+            let whepUrl = try requireWhepUrl(options)
             let displayName = options["displayName"] as? String
             let dumpWav = options["dumpPcmWav"] as? Bool ?? false
             let audioSource = options["audioSource"] as? String ?? "glasses"
@@ -30,10 +30,62 @@ public class AcsMeetingModule: Module {
             return meeting.snapshot()
         }
 
+        /// Refuses rather than no-ops. A silent success here would let the orchestrator go on to an ACS
+        /// join and a glasses publish that have no network to meet on, which surfaces as a black tile
+        /// several steps later instead of as the unsupported transport it is.
+        AsyncFunction("joinScopedNetwork") { (_: String, _: String) -> String in
+            throw NSError(
+                domain: "MentraAcsMeeting",
+                code: 2,
+                userInfo: [
+                    NSLocalizedDescriptionKey:
+                        "NOT_IMPLEMENTED: SoftAP calling is Android-only; iOS cannot join the glasses hotspot as a scoped network",
+                ]
+            )
+        }
+
+        AsyncFunction("leaveScopedNetwork") {
+            // Nothing was ever joined, so releasing is a no-op rather than an error: teardown must stay
+            // safe to run after a failed start.
+        }
+
+        AsyncFunction("probeScopedGateway") { () -> [String: Any] in
+            // No scoped network exists on iOS, so there is nothing to probe. Report it as such rather
+            // than as unreachable, which the orchestrator would read as a live network failure.
+            ["reachable": false, "detail": "no scoped network on iOS"]
+        }
+
         AsyncFunction("leave") {
             self.session?.leave()
         }
 
+        AsyncFunction("endForEveryone") { (promise: Promise) in
+            guard let session = self.session else {
+                promise.reject(NSError(
+                    domain: "MentraAcsMeeting",
+                    code: 3,
+                    userInfo: [NSLocalizedDescriptionKey: "No active meeting to end"]
+                ))
+                return
+            }
+            session.endForEveryone { error in
+                // Local teardown has already run by the time this fires, so a rejection here means
+                // "the meeting may still be running", never "you are still in it".
+                if let error {
+                    promise.reject(error)
+                } else {
+                    promise.resolve(session.snapshot())
+                }
+            }
+        }
+
+        AsyncFunction("scopedNetworkInfo") { () -> [String: Any?] in
+            // No scoped network on iOS, so there is no prefix for the ICE-path proof to check
+            // against. Reported as unavailable rather than as an empty prefix, which the proof
+            // would read as "could not describe the network" on a platform that has none.
+            ["available": false, "localIpv4": nil, "prefix": nil]
+        }
+
         AsyncFunction("setMuted") { (muted: Bool) in
             self.session?.setMuted(muted) ?? ["state": "idle", "muted": muted]
         }
@@ -114,10 +166,16 @@ final class AcsMeetingSession {
     private static let mediaRestartBaseMs = 1000
     private static let mediaRestartMaxMs = 10000
     private var joinGeneration: UInt64 = 0
+    private var capabilitiesFeature: CapabilitiesCallFeature?
+    /// nil means "not reported yet", which the miniapp shows as End disabled rather than absent.
+    private var hangUpForEveryone: (allowed: Bool, reason: String)?
     private lazy var callDelegateProxy = AcsCallDelegateProxy(
         onStateChange: { [weak self] call in self?.handleCallStateChange(call) },
         onMuteChange: { [weak self] call in self?.handleCallMuteChange(call) }
     )
+    private lazy var capabilitiesDelegateProxy = AcsCapabilitiesDelegateProxy(
+        onChanged: { [weak self] in self?.refreshCapabilities() }
+    )
 
     init(onState: @escaping ([String: Any]) -> Void, onIncomingPcm: @escaping (String, Int, Int) -> Void) {
         self.onState = onState
@@ -134,6 +192,15 @@ final class AcsMeetingSession {
             "audioSafety": lastSafety.rawValue,
             "mediaSource": mediaSource.rawValue,
         ]
+        // Always present, so a host that simply has not heard from Teams yet is distinguishable
+        // from one that cannot report capabilities at all. Keys are omitted rather than sent as
+        // null while unknown; the host parses a missing key as unknown.
+        var hangUp: [String: Any] = [:]
+        if let capability = hangUpForEveryone {
+            hangUp["allowed"] = capability.allowed
+            hangUp["reason"] = capability.reason
+        }
+        result["capabilities"] = ["hangUpForEveryone": hangUp]
         if let meetingUrl { result["meetingUrl"] = meetingUrl }
         if let lastError { result["error"] = lastError }
         return result
@@ -314,6 +381,7 @@ final class AcsMeetingSession {
         }
         self.call = call
         call.delegate = callDelegateProxy
+        attachCapabilities(call)
 
         let bridge = PcmBridge(dumpWav: dumpWav)
         pcmBridge = bridge
@@ -423,6 +491,102 @@ final class AcsMeetingSession {
         queue.async { self.leaveLocked() }
     }
 
+    /**
+     End the meeting for everyone, then tear this device down.
+
+     Local teardown runs whether or not ACS accepted the hang-up, and the error is reported after
+     it. The wearer is out of the call either way; what the caller learns from a rejection is only
+     that the others may still be in it.
+
+     A known-denied capability is refused locally rather than sent. Teams only lets a presenter end
+     a meeting for everyone, ACS rejects the attempt with an opaque error, and the wearer would have
+     sat through a confirm sheet for nothing. An *unknown* capability is not a refusal: it is the
+     ordinary state before the first capabilities event, and letting ACS answer is more honest than
+     guessing.
+     */
+    func endForEveryone(completion: @escaping (Error?) -> Void) {
+        queue.async { [weak self] in
+            guard let self else { return }
+            if let refusal = self.hangUpForEveryoneRefusal() {
+                completion(NSError(
+                    domain: "MentraAcsMeeting",
+                    code: 3,
+                    userInfo: [NSLocalizedDescriptionKey: refusal]
+                ))
+                return
+            }
+            guard let active = self.call else {
+                self.leaveLocked()
+                completion(NSError(
+                    domain: "MentraAcsMeeting",
+                    code: 3,
+                    userInfo: [NSLocalizedDescriptionKey: "No active meeting to end"]
+                ))
+                return
+            }
+            let options = HangUpOptions()
+            options.forEveryone = true
+            active.hangUp(options: options) { [weak self] error in
+                guard let self else {
+                    completion(error)
+                    return
+                }
+                if let error {
+                    NSLog("ACS-SPIKE endForEveryone failed: \(error)")
+                }
+                self.queue.async {
+                    self.leaveLocked()
+                    completion(error)
+                }
+            }
+        }
+    }
+
+    /// The refusal to report, or nil when the End should be attempted.
+    private func hangUpForEveryoneRefusal() -> String? {
+        guard let capability = readHangUpForEveryone(), !capability.allowed else { return nil }
+        return "hang_up_for_everyone_not_allowed:\(capability.reason)"
+    }
+
+    /**
+     Subscribe to the runtime capability that decides whether End is offered.
+
+     Subscribed rather than read once: Teams can grant the capability after admission (a wearer
+     promoted to presenter mid-call), and an End button that never turns on is the same bug as one
+     that lies about what it does.
+     */
+    private func attachCapabilities(_ call: Call) {
+        let feature = call.feature(Features.capabilities)
+        capabilitiesFeature = feature
+        feature.delegate = capabilitiesDelegateProxy
+        refreshCapabilities()
+    }
+
+    fileprivate func refreshCapabilities() {
+        queue.async { [weak self] in
+            guard let self else { return }
+            let next = self.readHangUpForEveryone()
+            guard next?.allowed != self.hangUpForEveryone?.allowed
+                || next?.reason != self.hangUpForEveryone?.reason else { return }
+            self.hangUpForEveryone = next
+            NSLog("ACS-SPIKE hangUpForEveryone allowed=\(next?.allowed.description ?? "unknown") reason=\(next?.reason ?? "-")")
+            self.onState(self.snapshot())
+        }
+    }
+
+    /// Drop the capability so the next call starts unknown instead of inheriting the last one's.
+    private func detachCapabilities() {
+        capabilitiesFeature?.delegate = nil
+        capabilitiesFeature = nil
+        hangUpForEveryone = nil
+    }
+
+    private func readHangUpForEveryone() -> (allowed: Bool, reason: String)? {
+        guard let feature = capabilitiesFeature else { return nil }
+        guard let capability = feature.capabilities.first(where: { $0.type == .hangUpForEveryone }) else { return nil }
+        return (capability.isAllowed, String(describing: capability.reason))
+    }
+
     fileprivate func applyAudioPolicy(_ reason: String) {
         queue.async { self.applyAudioPolicyOnQueue(reason) }
     }
@@ -469,6 +633,7 @@ final class AcsMeetingSession {
         // Detach before stop so the teardown's own idle transition does not emit a
         // snapshot (or schedule a rebuild) for a call that is going away.
         cancelMediaRestart()
+        detachCapabilities()
         whep?.onStateChange = nil
         mediaSource = .idle
         whep?.stop()
@@ -644,6 +809,21 @@ private final class AcsCallDelegateProxy: NSObject, CallDelegate {
     }
 }
 
+private final class AcsCapabilitiesDelegateProxy: NSObject, CapabilitiesCallFeatureDelegate {
+    private let onChanged: () -> Void
+
+    init(onChanged: @escaping () -> Void) {
+        self.onChanged = onChanged
+    }
+
+    func capabilitiesCallFeature(
+        _: CapabilitiesCallFeature,
+        didChangeCapabilities _: CapabilitiesChangedEventArgs
+    ) {
+        onChanged()
+    }
+}
+
 private struct AcsMeetingError: LocalizedError {
     let message: String
 
@@ -675,7 +855,7 @@ struct AcsOutgoingVideo {
     let fps: Int
     let maxBitrateBps: Int
 
-    static let hd = AcsOutgoingVideo(width: 1280, height: 720, fps: 15, maxBitrateBps: 2_500_000)
+    static let hd = AcsOutgoingVideo(width: 1280, height: 720, fps: 15, maxBitrateBps: 3_000_000)
     static let allowedSizes: Set<String> = ["1280x720", "960x540"]
 }
 
@@ -686,6 +866,37 @@ private func requireString(_ options: [String: Any], _ key: String) throws -> St
     return value
 }
 
+/// Resolves the WHEP URL from either the `videoSource` union or a legacy bare `whepUrl`.
+///
+/// SoftAP is refused here with `NOT_IMPLEMENTED` rather than allowed to fall through. Joining
+/// without a usable video source would produce a call that connects and shows the remote
+/// participant a black tile, with nothing in the logs to explain it. iOS cannot serve the local
+/// WHIP endpoint yet — see the SoftAP plan's iOS spike — so saying so plainly is the correct
+/// behaviour until it can.
+private func requireWhepUrl(_ options: [String: Any]) throws -> String {
+  guard let source = options["videoSource"] as? [String: Any] else {
+    return try requireString(options, "whepUrl")
+  }
+  let type = (source["type"] as? String)?.lowercased() ?? ""
+  switch type {
+  case "whep":
+    if let url = source["url"] as? String, !url.isEmpty { return url }
+    return try requireString(options, "whepUrl")
+  case "softap":
+    throw NSError(
+      domain: "MentraAcsMeeting",
+      code: 2,
+      userInfo: [NSLocalizedDescriptionKey: "NOT_IMPLEMENTED: SoftAP calling is Android-only"]
+    )
+  default:
+    throw NSError(
+      domain: "MentraAcsMeeting",
+      code: 1,
+      userInfo: [NSLocalizedDescriptionKey: "unsupported videoSource.type: \(type)"]
+    )
+  }
+}
+
 private func parseAcsOutgoingVideo(_ raw: Any?) throws -> AcsOutgoingVideo {
     guard let raw else { return .hd }
     guard let map = raw as? [String: Any] else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/acs-meeting",
-  "version": "3.2.0-dev.217",
+  "version": "3.2.0-dev.222",
   "description": "MentraOS native ACS Teams meeting module (WHEP decode → ACS raw media)",
   "main": "build/index.js",
   "react-native": "src/index.ts",

package/src/AcsMeeting.types.ts

@@ -48,6 +48,11 @@ export type AcsMeetingJoinOptions = {
   displayName?: string
   /** "glasses" sends WHEP PCM. "phone" uses the ACS local mic (handset or BT). */
   audioSource?: AcsAudioSource
+  /**
+   * Hold outgoing PCM this many ms before ACS. SoftAP+LC3 sets this in the host
+   * because BLE audio reaches the phone before SoftAP video.
+   */
+  audioDelayMs?: number
   /** Dump WHEP PCM to a WAV in cache for P4 verification. */
   dumpPcmWav?: boolean
   /** When omitted, native keeps 1280×720@15 / 2.5 Mbps. */

package/src/AcsMeetingModule.ts

@@ -4,12 +4,25 @@ import type {AcsMeetingJoinOptions, AcsMeetingModuleEvents, AcsMeetingState} fro
 
 declare class AcsMeetingNativeModule extends NativeModule<AcsMeetingModuleEvents> {
   join(options: AcsMeetingJoinOptions): Promise<AcsMeetingState>
+  /** Sign in to ACS before SoftAP so Teams is not resolved through glasses DNS. */
+  prepareAgent(options: {token: string; displayName?: string}): Promise<AcsMeetingState>
   leave(): Promise<void>
+  /**
+   * Leave, and resolve only once the hang-up, the agent disposal, and the network releases have
+   * finished. `leave()` only queues that work, so awaiting it proves nothing about cleanup.
+   */
+  leaveAndAwait(options: {timeoutMs: number}): Promise<{completed: boolean}>
   setMuted(muted: boolean): Promise<AcsMeetingState>
   setAudioSource(source: "glasses" | "phone"): Promise<AcsMeetingState>
   updateVideoSource(whepUrl: string): Promise<void>
   /** Force a WHEP rebuild on the current URL (phone changed networks). */
   restartVideoSource(): Promise<void>
+  /** SoftAP: join the glasses hotspot as a scoped network; resolves to the phone's IPv4 on it. Android only. */
+  joinScopedNetwork(ssid: string, passphrase: string): Promise<string>
+  beginTrace(traceId: string): Promise<void>
+  leaveScopedNetwork(): Promise<void>
+  /** SoftAP: TCP-probe the hotspot gateway over the scoped network. */
+  probeScopedGateway(): Promise<{reachable: boolean; detail: string}>
   getState(): Promise<AcsMeetingState>
 }
 

package/src/AcsMeetingModule.web.ts

@@ -8,9 +8,15 @@ export default {
   async join(_options: AcsMeetingJoinOptions): Promise<AcsMeetingState> {
     unavailable()
   },
+  async prepareAgent(_options: {token: string; displayName?: string}): Promise<AcsMeetingState> {
+    unavailable()
+  },
   async leave(): Promise<void> {
     unavailable()
   },
+  async leaveAndAwait(_options: {timeoutMs: number}): Promise<{completed: boolean}> {
+    unavailable()
+  },
   async setMuted(_muted: boolean): Promise<AcsMeetingState> {
     unavailable()
   },
@@ -23,6 +29,13 @@ export default {
   async restartVideoSource(): Promise<void> {
     unavailable()
   },
+  async joinScopedNetwork(_ssid: string, _passphrase: string): Promise<string> {
+    unavailable()
+  },
+  async leaveScopedNetwork(): Promise<void> {},
+  async probeScopedGateway(): Promise<{reachable: boolean; detail: string}> {
+    return {reachable: false, detail: "no scoped network on web"}
+  },
   async getState(): Promise<AcsMeetingState> {
     return {state: "idle", muted: false}
   },