@mentra/engine 0.1.0-dev.0 → 3.1.0-dev.10

package/build/services/LocalDisplayManager.js

@@ -44,6 +44,12 @@ const BOOT_DURATION_MS = 1500;
 const BACKGROUND_LOCK_TIMEOUT_MS = 10_000;
 // Sentinel package name used as the "source" of the system boot message.
 const SYSTEM_BOOT_PKG = "system.boot";
+/** "Render nothing" — an empty scene or an explicit clear_view layout. */
+function isClearPayload(payload) {
+    if (payload.scene)
+        return payload.scene.length === 0;
+    return payload.layout?.layoutType === "clear_view";
+}
 // =============================================================================
 // LocalDisplayManager
 // =============================================================================
@@ -79,13 +85,19 @@ class LocalDisplayManager {
      */
     onMount(packageName, displayName) {
         console.log(`${LOG_TAG}: onMount(${packageName}, "${displayName}")`);
-        // Cancel any in-flight boot for a prior app.
-        this.cancelBoot();
         // Snapshot whatever's on the glasses BEFORE the boot text overwrites it.
         // registerApp fires onMount for every spawn — including a background app or
         // a crash-respawn while another app is foreground — so a boot that times out
         // without rendering must put the prior frame back rather than blank it.
-        const preBoot = this.currentDisplay;
+        // Never snapshot the boot text itself: back-to-back mounts (the autostart
+        // restore loop, crash-respawn chains) land while the previous app's
+        // "Starting X…" is still on the glasses, and endBoot would "restore" that
+        // stale, expiry-less frame permanently. Across chained boots, inherit the
+        // original pre-boot frame instead.
+        const inherited = this.bootingApp ? this.bootingApp.preBoot : this.currentDisplay;
+        const preBoot = inherited?.packageName === SYSTEM_BOOT_PKG ? null : inherited;
+        // Cancel any in-flight boot for a prior app.
+        this.cancelBoot();
         // Send the boot message directly (bypass arbitration — this is a system
         // display). Goes through sendNow so scene devices render it as a scene:
         // otherwise every app start would be a legacy→scene transition on the
@@ -95,7 +107,7 @@ class LocalDisplayManager {
             layout: { layoutType: "text_wall", text: `Starting ${displayName}…` },
         });
         const timerId = BgTimer.setTimeout(() => {
-            this.endBoot(/* triggeredByFirstDisplay */ false);
+            this.endBoot();
         }, BOOT_DURATION_MS);
         this.bootingApp = {
             packageName,
@@ -123,14 +135,38 @@ class LocalDisplayManager {
             this.coreAppDisplay = null;
         }
     }
+    /** Report-safe ownership snapshot for incident diagnostics. */
+    getDiagnosticSnapshot() {
+        return {
+            coreAppPackageName: this.coreApp,
+            currentDisplayPackageName: this.currentDisplay?.packageName ?? null,
+            backgroundLockPackageName: this.backgroundLock?.packageName ?? null,
+            bootingPackageName: this.bootingApp?.packageName ?? null,
+        };
+    }
     /**
      * A local miniapp is going away. Clean up all state associated with it.
      */
     onUnmount(packageName) {
         console.log(`${LOG_TAG}: onUnmount(${packageName})`);
-        // If this was the booting app, cancel boot.
+        // If this was the booting app, cancel boot — and don't strand its
+        // "Starting X…" text (a system frame with no expiry): put back what the
+        // boot covered, or clear.
         if (this.bootingApp?.packageName === packageName) {
+            const preBoot = this.bootingApp.preBoot;
             this.cancelBoot();
+            if (this.currentDisplay?.packageName === SYSTEM_BOOT_PKG) {
+                // The preBoot owner may have forfeited its frame during the boot
+                // window (a clear parked in the boot queue) — don't resurrect it.
+                const ownerQueued = preBoot ? this.bootQueue.get(preBoot.packageName) : undefined;
+                const preBootForfeited = ownerQueued !== undefined && isClearPayload(ownerQueued.payload);
+                if (preBoot && !preBootForfeited && (preBoot.expiresAt === null || preBoot.expiresAt > this.now())) {
+                    this.restoreDisplay(preBoot);
+                }
+                else {
+                    this.sendClear();
+                }
+            }
         }
         this.bootQueue.get(packageName)?.resolve?.({ status: "blocked", reason: "app stopped" });
         this.bootQueue.delete(packageName);
@@ -140,10 +176,17 @@ class LocalDisplayManager {
         if (this.backgroundLock?.packageName === packageName) {
             this.backgroundLock = null;
         }
-        // Clear saved core app display if the core is going away.
+        // Drop the saved core frame if the core's context is going away — the
+        // frame belongs to a dead context and must not be restored later. The
+        // coreApp POINTER itself is NOT cleared here: it is derived state owned
+        // by the apps-store reconciler. A liveness/crash respawn tears the
+        // context down (this path) without any store change — the app is still
+        // "running" — and clearing the pointer here would leave the respawned
+        // foreground app arbitrating as background until an unrelated store
+        // write happened to re-run the reconciler. Real stops release the slot
+        // via the store (running → false → reconciler → onCoreAppChange(null)).
         if (this.coreApp === packageName) {
             this.coreAppDisplay = null;
-            this.coreApp = null;
         }
         // If this app owned the current on-glasses display, clear it (and maybe
         // restore the core app's display if it still has time left).
@@ -183,12 +226,21 @@ class LocalDisplayManager {
             superseded?.resolve?.({ status: "blocked", reason: "superseded by a newer frame" });
             this.bootQueue.set(packageName, { payload, resolve });
             if (this.bootingApp.packageName === packageName) {
-                this.endBoot(/* triggeredByFirstDisplay */ true);
+                this.endBoot();
             }
             return;
         }
         this.arbitrateAndSend(packageName, payload, resolve);
     }
+    /**
+     * End a package's temporary display early. If it currently owns the main
+     * view, release its background lock and restore the foreground miniapp's
+     * saved frame. A dismissal for a package that is no longer visible is a
+     * no-op.
+     */
+    dismiss(packageName) {
+        this.handleExpiry(packageName);
+    }
     // ===========================================================================
     // Internals — arbitration
     // ===========================================================================
@@ -198,6 +250,15 @@ class LocalDisplayManager {
         if (this.backgroundLock && now > this.backgroundLock.expiresAt) {
             this.backgroundLock = null;
         }
+        // A clear ("render nothing") means "I'm done with the display" — it is a
+        // forfeit, not a frame. A background app releases its lock and the core
+        // app's still-valid display comes back; treating it as a render instead
+        // would RENEW the lock with an empty frame and blank the glasses while
+        // still blocking everyone else.
+        if (isClearPayload(payload)) {
+            this.handleAppClear(packageName, resolve);
+            return;
+        }
         const isCore = packageName === this.coreApp;
         if (isCore) {
             // Save so we can restore later.
@@ -246,6 +307,30 @@ class LocalDisplayManager {
         }
         this.sendNow(packageName, payload, resolve);
     }
+    /**
+     * An app cleared its display ("render nothing"). Same semantics as its
+     * frame expiring: give up ownership, restore the core app's still-valid
+     * display if there is one, otherwise clear the glasses.
+     */
+    handleAppClear(packageName, resolve) {
+        // Forget the app's retained scene state — its next render starts fresh.
+        sceneRenderer.clearApp(packageName);
+        if (this.backgroundLock?.packageName === packageName) {
+            this.backgroundLock = null;
+        }
+        if (this.coreApp === packageName) {
+            this.coreAppDisplay = null;
+        }
+        if (this.currentDisplay?.packageName === packageName) {
+            this.clearExpiryTimer();
+            this.currentDisplay = null;
+            this.tryRestoreCoreDisplay();
+            if (!this.currentDisplay) {
+                this.sendClear();
+            }
+        }
+        resolve?.({ status: "displayed" });
+    }
     // ===========================================================================
     // Internals — send
     // ===========================================================================
@@ -411,7 +496,7 @@ class LocalDisplayManager {
         BgTimer.clearTimeout(this.bootingApp.timerId);
         this.bootingApp = null;
     }
-    endBoot(triggeredByFirstDisplay) {
+    endBoot() {
         if (!this.bootingApp)
             return;
         const preBoot = this.bootingApp.preBoot;
@@ -430,17 +515,18 @@ class LocalDisplayManager {
                 continue;
             this.arbitrateAndSend(pkg, entry.payload, entry.resolve);
         }
-        // Boot ended on the timeout with nothing queued and no first display — the
-        // app just never rendered. Restore whatever was on the glasses before the
-        // boot text so a background app or crash-respawn can't blank a foreground
-        // app's frame (registerApp fires onMount for every spawn, and the core app
-        // isn't wired on the local path yet). If the glasses were empty before,
-        // clear the lingering "Starting …" instead — otherwise a miniapp that never
-        // renders (e.g. audio-only) would strand it.
-        if (!triggeredByFirstDisplay && queued.length === 0) {
-            // Only restore a frame that's still valid — one whose duration elapsed
-            // during the boot window should clear, not come back.
-            if (preBoot && (preBoot.expiresAt === null || preBoot.expiresAt > this.now())) {
+        // If the boot text is still on the glasses — nothing was queued, or every
+        // drained request lost arbitration — it must not strand: it's a system
+        // frame with no expiry. Restore whatever was on the glasses before the
+        // boot, else clear. Two reasons NOT to restore: the frame's duration
+        // elapsed during the boot window, or its owner FORFEITED it during the
+        // window (its final queued intent — the queue keeps last-wins per app —
+        // was a clear, which the drain above processed as a forfeit; restoring
+        // would resurrect content the clear removed).
+        if (this.currentDisplay?.packageName === SYSTEM_BOOT_PKG) {
+            const ownerEntry = preBoot ? queued.find(([pkg]) => pkg === preBoot.packageName) : undefined;
+            const preBootForfeited = ownerEntry !== undefined && isClearPayload(ownerEntry[1].payload);
+            if (preBoot && !preBootForfeited && (preBoot.expiresAt === null || preBoot.expiresAt > this.now())) {
                 this.restoreDisplay(preBoot);
             }
             else {

package/build/services/LocalDisplayManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalDisplayManager.js","sourceRoot":"","sources":["../../src/services/LocalDisplayManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * LocalDisplayManager\n *\n * Phone-side arbiter for display requests originating from LOCAL miniapps\n * (the @mentra/miniapp SDK). Mirrors the user-facing behavior of the cloud\n * DisplayManager (cloud/packages/cloud/src/services/layout/DisplayManager6.1.ts)\n * for the features that matter on the phone:\n *\n *   - boot message (\"Starting <AppName>…\") with a bounded window\n *   - durationMs auto-clear\n *   - core-app vs background-app arbitration with a background lock\n *\n * Scope is deliberately local-only. Cloud-originated displays are untouched\n * and may race with local displays during dev; that's acceptable per plan\n * (agents/local-display-manager-plan.md).\n *\n * Display pacing is NOT done here. A JS-side ~300ms throttle used to live in\n * this class, but JS timers (and therefore the throttle's trailing flush) do\n * not fire on schedule while the iOS app is suspended in the background — so\n * under streaming captions, updates accumulated and then flushed in a burst on\n * the next wake. Pacing + last-wins coalescing now live in the native per-device\n * queue (e.g. G2's event-driven EvenHub queue), which drains off the same BLE\n * events that wake the process. This class forwards every request straight\n * through; the native layer collapses redundant frames per display target.\n *\n * The remaining BgTimer use (boot window, durationMs expiry) is timing that\n * does not need sub-second background fidelity.\n */\n\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport displayProcessor from \"./DisplayProcessor\"\nimport {useDisplayStore} from \"../stores/display\"\nimport sceneRenderer from \"./SceneRenderer\"\nimport {isGlassesConnected} from \"./GlassesReadiness\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport type {SceneElementInput} from \"../utils/display/scene\"\nimport {BgTimer} from \"../utils/timers\"\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface DisplayPayload {\n  view?: \"main\" | \"dashboard\" | string\n  /** Legacy layout (sugar / old bundles / cloud shapes). Either this or `scene`. */\n  layout?: {layoutType: string; [key: string]: unknown}\n  /** Scene elements from display.render(). Either this or `layout`. */\n  scene?: SceneElementInput[]\n  durationMs?: number\n}\n\n/** Outcome delivered to an awaiting render() call (REQUEST_RESULT payload). */\nexport interface DisplayRequestResult {\n  status: \"displayed\" | \"blocked\"\n  degraded?: boolean\n  dropped?: string[]\n  reason?: string\n}\n\nexport type DisplayRequestResolver = (result: DisplayRequestResult) => void\n\ninterface ActiveDisplay {\n  packageName: string\n  processedEvent: Record<string, unknown>\n  /** Set when this display is a scene — restore goes through SceneRenderer replay. */\n  scene?: SceneElementInput[]\n  expiresAt: number | null\n}\n\ninterface BootingApp {\n  packageName: string\n  displayName: string\n  startedAt: number\n  timerId: number\n  /** Whatever was on the glasses when this boot started, so a boot that times\n   * out without the app rendering can restore it instead of blanking a frame\n   * another (e.g. foreground) app owns. Null if the glasses were empty. */\n  preBoot: ActiveDisplay | null\n}\n\ninterface BackgroundLock {\n  packageName: string\n  acquiredAt: number\n  expiresAt: number\n  lastActiveTime: number\n}\n\n// =============================================================================\n// Constants\n// =============================================================================\n\nconst LOG_TAG = \"LOCAL_DISPLAY\"\nconst BOOT_DURATION_MS = 1500\n// Mirrors cloud lease for a bg app holding the display. The bg app has to\n// keep driving the display to hold the lock; if it goes quiet and the core\n// app wants the screen, we release.\nconst BACKGROUND_LOCK_TIMEOUT_MS = 10_000\n// Sentinel package name used as the \"source\" of the system boot message.\nconst SYSTEM_BOOT_PKG = \"system.boot\"\n\n// =============================================================================\n// LocalDisplayManager\n// =============================================================================\n\nclass LocalDisplayManager {\n  private static instance: LocalDisplayManager | null = null\n\n  private coreApp: string | null = null\n  private coreAppDisplay: ActiveDisplay | null = null\n  private currentDisplay: ActiveDisplay | null = null\n  private backgroundLock: BackgroundLock | null = null\n\n  private bootingApp: BootingApp | null = null\n  private bootQueue: Map<string, {payload: DisplayPayload; resolve?: DisplayRequestResolver}> = new Map()\n\n  private expiryTimerId: number | null = null\n\n  /** Reconnect-replay subscription state (attachToRuntime). */\n  private runtimeAttached = false\n  private glassesWasConnected = false\n  private unsubscribeGlassesStatus: (() => void) | null = null\n\n  /** Injectable for tests. */\n  private now: () => number = () => Date.now()\n\n  private constructor() {}\n\n  public static getInstance(): LocalDisplayManager {\n    if (!LocalDisplayManager.instance) {\n      LocalDisplayManager.instance = new LocalDisplayManager()\n    }\n    return LocalDisplayManager.instance\n  }\n\n  // ===========================================================================\n  // Lifecycle API (called from MiniappHost)\n  // ===========================================================================\n\n  /**\n   * A new local miniapp just mounted. Start the boot window.\n   * Calling this for a different pkg while another is booting cancels the\n   * previous boot.\n   */\n  public onMount(packageName: string, displayName: string): void {\n    console.log(`${LOG_TAG}: onMount(${packageName}, \"${displayName}\")`)\n\n    // Cancel any in-flight boot for a prior app.\n    this.cancelBoot()\n\n    // Snapshot whatever's on the glasses BEFORE the boot text overwrites it.\n    // registerApp fires onMount for every spawn — including a background app or\n    // a crash-respawn while another app is foreground — so a boot that times out\n    // without rendering must put the prior frame back rather than blank it.\n    const preBoot = this.currentDisplay\n\n    // Send the boot message directly (bypass arbitration — this is a system\n    // display). Goes through sendNow so scene devices render it as a scene:\n    // otherwise every app start would be a legacy→scene transition on the\n    // glasses (which costs a blanking clear).\n    this.sendNow(SYSTEM_BOOT_PKG, {\n      view: \"main\",\n      layout: {layoutType: \"text_wall\", text: `Starting ${displayName}…`},\n    })\n\n    const timerId = BgTimer.setTimeout(() => {\n      this.endBoot(/* triggeredByFirstDisplay */ false)\n    }, BOOT_DURATION_MS)\n\n    this.bootingApp = {\n      packageName,\n      displayName,\n      startedAt: this.now(),\n      timerId,\n      preBoot,\n    }\n    this.bootQueue.clear()\n  }\n\n  /**\n   * Mark which miniapp is the \"core\" (foreground) app. Pass null when no local\n   * miniapp is foreground.\n   */\n  public onCoreAppChange(packageName: string | null): void {\n    if (this.coreApp === packageName) return\n    console.log(`${LOG_TAG}: onCoreAppChange(${packageName ?? \"null\"})`)\n\n    this.coreApp = packageName\n\n    // No core app means no saved frame to restore on the next unmount.\n    // Without this, the previous core's last frame can flicker back onto\n    // the glasses when the user-initiated clear is followed by an\n    // onUnmount that still finds a populated coreAppDisplay.\n    if (packageName === null) {\n      this.coreAppDisplay = null\n    }\n  }\n\n  /**\n   * A local miniapp is going away. Clean up all state associated with it.\n   */\n  public onUnmount(packageName: string): void {\n    console.log(`${LOG_TAG}: onUnmount(${packageName})`)\n\n    // If this was the booting app, cancel boot.\n    if (this.bootingApp?.packageName === packageName) {\n      this.cancelBoot()\n    }\n    this.bootQueue.get(packageName)?.resolve?.({status: \"blocked\", reason: \"app stopped\"})\n    this.bootQueue.delete(packageName)\n\n    // Forget the app's retained scenes — nothing left to replay for it.\n    sceneRenderer.clearApp(packageName)\n\n    // Release bg lock if this app held it.\n    if (this.backgroundLock?.packageName === packageName) {\n      this.backgroundLock = null\n    }\n\n    // Clear saved core app display if the core is going away.\n    if (this.coreApp === packageName) {\n      this.coreAppDisplay = null\n      this.coreApp = null\n    }\n\n    // If this app owned the current on-glasses display, clear it (and maybe\n    // restore the core app's display if it still has time left).\n    if (this.currentDisplay?.packageName === packageName) {\n      this.clearExpiryTimer()\n      this.currentDisplay = null\n      this.tryRestoreCoreDisplay()\n      if (!this.currentDisplay) {\n        // Nothing to restore → clear the glasses.\n        this.sendClear()\n      }\n    }\n  }\n\n  // ===========================================================================\n  // Display request API (called from LocalMiniappRuntime.handleDisplay)\n  // ===========================================================================\n\n  /**\n   * A miniapp requested a display. Routes through boot queue, arbitration,\n   * and throttle. This is the only public entry point for miniapp display\n   * traffic on the local path.\n   *\n   * `resolve`, when provided (render() requests), is guaranteed to be called\n   * exactly once with the request's outcome — including for requests parked in\n   * the boot queue (resolved when drained or superseded).\n   */\n  public request(packageName: string, payload: DisplayPayload, resolve?: DisplayRequestResolver): void {\n    // Dashboard view: pass straight through (no throttle/arbitration). Local\n    // dashboard rendering is currently a stub on the phone anyway.\n    if (payload.view === \"dashboard\") {\n      this.sendNow(packageName, payload, resolve)\n      return\n    }\n\n    // During boot, any app's requests go into the queue. If the booting app\n    // itself makes its first display call, end boot early and drain.\n    if (this.bootingApp) {\n      const superseded = this.bootQueue.get(packageName)\n      superseded?.resolve?.({status: \"blocked\", reason: \"superseded by a newer frame\"})\n      this.bootQueue.set(packageName, {payload, resolve})\n      if (this.bootingApp.packageName === packageName) {\n        this.endBoot(/* triggeredByFirstDisplay */ true)\n      }\n      return\n    }\n\n    this.arbitrateAndSend(packageName, payload, resolve)\n  }\n\n  // ===========================================================================\n  // Internals — arbitration\n  // ===========================================================================\n\n  private arbitrateAndSend(packageName: string, payload: DisplayPayload, resolve?: DisplayRequestResolver): void {\n    const now = this.now()\n\n    // Expire a stale bg lock before arbitrating.\n    if (this.backgroundLock && now > this.backgroundLock.expiresAt) {\n      this.backgroundLock = null\n    }\n\n    const isCore = packageName === this.coreApp\n\n    if (isCore) {\n      // Save so we can restore later.\n      this.coreAppDisplay = {\n        packageName,\n        processedEvent: {}, // filled by sendNow\n        scene: payload.scene,\n        expiresAt: payload.durationMs ? now + payload.durationMs : null,\n      }\n\n      // If a bg app holds the lock AND is currently on the glasses, core is\n      // blocked. The saved coreAppDisplay surfaces when the bg app expires\n      // or unmounts.\n      const bgHoldsAndDisplays =\n        this.backgroundLock &&\n        this.currentDisplay &&\n        this.currentDisplay.packageName === this.backgroundLock.packageName\n      if (bgHoldsAndDisplays) {\n        resolve?.({status: \"blocked\", reason: \"a background app holds the display\"})\n        return\n      }\n\n      // Core can display. If a bg lock exists but holder isn't actively on\n      // the glasses, release it.\n      if (this.backgroundLock && !bgHoldsAndDisplays) {\n        this.backgroundLock = null\n      }\n\n      this.sendNow(packageName, payload, resolve)\n      return\n    }\n\n    // Non-core: this is a background app.\n    if (this.backgroundLock && this.backgroundLock.packageName !== packageName) {\n      // Another bg app already holds the lock — drop.\n      resolve?.({status: \"blocked\", reason: \"another background app holds the display\"})\n      return\n    }\n\n    // Acquire or bump the lock.\n    if (!this.backgroundLock) {\n      this.backgroundLock = {\n        packageName,\n        acquiredAt: now,\n        expiresAt: now + BACKGROUND_LOCK_TIMEOUT_MS,\n        lastActiveTime: now,\n      }\n    } else {\n      this.backgroundLock.lastActiveTime = now\n      this.backgroundLock.expiresAt = now + BACKGROUND_LOCK_TIMEOUT_MS\n    }\n\n    this.sendNow(packageName, payload, resolve)\n  }\n\n  // ===========================================================================\n  // Internals — send\n  // ===========================================================================\n\n  private sendNow(packageName: string, payload: DisplayPayload, resolve?: DisplayRequestResolver): void {\n    const expiresAt = payload.durationMs ? this.now() + payload.durationMs : null\n    const view = (payload.view === \"dashboard\" ? \"dashboard\" : \"main\") as \"main\" | \"dashboard\"\n\n    // Scene requests — and legacy layouts a positioning device can render as a\n    // scene (sugar, old bundles) — go through the scene pipeline. Everything\n    // else stays on the legacy path.\n    let sceneElements = payload.scene ?? null\n    if (!sceneElements && payload.layout) {\n      const caps = sceneRenderer.currentCapabilities()\n      if (caps?.canPosition) {\n        sceneElements = sceneRenderer.convertLegacyLayout(payload.layout, caps)\n      }\n    }\n\n    if (sceneElements) {\n      this.sendScene(packageName, view, sceneElements, expiresAt, resolve)\n    } else if (payload.layout) {\n      // This layout bypasses the scene pipeline (clear_view, dashboard_card,\n      // unknown types, or a non-positioning device). If this (app, view) had a\n      // retained scene, the glasses no longer match it — reset the diff\n      // baseline so the next render() repaints from empty instead of skipping\n      // \"unchanged\" elements.\n      sceneRenderer.resetBaseline(packageName, view)\n      const rawEvent: Record<string, unknown> = {\n        view: payload.view ?? \"main\",\n        layout: payload.layout,\n      }\n      if (payload.durationMs !== undefined) {\n        rawEvent.durationMs = payload.durationMs\n      }\n      this.sendToNative(packageName, rawEvent, expiresAt)\n      resolve?.({status: \"displayed\"})\n    } else {\n      // A scene payload on a device with no display block at all.\n      resolve?.({status: \"blocked\", reason: \"no display connected\"})\n      return\n    }\n\n    // If core app fired, refresh the saved snapshot with the actual processed\n    // event so restore uses the wrapped text (legacy) / the retained scene.\n    if (packageName === this.coreApp && this.currentDisplay) {\n      this.coreAppDisplay = {\n        packageName,\n        processedEvent: this.currentDisplay.processedEvent,\n        scene: this.currentDisplay.scene,\n        expiresAt: this.currentDisplay.expiresAt,\n      }\n    }\n  }\n\n  /**\n   * Send a scene through SceneRenderer. On positioning devices this emits a\n   * SceneFrame; on degrade devices SceneRenderer hands back a legacy layout\n   * that rides the existing (unchanged) DisplayProcessor path.\n   */\n  private sendScene(\n    packageName: string,\n    view: \"main\" | \"dashboard\",\n    elements: SceneElementInput[],\n    expiresAt: number | null,\n    resolve?: DisplayRequestResolver,\n  ): void {\n    const result = sceneRenderer.emitScene(packageName, view, elements)\n\n    if (result.kind === \"no-display\") {\n      resolve?.({status: \"blocked\", reason: \"no display connected\"})\n      return\n    }\n\n    if (result.kind === \"legacy\") {\n      if (result.layout) {\n        this.sendToNative(packageName, {view, layout: result.layout}, expiresAt)\n      } else {\n        // Scene degraded to nothing (e.g. all-image scene on a text-only\n        // device). render() replaces the frame, so nothing means clear.\n        this.sendClear()\n      }\n      resolve?.({status: \"displayed\", degraded: result.degraded, dropped: result.dropped})\n      return\n    }\n\n    this.currentDisplay = {packageName, processedEvent: {}, scene: elements, expiresAt}\n    this.clearExpiryTimer()\n    if (expiresAt !== null) {\n      const delay = Math.max(0, expiresAt - this.now())\n      this.expiryTimerId = BgTimer.setTimeout(() => {\n        this.expiryTimerId = null\n        this.handleExpiry(packageName)\n      }, delay)\n    }\n    resolve?.({status: \"displayed\", degraded: result.degraded, dropped: result.dropped})\n  }\n\n  private sendToNative(packageName: string, rawEvent: Record<string, unknown>, expiresAt: number | null): void {\n    let processedEvent: Record<string, unknown>\n    try {\n      processedEvent = displayProcessor.processDisplayEvent(rawEvent as any)\n    } catch (err) {\n      console.error(`${LOG_TAG}: DisplayProcessor error, using raw event:`, err)\n      processedEvent = rawEvent\n    }\n\n    try {\n      // The display output path is a direct btsdk call now (was a host sendDisplayEvent\n      // hook) so a bare OEM renders to the glasses without wiring it.\n      void Promise.resolve(BluetoothSdk.displayEvent(processedEvent)).catch((err) => {\n        console.error(`${LOG_TAG}: native display failed:`, err)\n      })\n      // The mirror store also lives in engine, so display requests update the\n      // phone-side preview without any host hook.\n      useDisplayStore.getState().setDisplayEvent(JSON.stringify(processedEvent))\n    } catch (err) {\n      console.error(`${LOG_TAG}: native display failed:`, err)\n    }\n\n    this.currentDisplay = {packageName, processedEvent, expiresAt}\n\n    this.clearExpiryTimer()\n    if (expiresAt !== null) {\n      const delay = Math.max(0, expiresAt - this.now())\n      this.expiryTimerId = BgTimer.setTimeout(() => {\n        this.expiryTimerId = null\n        this.handleExpiry(packageName)\n      }, delay)\n    }\n  }\n\n  private handleExpiry(packageName: string): void {\n    // Someone else is on the glasses now — ignore.\n    if (!this.currentDisplay || this.currentDisplay.packageName !== packageName) {\n      return\n    }\n\n    // Release the lock if it belonged to this (bg) app.\n    if (this.backgroundLock?.packageName === packageName) {\n      this.backgroundLock = null\n    }\n\n    this.currentDisplay = null\n    this.tryRestoreCoreDisplay()\n    if (!this.currentDisplay) {\n      this.sendClear()\n    }\n  }\n\n  private tryRestoreCoreDisplay(): void {\n    if (!this.coreAppDisplay) return\n    // If the core snapshot has a duration and it's already elapsed, skip.\n    if (this.coreAppDisplay.expiresAt !== null && this.now() >= this.coreAppDisplay.expiresAt) {\n      this.coreAppDisplay = null\n      return\n    }\n    // Re-send the core's saved display.\n    this.restoreDisplay(this.coreAppDisplay)\n  }\n\n  private sendClear(): void {\n    const clearEvent: Record<string, unknown> = {\n      view: \"main\",\n      layout: {layoutType: \"clear_view\"},\n    }\n    this.sendToNative(\"system.clear\", clearEvent, null)\n    this.currentDisplay = null\n    // The glasses main view is now blank: every app's retained scene is\n    // replay-only until it re-renders — diffing against it would skip\n    // \"unchanged\" elements onto the blank screen.\n    sceneRenderer.markViewStale(\"main\")\n  }\n\n  // ===========================================================================\n  // Internals — boot\n  // ===========================================================================\n\n  private cancelBoot(): void {\n    if (!this.bootingApp) return\n    BgTimer.clearTimeout(this.bootingApp.timerId)\n    this.bootingApp = null\n  }\n\n  private endBoot(triggeredByFirstDisplay: boolean): void {\n    if (!this.bootingApp) return\n    const preBoot = this.bootingApp.preBoot\n    BgTimer.clearTimeout(this.bootingApp.timerId)\n    this.bootingApp = null\n\n    // Drain the queue: core first, then everyone else. Per-app last wins\n    // because the map holds one payload per packageName.\n    const queued = Array.from(this.bootQueue.entries())\n    this.bootQueue.clear()\n\n    const corePayload = this.coreApp ? queued.find(([pkg]) => pkg === this.coreApp) : undefined\n    if (corePayload) {\n      this.arbitrateAndSend(corePayload[0], corePayload[1].payload, corePayload[1].resolve)\n    }\n    for (const [pkg, entry] of queued) {\n      if (pkg === this.coreApp) continue\n      this.arbitrateAndSend(pkg, entry.payload, entry.resolve)\n    }\n\n    // Boot ended on the timeout with nothing queued and no first display — the\n    // app just never rendered. Restore whatever was on the glasses before the\n    // boot text so a background app or crash-respawn can't blank a foreground\n    // app's frame (registerApp fires onMount for every spawn, and the core app\n    // isn't wired on the local path yet). If the glasses were empty before,\n    // clear the lingering \"Starting …\" instead — otherwise a miniapp that never\n    // renders (e.g. audio-only) would strand it.\n    if (!triggeredByFirstDisplay && queued.length === 0) {\n      // Only restore a frame that's still valid — one whose duration elapsed\n      // during the boot window should clear, not come back.\n      if (preBoot && (preBoot.expiresAt === null || preBoot.expiresAt > this.now())) {\n        this.restoreDisplay(preBoot)\n      } else {\n        this.sendClear()\n      }\n    }\n  }\n\n  /**\n   * Re-push a previously-captured on-glasses frame (e.g. the display a boot\n   * window overwrote). Mirrors tryRestoreCoreDisplay: the saved event is already\n   * processed, and any remaining duration is recomputed from its expiry.\n   */\n  private restoreDisplay(saved: ActiveDisplay): void {\n    const remaining = saved.expiresAt !== null ? Math.max(0, saved.expiresAt - this.now()) : undefined\n\n    // Scene restores must REPLAY (create-based, epoch-bumped): re-emitting the\n    // scene through the normal diff would come back all-\"unchanged\" and the\n    // device would skip every element (spec §4 — replay is always create-based).\n    if (saved.scene) {\n      const expiresAt = remaining !== undefined ? this.now() + remaining : null\n      if (sceneRenderer.replayApp(saved.packageName, \"main\")) {\n        this.currentDisplay = {packageName: saved.packageName, processedEvent: {}, scene: saved.scene, expiresAt}\n        this.clearExpiryTimer()\n        if (expiresAt !== null) {\n          const delay = Math.max(0, expiresAt - this.now())\n          this.expiryTimerId = BgTimer.setTimeout(() => {\n            this.expiryTimerId = null\n            this.handleExpiry(saved.packageName)\n          }, delay)\n        }\n      } else {\n        // Retained state gone (app stopped since) — re-render the saved\n        // elements as a fresh scene instead.\n        this.sendNow(saved.packageName, {view: \"main\", scene: saved.scene, durationMs: remaining})\n      }\n      return\n    }\n\n    this.sendNow(saved.packageName, {\n      view: \"main\",\n      layout: saved.processedEvent.layout as DisplayPayload[\"layout\"],\n      durationMs: remaining,\n    })\n  }\n\n  // ===========================================================================\n  // Reconnect replay (design doc §3.4.7 — recovery = replay, host-driven)\n  // ===========================================================================\n\n  /**\n   * Subscribe to glasses connection state so the current owner's frame is\n   * replayed after a reconnect. Safe to call repeatedly; attaches once. Wired\n   * from MantleManager next to displayProcessor.attachToRuntime().\n   */\n  public attachToRuntime(): void {\n    if (this.runtimeAttached) return\n    // dev wired this through the (since-removed) glassesStatus runtime hooks;\n    // engine reads its own glasses store directly.\n    this.glassesWasConnected = isGlassesConnected(useGlassesStore.getState().connection)\n    this.unsubscribeGlassesStatus = useGlassesStore.subscribe(() => {\n      const connected = isGlassesConnected(useGlassesStore.getState().connection)\n      if (connected === this.glassesWasConnected) return\n      this.glassesWasConnected = connected\n      if (connected) {\n        this.replayCurrent()\n      }\n    })\n    this.runtimeAttached = true\n  }\n\n  /**\n   * Re-push the current on-glasses frame after a device recovery. Scenes replay\n   * from SceneRenderer's retained state (create-based, epoch-bumped); legacy\n   * frames re-send their processed event. Expired frames don't come back.\n   */\n  public replayCurrent(): void {\n    const current = this.currentDisplay\n    if (!current) return\n    if (current.expiresAt !== null && this.now() >= current.expiresAt) return\n\n    console.log(`${LOG_TAG}: replayCurrent(${current.packageName})`)\n    if (current.scene) {\n      if (!sceneRenderer.replayApp(current.packageName, \"main\")) {\n        // Retained state gone (app stopped between disconnect and reconnect).\n        this.sendClear()\n      }\n    } else if (current.processedEvent.layout) {\n      this.sendToNative(current.packageName, current.processedEvent, current.expiresAt)\n    }\n  }\n\n  // ===========================================================================\n  // Internals — timer helpers\n  // ===========================================================================\n\n  private clearExpiryTimer(): void {\n    if (this.expiryTimerId !== null) {\n      BgTimer.clearTimeout(this.expiryTimerId)\n      this.expiryTimerId = null\n    }\n  }\n\n  // ===========================================================================\n  // Test hooks\n  // ===========================================================================\n\n  /** Injected clock — tests only. */\n  public _setNowForTest(fn: () => number): void {\n    this.now = fn\n  }\n\n  /** Wipe state — tests only. */\n  public _resetForTest(): void {\n    this.cancelBoot()\n    this.clearExpiryTimer()\n    this.coreApp = null\n    this.coreAppDisplay = null\n    this.currentDisplay = null\n    this.backgroundLock = null\n    this.bootQueue.clear()\n    this.now = () => Date.now()\n    this.unsubscribeGlassesStatus?.()\n    this.unsubscribeGlassesStatus = null\n    this.runtimeAttached = false\n    this.glassesWasConnected = false\n    sceneRenderer._resetForTest()\n  }\n\n  /** Read-only state snapshot — tests only. */\n  public _peekForTest(): {\n    coreApp: string | null\n    currentDisplayPkg: string | null\n    bgLockPkg: string | null\n    isBooting: boolean\n  } {\n    return {\n      coreApp: this.coreApp,\n      currentDisplayPkg: this.currentDisplay?.packageName ?? null,\n      bgLockPkg: this.backgroundLock?.packageName ?? null,\n      isBooting: this.bootingApp !== null,\n    }\n  }\n}\n\nconst localDisplayManager = LocalDisplayManager.getInstance()\nexport default localDisplayManager\nexport {LocalDisplayManager}\n"]}
+{"version":3,"file":"LocalDisplayManager.js","sourceRoot":"","sources":["../../src/services/LocalDisplayManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * LocalDisplayManager\n *\n * Phone-side arbiter for display requests originating from LOCAL miniapps\n * (the @mentra/miniapp SDK). Mirrors the user-facing behavior of the cloud\n * DisplayManager (cloud/packages/cloud/src/services/layout/DisplayManager6.1.ts)\n * for the features that matter on the phone:\n *\n *   - boot message (\"Starting <AppName>…\") with a bounded window\n *   - durationMs auto-clear\n *   - core-app vs background-app arbitration with a background lock\n *\n * Scope is deliberately local-only. Cloud-originated displays are untouched\n * and may race with local displays during dev; that's acceptable per plan\n * (agents/local-display-manager-plan.md).\n *\n * Display pacing is NOT done here. A JS-side ~300ms throttle used to live in\n * this class, but JS timers (and therefore the throttle's trailing flush) do\n * not fire on schedule while the iOS app is suspended in the background — so\n * under streaming captions, updates accumulated and then flushed in a burst on\n * the next wake. Pacing + last-wins coalescing now live in the native per-device\n * queue (e.g. G2's event-driven EvenHub queue), which drains off the same BLE\n * events that wake the process. This class forwards every request straight\n * through; the native layer collapses redundant frames per display target.\n *\n * The remaining BgTimer use (boot window, durationMs expiry) is timing that\n * does not need sub-second background fidelity.\n */\n\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport displayProcessor from \"./DisplayProcessor\"\nimport {useDisplayStore} from \"../stores/display\"\nimport sceneRenderer from \"./SceneRenderer\"\nimport {isGlassesConnected} from \"./GlassesReadiness\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport type {SceneElementInput} from \"../utils/display/scene\"\nimport {BgTimer} from \"../utils/timers\"\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface DisplayPayload {\n  view?: \"main\" | \"dashboard\" | string\n  /** Legacy layout (sugar / old bundles / cloud shapes). Either this or `scene`. */\n  layout?: {layoutType: string; [key: string]: unknown}\n  /** Scene elements from display.render(). Either this or `layout`. */\n  scene?: SceneElementInput[]\n  durationMs?: number\n}\n\n/** Outcome delivered to an awaiting render() call (REQUEST_RESULT payload). */\nexport interface DisplayRequestResult {\n  status: \"displayed\" | \"blocked\"\n  degraded?: boolean\n  dropped?: string[]\n  reason?: string\n}\n\nexport type DisplayRequestResolver = (result: DisplayRequestResult) => void\n\ninterface ActiveDisplay {\n  packageName: string\n  processedEvent: Record<string, unknown>\n  /** Set when this display is a scene — restore goes through SceneRenderer replay. */\n  scene?: SceneElementInput[]\n  expiresAt: number | null\n}\n\ninterface BootingApp {\n  packageName: string\n  displayName: string\n  startedAt: number\n  timerId: number\n  /** Whatever was on the glasses when this boot started, so a boot that times\n   * out without the app rendering can restore it instead of blanking a frame\n   * another (e.g. foreground) app owns. Null if the glasses were empty. */\n  preBoot: ActiveDisplay | null\n}\n\ninterface BackgroundLock {\n  packageName: string\n  acquiredAt: number\n  expiresAt: number\n  lastActiveTime: number\n}\n\n// =============================================================================\n// Constants\n// =============================================================================\n\nconst LOG_TAG = \"LOCAL_DISPLAY\"\nconst BOOT_DURATION_MS = 1500\n// Mirrors cloud lease for a bg app holding the display. The bg app has to\n// keep driving the display to hold the lock; if it goes quiet and the core\n// app wants the screen, we release.\nconst BACKGROUND_LOCK_TIMEOUT_MS = 10_000\n// Sentinel package name used as the \"source\" of the system boot message.\nconst SYSTEM_BOOT_PKG = \"system.boot\"\n\n/** \"Render nothing\" — an empty scene or an explicit clear_view layout. */\nfunction isClearPayload(payload: DisplayPayload): boolean {\n  if (payload.scene) return payload.scene.length === 0\n  return payload.layout?.layoutType === \"clear_view\"\n}\n\n// =============================================================================\n// LocalDisplayManager\n// =============================================================================\n\nclass LocalDisplayManager {\n  private static instance: LocalDisplayManager | null = null\n\n  private coreApp: string | null = null\n  private coreAppDisplay: ActiveDisplay | null = null\n  private currentDisplay: ActiveDisplay | null = null\n  private backgroundLock: BackgroundLock | null = null\n\n  private bootingApp: BootingApp | null = null\n  private bootQueue: Map<string, {payload: DisplayPayload; resolve?: DisplayRequestResolver}> = new Map()\n\n  private expiryTimerId: number | null = null\n\n  /** Reconnect-replay subscription state (attachToRuntime). */\n  private runtimeAttached = false\n  private glassesWasConnected = false\n  private unsubscribeGlassesStatus: (() => void) | null = null\n\n  /** Injectable for tests. */\n  private now: () => number = () => Date.now()\n\n  private constructor() {}\n\n  public static getInstance(): LocalDisplayManager {\n    if (!LocalDisplayManager.instance) {\n      LocalDisplayManager.instance = new LocalDisplayManager()\n    }\n    return LocalDisplayManager.instance\n  }\n\n  // ===========================================================================\n  // Lifecycle API (called from MiniappHost)\n  // ===========================================================================\n\n  /**\n   * A new local miniapp just mounted. Start the boot window.\n   * Calling this for a different pkg while another is booting cancels the\n   * previous boot.\n   */\n  public onMount(packageName: string, displayName: string): void {\n    console.log(`${LOG_TAG}: onMount(${packageName}, \"${displayName}\")`)\n\n    // Snapshot whatever's on the glasses BEFORE the boot text overwrites it.\n    // registerApp fires onMount for every spawn — including a background app or\n    // a crash-respawn while another app is foreground — so a boot that times out\n    // without rendering must put the prior frame back rather than blank it.\n    // Never snapshot the boot text itself: back-to-back mounts (the autostart\n    // restore loop, crash-respawn chains) land while the previous app's\n    // \"Starting X…\" is still on the glasses, and endBoot would \"restore\" that\n    // stale, expiry-less frame permanently. Across chained boots, inherit the\n    // original pre-boot frame instead.\n    const inherited = this.bootingApp ? this.bootingApp.preBoot : this.currentDisplay\n    const preBoot = inherited?.packageName === SYSTEM_BOOT_PKG ? null : inherited\n\n    // Cancel any in-flight boot for a prior app.\n    this.cancelBoot()\n\n    // Send the boot message directly (bypass arbitration — this is a system\n    // display). Goes through sendNow so scene devices render it as a scene:\n    // otherwise every app start would be a legacy→scene transition on the\n    // glasses (which costs a blanking clear).\n    this.sendNow(SYSTEM_BOOT_PKG, {\n      view: \"main\",\n      layout: {layoutType: \"text_wall\", text: `Starting ${displayName}…`},\n    })\n\n    const timerId = BgTimer.setTimeout(() => {\n      this.endBoot()\n    }, BOOT_DURATION_MS)\n\n    this.bootingApp = {\n      packageName,\n      displayName,\n      startedAt: this.now(),\n      timerId,\n      preBoot,\n    }\n    this.bootQueue.clear()\n  }\n\n  /**\n   * Mark which miniapp is the \"core\" (foreground) app. Pass null when no local\n   * miniapp is foreground.\n   */\n  public onCoreAppChange(packageName: string | null): void {\n    if (this.coreApp === packageName) return\n    console.log(`${LOG_TAG}: onCoreAppChange(${packageName ?? \"null\"})`)\n\n    this.coreApp = packageName\n\n    // No core app means no saved frame to restore on the next unmount.\n    // Without this, the previous core's last frame can flicker back onto\n    // the glasses when the user-initiated clear is followed by an\n    // onUnmount that still finds a populated coreAppDisplay.\n    if (packageName === null) {\n      this.coreAppDisplay = null\n    }\n  }\n\n  /** Report-safe ownership snapshot for incident diagnostics. */\n  public getDiagnosticSnapshot(): Record<string, unknown> {\n    return {\n      coreAppPackageName: this.coreApp,\n      currentDisplayPackageName: this.currentDisplay?.packageName ?? null,\n      backgroundLockPackageName: this.backgroundLock?.packageName ?? null,\n      bootingPackageName: this.bootingApp?.packageName ?? null,\n    }\n  }\n\n  /**\n   * A local miniapp is going away. Clean up all state associated with it.\n   */\n  public onUnmount(packageName: string): void {\n    console.log(`${LOG_TAG}: onUnmount(${packageName})`)\n\n    // If this was the booting app, cancel boot — and don't strand its\n    // \"Starting X…\" text (a system frame with no expiry): put back what the\n    // boot covered, or clear.\n    if (this.bootingApp?.packageName === packageName) {\n      const preBoot = this.bootingApp.preBoot\n      this.cancelBoot()\n      if (this.currentDisplay?.packageName === SYSTEM_BOOT_PKG) {\n        // The preBoot owner may have forfeited its frame during the boot\n        // window (a clear parked in the boot queue) — don't resurrect it.\n        const ownerQueued = preBoot ? this.bootQueue.get(preBoot.packageName) : undefined\n        const preBootForfeited = ownerQueued !== undefined && isClearPayload(ownerQueued.payload)\n        if (preBoot && !preBootForfeited && (preBoot.expiresAt === null || preBoot.expiresAt > this.now())) {\n          this.restoreDisplay(preBoot)\n        } else {\n          this.sendClear()\n        }\n      }\n    }\n    this.bootQueue.get(packageName)?.resolve?.({status: \"blocked\", reason: \"app stopped\"})\n    this.bootQueue.delete(packageName)\n\n    // Forget the app's retained scenes — nothing left to replay for it.\n    sceneRenderer.clearApp(packageName)\n\n    // Release bg lock if this app held it.\n    if (this.backgroundLock?.packageName === packageName) {\n      this.backgroundLock = null\n    }\n\n    // Drop the saved core frame if the core's context is going away — the\n    // frame belongs to a dead context and must not be restored later. The\n    // coreApp POINTER itself is NOT cleared here: it is derived state owned\n    // by the apps-store reconciler. A liveness/crash respawn tears the\n    // context down (this path) without any store change — the app is still\n    // \"running\" — and clearing the pointer here would leave the respawned\n    // foreground app arbitrating as background until an unrelated store\n    // write happened to re-run the reconciler. Real stops release the slot\n    // via the store (running → false → reconciler → onCoreAppChange(null)).\n    if (this.coreApp === packageName) {\n      this.coreAppDisplay = null\n    }\n\n    // If this app owned the current on-glasses display, clear it (and maybe\n    // restore the core app's display if it still has time left).\n    if (this.currentDisplay?.packageName === packageName) {\n      this.clearExpiryTimer()\n      this.currentDisplay = null\n      this.tryRestoreCoreDisplay()\n      if (!this.currentDisplay) {\n        // Nothing to restore → clear the glasses.\n        this.sendClear()\n      }\n    }\n  }\n\n  // ===========================================================================\n  // Display request API (called from LocalMiniappRuntime.handleDisplay)\n  // ===========================================================================\n\n  /**\n   * A miniapp requested a display. Routes through boot queue, arbitration,\n   * and throttle. This is the only public entry point for miniapp display\n   * traffic on the local path.\n   *\n   * `resolve`, when provided (render() requests), is guaranteed to be called\n   * exactly once with the request's outcome — including for requests parked in\n   * the boot queue (resolved when drained or superseded).\n   */\n  public request(packageName: string, payload: DisplayPayload, resolve?: DisplayRequestResolver): void {\n    // Dashboard view: pass straight through (no throttle/arbitration). Local\n    // dashboard rendering is currently a stub on the phone anyway.\n    if (payload.view === \"dashboard\") {\n      this.sendNow(packageName, payload, resolve)\n      return\n    }\n\n    // During boot, any app's requests go into the queue. If the booting app\n    // itself makes its first display call, end boot early and drain.\n    if (this.bootingApp) {\n      const superseded = this.bootQueue.get(packageName)\n      superseded?.resolve?.({status: \"blocked\", reason: \"superseded by a newer frame\"})\n      this.bootQueue.set(packageName, {payload, resolve})\n      if (this.bootingApp.packageName === packageName) {\n        this.endBoot()\n      }\n      return\n    }\n\n    this.arbitrateAndSend(packageName, payload, resolve)\n  }\n\n  /**\n   * End a package's temporary display early. If it currently owns the main\n   * view, release its background lock and restore the foreground miniapp's\n   * saved frame. A dismissal for a package that is no longer visible is a\n   * no-op.\n   */\n  public dismiss(packageName: string): void {\n    this.handleExpiry(packageName)\n  }\n\n  // ===========================================================================\n  // Internals — arbitration\n  // ===========================================================================\n\n  private arbitrateAndSend(packageName: string, payload: DisplayPayload, resolve?: DisplayRequestResolver): void {\n    const now = this.now()\n\n    // Expire a stale bg lock before arbitrating.\n    if (this.backgroundLock && now > this.backgroundLock.expiresAt) {\n      this.backgroundLock = null\n    }\n\n    // A clear (\"render nothing\") means \"I'm done with the display\" — it is a\n    // forfeit, not a frame. A background app releases its lock and the core\n    // app's still-valid display comes back; treating it as a render instead\n    // would RENEW the lock with an empty frame and blank the glasses while\n    // still blocking everyone else.\n    if (isClearPayload(payload)) {\n      this.handleAppClear(packageName, resolve)\n      return\n    }\n\n    const isCore = packageName === this.coreApp\n\n    if (isCore) {\n      // Save so we can restore later.\n      this.coreAppDisplay = {\n        packageName,\n        processedEvent: {}, // filled by sendNow\n        scene: payload.scene,\n        expiresAt: payload.durationMs ? now + payload.durationMs : null,\n      }\n\n      // If a bg app holds the lock AND is currently on the glasses, core is\n      // blocked. The saved coreAppDisplay surfaces when the bg app expires\n      // or unmounts.\n      const bgHoldsAndDisplays =\n        this.backgroundLock &&\n        this.currentDisplay &&\n        this.currentDisplay.packageName === this.backgroundLock.packageName\n      if (bgHoldsAndDisplays) {\n        resolve?.({status: \"blocked\", reason: \"a background app holds the display\"})\n        return\n      }\n\n      // Core can display. If a bg lock exists but holder isn't actively on\n      // the glasses, release it.\n      if (this.backgroundLock && !bgHoldsAndDisplays) {\n        this.backgroundLock = null\n      }\n\n      this.sendNow(packageName, payload, resolve)\n      return\n    }\n\n    // Non-core: this is a background app.\n    if (this.backgroundLock && this.backgroundLock.packageName !== packageName) {\n      // Another bg app already holds the lock — drop.\n      resolve?.({status: \"blocked\", reason: \"another background app holds the display\"})\n      return\n    }\n\n    // Acquire or bump the lock.\n    if (!this.backgroundLock) {\n      this.backgroundLock = {\n        packageName,\n        acquiredAt: now,\n        expiresAt: now + BACKGROUND_LOCK_TIMEOUT_MS,\n        lastActiveTime: now,\n      }\n    } else {\n      this.backgroundLock.lastActiveTime = now\n      this.backgroundLock.expiresAt = now + BACKGROUND_LOCK_TIMEOUT_MS\n    }\n\n    this.sendNow(packageName, payload, resolve)\n  }\n\n  /**\n   * An app cleared its display (\"render nothing\"). Same semantics as its\n   * frame expiring: give up ownership, restore the core app's still-valid\n   * display if there is one, otherwise clear the glasses.\n   */\n  private handleAppClear(packageName: string, resolve?: DisplayRequestResolver): void {\n    // Forget the app's retained scene state — its next render starts fresh.\n    sceneRenderer.clearApp(packageName)\n\n    if (this.backgroundLock?.packageName === packageName) {\n      this.backgroundLock = null\n    }\n    if (this.coreApp === packageName) {\n      this.coreAppDisplay = null\n    }\n\n    if (this.currentDisplay?.packageName === packageName) {\n      this.clearExpiryTimer()\n      this.currentDisplay = null\n      this.tryRestoreCoreDisplay()\n      if (!this.currentDisplay) {\n        this.sendClear()\n      }\n    }\n    resolve?.({status: \"displayed\"})\n  }\n\n  // ===========================================================================\n  // Internals — send\n  // ===========================================================================\n\n  private sendNow(packageName: string, payload: DisplayPayload, resolve?: DisplayRequestResolver): void {\n    const expiresAt = payload.durationMs ? this.now() + payload.durationMs : null\n    const view = (payload.view === \"dashboard\" ? \"dashboard\" : \"main\") as \"main\" | \"dashboard\"\n\n    // Scene requests — and legacy layouts a positioning device can render as a\n    // scene (sugar, old bundles) — go through the scene pipeline. Everything\n    // else stays on the legacy path.\n    let sceneElements = payload.scene ?? null\n    if (!sceneElements && payload.layout) {\n      const caps = sceneRenderer.currentCapabilities()\n      if (caps?.canPosition) {\n        sceneElements = sceneRenderer.convertLegacyLayout(payload.layout, caps)\n      }\n    }\n\n    if (sceneElements) {\n      this.sendScene(packageName, view, sceneElements, expiresAt, resolve)\n    } else if (payload.layout) {\n      // This layout bypasses the scene pipeline (clear_view, dashboard_card,\n      // unknown types, or a non-positioning device). If this (app, view) had a\n      // retained scene, the glasses no longer match it — reset the diff\n      // baseline so the next render() repaints from empty instead of skipping\n      // \"unchanged\" elements.\n      sceneRenderer.resetBaseline(packageName, view)\n      const rawEvent: Record<string, unknown> = {\n        view: payload.view ?? \"main\",\n        layout: payload.layout,\n      }\n      if (payload.durationMs !== undefined) {\n        rawEvent.durationMs = payload.durationMs\n      }\n      this.sendToNative(packageName, rawEvent, expiresAt)\n      resolve?.({status: \"displayed\"})\n    } else {\n      // A scene payload on a device with no display block at all.\n      resolve?.({status: \"blocked\", reason: \"no display connected\"})\n      return\n    }\n\n    // If core app fired, refresh the saved snapshot with the actual processed\n    // event so restore uses the wrapped text (legacy) / the retained scene.\n    if (packageName === this.coreApp && this.currentDisplay) {\n      this.coreAppDisplay = {\n        packageName,\n        processedEvent: this.currentDisplay.processedEvent,\n        scene: this.currentDisplay.scene,\n        expiresAt: this.currentDisplay.expiresAt,\n      }\n    }\n  }\n\n  /**\n   * Send a scene through SceneRenderer. On positioning devices this emits a\n   * SceneFrame; on degrade devices SceneRenderer hands back a legacy layout\n   * that rides the existing (unchanged) DisplayProcessor path.\n   */\n  private sendScene(\n    packageName: string,\n    view: \"main\" | \"dashboard\",\n    elements: SceneElementInput[],\n    expiresAt: number | null,\n    resolve?: DisplayRequestResolver,\n  ): void {\n    const result = sceneRenderer.emitScene(packageName, view, elements)\n\n    if (result.kind === \"no-display\") {\n      resolve?.({status: \"blocked\", reason: \"no display connected\"})\n      return\n    }\n\n    if (result.kind === \"legacy\") {\n      if (result.layout) {\n        this.sendToNative(packageName, {view, layout: result.layout}, expiresAt)\n      } else {\n        // Scene degraded to nothing (e.g. all-image scene on a text-only\n        // device). render() replaces the frame, so nothing means clear.\n        this.sendClear()\n      }\n      resolve?.({status: \"displayed\", degraded: result.degraded, dropped: result.dropped})\n      return\n    }\n\n    this.currentDisplay = {packageName, processedEvent: {}, scene: elements, expiresAt}\n    this.clearExpiryTimer()\n    if (expiresAt !== null) {\n      const delay = Math.max(0, expiresAt - this.now())\n      this.expiryTimerId = BgTimer.setTimeout(() => {\n        this.expiryTimerId = null\n        this.handleExpiry(packageName)\n      }, delay)\n    }\n    resolve?.({status: \"displayed\", degraded: result.degraded, dropped: result.dropped})\n  }\n\n  private sendToNative(packageName: string, rawEvent: Record<string, unknown>, expiresAt: number | null): void {\n    let processedEvent: Record<string, unknown>\n    try {\n      processedEvent = displayProcessor.processDisplayEvent(rawEvent as any)\n    } catch (err) {\n      console.error(`${LOG_TAG}: DisplayProcessor error, using raw event:`, err)\n      processedEvent = rawEvent\n    }\n\n    try {\n      // The display output path is a direct btsdk call now (was a host sendDisplayEvent\n      // hook) so a bare OEM renders to the glasses without wiring it.\n      void Promise.resolve(BluetoothSdk.displayEvent(processedEvent)).catch((err) => {\n        console.error(`${LOG_TAG}: native display failed:`, err)\n      })\n      // The mirror store also lives in engine, so display requests update the\n      // phone-side preview without any host hook.\n      useDisplayStore.getState().setDisplayEvent(JSON.stringify(processedEvent))\n    } catch (err) {\n      console.error(`${LOG_TAG}: native display failed:`, err)\n    }\n\n    this.currentDisplay = {packageName, processedEvent, expiresAt}\n\n    this.clearExpiryTimer()\n    if (expiresAt !== null) {\n      const delay = Math.max(0, expiresAt - this.now())\n      this.expiryTimerId = BgTimer.setTimeout(() => {\n        this.expiryTimerId = null\n        this.handleExpiry(packageName)\n      }, delay)\n    }\n  }\n\n  private handleExpiry(packageName: string): void {\n    // Someone else is on the glasses now — ignore.\n    if (!this.currentDisplay || this.currentDisplay.packageName !== packageName) {\n      return\n    }\n\n    // Release the lock if it belonged to this (bg) app.\n    if (this.backgroundLock?.packageName === packageName) {\n      this.backgroundLock = null\n    }\n\n    this.currentDisplay = null\n    this.tryRestoreCoreDisplay()\n    if (!this.currentDisplay) {\n      this.sendClear()\n    }\n  }\n\n  private tryRestoreCoreDisplay(): void {\n    if (!this.coreAppDisplay) return\n    // If the core snapshot has a duration and it's already elapsed, skip.\n    if (this.coreAppDisplay.expiresAt !== null && this.now() >= this.coreAppDisplay.expiresAt) {\n      this.coreAppDisplay = null\n      return\n    }\n    // Re-send the core's saved display.\n    this.restoreDisplay(this.coreAppDisplay)\n  }\n\n  private sendClear(): void {\n    const clearEvent: Record<string, unknown> = {\n      view: \"main\",\n      layout: {layoutType: \"clear_view\"},\n    }\n    this.sendToNative(\"system.clear\", clearEvent, null)\n    this.currentDisplay = null\n    // The glasses main view is now blank: every app's retained scene is\n    // replay-only until it re-renders — diffing against it would skip\n    // \"unchanged\" elements onto the blank screen.\n    sceneRenderer.markViewStale(\"main\")\n  }\n\n  // ===========================================================================\n  // Internals — boot\n  // ===========================================================================\n\n  private cancelBoot(): void {\n    if (!this.bootingApp) return\n    BgTimer.clearTimeout(this.bootingApp.timerId)\n    this.bootingApp = null\n  }\n\n  private endBoot(): void {\n    if (!this.bootingApp) return\n    const preBoot = this.bootingApp.preBoot\n    BgTimer.clearTimeout(this.bootingApp.timerId)\n    this.bootingApp = null\n\n    // Drain the queue: core first, then everyone else. Per-app last wins\n    // because the map holds one payload per packageName.\n    const queued = Array.from(this.bootQueue.entries())\n    this.bootQueue.clear()\n\n    const corePayload = this.coreApp ? queued.find(([pkg]) => pkg === this.coreApp) : undefined\n    if (corePayload) {\n      this.arbitrateAndSend(corePayload[0], corePayload[1].payload, corePayload[1].resolve)\n    }\n    for (const [pkg, entry] of queued) {\n      if (pkg === this.coreApp) continue\n      this.arbitrateAndSend(pkg, entry.payload, entry.resolve)\n    }\n\n    // If the boot text is still on the glasses — nothing was queued, or every\n    // drained request lost arbitration — it must not strand: it's a system\n    // frame with no expiry. Restore whatever was on the glasses before the\n    // boot, else clear. Two reasons NOT to restore: the frame's duration\n    // elapsed during the boot window, or its owner FORFEITED it during the\n    // window (its final queued intent — the queue keeps last-wins per app —\n    // was a clear, which the drain above processed as a forfeit; restoring\n    // would resurrect content the clear removed).\n    if (this.currentDisplay?.packageName === SYSTEM_BOOT_PKG) {\n      const ownerEntry = preBoot ? queued.find(([pkg]) => pkg === preBoot.packageName) : undefined\n      const preBootForfeited = ownerEntry !== undefined && isClearPayload(ownerEntry[1].payload)\n      if (preBoot && !preBootForfeited && (preBoot.expiresAt === null || preBoot.expiresAt > this.now())) {\n        this.restoreDisplay(preBoot)\n      } else {\n        this.sendClear()\n      }\n    }\n  }\n\n  /**\n   * Re-push a previously-captured on-glasses frame (e.g. the display a boot\n   * window overwrote). Mirrors tryRestoreCoreDisplay: the saved event is already\n   * processed, and any remaining duration is recomputed from its expiry.\n   */\n  private restoreDisplay(saved: ActiveDisplay): void {\n    const remaining = saved.expiresAt !== null ? Math.max(0, saved.expiresAt - this.now()) : undefined\n\n    // Scene restores must REPLAY (create-based, epoch-bumped): re-emitting the\n    // scene through the normal diff would come back all-\"unchanged\" and the\n    // device would skip every element (spec §4 — replay is always create-based).\n    if (saved.scene) {\n      const expiresAt = remaining !== undefined ? this.now() + remaining : null\n      if (sceneRenderer.replayApp(saved.packageName, \"main\")) {\n        this.currentDisplay = {packageName: saved.packageName, processedEvent: {}, scene: saved.scene, expiresAt}\n        this.clearExpiryTimer()\n        if (expiresAt !== null) {\n          const delay = Math.max(0, expiresAt - this.now())\n          this.expiryTimerId = BgTimer.setTimeout(() => {\n            this.expiryTimerId = null\n            this.handleExpiry(saved.packageName)\n          }, delay)\n        }\n      } else {\n        // Retained state gone (app stopped since) — re-render the saved\n        // elements as a fresh scene instead.\n        this.sendNow(saved.packageName, {view: \"main\", scene: saved.scene, durationMs: remaining})\n      }\n      return\n    }\n\n    this.sendNow(saved.packageName, {\n      view: \"main\",\n      layout: saved.processedEvent.layout as DisplayPayload[\"layout\"],\n      durationMs: remaining,\n    })\n  }\n\n  // ===========================================================================\n  // Reconnect replay (design doc §3.4.7 — recovery = replay, host-driven)\n  // ===========================================================================\n\n  /**\n   * Subscribe to glasses connection state so the current owner's frame is\n   * replayed after a reconnect. Safe to call repeatedly; attaches once. Wired\n   * from MantleManager next to displayProcessor.attachToRuntime().\n   */\n  public attachToRuntime(): void {\n    if (this.runtimeAttached) return\n    // dev wired this through the (since-removed) glassesStatus runtime hooks;\n    // engine reads its own glasses store directly.\n    this.glassesWasConnected = isGlassesConnected(useGlassesStore.getState().connection)\n    this.unsubscribeGlassesStatus = useGlassesStore.subscribe(() => {\n      const connected = isGlassesConnected(useGlassesStore.getState().connection)\n      if (connected === this.glassesWasConnected) return\n      this.glassesWasConnected = connected\n      if (connected) {\n        this.replayCurrent()\n      }\n    })\n    this.runtimeAttached = true\n  }\n\n  /**\n   * Re-push the current on-glasses frame after a device recovery. Scenes replay\n   * from SceneRenderer's retained state (create-based, epoch-bumped); legacy\n   * frames re-send their processed event. Expired frames don't come back.\n   */\n  public replayCurrent(): void {\n    const current = this.currentDisplay\n    if (!current) return\n    if (current.expiresAt !== null && this.now() >= current.expiresAt) return\n\n    console.log(`${LOG_TAG}: replayCurrent(${current.packageName})`)\n    if (current.scene) {\n      if (!sceneRenderer.replayApp(current.packageName, \"main\")) {\n        // Retained state gone (app stopped between disconnect and reconnect).\n        this.sendClear()\n      }\n    } else if (current.processedEvent.layout) {\n      this.sendToNative(current.packageName, current.processedEvent, current.expiresAt)\n    }\n  }\n\n  // ===========================================================================\n  // Internals — timer helpers\n  // ===========================================================================\n\n  private clearExpiryTimer(): void {\n    if (this.expiryTimerId !== null) {\n      BgTimer.clearTimeout(this.expiryTimerId)\n      this.expiryTimerId = null\n    }\n  }\n\n  // ===========================================================================\n  // Test hooks\n  // ===========================================================================\n\n  /** Injected clock — tests only. */\n  public _setNowForTest(fn: () => number): void {\n    this.now = fn\n  }\n\n  /** Wipe state — tests only. */\n  public _resetForTest(): void {\n    this.cancelBoot()\n    this.clearExpiryTimer()\n    this.coreApp = null\n    this.coreAppDisplay = null\n    this.currentDisplay = null\n    this.backgroundLock = null\n    this.bootQueue.clear()\n    this.now = () => Date.now()\n    this.unsubscribeGlassesStatus?.()\n    this.unsubscribeGlassesStatus = null\n    this.runtimeAttached = false\n    this.glassesWasConnected = false\n    sceneRenderer._resetForTest()\n  }\n\n  /** Read-only state snapshot — tests only. */\n  public _peekForTest(): {\n    coreApp: string | null\n    currentDisplayPkg: string | null\n    bgLockPkg: string | null\n    isBooting: boolean\n  } {\n    return {\n      coreApp: this.coreApp,\n      currentDisplayPkg: this.currentDisplay?.packageName ?? null,\n      bgLockPkg: this.backgroundLock?.packageName ?? null,\n      isBooting: this.bootingApp !== null,\n    }\n  }\n}\n\nconst localDisplayManager = LocalDisplayManager.getInstance()\nexport default localDisplayManager\nexport {LocalDisplayManager}\n"]}

package/build/services/LocalMiniappRuntime.d.ts

@@ -8,10 +8,20 @@
  * This runtime handles request dispatch, stream fan-out, and lifecycle
  * management (connect/disconnect/ping).
  */
+import { type MiniappRuntimeDiagnosticSnapshot } from "../utils/miniappDiagnostics";
 export interface InstalledMiniappManifest {
+    packageName?: string;
     /** Human-facing app name (from miniapp.json `name`). Shown in the "Starting
      * <name>…" boot message; falls back to the package name when absent. */
     name?: string;
+    version?: string;
+    sdkVersion?: string;
+    minHostVersion?: string;
+    type?: string;
+    entry?: {
+        background?: string;
+        ui?: string;
+    };
     permissions?: Array<{
         type: string;
         required?: boolean;
@@ -22,7 +32,14 @@ export interface InstalledMiniappManifest {
         level: string;
         description?: string;
     }>;
+    actions?: Array<{
+        id?: unknown;
+        description?: unknown;
+        parameters?: unknown;
+        outputSchema?: unknown;
+    }>;
 }
+type TranscriptionEventSource = "cloud" | "local";
 declare class LocalMiniappRuntime {
     private static instance;
     /** Connected miniapps keyed by packageName. */
@@ -38,10 +55,19 @@ declare class LocalMiniappRuntime {
     private connectWaiters;
     /** Ref-counted stream subscriptions: stream → set of packageNames. */
     private streamSubscribers;
+    /** Host observers for the Mentra Live button-capture policy. */
+    private buttonPressSubscriberListeners;
     /** Guards one-time wiring of the cloud transcript/translation fan-out. */
     private cloudResultsWired;
     private cloudStatusWired;
     private cloudAudioSubscriptionSync;
+    /**
+     * Per-miniapp language hints from TRANSCRIPTION_CONFIG (issue 021 WP3).
+     * Bare ISO 639-1 codes, already registry-validated by the SDK and
+     * re-normalized here (defense in depth). Merged (union) into the auto-mode
+     * cloud transcription subscription in buildCloudAudioSubscriptions.
+     */
+    private transcriptionHintsByApp;
     /** Ping interval handle. */
     private pingIntervalId;
     private foregroundProbeTimers;
@@ -56,9 +82,17 @@ declare class LocalMiniappRuntime {
     onLivenessTimeout: ((packageName: string) => void) | null;
     /** Pending cloud requests: requestId → packageName that originated the request. */
     private pendingCloudRequests;
+    private speechRuns;
     private localSecret;
     private usedTokens;
     private constructor();
+    /** Snapshot of miniapps actively subscribed to hardware button events. */
+    getButtonPressSubscribers(): string[];
+    /** Observe active hardware-button subscriptions. */
+    onButtonPressSubscribersChanged(listener: (packageNames: string[]) => void): () => void;
+    /** Report-safe live miniapp/subscription/resource snapshot. */
+    getDiagnosticSnapshot(nowMs?: number): MiniappRuntimeDiagnosticSnapshot;
+    private replaceStreamSubscribers;
     /**
      * Generate an HMAC-signed local session token for browser fallback auth.
      * Token format: base64(JSON({userId, packageName, exp})).base64(HMAC-SHA256(payload, secret))
@@ -165,7 +199,15 @@ declare class LocalMiniappRuntime {
      * the instant the connection comes up".
      */
     private redriveMiniappAuthDelivery;
+    /**
+     * TRANSCRIPTION_CONFIG (issue 021 WP3): store the miniapp's language hints
+     * and rebuild the cloud subscription set so the auto-mode subscription
+     * carries them. Replies with a REQUEST_RESULT so the SDK's configure()
+     * promise settles: unknown hint values are an error, not a silent drop.
+     */
+    private handleTranscriptionConfig;
     private handleSubscribe;
+    private handleCalendarListEvents;
     /**
      * For state-bearing streams (battery, connection), deliver the current value
      * immediately on subscribe. Other streams (button press, transcription, etc.)
@@ -200,6 +242,7 @@ declare class LocalMiniappRuntime {
     private handleSpeakerStreamClose;
     private handleSpeakerStreamAbort;
     private handleSpeak;
+    private cancelSpeech;
     private handleRgbLed;
     private handleLocationPoll;
     /**
@@ -217,6 +260,15 @@ declare class LocalMiniappRuntime {
      * BLOB_WRITE), so nothing audio-specific runs in the host.
      */
     private readonly blobStore;
+    private readonly blobRequestQueues;
+    private readonly simpleStorage;
+    /**
+     * BlobStore's file helpers are synchronous once a user namespace is selected,
+     * but first-boot Core auth is not. Queue requests per app behind stable
+     * identity resolution so CREATE/WRITE/COMMIT ordering survives that wait.
+     */
+    private enqueueBlobRequest;
+    private handleBlobRequestError;
     /**
      * Heading is a sensor stream — start the native compass when any mini
      * app is subscribed to "heading_update", stop it when none are.
@@ -251,7 +303,6 @@ declare class LocalMiniappRuntime {
      * "off" so it can drop GPS power.
      */
     private recomputeLocationTier;
-    private getStorageKeyPrefix;
     private handleStorageGet;
     private handleStorageSet;
     private handleStorageDelete;
@@ -260,6 +311,7 @@ declare class LocalMiniappRuntime {
     private handleStorageHas;
     private handleStorageGetAll;
     private handleStorageSetMultiple;
+    private handleSetWifiAdbState;
     private handleCameraFov;
     /**
      * Explicit IMU enable/disable from a miniapp (session.imu.setEnabled).
@@ -272,6 +324,23 @@ declare class LocalMiniappRuntime {
      * still re-derive the sensor state from subscriptions.
      */
     private handleImuSetEnabled;
+    /**
+     * Lifecycle-scoped glasses-side VAD override from a miniapp
+     * (session.mic.setVoiceActivityDetectionEnabled). Requires MICROPHONE in the
+     * miniapp manifest. Mentra Live only today — other models no-op via DeviceStore.
+     */
+    private handleMicSetVadEnabled;
+    /**
+     * Lifecycle-scoped center-mic loudness gate ("Barrier") override from a miniapp
+     * (session.mic.setLoudnessGateEnabled). Requires MICROPHONE in the miniapp
+     * manifest. Mentra Live only today — other models no-op via DeviceStore.
+     */
+    private handleMicSetLoudnessGateEnabled;
+    /**
+     * session.system.scanQr — host camera overlay. Must not clear miniapp
+     * foreground; the host seam is responsible for presenting a Modal on top.
+     */
+    private handleScanQr;
     private handleShare;
     private handleOpenUrl;
     private handleCopyClipboard;
@@ -312,6 +381,7 @@ declare class LocalMiniappRuntime {
         ok: boolean;
         error?: string;
     };
+    private getConfiguredMicGates;
     private recomputeMicRequirements;
     /**
      * Recompute the aggregated v2 cloud subscription list across all local miniapps.
@@ -353,7 +423,9 @@ declare class LocalMiniappRuntime {
      * - Cloud sends "head_up" → miniapp protocol uses "head_position" (HEAD_POSITION)
      * - Cloud sends "VAD" (uppercase) → miniapp protocol uses "vad" (lowercase)
      */
-    forwardEvent(streamType: string, data: unknown): void;
+    forwardEvent(streamType: string, data: unknown, transcriptionSource?: TranscriptionEventSource): void;
+    private appTranscriptionRoutesForSubscription;
+    private appTranscriptionRoutesForEvent;
     /**
      * Translate cloud event names to miniapp stream type values.
      */