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

package/build/services/PhoneCameraFovCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneCameraFovCoordinator.js","sourceRoot":"","sources":["../../src/services/PhoneCameraFovCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk, {type CameraFovRequest, type CameraFovResult} from \"@mentra/bluetooth-sdk/internal\"\n\nexport const CAMERA_FOV_OVERRIDE_TTL_MS = 300_000\nexport const CAMERA_FOV_OVERRIDE_REFRESH_MS = 120_000\n// Legacy ASG clients restart the camera HAL for an FOV update but cannot acknowledge\n// when it is usable again. The ASG cooldown is 5s; retain a small settling margin so\n// miniapps cannot submit a photo against the stale camera service.\nconst LEGACY_CAMERA_RESTART_SETTLE_MS = 7_000\n\ninterface OverrideEntry {\n  leaseId: string\n  fov: number\n  roiPosition: \"center\" | \"bottom\" | \"top\"\n  order: number\n}\n\nlet leaseCounter = 0\n\nfunction mintLeaseId(): string {\n  leaseCounter = (leaseCounter + 1) & 0xffff\n  return `fov-${leaseCounter.toString(16).padStart(4, \"0\")}`\n}\n\nfunction isLegacyFovCompatibilityError(error: unknown): boolean {\n  const message = error instanceof Error ? error.message : String(error)\n  return /timed out waiting for glasses response|not available|unknown method/i.test(message)\n}\n\n/**\n * Serializes miniapp-owned FOV/ROI overrides. The last live owner wins; releasing it applies the\n * previous owner or asks ASG to restore its persistent base. ASG refreshes are no-restart TTL\n * extensions for crash safety.\n */\nexport class PhoneCameraFovCoordinator {\n  private readonly overrides = new Map<string, OverrideEntry>()\n  private effectiveLeaseId: string | undefined\n  private sequence = 0\n  private queue: Promise<unknown> = Promise.resolve()\n  private refreshTimer: ReturnType<typeof setTimeout> | undefined\n  private legacyMode = false\n\n  constructor(private readonly legacyRestartSettleMs = LEGACY_CAMERA_RESTART_SETTLE_MS) {}\n\n  /** Report-safe FOV ownership snapshot for incident diagnostics. */\n  getDiagnosticSnapshot(): Record<string, unknown> {\n    return {\n      owners: [...this.overrides.entries()]\n        .sort(([, a], [, b]) => b.order - a.order)\n        .map(([packageName, entry]) => ({\n          packageName,\n          effective: entry.leaseId === this.effectiveLeaseId,\n          fov: entry.fov,\n          roiPosition: entry.roiPosition,\n        })),\n      legacyMode: this.legacyMode,\n    }\n  }\n\n  setOverride(packageName: string, request: CameraFovRequest): Promise<CameraFovResult> {\n    return this.enqueue(async () => {\n      const previous = this.overrides.get(packageName)\n      const leaseId = previous?.leaseId ?? mintLeaseId()\n      const order = ++this.sequence\n      try {\n        if (this.legacyMode) return this.setLegacyOverride(packageName, request, leaseId, order)\n        const result = await BluetoothSdk.setCameraFovOverride({\n          ...request,\n          leaseId,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        this.overrides.set(packageName, {\n          leaseId,\n          fov: result.fov,\n          roiPosition: result.roiPosition,\n          order,\n        })\n        this.effectiveLeaseId = leaseId\n        this.scheduleRefresh()\n        return result\n      } catch (error) {\n        if (!isLegacyFovCompatibilityError(error)) throw error\n        console.warn(\"[PhoneCameraFovCoordinator] override unavailable; using legacy FOV command\", error)\n        const result = await this.setLegacyOverride(packageName, request, leaseId, order)\n        // Only cache compatibility mode after the fallback itself succeeds. A\n        // disconnect or missing native bridge must not permanently downgrade\n        // future requests on a healthy/newer glasses connection.\n        this.legacyMode = true\n        return result\n      }\n    })\n  }\n\n  releaseForApp(packageName: string): Promise<void> {\n    return this.enqueue(async () => {\n      const removed = this.overrides.get(packageName)\n      if (!removed) return\n      if (removed.leaseId !== this.effectiveLeaseId) {\n        this.overrides.delete(packageName)\n        return\n      }\n\n      const next = [...this.overrides.entries()]\n        .filter(([candidatePackage]) => candidatePackage !== packageName)\n        .map(([, entry]) => entry)\n        .sort((a, b) => b.order - a.order)[0]\n      if (this.legacyMode) {\n        if (next) {\n          await this.applyLegacyFov({fov: next.fov, roiPosition: next.roiPosition})\n          this.overrides.delete(packageName)\n          this.effectiveLeaseId = next.leaseId\n        } else {\n          // Legacy commands are one-way and have no lease-release protocol.\n          // Ask native to replay its unchanged persistent base setting, then\n          // probe the modern override path again for the next ownership cycle.\n          await BluetoothSdk.restoreLegacyCameraFov()\n          await this.waitForLegacyCameraRestart()\n          this.overrides.delete(packageName)\n          this.clearRefresh()\n          this.effectiveLeaseId = undefined\n          this.legacyMode = false\n        }\n        return\n      }\n      if (next) {\n        await BluetoothSdk.setCameraFovOverride({\n          leaseId: next.leaseId,\n          fov: next.fov,\n          roiPosition: next.roiPosition,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        // Commit phone-side ownership only after ASG accepted the replacement. On failure the\n        // closing app remains effective here, allowing unregister/reconnect cleanup to retry.\n        this.overrides.delete(packageName)\n        this.effectiveLeaseId = next.leaseId\n        this.scheduleRefresh()\n      } else {\n        await BluetoothSdk.releaseCameraFovOverride(removed.leaseId)\n        this.overrides.delete(packageName)\n        this.clearRefresh()\n        this.effectiveLeaseId = undefined\n      }\n    })\n  }\n\n  private scheduleRefresh(): void {\n    if (this.legacyMode) return\n    this.clearRefresh()\n    const leaseId = this.effectiveLeaseId\n    if (!leaseId) return\n    this.refreshTimer = setTimeout(() => {\n      void this.enqueue(async () => {\n        if (this.effectiveLeaseId !== leaseId) return\n        const entry = [...this.overrides.values()].find((candidate) => candidate.leaseId === leaseId)\n        if (!entry) return\n        await BluetoothSdk.setCameraFovOverride({\n          leaseId,\n          fov: entry.fov,\n          roiPosition: entry.roiPosition,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        this.scheduleRefresh()\n      }).catch((error) => console.warn(\"[PhoneCameraFovCoordinator] failed to refresh override\", error))\n    }, CAMERA_FOV_OVERRIDE_REFRESH_MS)\n  }\n\n  private clearRefresh(): void {\n    if (this.refreshTimer) clearTimeout(this.refreshTimer)\n    this.refreshTimer = undefined\n  }\n\n  private async setLegacyOverride(\n    packageName: string,\n    request: CameraFovRequest,\n    leaseId: string,\n    order: number,\n  ): Promise<CameraFovResult> {\n    const result = await this.applyLegacyFov(request)\n    this.overrides.set(packageName, {\n      leaseId,\n      fov: result.fov,\n      roiPosition: result.roiPosition,\n      order,\n    })\n    this.effectiveLeaseId = leaseId\n    this.clearRefresh()\n    return result\n  }\n\n  private async applyLegacyFov(request: CameraFovRequest): Promise<CameraFovResult> {\n    const result = await BluetoothSdk.setLegacyCameraFov(request)\n    await this.waitForLegacyCameraRestart()\n    return result\n  }\n\n  private waitForLegacyCameraRestart(): Promise<void> {\n    if (this.legacyRestartSettleMs <= 0) return Promise.resolve()\n    return new Promise<void>((resolve) => setTimeout(resolve, this.legacyRestartSettleMs))\n  }\n\n  private enqueue<T>(operation: () => Promise<T>): Promise<T> {\n    const result = this.queue.then(operation, operation)\n    this.queue = result.then(\n      () => undefined,\n      () => undefined,\n    )\n    return result\n  }\n}\n\nexport const phoneCameraFovCoordinator = new PhoneCameraFovCoordinator()\n"]}
+{"version":3,"file":"PhoneCameraFovCoordinator.js","sourceRoot":"","sources":["../../src/services/PhoneCameraFovCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk, {type CameraFovRequest, type CameraFovResult} from \"@mentra/bluetooth-sdk/internal\"\n\nexport const CAMERA_FOV_OVERRIDE_TTL_MS = 300_000\nexport const CAMERA_FOV_OVERRIDE_REFRESH_MS = 120_000\n// Legacy ASG clients restart the camera HAL for an FOV update but cannot acknowledge\n// when it is usable again. The ASG cooldown is 5s; retain a small settling margin so\n// miniapps cannot submit a photo against the stale camera service.\nconst LEGACY_CAMERA_RESTART_SETTLE_MS = 7_000\n\ninterface OverrideEntry {\n  leaseId: string\n  fov: number\n  roiPosition: \"center\" | \"bottom\" | \"top\"\n  order: number\n}\n\nlet leaseCounter = 0\n\nfunction mintLeaseId(): string {\n  leaseCounter = (leaseCounter + 1) & 0xffff\n  return `fov-${leaseCounter.toString(16).padStart(4, \"0\")}`\n}\n\nfunction isLegacyFovCompatibilityError(error: unknown): boolean {\n  const message = error instanceof Error ? error.message : String(error)\n  return /timed out waiting for glasses response|not available|unknown method/i.test(message)\n}\n\n/**\n * Serializes miniapp-owned FOV/ROI overrides. The last live owner wins; releasing it applies the\n * previous owner or asks ASG to restore its persistent base. ASG refreshes are no-restart TTL\n * extensions for crash safety.\n */\nexport class PhoneCameraFovCoordinator {\n  private readonly overrides = new Map<string, OverrideEntry>()\n  private effectiveLeaseId: string | undefined\n  private sequence = 0\n  private queue: Promise<unknown> = Promise.resolve()\n  private refreshTimer: ReturnType<typeof setTimeout> | undefined\n  private legacyMode = false\n\n  constructor(private readonly legacyRestartSettleMs = LEGACY_CAMERA_RESTART_SETTLE_MS) {}\n\n  /** Report-safe FOV ownership snapshot for incident diagnostics. */\n  getDiagnosticSnapshot(): Record<string, unknown> {\n    return {\n      owners: [...this.overrides.entries()]\n        .sort(([, a], [, b]) => b.order - a.order)\n        .map(([packageName, entry]) => ({\n          packageName,\n          effective: entry.leaseId === this.effectiveLeaseId,\n          fov: entry.fov,\n          roiPosition: entry.roiPosition,\n        })),\n      legacyMode: this.legacyMode,\n    }\n  }\n\n  setOverride(packageName: string, request: CameraFovRequest): Promise<CameraFovResult> {\n    return this.enqueue(async () => {\n      const previous = this.overrides.get(packageName)\n      const leaseId = previous?.leaseId ?? mintLeaseId()\n      const order = ++this.sequence\n      try {\n        if (this.legacyMode) return this.setLegacyOverride(packageName, request, leaseId, order)\n        const result = await BluetoothSdk.setCameraFovOverride({\n          ...request,\n          leaseId,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        this.overrides.set(packageName, {\n          leaseId,\n          fov: result.fov,\n          roiPosition: result.roiPosition,\n          order,\n        })\n        this.effectiveLeaseId = leaseId\n        this.scheduleRefresh()\n        return result\n      } catch (error) {\n        if (!isLegacyFovCompatibilityError(error)) throw error\n        console.warn(\"[PhoneCameraFovCoordinator] override unavailable; using legacy FOV command\", error)\n        const result = await this.setLegacyOverride(packageName, request, leaseId, order)\n        // Only cache compatibility mode after the fallback itself succeeds. A\n        // disconnect or missing native bridge must not permanently downgrade\n        // future requests on a healthy/newer glasses connection.\n        this.legacyMode = true\n        return result\n      }\n    })\n  }\n\n  /**\n   * Re-assert the current override on the glasses.\n   *\n   * The on-connect device-settings push replays the persistent `camera_fov`,\n   * so glasses that connect mid-call come up at the user's saved value and\n   * silently drop a miniapp's override — a Mentra Call wearer loses the 102°\n   * bottom crop by connecting their glasses after joining.\n   *\n   * The effective lease is recomputed inside [enqueue], not captured at call\n   * time: a `setOverride` or `releaseForApp` already queued ahead of this must\n   * win, and it is this coordinator that has to be the authoritative last\n   * writer. Sends the complete override — `fov` *and* `roiPosition` — because\n   * the scalar alone leaves the ROI wherever the persistent setting put it.\n   *\n   * No-op in legacy mode: those commands restart the camera HAL, which is far\n   * too expensive to fire on every reconnect.\n   */\n  reapplyEffectiveOverride(): Promise<void> {\n    return this.enqueue(async () => {\n      if (this.legacyMode) return\n      const leaseId = this.effectiveLeaseId\n      if (!leaseId) return\n      const entry = [...this.overrides.values()].find((candidate) => candidate.leaseId === leaseId)\n      if (!entry) return\n      await BluetoothSdk.setCameraFovOverride({\n        leaseId,\n        fov: entry.fov,\n        roiPosition: entry.roiPosition,\n        ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n      })\n      this.scheduleRefresh()\n    })\n  }\n\n  releaseForApp(packageName: string): Promise<void> {\n    return this.enqueue(async () => {\n      const removed = this.overrides.get(packageName)\n      if (!removed) return\n      if (removed.leaseId !== this.effectiveLeaseId) {\n        this.overrides.delete(packageName)\n        return\n      }\n\n      const next = [...this.overrides.entries()]\n        .filter(([candidatePackage]) => candidatePackage !== packageName)\n        .map(([, entry]) => entry)\n        .sort((a, b) => b.order - a.order)[0]\n      if (this.legacyMode) {\n        if (next) {\n          await this.applyLegacyFov({fov: next.fov, roiPosition: next.roiPosition})\n          this.overrides.delete(packageName)\n          this.effectiveLeaseId = next.leaseId\n        } else {\n          // Legacy commands are one-way and have no lease-release protocol.\n          // Ask native to replay its unchanged persistent base setting, then\n          // probe the modern override path again for the next ownership cycle.\n          await BluetoothSdk.restoreLegacyCameraFov()\n          await this.waitForLegacyCameraRestart()\n          this.overrides.delete(packageName)\n          this.clearRefresh()\n          this.effectiveLeaseId = undefined\n          this.legacyMode = false\n        }\n        return\n      }\n      if (next) {\n        await BluetoothSdk.setCameraFovOverride({\n          leaseId: next.leaseId,\n          fov: next.fov,\n          roiPosition: next.roiPosition,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        // Commit phone-side ownership only after ASG accepted the replacement. On failure the\n        // closing app remains effective here, allowing unregister/reconnect cleanup to retry.\n        this.overrides.delete(packageName)\n        this.effectiveLeaseId = next.leaseId\n        this.scheduleRefresh()\n      } else {\n        await BluetoothSdk.releaseCameraFovOverride(removed.leaseId)\n        this.overrides.delete(packageName)\n        this.clearRefresh()\n        this.effectiveLeaseId = undefined\n      }\n    })\n  }\n\n  private scheduleRefresh(): void {\n    if (this.legacyMode) return\n    this.clearRefresh()\n    const leaseId = this.effectiveLeaseId\n    if (!leaseId) return\n    this.refreshTimer = setTimeout(() => {\n      void this.enqueue(async () => {\n        if (this.effectiveLeaseId !== leaseId) return\n        const entry = [...this.overrides.values()].find((candidate) => candidate.leaseId === leaseId)\n        if (!entry) return\n        await BluetoothSdk.setCameraFovOverride({\n          leaseId,\n          fov: entry.fov,\n          roiPosition: entry.roiPosition,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        this.scheduleRefresh()\n      }).catch((error) => console.warn(\"[PhoneCameraFovCoordinator] failed to refresh override\", error))\n    }, CAMERA_FOV_OVERRIDE_REFRESH_MS)\n  }\n\n  private clearRefresh(): void {\n    if (this.refreshTimer) clearTimeout(this.refreshTimer)\n    this.refreshTimer = undefined\n  }\n\n  private async setLegacyOverride(\n    packageName: string,\n    request: CameraFovRequest,\n    leaseId: string,\n    order: number,\n  ): Promise<CameraFovResult> {\n    const result = await this.applyLegacyFov(request)\n    this.overrides.set(packageName, {\n      leaseId,\n      fov: result.fov,\n      roiPosition: result.roiPosition,\n      order,\n    })\n    this.effectiveLeaseId = leaseId\n    this.clearRefresh()\n    return result\n  }\n\n  private async applyLegacyFov(request: CameraFovRequest): Promise<CameraFovResult> {\n    const result = await BluetoothSdk.setLegacyCameraFov(request)\n    await this.waitForLegacyCameraRestart()\n    return result\n  }\n\n  private waitForLegacyCameraRestart(): Promise<void> {\n    if (this.legacyRestartSettleMs <= 0) return Promise.resolve()\n    return new Promise<void>((resolve) => setTimeout(resolve, this.legacyRestartSettleMs))\n  }\n\n  private enqueue<T>(operation: () => Promise<T>): Promise<T> {\n    const result = this.queue.then(operation, operation)\n    this.queue = result.then(\n      () => undefined,\n      () => undefined,\n    )\n    return result\n  }\n}\n\nexport const phoneCameraFovCoordinator = new PhoneCameraFovCoordinator()\n"]}

package/build/services/PhoneStreamCoordinator.d.ts

@@ -26,6 +26,18 @@
  * streams. We use a `phone-` prefix so they're trivially distinguishable from
  * cloud-minted IDs in logs and from cloud-SDK app streams that flow through
  * the legacy path.
+ *
+ * BLE link loss is a SUSPENDED state, not a failure:
+ *   The glasses publisher keeps pushing over Wi-Fi when the phone's Bluetooth
+ *   link drops; only our keep-alives stop reaching it. While the store says
+ *   the glasses are disconnected we pause the heartbeat (so we don't count
+ *   misses we caused ourselves), fan out `suspended`, and give the link
+ *   `glassesGraceMs` to come back. On reconnect we resume, heartbeat at once,
+ *   and fan out `resumed` with the SAME streamId — no re-provision. The grace
+ *   ends early when Cloudflare reports the publisher gone for two probes in
+ *   a row (glasses powered off, not a BLE hiccup). If the grace expires the
+ *   stream is torn down with reason `glasses_disconnected`, and the BLE stop
+ *   the glasses never received is sent on the next reconnect.
  */
 import type { KeepAliveAckEvent, StreamResolvedConfig, StreamStartRequest, StreamStatusEvent } from "@mentra/bluetooth-sdk/internal";
 import { type RestreamDestinationInput } from "./cloudStreamApi";
@@ -42,11 +54,28 @@ declare const DEFAULT_TIMINGS: {
     readonly hlsReadinessInitialDelayMs: 5000;
     readonly hlsReadinessPollMs: 2000;
     readonly hlsReadinessMaxAttempts: 30;
+    readonly glassesGraceMs: 45000;
+    readonly suspendedPublisherGoneProbes: 2;
 };
 type TimingConfig = {
     [K in keyof typeof DEFAULT_TIMINGS]: number;
 };
 export type CoordinatorTimings = Partial<TimingConfig>;
+/**
+ * Where the coordinator learns whether the phone↔glasses BLE link is up.
+ * Injected so tests can drive link transitions without the zustand store.
+ */
+export interface GlassesLinkSource {
+    isConnected(): boolean;
+    /** Fires on every connected↔disconnected transition. */
+    subscribe(listener: (connected: boolean) => void): () => void;
+}
+/** Reasons carried on coordinator-sourced `stream_status` fanouts for link events. */
+export declare const LINK_STATUS: {
+    readonly suspended: "suspended";
+    readonly resumed: "resumed";
+    readonly reason: "glasses_disconnected";
+};
 export interface StartUnmanagedOptions {
     streamUrl: string;
     video?: StreamStartRequest["video"];
@@ -54,6 +83,7 @@ export interface StartUnmanagedOptions {
     sound?: boolean;
     /** Optional Bearer token for WHIP Authorization (custom authenticated endpoints). */
     authToken?: string;
+    captureAudio?: boolean;
 }
 export interface StartManagedOptions {
     restreamDestinations?: RestreamDestinationInput[];
@@ -71,6 +101,8 @@ export interface StartManagedOptions {
      *     that drop WHIP/SRT UDP.
      */
     ingest?: "srt" | "whip" | "rtmp";
+    /** When false, glasses skip encoding their mic for this WHIP session. */
+    captureAudio?: boolean;
 }
 export interface StreamPublisherStartResult {
     streamId: string;
@@ -112,6 +144,16 @@ export declare class PhoneStreamCoordinator {
     private statusSubscriber;
     private idCounter;
     private readonly timings;
+    private readonly linkSource;
+    private unsubscribeLink;
+    private suspended;
+    /**
+     * A stream was torn down while the BLE link was down, so the glasses never
+     * got `stopStream`. Sent on the next reconnect (if no new stream has claimed
+     * the slot) so a publisher that outlived its input does not keep pushing
+     * until its own watchdog fires.
+     */
+    private pendingBleStop;
     /**
      * Serializes state transitions (start, stop, teardown). Without it, a
      * second `start*` racing with the first can pass the `this.current === null`
@@ -125,7 +167,17 @@ export declare class PhoneStreamCoordinator {
     private lastFanoutSignature;
     /** Send full resolvedConfig only once per stream session. */
     private resolvedConfigForwarded;
-    constructor(timings?: CoordinatorTimings);
+    constructor(timings?: CoordinatorTimings, deps?: {
+        linkSource?: GlassesLinkSource;
+    });
+    /**
+     * Fail fast if glasses aren't connected — BEFORE provisioning. Without this a
+     * managed start would create a provider live input, fail the BLE command, and
+     * tear the input down again: a slow, billable no-op with a confusing error.
+     */
+    private assertGlassesConnected;
+    /** True while the active stream is parked on a dropped BLE link. */
+    isSuspended(): boolean;
     /**
      * Run `work` under the transition lock. Each call awaits the previous
      * transition before re-evaluating preconditions, so e.g. two concurrent
@@ -156,7 +208,21 @@ export declare class PhoneStreamCoordinator {
     handleGlassesStatus(event: StreamStatusEvent): void;
     /** Called by MantleManager when a phone-owned keep_alive_ack arrives. */
     handleKeepAliveAck(event: KeepAliveAckEvent): void;
+    private attachLink;
+    private detachLinkIfIdle;
+    private handleLinkChange;
+    private suspend;
+    private resumeLocked;
+    private onGraceExpired;
+    /**
+     * End a suspended stream. `publisherGone` distinguishes "glasses are off and
+     * Cloudflare confirms nothing is publishing" from "grace ran out with the
+     * publisher possibly still alive" — miniapps word the two differently.
+     */
+    private failSuspended;
+    private flushPendingBleStop;
     private mintId;
+    /** BLE keep-alives. StreamLifecycleController uses BgTimer so they survive MentraOS backgrounding. */
     private startLifecycle;
     private startCloudflareStatusPoll;
     private startHlsReadinessPoll;

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

@@ -1 +1 @@
-{"version":3,"file":"PhoneStreamCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/PhoneStreamCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AAMvC,OAAO,EAML,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAA;AAEzB;;;GAGG;AACH,QAAA,MAAM,eAAe;;;;;;;;;CAYX,CAAA;AAEV,KAAK,YAAY,GAAG;KAAE,CAAC,IAAI,MAAM,OAAO,eAAe,GAAG,MAAM;CAAC,CAAA;AACjE,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;AAetD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,CAAC,EAAE,wBAAwB,EAAE,CAAA;IACjD,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC;AAED,MAAM,WAAW,kBAAmB,SAAQ,0BAA0B;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB;;6CAEyC;IACzC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,aAAa,CAAA;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAA;AAoCxF,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,MAAM;IAE5B,6EAA6E;aAC7D,KAAK,CAAC,EAAE,MAAM;IAC9B,kEAAkE;aAClD,SAAS,CAAC,EAAE,MAAM;gBALlB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;IACf,6EAA6E;IAC7D,KAAK,CAAC,EAAE,MAAM,YAAA;IAC9B,kEAAkE;IAClD,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAkBD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAmC;IACnD,+DAA+D;IAC/D,OAAO,CAAC,mBAAmB,CAAsB;IACjD,6DAA6D;IAC7D,OAAO,CAAC,uBAAuB,CAAQ;gBAE3B,OAAO,GAAE,kBAAuB;IAI5C;;;;OAIG;YACW,YAAY;IAY1B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,GAAG,IAAI;IAI/C;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI/B,sEAAsE;IACtE,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmB1C,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,0BAA0B,CAAC;IAgDhC,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAqIxB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjE;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IA2CnD,yEAAyE;IACzE,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IASlD,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,yBAAyB;IA8GjC,OAAO,CAAC,qBAAqB;IAsE7B,OAAO,CAAC,MAAM;IAed;;;;;;OAMG;YACW,cAAc;CAgD7B;AAqDD,eAAO,MAAM,sBAAsB,wBAA+B,CAAA"}
+{"version":3,"file":"PhoneStreamCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/PhoneStreamCoordinator.ts"],"names":[],"mappings":"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"}

package/build/services/PhoneStreamCoordinator.js

@@ -26,6 +26,18 @@
  * streams. We use a `phone-` prefix so they're trivially distinguishable from
  * cloud-minted IDs in logs and from cloud-SDK app streams that flow through
  * the legacy path.
+ *
+ * BLE link loss is a SUSPENDED state, not a failure:
+ *   The glasses publisher keeps pushing over Wi-Fi when the phone's Bluetooth
+ *   link drops; only our keep-alives stop reaching it. While the store says
+ *   the glasses are disconnected we pause the heartbeat (so we don't count
+ *   misses we caused ourselves), fan out `suspended`, and give the link
+ *   `glassesGraceMs` to come back. On reconnect we resume, heartbeat at once,
+ *   and fan out `resumed` with the SAME streamId — no re-provision. The grace
+ *   ends early when Cloudflare reports the publisher gone for two probes in
+ *   a row (glasses powered off, not a BLE hiccup). If the grace expires the
+ *   stream is torn down with reason `glasses_disconnected`, and the BLE stop
+ *   the glasses never received is sent on the next reconnect.
  */
 import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
 import { isGlassesConnected } from "./GlassesReadiness";
@@ -49,6 +61,23 @@ const DEFAULT_TIMINGS = {
     hlsReadinessInitialDelayMs: 5_000,
     hlsReadinessPollMs: 2_000,
     hlsReadinessMaxAttempts: 30,
+    // How long a stream survives a BLE link drop before we give up on it. Must
+    // stay under the glasses publisher's own 60s no-keep-alive watchdog with
+    // margin for the resume heartbeat's round trip.
+    glassesGraceMs: 45_000,
+    // Consecutive Cloudflare "publisher disconnected" probes while suspended
+    // before we conclude the glasses are off (not just out of BLE range).
+    suspendedPublisherGoneProbes: 2,
+};
+const storeLinkSource = {
+    isConnected: () => isGlassesConnected(useGlassesStore.getState().connection),
+    subscribe: (listener) => useGlassesStore.subscribe((s) => isGlassesConnected(s.connection), listener),
+};
+/** Reasons carried on coordinator-sourced `stream_status` fanouts for link events. */
+export const LINK_STATUS = {
+    suspended: "suspended",
+    resumed: "resumed",
+    reason: "glasses_disconnected",
 };
 // Console-backed minimal logger; replaces pino on the phone.
 const consoleLogger = {
@@ -78,22 +107,22 @@ export class StreamConflictError extends Error {
         this.name = "StreamConflictError";
     }
 }
-/**
- * Fail fast if glasses aren't connected — BEFORE provisioning. Without this a
- * managed start would create a provider live input, fail the BLE command, and
- * tear the input down again: a slow, billable no-op with a confusing error.
- */
-function assertGlassesConnected() {
-    if (!isGlassesConnected(useGlassesStore.getState().connection)) {
-        throw new StreamConflictError("GLASSES_NOT_CONNECTED", "Glasses are not connected", "command", "ble");
-    }
-}
 export class PhoneStreamCoordinator {
     current = null;
     lifecycle = null;
     statusSubscriber = null;
     idCounter = 0;
     timings;
+    linkSource;
+    unsubscribeLink = null;
+    suspended = null;
+    /**
+     * A stream was torn down while the BLE link was down, so the glasses never
+     * got `stopStream`. Sent on the next reconnect (if no new stream has claimed
+     * the slot) so a publisher that outlived its input does not keep pushing
+     * until its own watchdog fires.
+     */
+    pendingBleStop = null;
     /**
      * Serializes state transitions (start, stop, teardown). Without it, a
      * second `start*` racing with the first can pass the `this.current === null`
@@ -107,8 +136,23 @@ export class PhoneStreamCoordinator {
     lastFanoutSignature = null;
     /** Send full resolvedConfig only once per stream session. */
     resolvedConfigForwarded = false;
-    constructor(timings = {}) {
+    constructor(timings = {}, deps = {}) {
         this.timings = { ...DEFAULT_TIMINGS, ...timings };
+        this.linkSource = deps.linkSource ?? storeLinkSource;
+    }
+    /**
+     * Fail fast if glasses aren't connected — BEFORE provisioning. Without this a
+     * managed start would create a provider live input, fail the BLE command, and
+     * tear the input down again: a slow, billable no-op with a confusing error.
+     */
+    assertGlassesConnected() {
+        if (!this.linkSource.isConnected()) {
+            throw new StreamConflictError("GLASSES_NOT_CONNECTED", "Glasses are not connected", "command", "ble");
+        }
+    }
+    /** True while the active stream is parked on a dropped BLE link. */
+    isSuspended() {
+        return this.suspended !== null;
     }
     /**
      * Run `work` under the transition lock. Each call awaits the previous
@@ -146,7 +190,11 @@ export class PhoneStreamCoordinator {
     /** Report-safe stream ownership snapshot for incident diagnostics. */
     getDiagnosticSnapshot() {
         if (!this.current)
-            return { active: false };
+            return { active: false, pendingBleStop: this.pendingBleStop?.streamId ?? null };
+        const link = {
+            suspended: this.suspended !== null,
+            ...(this.suspended ? { suspendedForMs: Date.now() - this.suspended.since } : {}),
+        };
         return this.current.kind === "managed"
             ? {
                 active: true,
@@ -155,12 +203,14 @@ export class PhoneStreamCoordinator {
                 subscribers: [...this.current.subscribers].sort(),
                 mode: this.current.mode,
                 playbackReady: this.current.hlsReady,
+                ...link,
             }
             : {
                 active: true,
                 kind: this.current.kind,
                 streamId: this.current.streamId,
                 ownerPackageName: this.current.packageName,
+                ...link,
             };
     }
     async startUnmanaged(packageName, opts) {
@@ -169,7 +219,7 @@ export class PhoneStreamCoordinator {
         if (!opts.streamUrl || typeof opts.streamUrl !== "string") {
             throw new StreamConflictError("STREAM_URL_REQUIRED", "streamUrl is required");
         }
-        assertGlassesConnected();
+        this.assertGlassesConnected();
         return this.runExclusive(async () => {
             if (this.current) {
                 throw new StreamConflictError("STREAM_ALREADY_ACTIVE", `A ${this.current.kind} stream is already active. Stop it before starting a new one.`);
@@ -195,6 +245,7 @@ export class PhoneStreamCoordinator {
                     ...(opts.video !== undefined ? { video: opts.video } : {}),
                     ...(opts.audio !== undefined ? { audio: opts.audio } : {}),
                     ...(opts.authToken ? { authToken: opts.authToken } : {}),
+                    ...(typeof opts.captureAudio === "boolean" ? { captureAudio: opts.captureAudio } : {}),
                 });
                 const result = publisherStartResult(streamId, event);
                 this.startLifecycle(streamId);
@@ -219,7 +270,7 @@ export class PhoneStreamCoordinator {
         // Two-phase: the entry-claim runs under the transition lock; the wait for
         // HLS readiness happens AFTER the lock releases so a long warm-up doesn't
         // block subsequent start/stop transitions on this coordinator.
-        assertGlassesConnected();
+        this.assertGlassesConnected();
         const decision = await this.runExclusive(async () => {
             if (this.current && this.current.kind === "unmanaged") {
                 throw new StreamConflictError("STREAM_ALREADY_ACTIVE", "An unmanaged stream is already active. Stop it before starting a managed stream.");
@@ -279,6 +330,7 @@ export class PhoneStreamCoordinator {
                     // See startUnmanaged: the native bridge rejects explicit `undefined`.
                     ...(opts.video !== undefined ? { video: opts.video } : {}),
                     ...(opts.audio !== undefined ? { audio: opts.audio } : {}),
+                    ...(typeof opts.captureAudio === "boolean" ? { captureAudio: opts.captureAudio } : {}),
                 });
                 entry.publisherStart = publisherStartResult(streamId, event);
                 console.info("[STREAM_STARTUP]", {
@@ -396,13 +448,120 @@ export class PhoneStreamCoordinator {
         this.lifecycle?.handleAck(event.ackId);
     }
     // ===========================================================================
+    // BLE link suspension
+    // ===========================================================================
+    attachLink() {
+        if (this.unsubscribeLink)
+            return;
+        this.unsubscribeLink = this.linkSource.subscribe((connected) => this.handleLinkChange(connected));
+    }
+    detachLinkIfIdle() {
+        if (this.current || this.pendingBleStop || !this.unsubscribeLink)
+            return;
+        this.unsubscribeLink();
+        this.unsubscribeLink = null;
+    }
+    handleLinkChange(connected) {
+        if (connected) {
+            if (this.current && this.suspended) {
+                this.resumeLocked();
+            }
+            else if (!this.current && this.pendingBleStop) {
+                this.flushPendingBleStop();
+            }
+            return;
+        }
+        if (this.current && !this.suspended)
+            this.suspend();
+    }
+    suspend() {
+        const entry = this.current;
+        if (!entry)
+            return;
+        const since = Date.now();
+        // Pause the heartbeat: misses now would be our own fault, not the
+        // publisher's, and counting them would reap a stream that is still live.
+        this.lifecycle?.setActive(false);
+        const graceTimer = setTimeout(() => this.onGraceExpired(entry.streamId), this.timings.glassesGraceMs);
+        this.suspended = { since, graceTimer, publisherGoneProbes: 0 };
+        console.warn("[STREAM] BLE link lost; stream suspended", {
+            streamId: entry.streamId,
+            graceMs: this.timings.glassesGraceMs,
+        });
+        this.fanout({
+            streamId: entry.streamId,
+            source: "coordinator",
+            status: LINK_STATUS.suspended,
+            data: { reason: LINK_STATUS.reason, graceMs: this.timings.glassesGraceMs, since },
+        });
+    }
+    resumeLocked() {
+        const entry = this.current;
+        const suspended = this.suspended;
+        if (!entry || !suspended)
+            return;
+        clearTimeout(suspended.graceTimer);
+        this.suspended = null;
+        const suspendedMs = Date.now() - suspended.since;
+        console.info("[STREAM] BLE link back; stream resumed", { streamId: entry.streamId, suspendedMs });
+        // Resume and heartbeat immediately: the glasses watchdog has been running
+        // the whole time, so the first keep-alive must not wait another interval.
+        this.lifecycle?.setActive(true);
+        this.lifecycle?.tickNow();
+        // A resumed session is a fresh status baseline for subscribers.
+        this.lastFanoutSignature = null;
+        this.fanout({
+            streamId: entry.streamId,
+            source: "coordinator",
+            status: LINK_STATUS.resumed,
+            data: { reason: LINK_STATUS.reason, suspendedMs },
+        });
+    }
+    onGraceExpired(streamId) {
+        if (this.current?.streamId !== streamId || !this.suspended)
+            return;
+        this.failSuspended(streamId, "glasses_disconnected", { publisherGone: false });
+    }
+    /**
+     * End a suspended stream. `publisherGone` distinguishes "glasses are off and
+     * Cloudflare confirms nothing is publishing" from "grace ran out with the
+     * publisher possibly still alive" — miniapps word the two differently.
+     */
+    failSuspended(streamId, reason, detail) {
+        this.fanout({
+            streamId,
+            source: "coordinator",
+            status: "error",
+            data: { reason: LINK_STATUS.reason, teardownReason: reason, ...detail },
+        });
+        void this.runExclusive(async () => {
+            if (this.current?.streamId !== streamId)
+                return;
+            await this.teardownLocked(reason);
+        });
+    }
+    flushPendingBleStop() {
+        const pending = this.pendingBleStop;
+        if (!pending)
+            return;
+        this.pendingBleStop = null;
+        console.info("[STREAM] BLE link back; sending deferred stopStream", pending);
+        void BluetoothSdk.stopStream()
+            .catch((err) => console.warn("[STREAM] deferred stopStream failed:", err))
+            .finally(() => this.detachLinkIfIdle());
+    }
+    // ===========================================================================
     // Internal
     // ===========================================================================
     mintId(prefix) {
         this.idCounter += 1;
         return `phone-${prefix}-${Date.now().toString(36)}-${this.idCounter}`;
     }
+    /** BLE keep-alives. StreamLifecycleController uses BgTimer so they survive MentraOS backgrounding. */
     startLifecycle(streamId) {
+        // A new stream supersedes any deferred stop for the previous one.
+        this.pendingBleStop = null;
+        this.attachLink();
         this.lifecycle?.dispose();
         const ctrl = new StreamLifecycleController({
             logger: consoleLogger,
@@ -475,6 +634,21 @@ export class PhoneStreamCoordinator {
                     status: status.isConnected ? "connected" : "disconnected",
                     data: status,
                 });
+                // While the BLE link is down, Cloudflare is the only witness to the
+                // publisher. Two consecutive "nobody is publishing" probes mean the
+                // glasses are off, not merely out of Bluetooth range — stop waiting.
+                if (this.suspended) {
+                    if (status.isConnected) {
+                        this.suspended.publisherGoneProbes = 0;
+                    }
+                    else {
+                        this.suspended.publisherGoneProbes += 1;
+                        if (this.suspended.publisherGoneProbes >= this.timings.suspendedPublisherGoneProbes) {
+                            this.failSuspended(entry.streamId, "glasses_disconnected_publisher_gone", { publisherGone: true });
+                            keepPolling = false;
+                        }
+                    }
+                }
                 // webrtc mode readiness: first "connected" means WHEP playback is
                 // available (WebRTC playback follows the ingest directly; there is no
                 // manifest to probe).
@@ -652,11 +826,25 @@ export class PhoneStreamCoordinator {
         const sendBleStop = options.sendBleStop !== false;
         this.lastFanoutSignature = null;
         this.resolvedConfigForwarded = false;
+        if (this.suspended) {
+            clearTimeout(this.suspended.graceTimer);
+            this.suspended = null;
+        }
         // Dispose the lifecycle controller immediately so it doesn't fire one
         // more keep-alive against a stream we're tearing down. The transition
         // lock guarantees no new lifecycle is started concurrently.
         this.lifecycle?.dispose();
         this.lifecycle = null;
+        // With the link down a BLE write can only fail (and hold the transition
+        // lock for the native timeout). Defer it to the next reconnect instead.
+        const linkUp = this.linkSource.isConnected();
+        if (sendBleStop && !linkUp) {
+            this.pendingBleStop = { streamId: entry.streamId };
+            console.warn("[STREAM] BLE link down during teardown; stopStream deferred", {
+                streamId: entry.streamId,
+                reason,
+            });
+        }
         if (entry.kind === "managed") {
             if (entry.cloudflareTimer)
                 clearTimeout(entry.cloudflareTimer);
@@ -670,7 +858,7 @@ export class PhoneStreamCoordinator {
             entry.hlsReadyRejecters = [];
         }
         try {
-            if (sendBleStop) {
+            if (sendBleStop && linkUp) {
                 await BluetoothSdk.stopStream();
             }
         }
@@ -684,6 +872,7 @@ export class PhoneStreamCoordinator {
             // serializes us, so this should always be true).
             if (this.current === entry)
                 this.current = null;
+            this.detachLinkIfIdle();
             if (entry.kind === "managed") {
                 // Start remote cleanup only after the publisher has stopped, but do not
                 // hold the local transition lock on an unbounded network request. The