@mentra/engine 3.2.0-dev.116 → 3.2.0-dev.121

package/build/services/AcsMeetingService.js

@@ -0,0 +1,477 @@
+/**
+ * Host-side ACS meeting controller. One active meeting. Native module owns
+ * WHEP + ACS; this service maps that into miniapp envelopes and pipes
+ * incoming PCM into AudioPlaybackService (A2DP / PcmStreamPlayer).
+ */
+import audioPlaybackService from "./AudioPlaybackService";
+import { SETTINGS, useSettingsStore } from "../stores/settings";
+import { ACS_CALL_MIC } from "./acsAudioSource";
+export { ACS_CALL_MIC };
+/**
+ * The call microphone is [ACS_CALL_MIC]. Flip that constant to `"glasses"`
+ * to restore glasses WHIP → Cloudflare → WHEP PCM. Do not use ACS
+ * LocalOutgoingAudioStream for phone: that path makes ACS own the route
+ * (MODE_IN_COMMUNICATION + forced speaker) and opens an echo loop.
+ * preferred_mic governs MentraOS STT capture, not this call.
+ */
+export function resolveAcsAudioSource() {
+    return { source: ACS_CALL_MIC, reason: "explicit" };
+}
+const PARTICIPANT_STATES = new Set([
+    "idle",
+    "connecting",
+    "connected",
+    "lobby",
+    "hold",
+    "disconnected",
+]);
+export function parseMeetingParticipants(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const result = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const value = entry;
+        if (typeof value.id !== "string" || !value.id)
+            continue;
+        const state = PARTICIPANT_STATES.has(value.state)
+            ? value.state
+            : "idle";
+        result.push({
+            id: value.id,
+            displayName: typeof value.displayName === "string" && value.displayName ? value.displayName : null,
+            state,
+            isMuted: Boolean(value.isMuted),
+            isSpeaking: Boolean(value.isSpeaking),
+        });
+    }
+    return result;
+}
+/** ACS VirtualOutgoingVideoStream documented 16:9 sizes. P540 is 960×540, not 540×960. */
+const ACS_VIRTUAL_CAMERA_SIZES = new Set(["1280x720", "960x540"]);
+export function parseAcsOutgoingVideo(raw) {
+    if (raw == null)
+        return undefined;
+    if (typeof raw !== "object")
+        throw new Error("video must be an object");
+    const value = raw;
+    const width = Number(value.width);
+    const height = Number(value.height);
+    const fps = Number(value.fps);
+    const maxBitrateBps = Number(value.maxBitrateBps);
+    if (![width, height, fps, maxBitrateBps].every(Number.isFinite)) {
+        throw new Error("video requires width, height, fps, and maxBitrateBps");
+    }
+    if (!ACS_VIRTUAL_CAMERA_SIZES.has(`${width}x${height}`) || fps < 1 || fps > 30 || maxBitrateBps <= 0) {
+        throw new Error(`unsupported ACS video ${width}x${height}@${fps}`);
+    }
+    return { width, height, fps, maxBitrateBps };
+}
+let nativeModule;
+function getNative() {
+    if (nativeModule !== undefined)
+        return nativeModule;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        nativeModule = require("@mentra/acs-meeting").default;
+    }
+    catch {
+        nativeModule = null;
+    }
+    return nativeModule;
+}
+/** Test seam: skip the native require and inject a fake ACS module. */
+export function setAcsMeetingNativeForTests(mod) {
+    nativeModule = mod;
+}
+let phoneNetwork;
+function getPhoneNetwork() {
+    if (phoneNetwork !== undefined)
+        return phoneNetwork;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const netInfo = require("@react-native-community/netinfo");
+        phoneNetwork = netInfo.default ?? netInfo;
+    }
+    catch {
+        phoneNetwork = null;
+    }
+    return phoneNetwork;
+}
+/** Test seam: inject a fake phone-network feed (or `null` to disable it). */
+export function setAcsMeetingPhoneNetworkForTests(source) {
+    phoneNetwork = source;
+}
+function parseActiveStream(value) {
+    if (value === "none" || value === "virtual" || value === "local")
+        return value;
+    return undefined;
+}
+function parseAudioSafety(value) {
+    if (value === "safe" || value === "degraded" || value === "unsafe")
+        return value;
+    return undefined;
+}
+function parseMediaSource(value) {
+    if (value === "idle" || value === "connecting" || value === "live" || value === "failed")
+        return value;
+    return undefined;
+}
+/** Meeting phases during which the WHEP feed should be alive and is worth restarting. */
+const MEDIA_ACTIVE_PHASES = new Set(["connecting", "lobby", "connected"]);
+/** Floor between WHEP restarts we trigger from the host, so a flapping network cannot thrash native. */
+const MEDIA_RESTART_MIN_INTERVAL_MS = 3000;
+/** Formats the native PcmStreamPlayer accepts (mono only). */
+const PCM_SAMPLE_RATES = new Set([16000, 24000, 48000]);
+const PCM_BACKLOG_WARN_MS = 600;
+class AcsMeetingService {
+    owner = null;
+    pcmStreamId = null;
+    pcmFormat = null;
+    pcmReopen = null;
+    pcmWriteChain = Promise.resolve();
+    lastBacklogWarnAt = 0;
+    subscriptions = [];
+    lastState = { state: "idle", muted: false };
+    onState = null;
+    /** WHEP URL native is (or should be) subscribed to; what a host-triggered restart re-feeds. */
+    whepUrl = null;
+    phoneNetworkUnsub = null;
+    lastPhoneNetworkKey = null;
+    lastMediaRestartAt = 0;
+    setStateHandler(handler) {
+        this.onState = handler;
+    }
+    getState() {
+        return { ...this.lastState };
+    }
+    ownerPackage() {
+        return this.owner;
+    }
+    async join(packageName, args) {
+        const native = getNative();
+        if (!native) {
+            console.warn("[AcsMeeting] phase=join-native nativeLoaded=false");
+            throw new Error("ACS meeting module is not available on this host");
+        }
+        if (this.owner && this.owner !== packageName) {
+            throw new Error("Another miniapp already has an active meeting");
+        }
+        // Validate before claiming ownership so a bad request cannot leave the slot taken.
+        const video = args.video ? parseAcsOutgoingVideo(args.video) : undefined;
+        const resolved = resolveAcsAudioSource();
+        this.owner = packageName;
+        this.whepUrl = args.whepUrl;
+        this.bindNative(native, packageName);
+        console.log("[AcsMeeting] phase=join-native", {
+            packageName,
+            nativeLoaded: true,
+            hasToken: Boolean(args.token),
+            hasWhep: Boolean(args.whepUrl),
+            audioSource: resolved.source,
+            audioSourceReason: resolved.reason,
+            preferredMic: useSettingsStore.getState().getSetting(SETTINGS.preferred_mic.key),
+        });
+        try {
+            const state = await native.join({
+                meetingUrl: args.meetingUrl,
+                token: args.token,
+                whepUrl: args.whepUrl,
+                displayName: args.displayName,
+                audioSource: resolved.source,
+                ...(video ? { video } : {}),
+            });
+            this.lastState = {
+                ...state,
+                audioSource: resolved.source,
+                audioSourceReason: resolved.reason,
+            };
+            console.log("[AcsMeeting] phase=join-native-ok", { state: state.state, muted: state.muted });
+        }
+        catch (error) {
+            // Native never joined (or is unwinding). Release the slot so the same or another
+            // miniapp can retry, and make sure nothing half-joined lingers in Teams.
+            console.warn("[AcsMeeting] phase=join-native-failed", {
+                packageName,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            await native.leave().catch((leaveError) => {
+                console.warn("[AcsMeeting] native leave after failed join also failed", leaveError);
+            });
+            await this.releaseHostState();
+            throw error;
+        }
+        this.watchPhoneNetwork(native);
+        // Return audio is additive: the wearer is already in the meeting with camera and
+        // mic. A playback failure must not reject the join — that would leave the miniapp
+        // believing it never joined while native keeps the wearer in Teams.
+        try {
+            await this.ensurePcmPlayback(packageName);
+            console.log("[AcsMeeting] phase=pcm-playback", { streamId: this.pcmStreamId });
+        }
+        catch (error) {
+            console.warn("[AcsMeeting] phase=pcm-playback-failed; continuing without return audio", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        return this.lastState;
+    }
+    async leave(packageName) {
+        if (this.owner && this.owner !== packageName)
+            return;
+        const native = getNative();
+        try {
+            await native?.leave();
+        }
+        finally {
+            await this.releaseHostState();
+        }
+    }
+    /**
+     * Drop everything the host set up around a session: the network watcher, return
+     * audio, native listeners, ownership. Runs after native has been told to leave
+     * (or after a join that never produced a native call).
+     */
+    async releaseHostState() {
+        this.unwatchPhoneNetwork();
+        await this.stopPcm();
+        this.unbindNative();
+        this.owner = null;
+        this.whepUrl = null;
+        this.lastMediaRestartAt = 0;
+        this.lastState = { state: "idle", muted: false };
+    }
+    async setMuted(packageName, muted) {
+        this.assertOwner(packageName);
+        const native = getNative();
+        if (!native)
+            throw new Error("ACS meeting module is not available on this host");
+        const state = await native.setMuted(muted);
+        this.lastState = {
+            ...this.lastState,
+            ...state,
+            audioSourceReason: this.lastState.audioSourceReason,
+        };
+        return this.lastState;
+    }
+    async updateVideoSource(packageName, whepUrl) {
+        this.assertOwner(packageName);
+        const native = getNative();
+        if (!native)
+            throw new Error("ACS meeting module is not available on this host");
+        this.whepUrl = whepUrl;
+        await native.updateVideoSource(whepUrl);
+    }
+    async readState(packageName) {
+        if (this.owner && this.owner !== packageName) {
+            return { state: "idle", muted: false };
+        }
+        const native = getNative();
+        if (!native)
+            return { state: "idle", muted: false };
+        const state = await native.getState();
+        this.lastState = state;
+        return state;
+    }
+    async leaveIfOwner(packageName) {
+        if (this.owner === packageName)
+            await this.leave(packageName);
+    }
+    assertOwner(packageName) {
+        if (this.owner !== packageName) {
+            throw new Error(this.owner ? "This miniapp does not own the active meeting" : "No active meeting; call meeting.join first");
+        }
+    }
+    unbindNative() {
+        this.subscriptions.forEach((sub) => sub.remove());
+        this.subscriptions = [];
+    }
+    bindNative(native, packageName) {
+        this.unbindNative();
+        this.subscriptions = [
+            native.addListener("onState", (event) => {
+                const audioSafety = parseAudioSafety(event.audioSafety);
+                if (audioSafety === "unsafe") {
+                    console.error("[AcsMeeting] phase=audio-unsafe", {
+                        activeStream: event.activeStream,
+                        audioSource: event.audioSource,
+                    });
+                }
+                const participants = parseMeetingParticipants(event.participants);
+                const mediaSource = parseMediaSource(event.mediaSource);
+                const state = {
+                    state: event.state ?? "idle",
+                    muted: Boolean(event.muted),
+                    error: event.error,
+                    meetingUrl: event.meetingUrl,
+                    provider: "acs-teams",
+                    audioSource: event.audioSource === "phone" ? "phone" : "glasses",
+                    audioSourceReason: this.lastState.audioSourceReason,
+                    activeStream: parseActiveStream(event.activeStream),
+                    audioSafety,
+                    ...(mediaSource ? { mediaSource } : {}),
+                    ...(participants ? { participants } : {}),
+                };
+                this.lastState = state;
+                console.log("[AcsMeeting] phase=native-state", {
+                    state: state.state,
+                    muted: state.muted,
+                    error: state.error,
+                    audioSource: state.audioSource,
+                    activeStream: state.activeStream,
+                    audioSafety: state.audioSafety,
+                    mediaSource: state.mediaSource,
+                    participants: participants?.length,
+                });
+                this.onState?.(packageName, state);
+            }),
+            native.addListener("onIncomingPcm", (event) => {
+                const base64 = event.base64;
+                if (!base64 || !this.owner)
+                    return;
+                // Serialize: native async calls may complete out of order, and PCM
+                // chunks written out of order are audible as garbling.
+                this.pcmWriteChain = this.pcmWriteChain
+                    .then(() => this.writeIncomingPcm(packageName, base64, event.sampleRate, event.channels))
+                    .catch(() => undefined);
+            }),
+        ];
+    }
+    /**
+     * The WHEP PeerConnection does not survive the phone changing networks
+     * (Wi-Fi↔cellular, or a different Wi-Fi): ICE fails and native parks the source
+     * as `failed` while the ACS call itself reconnects on its own. Nudge native to
+     * rebuild the subscription whenever the phone's network identity changes during
+     * a live meeting. Native ignores the request when the source is healthy on the
+     * same URL, so a spurious event costs nothing.
+     */
+    watchPhoneNetwork(native) {
+        this.unwatchPhoneNetwork();
+        const source = getPhoneNetwork();
+        if (!source)
+            return;
+        this.lastPhoneNetworkKey = null;
+        try {
+            this.phoneNetworkUnsub = source.addEventListener((info) => {
+                const key = `${info.type}:${info.isConnected === false ? "offline" : "online"}`;
+                const previous = this.lastPhoneNetworkKey;
+                this.lastPhoneNetworkKey = key;
+                // First callback is NetInfo replaying the current state, not a change.
+                if (previous === null || previous === key)
+                    return;
+                if (info.isConnected === false)
+                    return;
+                void this.restartMediaSource(native, `phone network ${previous} → ${key}`);
+            });
+        }
+        catch (error) {
+            console.warn("[AcsMeeting] phone network watch unavailable", error);
+            this.phoneNetworkUnsub = null;
+        }
+    }
+    unwatchPhoneNetwork() {
+        this.phoneNetworkUnsub?.();
+        this.phoneNetworkUnsub = null;
+        this.lastPhoneNetworkKey = null;
+    }
+    async restartMediaSource(native, reason) {
+        const whepUrl = this.whepUrl;
+        if (!this.owner || !whepUrl || !MEDIA_ACTIVE_PHASES.has(this.lastState.state))
+            return;
+        const now = Date.now();
+        if (now - this.lastMediaRestartAt < MEDIA_RESTART_MIN_INTERVAL_MS)
+            return;
+        this.lastMediaRestartAt = now;
+        console.log("[AcsMeeting] phase=media-restart", { reason, mediaSource: this.lastState.mediaSource });
+        try {
+            // A same-URL updateVideoSource is a no-op while native still believes the
+            // peer is healthy; after a network switch that belief is exactly what is wrong.
+            if (native.restartVideoSource)
+                await native.restartVideoSource();
+            else
+                await native.updateVideoSource(whepUrl);
+        }
+        catch (error) {
+            console.warn("[AcsMeeting] media restart failed", { reason, error });
+        }
+    }
+    /**
+     * Native normalizes to 16 kHz mono, so this is normally a straight write.
+     * If the format ever differs, reopen the player to match rather than play
+     * the bytes at the wrong rate (that is what slows and deepens the audio).
+     */
+    async writeIncomingPcm(packageName, base64, rawRate, rawChannels) {
+        const sampleRate = Number(rawRate) || 16000;
+        const channels = Number(rawChannels) || 1;
+        if (!PCM_SAMPLE_RATES.has(sampleRate) || channels !== 1) {
+            console.warn("[AcsMeeting] incoming PCM format unsupported; dropping chunk", { sampleRate, channels });
+            return;
+        }
+        if (this.pcmFormat && (this.pcmFormat.sampleRate !== sampleRate || this.pcmFormat.channels !== channels)) {
+            if (!this.pcmReopen) {
+                console.warn("[AcsMeeting] incoming PCM format changed; reopening player", {
+                    from: this.pcmFormat,
+                    to: { sampleRate, channels },
+                });
+                this.pcmReopen = this.stopPcm()
+                    .then(() => this.ensurePcmPlayback(packageName, sampleRate, channels))
+                    .finally(() => {
+                    this.pcmReopen = null;
+                });
+            }
+            await this.pcmReopen;
+        }
+        else if (!this.pcmStreamId) {
+            await this.ensurePcmPlayback(packageName, sampleRate, channels);
+        }
+        const streamId = this.pcmStreamId;
+        if (!streamId)
+            return;
+        try {
+            const result = await audioPlaybackService.writeStreamChunk(streamId, base64);
+            const bufferedMs = result?.bufferedMs;
+            if (typeof bufferedMs === "number" && bufferedMs > PCM_BACKLOG_WARN_MS) {
+                const now = Date.now();
+                if (now - this.lastBacklogWarnAt > 5000) {
+                    this.lastBacklogWarnAt = now;
+                    console.warn("[AcsMeeting] incoming PCM backlog high", { bufferedMs });
+                }
+            }
+        }
+        catch (error) {
+            console.warn("[AcsMeeting] incoming PCM write failed", error);
+        }
+    }
+    async ensurePcmPlayback(packageName, sampleRate = 16000, channels = 1) {
+        if (this.pcmStreamId)
+            return;
+        const streamId = `acs-in-${packageName}-${Date.now()}`;
+        await audioPlaybackService.openStream({
+            streamId,
+            appId: packageName,
+            sampleRate,
+            channels,
+            stopOtherAudio: true,
+            onEnded: () => {
+                if (this.pcmStreamId === streamId) {
+                    this.pcmStreamId = null;
+                    this.pcmFormat = null;
+                }
+            },
+        });
+        this.pcmStreamId = streamId;
+        this.pcmFormat = { sampleRate, channels };
+    }
+    async stopPcm() {
+        const streamId = this.pcmStreamId;
+        this.pcmStreamId = null;
+        this.pcmFormat = null;
+        if (!streamId)
+            return;
+        await audioPlaybackService.abortStream(streamId).catch(() => undefined);
+    }
+}
+const acsMeetingService = new AcsMeetingService();
+export default acsMeetingService;
+//# sourceMappingURL=AcsMeetingService.js.map

package/build/services/AcsMeetingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcsMeetingService.js","sourceRoot":"","sources":["../../src/services/AcsMeetingService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Host-side ACS meeting controller. One active meeting. Native module owns\n * WHEP + ACS; this service maps that into miniapp envelopes and pipes\n * incoming PCM into AudioPlaybackService (A2DP / PcmStreamPlayer).\n */\n\nimport audioPlaybackService from \"./AudioPlaybackService\"\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\nimport {ACS_CALL_MIC, type ResolvedAudioSource, type SourceReason} from \"./acsAudioSource\"\n\nexport {ACS_CALL_MIC}\nexport type {ResolvedAudioSource, SourceReason}\n\ntype MeetingPhase = \"idle\" | \"connecting\" | \"lobby\" | \"connected\" | \"disconnected\" | \"error\"\n\nexport type AudioSafety = \"safe\" | \"degraded\" | \"unsafe\"\nexport type ActiveStream = \"none\" | \"virtual\" | \"local\"\n/**\n * Health of the glasses WHEP subscription that feeds the call. `failed` means ICE\n * dropped or the WHEP endpoint went away (glasses stopped publishing, phone changed\n * networks); the ACS call itself may still be `connected` with a frozen last frame.\n */\nexport type MediaSourceState = \"idle\" | \"connecting\" | \"live\" | \"failed\"\n\nexport type MeetingParticipantState = \"idle\" | \"connecting\" | \"connected\" | \"lobby\" | \"hold\" | \"disconnected\"\n\nexport interface MeetingParticipant {\n  id: string\n  displayName: string | null\n  state: MeetingParticipantState\n  isMuted: boolean\n  isSpeaking: boolean\n}\n\nexport interface MeetingState {\n  state: MeetingPhase\n  muted: boolean\n  error?: string\n  meetingUrl?: string\n  provider?: \"acs-teams\"\n  audioSource?: \"glasses\" | \"phone\"\n  audioSourceReason?: SourceReason\n  activeStream?: ActiveStream\n  audioSafety?: AudioSafety\n  mediaSource?: MediaSourceState\n  participants?: MeetingParticipant[]\n}\n\n/**\n * The call microphone is [ACS_CALL_MIC]. Flip that constant to `\"glasses\"`\n * to restore glasses WHIP → Cloudflare → WHEP PCM. Do not use ACS\n * LocalOutgoingAudioStream for phone: that path makes ACS own the route\n * (MODE_IN_COMMUNICATION + forced speaker) and opens an echo loop.\n * preferred_mic governs MentraOS STT capture, not this call.\n */\nexport function resolveAcsAudioSource(): ResolvedAudioSource {\n  return {source: ACS_CALL_MIC, reason: \"explicit\"}\n}\n\nconst PARTICIPANT_STATES = new Set<MeetingParticipantState>([\n  \"idle\",\n  \"connecting\",\n  \"connected\",\n  \"lobby\",\n  \"hold\",\n  \"disconnected\",\n])\n\nexport function parseMeetingParticipants(raw: unknown): MeetingParticipant[] | undefined {\n  if (!Array.isArray(raw)) return undefined\n  const result: MeetingParticipant[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== \"object\") continue\n    const value = entry as Record<string, unknown>\n    if (typeof value.id !== \"string\" || !value.id) continue\n    const state = PARTICIPANT_STATES.has(value.state as MeetingParticipantState)\n      ? (value.state as MeetingParticipantState)\n      : \"idle\"\n    result.push({\n      id: value.id,\n      displayName: typeof value.displayName === \"string\" && value.displayName ? value.displayName : null,\n      state,\n      isMuted: Boolean(value.isMuted),\n      isSpeaking: Boolean(value.isSpeaking),\n    })\n  }\n  return result\n}\n\nexport type AcsOutgoingVideo = {\n  width: number\n  height: number\n  fps: number\n  maxBitrateBps: number\n}\n\n/** ACS VirtualOutgoingVideoStream documented 16:9 sizes. P540 is 960×540, not 540×960. */\nconst ACS_VIRTUAL_CAMERA_SIZES = new Set([\"1280x720\", \"960x540\"])\n\nexport function parseAcsOutgoingVideo(raw: unknown): AcsOutgoingVideo | undefined {\n  if (raw == null) return undefined\n  if (typeof raw !== \"object\") throw new Error(\"video must be an object\")\n  const value = raw as Record<string, unknown>\n  const width = Number(value.width)\n  const height = Number(value.height)\n  const fps = Number(value.fps)\n  const maxBitrateBps = Number(value.maxBitrateBps)\n  if (![width, height, fps, maxBitrateBps].every(Number.isFinite)) {\n    throw new Error(\"video requires width, height, fps, and maxBitrateBps\")\n  }\n  if (!ACS_VIRTUAL_CAMERA_SIZES.has(`${width}x${height}`) || fps < 1 || fps > 30 || maxBitrateBps <= 0) {\n    throw new Error(`unsupported ACS video ${width}x${height}@${fps}`)\n  }\n  return {width, height, fps, maxBitrateBps}\n}\n\ntype NativeModule = {\n  join(options: {\n    meetingUrl: string\n    token: string\n    whepUrl: string\n    displayName?: string\n    dumpPcmWav?: boolean\n    audioSource?: \"glasses\" | \"phone\"\n    video?: AcsOutgoingVideo\n  }): Promise<MeetingState>\n  leave(): Promise<void>\n  setMuted(muted: boolean): Promise<MeetingState>\n  setAudioSource(source: \"glasses\" | \"phone\"): Promise<MeetingState>\n  updateVideoSource(whepUrl: string): Promise<void>\n  /** Force a WHEP rebuild on the current URL. Absent on natives that predate it. */\n  restartVideoSource?(): Promise<void>\n  getState(): Promise<MeetingState>\n  addListener(event: string, listener: (event: Record<string, unknown>) => void): {remove: () => void}\n}\n\nlet nativeModule: NativeModule | null | undefined\n\nfunction getNative(): NativeModule | null {\n  if (nativeModule !== undefined) return nativeModule\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    nativeModule = require(\"@mentra/acs-meeting\").default as NativeModule\n  } catch {\n    nativeModule = null\n  }\n  return nativeModule\n}\n\n/** Test seam: skip the native require and inject a fake ACS module. */\nexport function setAcsMeetingNativeForTests(mod: NativeModule | null | undefined): void {\n  nativeModule = mod\n}\n\n/**\n * Phone connectivity feed. Only the subset of `@react-native-community/netinfo`\n * this service needs, so tests can inject a fake and hosts without the package\n * (or a bare test runtime) degrade to \"no phone-network awareness\" instead of\n * failing to load the meeting service.\n */\nexport type PhoneNetworkInfo = {type: string; isConnected: boolean | null}\ntype PhoneNetworkSource = {\n  addEventListener(listener: (state: PhoneNetworkInfo) => void): () => void\n}\n\nlet phoneNetwork: PhoneNetworkSource | null | undefined\n\nfunction getPhoneNetwork(): PhoneNetworkSource | null {\n  if (phoneNetwork !== undefined) return phoneNetwork\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const netInfo = require(\"@react-native-community/netinfo\") as {default?: PhoneNetworkSource} & PhoneNetworkSource\n    phoneNetwork = netInfo.default ?? netInfo\n  } catch {\n    phoneNetwork = null\n  }\n  return phoneNetwork\n}\n\n/** Test seam: inject a fake phone-network feed (or `null` to disable it). */\nexport function setAcsMeetingPhoneNetworkForTests(source: PhoneNetworkSource | null | undefined): void {\n  phoneNetwork = source\n}\n\nfunction parseActiveStream(value: unknown): ActiveStream | undefined {\n  if (value === \"none\" || value === \"virtual\" || value === \"local\") return value\n  return undefined\n}\n\nfunction parseAudioSafety(value: unknown): AudioSafety | undefined {\n  if (value === \"safe\" || value === \"degraded\" || value === \"unsafe\") return value\n  return undefined\n}\n\nfunction parseMediaSource(value: unknown): MediaSourceState | undefined {\n  if (value === \"idle\" || value === \"connecting\" || value === \"live\" || value === \"failed\") return value\n  return undefined\n}\n\n/** Meeting phases during which the WHEP feed should be alive and is worth restarting. */\nconst MEDIA_ACTIVE_PHASES = new Set<MeetingPhase>([\"connecting\", \"lobby\", \"connected\"])\n/** Floor between WHEP restarts we trigger from the host, so a flapping network cannot thrash native. */\nconst MEDIA_RESTART_MIN_INTERVAL_MS = 3000\n\n/** Formats the native PcmStreamPlayer accepts (mono only). */\nconst PCM_SAMPLE_RATES = new Set([16000, 24000, 48000])\nconst PCM_BACKLOG_WARN_MS = 600\n\nclass AcsMeetingService {\n  private owner: string | null = null\n  private pcmStreamId: string | null = null\n  private pcmFormat: {sampleRate: number; channels: number} | null = null\n  private pcmReopen: Promise<void> | null = null\n  private pcmWriteChain: Promise<void> = Promise.resolve()\n  private lastBacklogWarnAt = 0\n  private subscriptions: Array<{remove: () => void}> = []\n  private lastState: MeetingState = {state: \"idle\", muted: false}\n  private onState: ((packageName: string, state: MeetingState) => void) | null = null\n  /** WHEP URL native is (or should be) subscribed to; what a host-triggered restart re-feeds. */\n  private whepUrl: string | null = null\n  private phoneNetworkUnsub: (() => void) | null = null\n  private lastPhoneNetworkKey: string | null = null\n  private lastMediaRestartAt = 0\n\n  setStateHandler(handler: (packageName: string, state: MeetingState) => void): void {\n    this.onState = handler\n  }\n\n  getState(): MeetingState {\n    return {...this.lastState}\n  }\n\n  ownerPackage(): string | null {\n    return this.owner\n  }\n\n  async join(\n    packageName: string,\n    args: {\n      meetingUrl: string\n      token: string\n      whepUrl: string\n      displayName?: string\n      video?: AcsOutgoingVideo\n    },\n  ): Promise<MeetingState> {\n    const native = getNative()\n    if (!native) {\n      console.warn(\"[AcsMeeting] phase=join-native nativeLoaded=false\")\n      throw new Error(\"ACS meeting module is not available on this host\")\n    }\n    if (this.owner && this.owner !== packageName) {\n      throw new Error(\"Another miniapp already has an active meeting\")\n    }\n    // Validate before claiming ownership so a bad request cannot leave the slot taken.\n    const video = args.video ? parseAcsOutgoingVideo(args.video) : undefined\n    const resolved = resolveAcsAudioSource()\n    this.owner = packageName\n    this.whepUrl = args.whepUrl\n    this.bindNative(native, packageName)\n    console.log(\"[AcsMeeting] phase=join-native\", {\n      packageName,\n      nativeLoaded: true,\n      hasToken: Boolean(args.token),\n      hasWhep: Boolean(args.whepUrl),\n      audioSource: resolved.source,\n      audioSourceReason: resolved.reason,\n      preferredMic: useSettingsStore.getState().getSetting(SETTINGS.preferred_mic.key),\n    })\n    try {\n      const state = await native.join({\n        meetingUrl: args.meetingUrl,\n        token: args.token,\n        whepUrl: args.whepUrl,\n        displayName: args.displayName,\n        audioSource: resolved.source,\n        ...(video ? {video} : {}),\n      })\n      this.lastState = {\n        ...state,\n        audioSource: resolved.source,\n        audioSourceReason: resolved.reason,\n      }\n      console.log(\"[AcsMeeting] phase=join-native-ok\", {state: state.state, muted: state.muted})\n    } catch (error) {\n      // Native never joined (or is unwinding). Release the slot so the same or another\n      // miniapp can retry, and make sure nothing half-joined lingers in Teams.\n      console.warn(\"[AcsMeeting] phase=join-native-failed\", {\n        packageName,\n        error: error instanceof Error ? error.message : String(error),\n      })\n      await native.leave().catch((leaveError) => {\n        console.warn(\"[AcsMeeting] native leave after failed join also failed\", leaveError)\n      })\n      await this.releaseHostState()\n      throw error\n    }\n    this.watchPhoneNetwork(native)\n    // Return audio is additive: the wearer is already in the meeting with camera and\n    // mic. A playback failure must not reject the join — that would leave the miniapp\n    // believing it never joined while native keeps the wearer in Teams.\n    try {\n      await this.ensurePcmPlayback(packageName)\n      console.log(\"[AcsMeeting] phase=pcm-playback\", {streamId: this.pcmStreamId})\n    } catch (error) {\n      console.warn(\"[AcsMeeting] phase=pcm-playback-failed; continuing without return audio\", {\n        error: error instanceof Error ? error.message : String(error),\n      })\n    }\n    return this.lastState\n  }\n\n  async leave(packageName: string): Promise<void> {\n    if (this.owner && this.owner !== packageName) return\n    const native = getNative()\n    try {\n      await native?.leave()\n    } finally {\n      await this.releaseHostState()\n    }\n  }\n\n  /**\n   * Drop everything the host set up around a session: the network watcher, return\n   * audio, native listeners, ownership. Runs after native has been told to leave\n   * (or after a join that never produced a native call).\n   */\n  private async releaseHostState(): Promise<void> {\n    this.unwatchPhoneNetwork()\n    await this.stopPcm()\n    this.unbindNative()\n    this.owner = null\n    this.whepUrl = null\n    this.lastMediaRestartAt = 0\n    this.lastState = {state: \"idle\", muted: false}\n  }\n\n  async setMuted(packageName: string, muted: boolean): Promise<MeetingState> {\n    this.assertOwner(packageName)\n    const native = getNative()\n    if (!native) throw new Error(\"ACS meeting module is not available on this host\")\n    const state = await native.setMuted(muted)\n    this.lastState = {\n      ...this.lastState,\n      ...state,\n      audioSourceReason: this.lastState.audioSourceReason,\n    }\n    return this.lastState\n  }\n\n  async updateVideoSource(packageName: string, whepUrl: string): Promise<void> {\n    this.assertOwner(packageName)\n    const native = getNative()\n    if (!native) throw new Error(\"ACS meeting module is not available on this host\")\n    this.whepUrl = whepUrl\n    await native.updateVideoSource(whepUrl)\n  }\n\n  async readState(packageName: string): Promise<MeetingState> {\n    if (this.owner && this.owner !== packageName) {\n      return {state: \"idle\", muted: false}\n    }\n    const native = getNative()\n    if (!native) return {state: \"idle\", muted: false}\n    const state = await native.getState()\n    this.lastState = state\n    return state\n  }\n\n  async leaveIfOwner(packageName: string): Promise<void> {\n    if (this.owner === packageName) await this.leave(packageName)\n  }\n\n  private assertOwner(packageName: string): void {\n    if (this.owner !== packageName) {\n      throw new Error(\n        this.owner ? \"This miniapp does not own the active meeting\" : \"No active meeting; call meeting.join first\",\n      )\n    }\n  }\n\n  private unbindNative(): void {\n    this.subscriptions.forEach((sub) => sub.remove())\n    this.subscriptions = []\n  }\n\n  private bindNative(native: NativeModule, packageName: string): void {\n    this.unbindNative()\n    this.subscriptions = [\n      native.addListener(\"onState\", (event) => {\n        const audioSafety = parseAudioSafety(event.audioSafety)\n        if (audioSafety === \"unsafe\") {\n          console.error(\"[AcsMeeting] phase=audio-unsafe\", {\n            activeStream: event.activeStream,\n            audioSource: event.audioSource,\n          })\n        }\n        const participants = parseMeetingParticipants(event.participants)\n        const mediaSource = parseMediaSource(event.mediaSource)\n        const state: MeetingState = {\n          state: (event.state as MeetingPhase) ?? \"idle\",\n          muted: Boolean(event.muted),\n          error: event.error as string | undefined,\n          meetingUrl: event.meetingUrl as string | undefined,\n          provider: \"acs-teams\",\n          audioSource: event.audioSource === \"phone\" ? \"phone\" : \"glasses\",\n          audioSourceReason: this.lastState.audioSourceReason,\n          activeStream: parseActiveStream(event.activeStream),\n          audioSafety,\n          ...(mediaSource ? {mediaSource} : {}),\n          ...(participants ? {participants} : {}),\n        }\n        this.lastState = state\n        console.log(\"[AcsMeeting] phase=native-state\", {\n          state: state.state,\n          muted: state.muted,\n          error: state.error,\n          audioSource: state.audioSource,\n          activeStream: state.activeStream,\n          audioSafety: state.audioSafety,\n          mediaSource: state.mediaSource,\n          participants: participants?.length,\n        })\n        this.onState?.(packageName, state)\n      }),\n      native.addListener(\"onIncomingPcm\", (event) => {\n        const base64 = event.base64 as string | undefined\n        if (!base64 || !this.owner) return\n        // Serialize: native async calls may complete out of order, and PCM\n        // chunks written out of order are audible as garbling.\n        this.pcmWriteChain = this.pcmWriteChain\n          .then(() => this.writeIncomingPcm(packageName, base64, event.sampleRate, event.channels))\n          .catch(() => undefined)\n      }),\n    ]\n  }\n\n  /**\n   * The WHEP PeerConnection does not survive the phone changing networks\n   * (Wi-Fi↔cellular, or a different Wi-Fi): ICE fails and native parks the source\n   * as `failed` while the ACS call itself reconnects on its own. Nudge native to\n   * rebuild the subscription whenever the phone's network identity changes during\n   * a live meeting. Native ignores the request when the source is healthy on the\n   * same URL, so a spurious event costs nothing.\n   */\n  private watchPhoneNetwork(native: NativeModule): void {\n    this.unwatchPhoneNetwork()\n    const source = getPhoneNetwork()\n    if (!source) return\n    this.lastPhoneNetworkKey = null\n    try {\n      this.phoneNetworkUnsub = source.addEventListener((info) => {\n        const key = `${info.type}:${info.isConnected === false ? \"offline\" : \"online\"}`\n        const previous = this.lastPhoneNetworkKey\n        this.lastPhoneNetworkKey = key\n        // First callback is NetInfo replaying the current state, not a change.\n        if (previous === null || previous === key) return\n        if (info.isConnected === false) return\n        void this.restartMediaSource(native, `phone network ${previous} → ${key}`)\n      })\n    } catch (error) {\n      console.warn(\"[AcsMeeting] phone network watch unavailable\", error)\n      this.phoneNetworkUnsub = null\n    }\n  }\n\n  private unwatchPhoneNetwork(): void {\n    this.phoneNetworkUnsub?.()\n    this.phoneNetworkUnsub = null\n    this.lastPhoneNetworkKey = null\n  }\n\n  private async restartMediaSource(native: NativeModule, reason: string): Promise<void> {\n    const whepUrl = this.whepUrl\n    if (!this.owner || !whepUrl || !MEDIA_ACTIVE_PHASES.has(this.lastState.state)) return\n    const now = Date.now()\n    if (now - this.lastMediaRestartAt < MEDIA_RESTART_MIN_INTERVAL_MS) return\n    this.lastMediaRestartAt = now\n    console.log(\"[AcsMeeting] phase=media-restart\", {reason, mediaSource: this.lastState.mediaSource})\n    try {\n      // A same-URL updateVideoSource is a no-op while native still believes the\n      // peer is healthy; after a network switch that belief is exactly what is wrong.\n      if (native.restartVideoSource) await native.restartVideoSource()\n      else await native.updateVideoSource(whepUrl)\n    } catch (error) {\n      console.warn(\"[AcsMeeting] media restart failed\", {reason, error})\n    }\n  }\n\n  /**\n   * Native normalizes to 16 kHz mono, so this is normally a straight write.\n   * If the format ever differs, reopen the player to match rather than play\n   * the bytes at the wrong rate (that is what slows and deepens the audio).\n   */\n  private async writeIncomingPcm(\n    packageName: string,\n    base64: string,\n    rawRate: unknown,\n    rawChannels: unknown,\n  ): Promise<void> {\n    const sampleRate = Number(rawRate) || 16000\n    const channels = Number(rawChannels) || 1\n    if (!PCM_SAMPLE_RATES.has(sampleRate) || channels !== 1) {\n      console.warn(\"[AcsMeeting] incoming PCM format unsupported; dropping chunk\", {sampleRate, channels})\n      return\n    }\n    if (this.pcmFormat && (this.pcmFormat.sampleRate !== sampleRate || this.pcmFormat.channels !== channels)) {\n      if (!this.pcmReopen) {\n        console.warn(\"[AcsMeeting] incoming PCM format changed; reopening player\", {\n          from: this.pcmFormat,\n          to: {sampleRate, channels},\n        })\n        this.pcmReopen = this.stopPcm()\n          .then(() => this.ensurePcmPlayback(packageName, sampleRate, channels))\n          .finally(() => {\n            this.pcmReopen = null\n          })\n      }\n      await this.pcmReopen\n    } else if (!this.pcmStreamId) {\n      await this.ensurePcmPlayback(packageName, sampleRate, channels)\n    }\n    const streamId = this.pcmStreamId\n    if (!streamId) return\n    try {\n      const result = await audioPlaybackService.writeStreamChunk(streamId, base64)\n      const bufferedMs = result?.bufferedMs\n      if (typeof bufferedMs === \"number\" && bufferedMs > PCM_BACKLOG_WARN_MS) {\n        const now = Date.now()\n        if (now - this.lastBacklogWarnAt > 5000) {\n          this.lastBacklogWarnAt = now\n          console.warn(\"[AcsMeeting] incoming PCM backlog high\", {bufferedMs})\n        }\n      }\n    } catch (error) {\n      console.warn(\"[AcsMeeting] incoming PCM write failed\", error)\n    }\n  }\n\n  private async ensurePcmPlayback(packageName: string, sampleRate = 16000, channels = 1): Promise<void> {\n    if (this.pcmStreamId) return\n    const streamId = `acs-in-${packageName}-${Date.now()}`\n    await audioPlaybackService.openStream({\n      streamId,\n      appId: packageName,\n      sampleRate,\n      channels,\n      stopOtherAudio: true,\n      onEnded: () => {\n        if (this.pcmStreamId === streamId) {\n          this.pcmStreamId = null\n          this.pcmFormat = null\n        }\n      },\n    })\n    this.pcmStreamId = streamId\n    this.pcmFormat = {sampleRate, channels}\n  }\n\n  private async stopPcm(): Promise<void> {\n    const streamId = this.pcmStreamId\n    this.pcmStreamId = null\n    this.pcmFormat = null\n    if (!streamId) return\n    await audioPlaybackService.abortStream(streamId).catch(() => undefined)\n  }\n}\n\nconst acsMeetingService = new AcsMeetingService()\nexport default acsMeetingService\n"]}

package/build/services/AppRegistry.d.ts

@@ -13,6 +13,7 @@
  *   - uninstall(packageName, version?)      remove one or all versions
  *   - getInstalledMiniapps()                ClientApp[] derived from disk
  *   - getActiveVersion(packageName)         active version string for a package
+ *   - getLatestDevSnapshotVersion(pkg)      newest on-disk `dev-*` snapshot
  *   - getBundleDir / getMiniappManifest     filesystem helpers used by hosts
  *   - subscribe(fn)                         register a refresh listener
  */
@@ -173,6 +174,14 @@ declare class AppRegistry {
     getInstalledVersions(packageName: string): string[];
     getActiveVersion(packageName: string): Promise<string>;
     setActiveVersion(packageName: string, version: string): Result<void, Error>;
+    /**
+     * Newest `dev-*` snapshot that still has a resolvable UI or background
+     * entry. Semver store installs are ignored — a live-dev tile must not
+     * silently fall back to a released store bundle when the laptop drops.
+     */
+    getLatestDevSnapshotVersion(packageName: string): string | null;
+    /** True iff {@link getLatestDevSnapshotVersion} finds a usable snapshot. */
+    hasDevSnapshot(packageName: string): boolean;
     getMetadata(packageName: string, version: string): InstalledInfo;
     getInstalledInfo(): InstalledLma[];
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"AppRegistry.d.ts","sourceRoot":"","sources":["../../src/services/AppRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AppRegistry.d.ts","sourceRoot":"","sources":["../../src/services/AppRegistry.ts"],"names":[],"mappings":"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"}

package/build/services/AppRegistry.js

@@ -13,6 +13,7 @@
  *   - uninstall(packageName, version?)      remove one or all versions
  *   - getInstalledMiniapps()                ClientApp[] derived from disk
  *   - getActiveVersion(packageName)         active version string for a package
+ *   - getLatestDevSnapshotVersion(pkg)      newest on-disk `dev-*` snapshot
  *   - getBundleDir / getMiniappManifest     filesystem helpers used by hosts
  *   - subscribe(fn)                         register a refresh listener
  */
@@ -608,6 +609,27 @@ class AppRegistry {
     setActiveVersion(packageName, version) {
         return storage.save(`${packageName}_active_version`, version);
     }
+    /**
+     * Newest `dev-*` snapshot that still has a resolvable UI or background
+     * entry. Semver store installs are ignored — a live-dev tile must not
+     * silently fall back to a released store bundle when the laptop drops.
+     */
+    getLatestDevSnapshotVersion(packageName) {
+        const versions = this.getInstalledVersions(packageName)
+            .filter((v) => v.startsWith("dev-"))
+            .sort()
+            .reverse();
+        for (const version of versions) {
+            const paths = this.getMiniappEntryPaths(packageName, version);
+            if (paths?.background || paths?.ui)
+                return version;
+        }
+        return null;
+    }
+    /** True iff {@link getLatestDevSnapshotVersion} finds a usable snapshot. */
+    hasDevSnapshot(packageName) {
+        return this.getLatestDevSnapshotVersion(packageName) != null;
+    }
     getMetadata(packageName, version) {
         try {
             const lmaDir = new Directory(Paths.document, "lmas", packageName, version);