@glassly/engine 0.1.0-dev.99 → 0.2.8-dev.445

package/README.md

@@ -110,6 +110,34 @@ disabled unless an Expo/React Native host explicitly sets
 debug `setOtaVersionUrl` surface. Pre-39 glasses retain their separate legacy
 path because those clients ignore the URL sent by the phone.
 
+## Phone notifications
+
+`engine.phoneNotifications` owns the notification policy for every host.
+Capture (Android's listener, or glasses that read the phone's stream) is never
+gated by it. Presentation has one owner per event, from
+`presentationOwner(hostActive)`:
+
+- `viewer` — the engine's notifications page, on connected Glassly CFW glasses
+- `firmware` — glasses whose firmware presents notifications
+  (`hasNativeNotifications`); on Android the host hands the event over with
+  `uploadToGlasses(event)`, on iOS the glasses already have it
+- `host` — the host's own card and speech, while its surface (Notify) runs
+- `none` — notifications are off, or nothing is there to show them
+
+Miniapp forwarding is not presentation and stays independent.
+
+Four settings drive firmware and viewer alike: `notifications_enabled`,
+`notifications_popups`, `notifications_popup_seconds` (0 = the presenter's
+default) and `notifications_hold_during_apps`, plus the shared
+`notifications_blocklist` and the phone-activity gate
+`notifications_ignore_while_active`. `PhoneNotificationsSync` folds them into
+one `GlassesNotificationConfig` and pushes it through the Bluetooth SDK on
+every change and every connection; the pure mapping lives in
+`services/notifications/notificationPolicy.ts`. `captureAuthorization()`
+tells the settings UI whether the glasses may read the phone's notifications
+(`not_needed` where the phone captures); `popupSecondsOptions()` lists the
+durations the connected firmware accepts.
+
 ## Imports
 
 Inside `mobile/modules/engine/src/`, use **relative paths** (`./services/...`,

package/build/engine.d.ts

@@ -5,7 +5,7 @@
  * name stays `engine` in code; the public API surface is `engine`.)
  *
  * It grows one facade at a time. The migration-era flat store/service exports
- * remain in a private GlasslyOS host package; they shrink as screens move onto
+ * remain in a private Glassly host package; they shrink as screens move onto
  * `engine.*`.
  */
 import { configure, updateUiSeams } from "./runtime/bootstrap";
@@ -39,6 +39,23 @@ export declare const engine: {
         requestVersionInfo: () => Promise<import("@glassly/bluetooth-sdk").VersionInfoResult>;
         onButtonPress: (cb: (event: import("@glassly/bluetooth-sdk").ButtonPressEvent) => void) => (() => void);
         onTouchGesture: (cb: (event: import("@glassly/bluetooth-sdk").TouchEvent) => void) => (() => void);
+        keyboard: {
+            scan: () => Promise<import("@glassly/bluetooth-sdk").KeyboardAdvertEvent[]>;
+            connect: (device: {
+                address: string;
+                addressType: number;
+                name: string;
+            }) => Promise<void>;
+            reconnect: () => Promise<void>;
+            disconnect: () => Promise<void>;
+            forget: () => Promise<void>;
+            passkey: (pin: number) => Promise<void>;
+            compare: (accept: boolean) => Promise<void>;
+            status: () => import("./facades/glasses").KeyboardStatusSnapshot;
+            onStatus: (cb: (status: import("./facades/glasses").KeyboardStatusSnapshot) => void) => (() => void);
+            onAdvert: (cb: (advert: import("@glassly/bluetooth-sdk").KeyboardAdvertEvent) => void) => (() => void);
+            onPairing: (cb: (prompt: import("@glassly/bluetooth-sdk").KeyboardPairingEvent) => void) => (() => void);
+        };
         controller: {
             connectDefault: () => Promise<void>;
             disconnect: () => Promise<void>;
@@ -122,6 +139,7 @@ export declare const engine: {
     };
     /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */
     dev: {
+        sendGesture: typeof import("./services/GlassesTouchInput").sendGesture;
         cloudUrls: () => {
             core?: string;
             runtime?: string;
@@ -143,6 +161,7 @@ export declare const engine: {
         }>;
         runtimeStatus: () => import("./facades/dev").DevRuntimeStatusSnapshot;
         onRuntimeStatus: (cb: (status: import("./facades/dev").DevRuntimeStatusSnapshot) => void) => (() => void);
+        onDashboardOpenTrace: (cb: (report: import("./services/debug/DashboardOpenTrace").DashboardOpenReport) => void) => (() => void);
     };
     /** Bug-report, automatic runtime report, and feedback submission. */
     reports: {
@@ -207,6 +226,7 @@ export declare const engine: {
         uninstall: (packageName: string, version?: string | undefined) => import("typesafe-ts").AsyncResult<void, Error>;
         saveScreenshot: (packageName: string, screenshot: string) => Promise<void>;
         setHiddenStatus: (packageName: string, status: boolean) => void;
+        setPersistent: (packageName: string, status: boolean) => Promise<void>;
     };
     /** First-time glasses discovery + pairing. */
     pairing: {
@@ -247,19 +267,23 @@ export declare const engine: {
     };
     /** Phone→glasses notification forwarding (Android). */
     phoneNotifications: {
-        installedApps: () => Promise<Array<{
-            packageName: string;
-            appName: string;
-            icon: string | null;
-        }>>;
+        installedApps: typeof import("./services/PhoneNotificationsSync").installedNotificationApps;
         blocklist: () => string[];
         setBlocklist: (packageNames: string[]) => import("typesafe-ts").AsyncResult<void, Error>;
         hasListenerPermission: () => Promise<boolean>;
         requestListenerPermission: () => Promise<boolean> | undefined;
-        ancsAuthorized: () => boolean;
+        captureAuthorization: typeof import("./services/PhoneNotificationsSync").captureAuthorization;
+        nativeNotifications: typeof import("./services/PhoneNotificationsSync").nativeNotificationsSupported;
+        popupSecondsOptions: typeof import("./services/PhoneNotificationsSync").nativeNotificationPopupSeconds;
+        presentationOwner: typeof import("./services/PhoneNotificationsSync").currentPresentationOwner;
+        uploadToGlasses: (event: import("@glassly/crust").PhoneNotificationEvent) => Promise<void>;
+        glassesStatus: () => Promise<import("@glassly/bluetooth-sdk").GlassesNotificationStatus>;
+        onGlassesStatus: (listener: (status: import("@glassly/bluetooth-sdk").GlassesNotificationStatus) => void) => (() => void);
+        onUploadResult: (listener: (result: import("@glassly/bluetooth-sdk").NotificationUploadResult) => void) => (() => void);
     };
     /** OS permissions (check/request/openSettings + per-miniapp requirements). */
     permissions: {
+        missingRequired(requirements: readonly import("./types").AppletPermission[]): Promise<string[]>;
         check(feature: string): Promise<boolean>;
         request(feature: string): Promise<boolean>;
         openSettings: () => Promise<void>;
@@ -291,9 +315,6 @@ export declare const engine: {
         stats: () => Promise<import(".").MemoryStats>;
         clearAll: () => Promise<void>;
         onChanged: (listener: () => void) => (() => void);
-        retentionExtended: () => boolean;
-        retentionDays: (extended?: boolean) => number;
-        setRetentionExtended: (extended: boolean) => void;
     };
     /** Device-local voice profiles for on-device speaker ID (Settings > Speakers). */
     speakers: {
@@ -334,6 +355,7 @@ export declare const engine: {
         mirror: {
             current(): import(".").DisplayMirrorEvent;
             onMirror(cb: (event: import(".").DisplayMirrorEvent) => void): () => void;
+            canvas(previewModel?: string): import("./facades/displayMirror").DisplayMirrorCanvas;
         };
         dashboard: {
             isOpen: () => boolean;

package/build/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,SAAS,EAAkD,aAAa,EAAC,MAAM,qBAAqB,CAAA;AAyC5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IAoF7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgCrC,mFAAmF;;;;;;;;IAEnF,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;gBA5GxD,CAAC;mBAClB,CAAC;;;gBAIyC,CAAC;mBAAiB,CAAC;;;;;;;;;;;;;;;;IAyGzE,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;IAE9E,qFAAqF;;;;IAErF,4EAA4E;;;;;;;;;;;IAE5E,+EAA+E;;;;;;;;;;;;;;;IAE/E,kFAAkF;;;;;+BA9HvC,CAAC;;;+BASyB,CAAC;;;;;;;;;;;;IAuHtE,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGpF,CAAA"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,SAAS,EAAkD,aAAa,EAAC,MAAM,qBAAqB,CAAA;AA0C5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IA2F7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiCrC,mFAAmF;;;;;;;;IAEnF,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;;gBAjH3E,CAAC;mBAAiB,CAAC;;;gBAKN,CAAC;mBAAiB,CAAC;;;;;;;;;;;;;;;;;IA8G1C,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;;IAE9E,qFAAqF;;;;IAErF,4EAA4E;;;;;;;;;;;IAE5E,+EAA+E;;;;;;;;;;;;IAE/E,kFAAkF;;;;;+BAzI5B,CAAC;;;+BAmBrD,CAPA;;;;;;;;;;;;IA+HF,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGpF,CAAA"}

package/build/engine.js

@@ -5,12 +5,13 @@
  * name stays `engine` in code; the public API surface is `engine`.)
  *
  * It grows one facade at a time. The migration-era flat store/service exports
- * remain in a private GlasslyOS host package; they shrink as screens move onto
+ * remain in a private Glassly host package; they shrink as screens move onto
  * `engine.*`.
  */
 import { configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams } from "./runtime/bootstrap";
 import { cloudClientService } from "./services/CloudClientService";
 import { hydrateDeviceStore, demoteOrphanedDefaultWearable } from "./services/DeviceStoreHydration";
+import { startPairedGlassesLatch, stopPairedGlassesLatch } from "./services/PairedGlassesLatch";
 import { startGlassesSettingsSync, stopGlassesSettingsSync } from "./services/GlassesSettingsSync";
 import { startGlassesStatusProjection, stopGlassesStatusProjection } from "./services/GlassesStatusProjection";
 import { startOtaService, stopOtaService } from "./services/OtaService";
@@ -18,6 +19,7 @@ import { startAudioCloudUplink, stopAudioCloudUplink } from "./services/AudioClo
 import sonioxDirectService from "./services/soniox/SonioxDirectService";
 import { startSupportProfileSync, stopSupportProfileSync } from "./services/SupportProfileSync";
 import { startDeviceEventRouter, stopDeviceEventRouter } from "./services/DeviceEventRouter";
+import { startPhoneActivityTracking, stopPhoneActivityTracking } from "./services/PhoneActivity";
 import { startPhoneNotificationsSync, stopPhoneNotificationsSync } from "./services/PhoneNotificationsSync";
 import { startSpeakerIdSync, stopSpeakerIdSync } from "./services/SpeakerIdSync";
 import { startCaptionsTesterReportService, stopCaptionsTesterReportService } from "./services/CaptionsTesterReportService";
@@ -45,8 +47,7 @@ import { memory } from "./facades/memory";
 import { speakers } from "./facades/speakers";
 import { providerKeys } from "./facades/providerKeys";
 import { logBuffer } from "./utils/devLogging";
-import customDashboardService from "./services/CustomDashboardService";
-import dashboardCoordinator from "./services/DashboardCoordinator";
+import pageHost from "./services/pages/PageHost";
 import gestureDotsService from "./services/GestureDotsService";
 export const engine = {
     /** Front door — hand engine auth + config, then start/stop the runtime. */
@@ -68,8 +69,12 @@ export const engine = {
         // of the runtime reads). Established first so the stores are live before the
         // syncs below react to them.
         startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent("glasses_connection_state", changed));
-        customDashboardService.start();
-        dashboardCoordinator.start();
+        // Lock + foreground state, read by the dashboard's notification gate and
+        // the G2 notification ctrl below; up before either consumer.
+        startPhoneActivityTracking();
+        // The overlay slot's owner: the designated dashboard miniapp's page shows
+        // through it (ADR-0006), so it is up before the miniapp runtime.
+        pageHost.start();
         gestureDotsService.start();
         // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,
         // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->
@@ -95,6 +100,8 @@ export const engine = {
         catch (error) {
             console.warn("engine.start: device-store hydration failed:", error instanceof Error ? error.message : error);
         }
+        // After the settings load so an already-paired phone latches on this start.
+        startPairedGlassesLatch();
         // Project the glasses' OTA events into the store for the engine.ota read surface.
         startOtaService();
         // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription
@@ -103,12 +110,12 @@ export const engine = {
         // Phone -> Soniox direct transcription (user-supplied API key). Started
         // after device-store hydration so the persisted key is already loaded.
         sonioxDirectService.start();
-        try {
-            await cloudClientService.syncCoreTokenToBluetooth();
-        }
-        catch (error) {
+        // Not awaited: the exchange behind it is a Core round trip with no client
+        // deadline, and start() must resolve offline. The glasses get the token
+        // when it lands; identity resolution joins the same single-flight exchange.
+        void cloudClientService.syncCoreTokenToBluetooth().catch((error) => {
             console.warn("engine.start: initial Cloud V2 core token sync failed:", error instanceof Error ? error.message : error);
-        }
+        });
         startSupportProfileSync();
         // Push device-setting changes to the glasses for ANY host, so
         // engine.glasses.settings.set() reaches the device (not just the Glassly app).
@@ -122,11 +129,11 @@ export const engine = {
         // Android internal/e2e: laptop captions tester can broadcast a failure intent;
         // engine owns turning that into a Cloud V2 report.
         startCaptionsTesterReportService();
-        // GlasslyJS crashloop-disabled is runtime state; engine owns filing the
+        // JSRuntime crashloop-disabled is runtime state; engine owns filing the
         // automatic report while hosts only render alert/telemetry side effects.
         startJSCrashloopReportService();
-        // Bring up the local-miniapp engine so a bare OEM can run GlasslyJS miniapps:
-        // the LocalMiniappRuntime (registry + WebView bridge), the GlasslyJS router
+        // Bring up the local-miniapp engine so a bare OEM can run JSRuntime miniapps:
+        // the LocalMiniappRuntime (registry + WebView bridge), the JSRuntime router
         // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor
         // (layout arbitration over the engine stores), and the gallery-sync service.
         // All idempotent — when the Glassly app's host bootstrap also calls these, the
@@ -150,19 +157,20 @@ export const engine = {
             }
         };
         await safely("glasses settings sync", stopGlassesSettingsSync);
+        await safely("paired glasses latch", stopPairedGlassesLatch);
         await safely("glasses status projection", stopGlassesStatusProjection);
         await safely("device event router", stopDeviceEventRouter);
-        await safely("dashboard coordinator", () => dashboardCoordinator.stop());
-        await safely("custom dashboard service", () => customDashboardService.stop());
+        await safely("page host", () => pageHost.stop());
         await safely("gesture dots service", () => gestureDotsService.stop());
         await safely("ota service", stopOtaService);
         await safely("audio cloud uplink", stopAudioCloudUplink);
         await safely("soniox direct service", () => sonioxDirectService.stop());
         await safely("support profile sync", stopSupportProfileSync);
         await safely("phone notifications sync", stopPhoneNotificationsSync);
+        await safely("phone activity tracking", stopPhoneActivityTracking);
         await safely("speaker id sync", stopSpeakerIdSync);
         await safely("captions tester report service", stopCaptionsTesterReportService);
-        await safely("glasslyjs crashloop report service", stopJSCrashloopReportService);
+        await safely("js crashloop report service", stopJSCrashloopReportService);
         await safely("miniapp engine", stopMiniappEngine);
         await safely("local miniapp runtime", () => localMiniappRuntime.cleanup());
         await safely("display processor", () => displayProcessor.detachFromRuntime());

package/build/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,SAAS,EAAE,KAAK,IAAI,cAAc,EAAE,IAAI,IAAI,aAAa,EAAE,aAAa,EAAC,MAAM,qBAAqB,CAAA;AAC5G,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAC,kBAAkB,EAAE,6BAA6B,EAAC,MAAM,iCAAiC,CAAA;AACjG,OAAO,EAAC,wBAAwB,EAAE,uBAAuB,EAAC,MAAM,gCAAgC,CAAA;AAChG,OAAO,EAAC,4BAA4B,EAAE,2BAA2B,EAAC,MAAM,oCAAoC,CAAA;AAC5G,OAAO,EAAC,eAAe,EAAE,cAAc,EAAC,MAAM,uBAAuB,CAAA;AACrE,OAAO,EAAC,qBAAqB,EAAE,oBAAoB,EAAC,MAAM,6BAA6B,CAAA;AACvF,OAAO,mBAAmB,MAAM,uCAAuC,CAAA;AACvE,OAAO,EAAC,uBAAuB,EAAE,sBAAsB,EAAC,MAAM,+BAA+B,CAAA;AAC7F,OAAO,EAAC,sBAAsB,EAAE,qBAAqB,EAAC,MAAM,8BAA8B,CAAA;AAC1F,OAAO,EAAC,2BAA2B,EAAE,0BAA0B,EAAC,MAAM,mCAAmC,CAAA;AACzG,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAC,gCAAgC,EAAE,+BAA+B,EAAC,MAAM,wCAAwC,CAAA;AACxH,OAAO,EAAC,6BAA6B,EAAE,4BAA4B,EAAC,MAAM,qCAAqC,CAAA;AAC/G,OAAO,EAAC,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,0BAA0B,CAAA;AAC/E,OAAO,mBAAmB,MAAM,gCAAgC,CAAA;AAChE,OAAO,gBAAgB,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAC,GAAG,EAAC,MAAM,eAAe,CAAA;AACjC,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,GAAG,EAAC,MAAM,eAAe,CAAA;AACjC,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAC,OAAO,EAAC,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAC,IAAI,EAAC,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAC,YAAY,EAAC,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAC5C,OAAO,sBAAsB,MAAM,mCAAmC,CAAA;AACtE,OAAO,oBAAoB,MAAM,iCAAiC,CAAA;AAClE,OAAO,kBAAkB,MAAM,+BAA+B,CAAA;AAE9D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,2EAA2E;IAC3E,SAAS;IACT,8EAA8E;IAC9E,aAAa;IACb;iDAC6C;IAC7C,KAAK,CAAC,KAAK;QACT,4EAA4E;QAC5E,oEAAoE;QACpE,SAAS,CAAC,wBAAwB,EAAE,CAAA;QACpC,MAAM,cAAc,EAAE,CAAA;QACtB,6EAA6E;QAC7E,2EAA2E;QAC3E,iBAAiB;QACjB,kBAAkB,CAAC,IAAI,EAAE,CAAA;QACzB,+EAA+E;QAC/E,6EAA6E;QAC7E,6BAA6B;QAC7B,4BAA4B,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,YAAY,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC,CAAA;QAChH,sBAAsB,CAAC,KAAK,EAAE,CAAA;QAC9B,oBAAoB,CAAC,KAAK,EAAE,CAAA;QAC5B,kBAAkB,CAAC,KAAK,EAAE,CAAA;QAC1B,mFAAmF;QACnF,qFAAqF;QACrF,oFAAoF;QACpF,+BAA+B;QAC/B,sBAAsB,EAAE,CAAA;QACxB,2EAA2E;QAC3E,4EAA4E;QAC5E,yEAAyE;QACzE,uEAAuE;QACvE,qEAAqE;QACrE,2EAA2E;QAC3E,oEAAoE;QACpE,sDAAsD;QACtD,IAAI,CAAC;YACH,MAAM,kBAAkB,EAAE,CAAA;YAC1B,qEAAqE;YACrE,yEAAyE;YACzE,wEAAwE;YACxE,+DAA+D;YAC/D,MAAM,6BAA6B,EAAE,CAAA;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAC9G,CAAC;QACD,kFAAkF;QAClF,eAAe,EAAE,CAAA;QACjB,gFAAgF;QAChF,gFAAgF;QAChF,qBAAqB,EAAE,CAAA;QACvB,wEAAwE;QACxE,uEAAuE;QACvE,mBAAmB,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,wBAAwB,EAAE,CAAA;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,wDAAwD,EACxD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAA;QACH,CAAC;QACD,uBAAuB,EAAE,CAAA;QACzB,8DAA8D;QAC9D,+EAA+E;QAC/E,wBAAwB,EAAE,CAAA;QAC1B,uEAAuE;QACvE,2BAA2B,EAAE,CAAA;QAC7B,wEAAwE;QACxE,0EAA0E;QAC1E,qEAAqE;QACrE,kBAAkB,EAAE,CAAA;QACpB,+EAA+E;QAC/E,mDAAmD;QACnD,gCAAgC,EAAE,CAAA;QAClC,wEAAwE;QACxE,yEAAyE;QACzE,6BAA6B,EAAE,CAAA;QAC/B,8EAA8E;QAC9E,4EAA4E;QAC5E,4EAA4E;QAC5E,6EAA6E;QAC7E,+EAA+E;QAC/E,oEAAoE;QACpE,iCAAiC;QACjC,mBAAmB,CAAC,UAAU,EAAE,CAAA;QAChC,mBAAmB,EAAE,CAAA;QACrB,gBAAgB,CAAC,eAAe,EAAE,CAAA;QAClC,kBAAkB,CAAC,UAAU,EAAE,CAAA;IACjC,CAAC;IACD;;yCAEqC;IACrC,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,KAAK,EAAE,KAAa,EAAE,IAAmB,EAAiB,EAAE;YACzE,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAA;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,UAAU,EAAE,KAAK,CAAC,CAAA;YACtD,CAAC;QACH,CAAC,CAAA;QACD,MAAM,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC,CAAA;QAC9D,MAAM,MAAM,CAAC,2BAA2B,EAAE,2BAA2B,CAAC,CAAA;QACtE,MAAM,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAA;QAC1D,MAAM,MAAM,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAA;QACxE,MAAM,MAAM,CAAC,0BAA0B,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7E,MAAM,MAAM,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAA;QACrE,MAAM,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;QAC3C,MAAM,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAA;QACxD,MAAM,MAAM,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAA;QACvE,MAAM,MAAM,CAAC,sBAAsB,EAAE,sBAAsB,CAAC,CAAA;QAC5D,MAAM,MAAM,CAAC,0BAA0B,EAAE,0BAA0B,CAAC,CAAA;QACpE,MAAM,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAA;QAClD,MAAM,MAAM,CAAC,gCAAgC,EAAE,+BAA+B,CAAC,CAAA;QAC/E,MAAM,MAAM,CAAC,oCAAoC,EAAE,4BAA4B,CAAC,CAAA;QAChF,MAAM,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;QACjD,MAAM,MAAM,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1E,MAAM,MAAM,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,CAAA;QAC7E,MAAM,MAAM,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAA;QACxE,MAAM,MAAM,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAA;QACjE,MAAM,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO;IACP,MAAM;IACN,mFAAmF;IACnF,OAAO;IACP,sEAAsE;IACtE,QAAQ;IACR,qFAAqF;IACrF,GAAG;IACH,qEAAqE;IACrE,OAAO;IACP,sFAAsF;IACtF,GAAG;IACH,6EAA6E;IAC7E,OAAO;IACP,iFAAiF;IACjF,QAAQ;IACR,8CAA8C;IAC9C,OAAO;IACP,uDAAuD;IACvD,kBAAkB;IAClB,8EAA8E;IAC9E,WAAW;IACX,qFAAqF;IACrF,aAAa;IACb,4EAA4E;IAC5E,IAAI;IACJ,+EAA+E;IAC/E,MAAM;IACN,kFAAkF;IAClF,QAAQ;IACR,mFAAmF;IACnF,YAAY;IACZ,OAAO;CACR,CAAA","sourcesContent":["/**\n * `engine` — the namespaced OEM-facing engine API (the \"(A) host API\" from the\n * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a\n * typed facade over the runtime. (Exported from the `@glassly/engine` module, whose\n * name stays `engine` in code; the public API surface is `engine`.)\n *\n * It grows one facade at a time. The migration-era flat store/service exports\n * remain in a private GlasslyOS host package; they shrink as screens move onto\n * `engine.*`.\n */\nimport {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from \"./runtime/bootstrap\"\nimport {cloudClientService} from \"./services/CloudClientService\"\nimport {hydrateDeviceStore, demoteOrphanedDefaultWearable} from \"./services/DeviceStoreHydration\"\nimport {startGlassesSettingsSync, stopGlassesSettingsSync} from \"./services/GlassesSettingsSync\"\nimport {startGlassesStatusProjection, stopGlassesStatusProjection} from \"./services/GlassesStatusProjection\"\nimport {startOtaService, stopOtaService} from \"./services/OtaService\"\nimport {startAudioCloudUplink, stopAudioCloudUplink} from \"./services/AudioCloudUplink\"\nimport sonioxDirectService from \"./services/soniox/SonioxDirectService\"\nimport {startSupportProfileSync, stopSupportProfileSync} from \"./services/SupportProfileSync\"\nimport {startDeviceEventRouter, stopDeviceEventRouter} from \"./services/DeviceEventRouter\"\nimport {startPhoneNotificationsSync, stopPhoneNotificationsSync} from \"./services/PhoneNotificationsSync\"\nimport {startSpeakerIdSync, stopSpeakerIdSync} from \"./services/SpeakerIdSync\"\nimport {startCaptionsTesterReportService, stopCaptionsTesterReportService} from \"./services/CaptionsTesterReportService\"\nimport {startJSCrashloopReportService, stopJSCrashloopReportService} from \"./services/JSCrashloopReportService\"\nimport {ensureMiniappEngine, stopMiniappEngine} from \"./services/MiniappEngine\"\nimport localMiniappRuntime from \"./services/LocalMiniappRuntime\"\nimport displayProcessor from \"./services/DisplayProcessor\"\nimport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nimport {glasses} from \"./facades/glasses\"\nimport {display} from \"./facades/display\"\nimport {speech} from \"./facades/speech\"\nimport {session} from \"./facades/session\"\nimport {settings} from \"./facades/settings\"\nimport {dev} from \"./facades/dev\"\nimport {reports} from \"./facades/reports\"\nimport {ota} from \"./facades/ota\"\nimport {gallery} from \"./facades/gallery\"\nimport {miniapps} from \"./facades/miniapps\"\nimport {pairing} from \"./facades/pairing\"\nimport {phoneNotifications} from \"./facades/phoneNotifications\"\nimport {permissions} from \"./facades/permissions\"\nimport {notifications} from \"./facades/notifications\"\nimport {maps} from \"./facades/maps\"\nimport {memory} from \"./facades/memory\"\nimport {speakers} from \"./facades/speakers\"\nimport {providerKeys} from \"./facades/providerKeys\"\nimport {logBuffer} from \"./utils/devLogging\"\nimport customDashboardService from \"./services/CustomDashboardService\"\nimport dashboardCoordinator from \"./services/DashboardCoordinator\"\nimport gestureDotsService from \"./services/GestureDotsService\"\n\nexport const engine = {\n  /** Front door — hand engine auth + config, then start/stop the runtime. */\n  configure,\n  /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */\n  updateUiSeams,\n  /** Start the runtime: mark started + construct/connect the cloud client + begin\n   * syncing device settings to the glasses. */\n  async start() {\n    // Reports attach recent phone logs, so engine owns console interception for\n    // OEM hosts too. Idempotent; the Glassly host may start it earlier.\n    logBuffer.startConsoleInterception()\n    await bootstrapStart()\n    // Construct + connect the cloud client so the documented configure()+start()\n    // lifecycle yields a live engine.session for OEMs. Idempotent for repeated\n    // start() calls.\n    cloudClientService.init()\n    // Project native device status -> the engine stores (the inbound feed the rest\n    // of the runtime reads). Established first so the stores are live before the\n    // syncs below react to them.\n    startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent(\"glasses_connection_state\", changed))\n    customDashboardService.start()\n    dashboardCoordinator.start()\n    gestureDotsService.start()\n    // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,\n    // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->\n    // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the\n    // Glassly app's MantleManager.\n    startDeviceEventRouter()\n    // Hydration contract: the native DeviceStore is in-memory and starts empty\n    // every launch; seed it from the persisted settings BEFORE start() resolves\n    // so every post-start getDefaultDevice() read is a trustworthy two-state\n    // answer (no false \"absent\" for genuinely-paired users at cold start).\n    // Ordered before startGlassesSettingsSync so the settings load can't\n    // double-push through the change subscription. A failed hydration must not\n    // brick the runtime: start() continues, and the guards that consume\n    // hasDefaultDevice() see the rejection and fail open.\n    try {\n      await hydrateDeviceStore()\n      // Boot repair: a persisted default_wearable without a native default\n      // device (identity abandoned mid-pairing, or resurrected from the server\n      // before identity stopped syncing) demotes to pending_wearable so hosts\n      // render finish-pairing instead of a connect that would throw.\n      await demoteOrphanedDefaultWearable()\n    } catch (error) {\n      console.warn(\"engine.start: device-store hydration failed:\", error instanceof Error ? error.message : error)\n    }\n    // Project the glasses' OTA events into the store for the engine.ota read surface.\n    startOtaService()\n    // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription\n    // works for any host (not just the Glassly app's host-side MantleManager fork).\n    startAudioCloudUplink()\n    // Phone -> Soniox direct transcription (user-supplied API key). Started\n    // after device-store hydration so the persisted key is already loaded.\n    sonioxDirectService.start()\n    try {\n      await cloudClientService.syncCoreTokenToBluetooth()\n    } catch (error) {\n      console.warn(\n        \"engine.start: initial Cloud V2 core token sync failed:\",\n        error instanceof Error ? error.message : error,\n      )\n    }\n    startSupportProfileSync()\n    // Push device-setting changes to the glasses for ANY host, so\n    // engine.glasses.settings.set() reaches the device (not just the Glassly app).\n    startGlassesSettingsSync()\n    // Same for phone-notification config -> the native listener (Android).\n    startPhoneNotificationsSync()\n    // On-device speaker identification: sync the enabled setting + enrolled\n    // profile centroids to the native SpeakerIdEngine, and start the resolver\n    // that annotates cloud transcripts with resolved speaker identities.\n    startSpeakerIdSync()\n    // Android internal/e2e: laptop captions tester can broadcast a failure intent;\n    // engine owns turning that into a Cloud V2 report.\n    startCaptionsTesterReportService()\n    // GlasslyJS crashloop-disabled is runtime state; engine owns filing the\n    // automatic report while hosts only render alert/telemetry side effects.\n    startJSCrashloopReportService()\n    // Bring up the local-miniapp engine so a bare OEM can run GlasslyJS miniapps:\n    // the LocalMiniappRuntime (registry + WebView bridge), the GlasslyJS router\n    // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor\n    // (layout arbitration over the engine stores), and the gallery-sync service.\n    // All idempotent — when the Glassly app's host bootstrap also calls these, the\n    // second call is a no-op. Host-only crashloop telemetry is attached\n    // separately by the Glassly app.\n    localMiniappRuntime.initialize()\n    ensureMiniappEngine()\n    displayProcessor.attachToRuntime()\n    gallerySyncService.initialize()\n  },\n  /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.\n   * Each step is guarded so one failing teardown can't skip the rest and leak\n   * the remaining runtime services. */\n  async stop() {\n    const safely = async (label: string, step: () => unknown): Promise<void> => {\n      try {\n        await step()\n      } catch (error) {\n        console.warn(`engine.stop: ${label} failed:`, error)\n      }\n    }\n    await safely(\"glasses settings sync\", stopGlassesSettingsSync)\n    await safely(\"glasses status projection\", stopGlassesStatusProjection)\n    await safely(\"device event router\", stopDeviceEventRouter)\n    await safely(\"dashboard coordinator\", () => dashboardCoordinator.stop())\n    await safely(\"custom dashboard service\", () => customDashboardService.stop())\n    await safely(\"gesture dots service\", () => gestureDotsService.stop())\n    await safely(\"ota service\", stopOtaService)\n    await safely(\"audio cloud uplink\", stopAudioCloudUplink)\n    await safely(\"soniox direct service\", () => sonioxDirectService.stop())\n    await safely(\"support profile sync\", stopSupportProfileSync)\n    await safely(\"phone notifications sync\", stopPhoneNotificationsSync)\n    await safely(\"speaker id sync\", stopSpeakerIdSync)\n    await safely(\"captions tester report service\", stopCaptionsTesterReportService)\n    await safely(\"glasslyjs crashloop report service\", stopJSCrashloopReportService)\n    await safely(\"miniapp engine\", stopMiniappEngine)\n    await safely(\"local miniapp runtime\", () => localMiniappRuntime.cleanup())\n    await safely(\"display processor\", () => displayProcessor.detachFromRuntime())\n    await safely(\"gallery sync service\", () => gallerySyncService.cleanup())\n    await safely(\"cloud client\", () => cloudClientService.shutdown())\n    await safely(\"bootstrap\", bootstrapStop)\n  },\n  glasses,\n  speech,\n  /** Cloud (cloud-v2) live-session status + account ops — engine owns the client. */\n  session,\n  /** Typed keyed user settings over the engine-owned settings store. */\n  settings,\n  /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */\n  dev,\n  /** Bug-report, automatic runtime report, and feedback submission. */\n  reports,\n  /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */\n  ota,\n  /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */\n  gallery,\n  /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */\n  miniapps,\n  /** First-time glasses discovery + pairing. */\n  pairing,\n  /** Phone→glasses notification forwarding (Android). */\n  phoneNotifications,\n  /** OS permissions (check/request/openSettings + per-miniapp requirements). */\n  permissions,\n  /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */\n  notifications,\n  /** Maps providers — user-supplied Mapbox access token (Settings > Keys). */\n  maps,\n  /** Shared user-scoped memory timeline (Settings > Memory + session.memory). */\n  memory,\n  /** Device-local voice profiles for on-device speaker ID (Settings > Speakers). */\n  speakers,\n  /** AI/voice provider key validation — user-supplied keys (Settings > API Keys). */\n  providerKeys,\n  display,\n}\n"]}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `engine` — the namespaced OEM-facing engine API (the \"(A) host API\" from the\n * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a\n * typed facade over the runtime. (Exported from the `@glassly/engine` module, whose\n * name stays `engine` in code; the public API surface is `engine`.)\n *\n * It grows one facade at a time. The migration-era flat store/service exports\n * remain in a private Glassly host package; they shrink as screens move onto\n * `engine.*`.\n */\nimport {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from \"./runtime/bootstrap\"\nimport {cloudClientService} from \"./services/CloudClientService\"\nimport {hydrateDeviceStore, demoteOrphanedDefaultWearable} from \"./services/DeviceStoreHydration\"\nimport {startPairedGlassesLatch, stopPairedGlassesLatch} from \"./services/PairedGlassesLatch\"\nimport {startGlassesSettingsSync, stopGlassesSettingsSync} from \"./services/GlassesSettingsSync\"\nimport {startGlassesStatusProjection, stopGlassesStatusProjection} from \"./services/GlassesStatusProjection\"\nimport {startOtaService, stopOtaService} from \"./services/OtaService\"\nimport {startAudioCloudUplink, stopAudioCloudUplink} from \"./services/AudioCloudUplink\"\nimport sonioxDirectService from \"./services/soniox/SonioxDirectService\"\nimport {startSupportProfileSync, stopSupportProfileSync} from \"./services/SupportProfileSync\"\nimport {startDeviceEventRouter, stopDeviceEventRouter} from \"./services/DeviceEventRouter\"\nimport {startPhoneActivityTracking, stopPhoneActivityTracking} from \"./services/PhoneActivity\"\nimport {startPhoneNotificationsSync, stopPhoneNotificationsSync} from \"./services/PhoneNotificationsSync\"\nimport {startSpeakerIdSync, stopSpeakerIdSync} from \"./services/SpeakerIdSync\"\nimport {startCaptionsTesterReportService, stopCaptionsTesterReportService} from \"./services/CaptionsTesterReportService\"\nimport {startJSCrashloopReportService, stopJSCrashloopReportService} from \"./services/JSCrashloopReportService\"\nimport {ensureMiniappEngine, stopMiniappEngine} from \"./services/MiniappEngine\"\nimport localMiniappRuntime from \"./services/LocalMiniappRuntime\"\nimport displayProcessor from \"./services/DisplayProcessor\"\nimport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nimport {glasses} from \"./facades/glasses\"\nimport {display} from \"./facades/display\"\nimport {speech} from \"./facades/speech\"\nimport {session} from \"./facades/session\"\nimport {settings} from \"./facades/settings\"\nimport {dev} from \"./facades/dev\"\nimport {reports} from \"./facades/reports\"\nimport {ota} from \"./facades/ota\"\nimport {gallery} from \"./facades/gallery\"\nimport {miniapps} from \"./facades/miniapps\"\nimport {pairing} from \"./facades/pairing\"\nimport {phoneNotifications} from \"./facades/phoneNotifications\"\nimport {permissions} from \"./facades/permissions\"\nimport {notifications} from \"./facades/notifications\"\nimport {maps} from \"./facades/maps\"\nimport {memory} from \"./facades/memory\"\nimport {speakers} from \"./facades/speakers\"\nimport {providerKeys} from \"./facades/providerKeys\"\nimport {logBuffer} from \"./utils/devLogging\"\nimport pageHost from \"./services/pages/PageHost\"\nimport gestureDotsService from \"./services/GestureDotsService\"\n\nexport const engine = {\n  /** Front door — hand engine auth + config, then start/stop the runtime. */\n  configure,\n  /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */\n  updateUiSeams,\n  /** Start the runtime: mark started + construct/connect the cloud client + begin\n   * syncing device settings to the glasses. */\n  async start() {\n    // Reports attach recent phone logs, so engine owns console interception for\n    // OEM hosts too. Idempotent; the Glassly host may start it earlier.\n    logBuffer.startConsoleInterception()\n    await bootstrapStart()\n    // Construct + connect the cloud client so the documented configure()+start()\n    // lifecycle yields a live engine.session for OEMs. Idempotent for repeated\n    // start() calls.\n    cloudClientService.init()\n    // Project native device status -> the engine stores (the inbound feed the rest\n    // of the runtime reads). Established first so the stores are live before the\n    // syncs below react to them.\n    startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent(\"glasses_connection_state\", changed))\n    // Lock + foreground state, read by the dashboard's notification gate and\n    // the G2 notification ctrl below; up before either consumer.\n    startPhoneActivityTracking()\n    // The overlay slot's owner: the designated dashboard miniapp's page shows\n    // through it (ADR-0006), so it is up before the miniapp runtime.\n    pageHost.start()\n    gestureDotsService.start()\n    // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,\n    // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->\n    // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the\n    // Glassly app's MantleManager.\n    startDeviceEventRouter()\n    // Hydration contract: the native DeviceStore is in-memory and starts empty\n    // every launch; seed it from the persisted settings BEFORE start() resolves\n    // so every post-start getDefaultDevice() read is a trustworthy two-state\n    // answer (no false \"absent\" for genuinely-paired users at cold start).\n    // Ordered before startGlassesSettingsSync so the settings load can't\n    // double-push through the change subscription. A failed hydration must not\n    // brick the runtime: start() continues, and the guards that consume\n    // hasDefaultDevice() see the rejection and fail open.\n    try {\n      await hydrateDeviceStore()\n      // Boot repair: a persisted default_wearable without a native default\n      // device (identity abandoned mid-pairing, or resurrected from the server\n      // before identity stopped syncing) demotes to pending_wearable so hosts\n      // render finish-pairing instead of a connect that would throw.\n      await demoteOrphanedDefaultWearable()\n    } catch (error) {\n      console.warn(\"engine.start: device-store hydration failed:\", error instanceof Error ? error.message : error)\n    }\n    // After the settings load so an already-paired phone latches on this start.\n    startPairedGlassesLatch()\n    // Project the glasses' OTA events into the store for the engine.ota read surface.\n    startOtaService()\n    // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription\n    // works for any host (not just the Glassly app's host-side MantleManager fork).\n    startAudioCloudUplink()\n    // Phone -> Soniox direct transcription (user-supplied API key). Started\n    // after device-store hydration so the persisted key is already loaded.\n    sonioxDirectService.start()\n    // Not awaited: the exchange behind it is a Core round trip with no client\n    // deadline, and start() must resolve offline. The glasses get the token\n    // when it lands; identity resolution joins the same single-flight exchange.\n    void cloudClientService.syncCoreTokenToBluetooth().catch((error) => {\n      console.warn(\n        \"engine.start: initial Cloud V2 core token sync failed:\",\n        error instanceof Error ? error.message : error,\n      )\n    })\n    startSupportProfileSync()\n    // Push device-setting changes to the glasses for ANY host, so\n    // engine.glasses.settings.set() reaches the device (not just the Glassly app).\n    startGlassesSettingsSync()\n    // Same for phone-notification config -> the native listener (Android).\n    startPhoneNotificationsSync()\n    // On-device speaker identification: sync the enabled setting + enrolled\n    // profile centroids to the native SpeakerIdEngine, and start the resolver\n    // that annotates cloud transcripts with resolved speaker identities.\n    startSpeakerIdSync()\n    // Android internal/e2e: laptop captions tester can broadcast a failure intent;\n    // engine owns turning that into a Cloud V2 report.\n    startCaptionsTesterReportService()\n    // JSRuntime crashloop-disabled is runtime state; engine owns filing the\n    // automatic report while hosts only render alert/telemetry side effects.\n    startJSCrashloopReportService()\n    // Bring up the local-miniapp engine so a bare OEM can run JSRuntime miniapps:\n    // the LocalMiniappRuntime (registry + WebView bridge), the JSRuntime router\n    // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor\n    // (layout arbitration over the engine stores), and the gallery-sync service.\n    // All idempotent — when the Glassly app's host bootstrap also calls these, the\n    // second call is a no-op. Host-only crashloop telemetry is attached\n    // separately by the Glassly app.\n    localMiniappRuntime.initialize()\n    ensureMiniappEngine()\n    displayProcessor.attachToRuntime()\n    gallerySyncService.initialize()\n  },\n  /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.\n   * Each step is guarded so one failing teardown can't skip the rest and leak\n   * the remaining runtime services. */\n  async stop() {\n    const safely = async (label: string, step: () => unknown): Promise<void> => {\n      try {\n        await step()\n      } catch (error) {\n        console.warn(`engine.stop: ${label} failed:`, error)\n      }\n    }\n    await safely(\"glasses settings sync\", stopGlassesSettingsSync)\n    await safely(\"paired glasses latch\", stopPairedGlassesLatch)\n    await safely(\"glasses status projection\", stopGlassesStatusProjection)\n    await safely(\"device event router\", stopDeviceEventRouter)\n    await safely(\"page host\", () => pageHost.stop())\n    await safely(\"gesture dots service\", () => gestureDotsService.stop())\n    await safely(\"ota service\", stopOtaService)\n    await safely(\"audio cloud uplink\", stopAudioCloudUplink)\n    await safely(\"soniox direct service\", () => sonioxDirectService.stop())\n    await safely(\"support profile sync\", stopSupportProfileSync)\n    await safely(\"phone notifications sync\", stopPhoneNotificationsSync)\n    await safely(\"phone activity tracking\", stopPhoneActivityTracking)\n    await safely(\"speaker id sync\", stopSpeakerIdSync)\n    await safely(\"captions tester report service\", stopCaptionsTesterReportService)\n    await safely(\"js crashloop report service\", stopJSCrashloopReportService)\n    await safely(\"miniapp engine\", stopMiniappEngine)\n    await safely(\"local miniapp runtime\", () => localMiniappRuntime.cleanup())\n    await safely(\"display processor\", () => displayProcessor.detachFromRuntime())\n    await safely(\"gallery sync service\", () => gallerySyncService.cleanup())\n    await safely(\"cloud client\", () => cloudClientService.shutdown())\n    await safely(\"bootstrap\", bootstrapStop)\n  },\n  glasses,\n  speech,\n  /** Cloud (cloud-v2) live-session status + account ops — engine owns the client. */\n  session,\n  /** Typed keyed user settings over the engine-owned settings store. */\n  settings,\n  /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */\n  dev,\n  /** Bug-report, automatic runtime report, and feedback submission. */\n  reports,\n  /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */\n  ota,\n  /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */\n  gallery,\n  /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */\n  miniapps,\n  /** First-time glasses discovery + pairing. */\n  pairing,\n  /** Phone→glasses notification forwarding (Android). */\n  phoneNotifications,\n  /** OS permissions (check/request/openSettings + per-miniapp requirements). */\n  permissions,\n  /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */\n  notifications,\n  /** Maps providers — user-supplied Mapbox access token (Settings > Keys). */\n  maps,\n  /** Shared user-scoped memory timeline (Settings > Memory + session.memory). */\n  memory,\n  /** Device-local voice profiles for on-device speaker ID (Settings > Speakers). */\n  speakers,\n  /** AI/voice provider key validation — user-supplied keys (Settings > API Keys). */\n  providerKeys,\n  display,\n}\n"]}

package/build/facades/dev.d.ts

@@ -1,3 +1,5 @@
+import { sendGesture } from "../services/GlassesTouchInput";
+import { type DashboardOpenReport } from "../services/debug/DashboardOpenTrace";
 declare function projectRuntimeStatus(): {
     searching: boolean;
     micRanking: import("@glassly/bluetooth-sdk").MicMode[];
@@ -23,6 +25,8 @@ declare function projectRuntimeStatus(): {
 };
 export type DevRuntimeStatusSnapshot = ReturnType<typeof projectRuntimeStatus>;
 export declare const dev: {
+    /** Inject a glasses gesture through the normal dashboard/miniapp input policy. */
+    sendGesture: typeof sendGesture;
     /** The cloud-v2 core/runtime URL overrides. */
     cloudUrls: () => {
         core?: string;
@@ -64,6 +68,11 @@ export declare const dev: {
     runtimeStatus: () => DevRuntimeStatusSnapshot;
     /** Subscribe to the projected engine runtime status; returns an unsubscribe. */
     onRuntimeStatus: (cb: (status: DevRuntimeStatusSnapshot) => void) => (() => void);
+    /**
+     * Each finished dashboard open while the debug_dashboard_open_timing setting
+     * is on: a ready-made title/body plus the stage timings. Returns an unsubscribe.
+     */
+    onDashboardOpenTrace: (cb: (report: DashboardOpenReport) => void) => (() => void);
 };
 export {};
 //# sourceMappingURL=dev.d.ts.map

package/build/facades/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"AAgEA,iBAAS,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAuB5B;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE9E,eAAO,MAAM,GAAG;IACd,+CAA+C;qBAChC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAIhD,0EAA0E;yBACrD;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAkBtD,8EAA8E;0BAC1D,IAAI;IAExB,iFAAiF;uBAChE,MAAM;IACvB;;;OAGG;2BACkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK5C;;;;;;;;;OASG;0BAEI,MAAM,SACJ,MAAM,KACZ,OAAO,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;IA6CtF,qEAAqE;yBAClD,wBAAwB;IAE3C,gFAAgF;0BAC1D,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAoBhF,CAAA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAC,WAAW,EAAC,MAAM,+BAA+B,CAAA;AACzD,OAA2B,EAAC,KAAK,mBAAmB,EAAC,MAAM,sCAAsC,CAAA;AA2CjG,iBAAS,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAuB5B;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE9E,eAAO,MAAM,GAAG;IACd,kFAAkF;;IAElF,+CAA+C;qBAChC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAIhD,0EAA0E;yBACrD;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAkBtD,8EAA8E;0BAC1D,IAAI;IAExB,iFAAiF;uBAChE,MAAM;IACvB;;;OAGG;2BACkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK5C;;;;;;;;;OASG;0BAEI,MAAM,SACJ,MAAM,KACZ,OAAO,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;IA6CtF,qEAAqE;yBAClD,wBAAwB;IAE3C,gFAAgF;0BAC1D,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAqB/E;;;OAGG;+BACwB,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAChF,CAAA"}

package/build/facades/dev.js

@@ -20,6 +20,8 @@ import { getConfigValues } from "../runtime/bootstrap";
 import { decideDevLaunchRoute } from "../utils/devMiniappLaunch";
 import { deriveDevPackageId, registerDevApp, DEV_APP_PACKAGE_NAME } from "../services/AppRegistry";
 import { useAppStatusStore } from "../stores/apps";
+import { sendGesture } from "../services/GlassesTouchInput";
+import dashboardOpenTrace from "../services/debug/DashboardOpenTrace";
 /**
  * Reconnect the cloud client onto the current cloud-URL overrides. Explicit
  * partial overrides merge over the boot-resolved config (which carries the
@@ -82,6 +84,8 @@ function projectRuntimeStatus() {
     };
 }
 export const dev = {
+    /** Inject a glasses gesture through the normal dashboard/miniapp input policy. */
+    sendGesture,
     /** The cloud-v2 core/runtime URL overrides. */
     cloudUrls: () => {
         const s = useSettingsStore.getState();
@@ -200,5 +204,10 @@ export const dev = {
             unsubscribers.forEach((unsubscribe) => unsubscribe());
         };
     },
+    /**
+     * Each finished dashboard open while the debug_dashboard_open_timing setting
+     * is on: a ready-made title/body plus the stage timings. Returns an unsubscribe.
+     */
+    onDashboardOpenTrace: (cb) => dashboardOpenTrace.onReport(cb),
 };
 //# sourceMappingURL=dev.js.map

package/build/facades/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * dev facade — `engine.dev`: developer/debug surface over engine-owned state.\n * Backend/cloud URL overrides read+write the engine settings store; the cloud\n * URL setters reconnect the engine-owned cloud client onto the new endpoints;\n *\n * NOTE: the dev-time endpoint *resolution* (Metro-host auto-detect, env defaults)\n * still lives host-side in `@/services/cloudClient` during the migration; this\n * facade manages the explicit overrides + reconnect.\n */\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport {isGlassesReady} from \"../services/GlassesReadiness\"\nimport {useCloudClientStatusStore} from \"../stores/cloudClientStatus\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\nimport {useTranscriptionDebugStore} from \"../stores/transcriptionDebug\"\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {getConfigValues} from \"../runtime/bootstrap\"\nimport {decideDevLaunchRoute} from \"../utils/devMiniappLaunch\"\nimport {deriveDevPackageId, registerDevApp, DEV_APP_PACKAGE_NAME, type DevAppRecord} from \"../services/AppRegistry\"\nimport {useAppStatusStore} from \"../stores/apps\"\n\ntype CloudUrlOverrides = {core?: string; runtime?: string}\n\n/**\n * Reconnect the cloud client onto the current cloud-URL overrides. Explicit\n * partial overrides merge over the boot-resolved config (which carries the\n * host's Metro/env URL resolution); both empty clears the live override.\n */\nfunction applyCloudUrlReconnect(urls: CloudUrlOverrides = currentCloudUrlOverrides()): void {\n  const resolved = resolveCloudUrlReconnectTarget(urls)\n  if (resolved === undefined) {\n    cloudClientService.reconnect(null)\n  } else if (resolved) {\n    cloudClientService.reconnect(resolved)\n  } else {\n    console.warn(\"engine.dev.setCloudUrls: partial cloud override missing boot-resolved sibling endpoint\")\n  }\n}\n\nfunction currentCloudUrlOverrides(): CloudUrlOverrides {\n  const s = useSettingsStore.getState()\n  return {\n    core: trimSetting(s.getSetting(SETTINGS.cloud_core_url.key)),\n    runtime: trimSetting(s.getSetting(SETTINGS.cloud_runtime_url.key)),\n  }\n}\n\nfunction resolveCloudUrlReconnectTarget(urls: CloudUrlOverrides): {core: string; runtime: string} | null | undefined {\n  const core = trimSetting(urls.core)\n  const runtime = trimSetting(urls.runtime)\n  if (!core && !runtime) return undefined\n\n  const config = getConfigValues()\n  const resolvedCore = core || config.coreUrl?.trim()\n  const resolvedRuntime = runtime || config.runtimeUrl?.trim()\n  return resolvedCore && resolvedRuntime ? {core: resolvedCore, runtime: resolvedRuntime} : null\n}\n\nfunction trimSetting(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined\n}\n\nfunction projectRuntimeStatus() {\n  const core = useCoreStore.getState()\n  const glasses = useGlassesStore.getState()\n  const connection = useConnectionStore.getState()\n  const cloudClient = useCloudClientStatusStore.getState()\n  const transcriptionDebug = useTranscriptionDebugStore.getState()\n  return {\n    searching: core.searching,\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    micRanking: [...core.micRanking],\n    currentMic: core.currentMic,\n    systemMicUnavailable: core.systemMicUnavailable,\n    glassesConnected: glasses.connection.state === \"connected\",\n    glassesFullyBooted: isGlassesReady(glasses.connection),\n    bluetoothClassicConnected: glasses.bluetoothClassicConnected,\n    coreStatus: connection.status,\n    cloudClientStatus: cloudClient.status,\n    cloudClientAudioTransport: cloudClient.audioTransport,\n    transcriptionSubscribers: [...transcriptionDebug.transcriptionSubscribers],\n    translationSubscribers: [...transcriptionDebug.translationSubscribers],\n    recentTranscriptSources: {...transcriptionDebug.recentTranscriptSources},\n    cloudAudioSubscriptionWrite: {...transcriptionDebug.cloudAudioSubscriptionWrite},\n  }\n}\n\nexport type DevRuntimeStatusSnapshot = ReturnType<typeof projectRuntimeStatus>\n\nexport const dev = {\n  /** The cloud-v2 core/runtime URL overrides. */\n  cloudUrls: (): {core?: string; runtime?: string} => {\n    const s = useSettingsStore.getState()\n    return {core: s.getSetting(SETTINGS.cloud_core_url.key), runtime: s.getSetting(SETTINGS.cloud_runtime_url.key)}\n  },\n  /** Override the cloud-v2 URLs and reconnect the live client onto them. */\n  setCloudUrls: (urls: {core?: string; runtime?: string}) => {\n    const next = {...currentCloudUrlOverrides(), ...urls}\n    const resolved = resolveCloudUrlReconnectTarget(next)\n    if (resolved === null) {\n      console.warn(\"engine.dev.setCloudUrls: ignoring partial cloud override without a resolvable sibling endpoint\")\n      return\n    }\n\n    const s = useSettingsStore.getState()\n    if (urls.core !== undefined) s.setSetting(SETTINGS.cloud_core_url.key, urls.core)\n    if (urls.runtime !== undefined) s.setSetting(SETTINGS.cloud_runtime_url.key, urls.runtime)\n    if (resolved === undefined) {\n      cloudClientService.reconnect(null)\n    } else {\n      cloudClientService.reconnect(resolved)\n    }\n  },\n\n  /** Tear down + rebuild the live cloud client (the dev \"reconnect\" button). */\n  reconnectCloud: (): void => applyCloudUrlReconnect(),\n\n  /** Current native (BLE-process) memory usage in MB — a dev/diagnostics gauge. */\n  getMemoryMB: (): number => BluetoothSdk.getMemoryMB(),\n  /**\n   * Phone-side bluetooth runtime snapshot (the core store read-model: scan/mic/\n   * search state) — the diagnostics/data-export surface. Shallow copy.\n   */\n  bluetoothStatus: (): Record<string, unknown> => {\n    const {setCoreInfo: _setCoreInfo, reset: _reset, ...state} = useCoreStore.getState()\n    return {...state}\n  },\n\n  /**\n   * Side-load a miniapp being served from a dev machine (the `glassly dev` / CLI\n   * flow) by its URL: probes `<url>/miniapp.json`, and on a reachable manifest\n   * registers it under its manifest package so it appears in `engine.miniapps`\n   * and can coexist with other dev miniapps. This is the OEM-host equivalent\n   * of the first-party\n   * developer-URL screen — the registration itself is engine-internal, so a\n   * host reaches it here rather than the internal registry. Rendering still\n   * flows through the normal display path once the miniapp is started.\n   */\n  loadDevMiniapp: async (\n    url: string,\n    name?: string,\n  ): Promise<{ok: true; packageName: string; name: string} | {ok: false; error: string}> => {\n    const devUrl = url.trim().replace(/\\/+$/, \"\")\n    if (!devUrl) return {ok: false, error: \"empty url\"}\n    const result = await decideDevLaunchRoute(\"\", devUrl)\n    if (result.decision !== \"live\") {\n      return {ok: false, error: \"dev server unreachable, or no miniapp.json served there\"}\n    }\n    const manifest = result.manifest\n    const appName = name ?? manifest.name ?? \"Dev Miniapp\"\n    const packageName = (manifest.packageName as string | undefined) ?? DEV_APP_PACKAGE_NAME\n    // Persist the host that answered — not the stale input IP — so home-tile\n    // relaunches skip a dead LAN address after mDNS/Metro failover.\n    const resolvedUrl = result.resolvedUrl || devUrl\n    // The `glassly-miniapp dev` server puts the hot-reload/log sidecar on the\n    // user port PLUS ONE — same convention as the first-party developer-URL\n    // screen's deriveDevPort.\n    let devPort: number | undefined\n    try {\n      const parsed = Number(new URL(resolvedUrl).port)\n      devPort = Number.isFinite(parsed) && parsed > 0 ? parsed + 1 : undefined\n    } catch {\n      devPort = undefined\n    }\n    // The record is stored under a namespaced dev id (deriveDevPackageId) so\n    // it survives release installs of the manifest package — stop/refresh and\n    // the returned packageName must use that id, which registerDevApp returns.\n    const devPackageId = deriveDevPackageId(packageName)\n    const existing = useAppStatusStore.getState().apps.find((app) => app.packageName === devPackageId)\n    if (existing?.running) await useAppStatusStore.getState().stop(devPackageId)\n    const record = await registerDevApp({\n      packageName,\n      name: appName,\n      iconUrl: manifest.icon ? new URL(manifest.icon, `${resolvedUrl}/`).toString() : `${resolvedUrl}/icon.png`,\n      // Persist the host that answered — not the stale input IP.\n      devUrl: resolvedUrl,\n      devPort,\n      type: manifest.type as DevAppRecord[\"type\"],\n      permissions: manifest.permissions as DevAppRecord[\"permissions\"],\n      hardwareRequirements: manifest.hardwareRequirements as DevAppRecord[\"hardwareRequirements\"],\n      actions: manifest.actions as DevAppRecord[\"actions\"],\n    })\n    await useAppStatusStore.getState().refresh()\n    return {ok: true, packageName: record.packageName, name: appName}\n  },\n\n  /** Current engine runtime status for engine-owned debug surfaces. */\n  runtimeStatus: (): DevRuntimeStatusSnapshot => projectRuntimeStatus(),\n\n  /** Subscribe to the projected engine runtime status; returns an unsubscribe. */\n  onRuntimeStatus: (cb: (status: DevRuntimeStatusSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectRuntimeStatus())\n    const notify = () => {\n      const snap = projectRuntimeStatus()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    }\n    const unsubscribers = [\n      useCoreStore.subscribe(notify),\n      useGlassesStore.subscribe(notify),\n      useConnectionStore.subscribe(notify),\n      useCloudClientStatusStore.subscribe(notify),\n      useTranscriptionDebugStore.subscribe(notify),\n    ]\n    return () => {\n      unsubscribers.forEach((unsubscribe) => unsubscribe())\n    }\n  },\n}\n"]}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * dev facade — `engine.dev`: developer/debug surface over engine-owned state.\n * Backend/cloud URL overrides read+write the engine settings store; the cloud\n * URL setters reconnect the engine-owned cloud client onto the new endpoints;\n *\n * NOTE: the dev-time endpoint *resolution* (Metro-host auto-detect, env defaults)\n * still lives host-side in `@/services/cloudClient` during the migration; this\n * facade manages the explicit overrides + reconnect.\n */\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport {isGlassesReady} from \"../services/GlassesReadiness\"\nimport {useCloudClientStatusStore} from \"../stores/cloudClientStatus\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\nimport {useTranscriptionDebugStore} from \"../stores/transcriptionDebug\"\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {getConfigValues} from \"../runtime/bootstrap\"\nimport {decideDevLaunchRoute} from \"../utils/devMiniappLaunch\"\nimport {deriveDevPackageId, registerDevApp, DEV_APP_PACKAGE_NAME, type DevAppRecord} from \"../services/AppRegistry\"\nimport {useAppStatusStore} from \"../stores/apps\"\nimport {sendGesture} from \"../services/GlassesTouchInput\"\nimport dashboardOpenTrace, {type DashboardOpenReport} from \"../services/debug/DashboardOpenTrace\"\n\ntype CloudUrlOverrides = {core?: string; runtime?: string}\n\n/**\n * Reconnect the cloud client onto the current cloud-URL overrides. Explicit\n * partial overrides merge over the boot-resolved config (which carries the\n * host's Metro/env URL resolution); both empty clears the live override.\n */\nfunction applyCloudUrlReconnect(urls: CloudUrlOverrides = currentCloudUrlOverrides()): void {\n  const resolved = resolveCloudUrlReconnectTarget(urls)\n  if (resolved === undefined) {\n    cloudClientService.reconnect(null)\n  } else if (resolved) {\n    cloudClientService.reconnect(resolved)\n  } else {\n    console.warn(\"engine.dev.setCloudUrls: partial cloud override missing boot-resolved sibling endpoint\")\n  }\n}\n\nfunction currentCloudUrlOverrides(): CloudUrlOverrides {\n  const s = useSettingsStore.getState()\n  return {\n    core: trimSetting(s.getSetting(SETTINGS.cloud_core_url.key)),\n    runtime: trimSetting(s.getSetting(SETTINGS.cloud_runtime_url.key)),\n  }\n}\n\nfunction resolveCloudUrlReconnectTarget(urls: CloudUrlOverrides): {core: string; runtime: string} | null | undefined {\n  const core = trimSetting(urls.core)\n  const runtime = trimSetting(urls.runtime)\n  if (!core && !runtime) return undefined\n\n  const config = getConfigValues()\n  const resolvedCore = core || config.coreUrl?.trim()\n  const resolvedRuntime = runtime || config.runtimeUrl?.trim()\n  return resolvedCore && resolvedRuntime ? {core: resolvedCore, runtime: resolvedRuntime} : null\n}\n\nfunction trimSetting(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined\n}\n\nfunction projectRuntimeStatus() {\n  const core = useCoreStore.getState()\n  const glasses = useGlassesStore.getState()\n  const connection = useConnectionStore.getState()\n  const cloudClient = useCloudClientStatusStore.getState()\n  const transcriptionDebug = useTranscriptionDebugStore.getState()\n  return {\n    searching: core.searching,\n    // Copy: the snapshot must not hand callers a mutable reference into the store.\n    micRanking: [...core.micRanking],\n    currentMic: core.currentMic,\n    systemMicUnavailable: core.systemMicUnavailable,\n    glassesConnected: glasses.connection.state === \"connected\",\n    glassesFullyBooted: isGlassesReady(glasses.connection),\n    bluetoothClassicConnected: glasses.bluetoothClassicConnected,\n    coreStatus: connection.status,\n    cloudClientStatus: cloudClient.status,\n    cloudClientAudioTransport: cloudClient.audioTransport,\n    transcriptionSubscribers: [...transcriptionDebug.transcriptionSubscribers],\n    translationSubscribers: [...transcriptionDebug.translationSubscribers],\n    recentTranscriptSources: {...transcriptionDebug.recentTranscriptSources},\n    cloudAudioSubscriptionWrite: {...transcriptionDebug.cloudAudioSubscriptionWrite},\n  }\n}\n\nexport type DevRuntimeStatusSnapshot = ReturnType<typeof projectRuntimeStatus>\n\nexport const dev = {\n  /** Inject a glasses gesture through the normal dashboard/miniapp input policy. */\n  sendGesture,\n  /** The cloud-v2 core/runtime URL overrides. */\n  cloudUrls: (): {core?: string; runtime?: string} => {\n    const s = useSettingsStore.getState()\n    return {core: s.getSetting(SETTINGS.cloud_core_url.key), runtime: s.getSetting(SETTINGS.cloud_runtime_url.key)}\n  },\n  /** Override the cloud-v2 URLs and reconnect the live client onto them. */\n  setCloudUrls: (urls: {core?: string; runtime?: string}) => {\n    const next = {...currentCloudUrlOverrides(), ...urls}\n    const resolved = resolveCloudUrlReconnectTarget(next)\n    if (resolved === null) {\n      console.warn(\"engine.dev.setCloudUrls: ignoring partial cloud override without a resolvable sibling endpoint\")\n      return\n    }\n\n    const s = useSettingsStore.getState()\n    if (urls.core !== undefined) s.setSetting(SETTINGS.cloud_core_url.key, urls.core)\n    if (urls.runtime !== undefined) s.setSetting(SETTINGS.cloud_runtime_url.key, urls.runtime)\n    if (resolved === undefined) {\n      cloudClientService.reconnect(null)\n    } else {\n      cloudClientService.reconnect(resolved)\n    }\n  },\n\n  /** Tear down + rebuild the live cloud client (the dev \"reconnect\" button). */\n  reconnectCloud: (): void => applyCloudUrlReconnect(),\n\n  /** Current native (BLE-process) memory usage in MB — a dev/diagnostics gauge. */\n  getMemoryMB: (): number => BluetoothSdk.getMemoryMB(),\n  /**\n   * Phone-side bluetooth runtime snapshot (the core store read-model: scan/mic/\n   * search state) — the diagnostics/data-export surface. Shallow copy.\n   */\n  bluetoothStatus: (): Record<string, unknown> => {\n    const {setCoreInfo: _setCoreInfo, reset: _reset, ...state} = useCoreStore.getState()\n    return {...state}\n  },\n\n  /**\n   * Side-load a miniapp being served from a dev machine (the `glassly dev` / CLI\n   * flow) by its URL: probes `<url>/miniapp.json`, and on a reachable manifest\n   * registers it under its manifest package so it appears in `engine.miniapps`\n   * and can coexist with other dev miniapps. This is the OEM-host equivalent\n   * of the first-party\n   * developer-URL screen — the registration itself is engine-internal, so a\n   * host reaches it here rather than the internal registry. Rendering still\n   * flows through the normal display path once the miniapp is started.\n   */\n  loadDevMiniapp: async (\n    url: string,\n    name?: string,\n  ): Promise<{ok: true; packageName: string; name: string} | {ok: false; error: string}> => {\n    const devUrl = url.trim().replace(/\\/+$/, \"\")\n    if (!devUrl) return {ok: false, error: \"empty url\"}\n    const result = await decideDevLaunchRoute(\"\", devUrl)\n    if (result.decision !== \"live\") {\n      return {ok: false, error: \"dev server unreachable, or no miniapp.json served there\"}\n    }\n    const manifest = result.manifest\n    const appName = name ?? manifest.name ?? \"Dev Miniapp\"\n    const packageName = (manifest.packageName as string | undefined) ?? DEV_APP_PACKAGE_NAME\n    // Persist the host that answered — not the stale input IP — so home-tile\n    // relaunches skip a dead LAN address after mDNS/Metro failover.\n    const resolvedUrl = result.resolvedUrl || devUrl\n    // The `glassly-miniapp dev` server puts the hot-reload/log sidecar on the\n    // user port PLUS ONE — same convention as the first-party developer-URL\n    // screen's deriveDevPort.\n    let devPort: number | undefined\n    try {\n      const parsed = Number(new URL(resolvedUrl).port)\n      devPort = Number.isFinite(parsed) && parsed > 0 ? parsed + 1 : undefined\n    } catch {\n      devPort = undefined\n    }\n    // The record is stored under a namespaced dev id (deriveDevPackageId) so\n    // it survives release installs of the manifest package — stop/refresh and\n    // the returned packageName must use that id, which registerDevApp returns.\n    const devPackageId = deriveDevPackageId(packageName)\n    const existing = useAppStatusStore.getState().apps.find((app) => app.packageName === devPackageId)\n    if (existing?.running) await useAppStatusStore.getState().stop(devPackageId)\n    const record = await registerDevApp({\n      packageName,\n      name: appName,\n      iconUrl: manifest.icon ? new URL(manifest.icon, `${resolvedUrl}/`).toString() : `${resolvedUrl}/icon.png`,\n      // Persist the host that answered — not the stale input IP.\n      devUrl: resolvedUrl,\n      devPort,\n      type: manifest.type as DevAppRecord[\"type\"],\n      permissions: manifest.permissions as DevAppRecord[\"permissions\"],\n      hardwareRequirements: manifest.hardwareRequirements as DevAppRecord[\"hardwareRequirements\"],\n      actions: manifest.actions as DevAppRecord[\"actions\"],\n    })\n    await useAppStatusStore.getState().refresh()\n    return {ok: true, packageName: record.packageName, name: appName}\n  },\n\n  /** Current engine runtime status for engine-owned debug surfaces. */\n  runtimeStatus: (): DevRuntimeStatusSnapshot => projectRuntimeStatus(),\n\n  /** Subscribe to the projected engine runtime status; returns an unsubscribe. */\n  onRuntimeStatus: (cb: (status: DevRuntimeStatusSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectRuntimeStatus())\n    const notify = () => {\n      const snap = projectRuntimeStatus()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    }\n    const unsubscribers = [\n      useCoreStore.subscribe(notify),\n      useGlassesStore.subscribe(notify),\n      useConnectionStore.subscribe(notify),\n      useCloudClientStatusStore.subscribe(notify),\n      useTranscriptionDebugStore.subscribe(notify),\n    ]\n    return () => {\n      unsubscribers.forEach((unsubscribe) => unsubscribe())\n    }\n  },\n\n  /**\n   * Each finished dashboard open while the debug_dashboard_open_timing setting\n   * is on: a ready-made title/body plus the stage timings. Returns an unsubscribe.\n   */\n  onDashboardOpenTrace: (cb: (report: DashboardOpenReport) => void): (() => void) => dashboardOpenTrace.onReport(cb),\n}\n"]}

package/build/facades/display.d.ts

@@ -10,14 +10,21 @@ export declare const display: {
     mirror: {
         current(): import("./displayMirror").DisplayMirrorEvent;
         onMirror(cb: (event: import("./displayMirror").DisplayMirrorEvent) => void): () => void;
+        canvas(previewModel?: string): import("./displayMirror").DisplayMirrorCanvas;
     };
-    /** Phone-composed dashboard controls (simulated head-up, dev tools). */
+    /**
+     * Dashboard controls for the simulator and dev tools. The dashboard is a
+     * miniapp's (ADR-0006): these replay the wearer's own inputs, so they do
+     * whatever the running apps make of them.
+     */
     dashboard: {
+        /** An overlay app holds the slot. */
         isOpen: () => boolean;
-        /** Open/close as if the head was raised/lowered (respects contextual_dashboard). */
+        /** As if the head was raised/lowered (the dashboard app applies contextual_dashboard). */
         setHeadUp: (up: boolean) => void;
-        /** Force open/close, ignoring contextual_dashboard (simulator button). */
+        /** A double tap on the empty screen: the dashboard app opens (simulator button). */
         open: () => void;
+        /** A double tap on the showing page: it closes. */
         close: () => void;
     };
     /** Write raw text to the glasses display at (x, y) with a font size. */

package/build/facades/display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/facades/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,wBAAwB,CAAA;AAIjD,eAAO,MAAM,OAAO;IAClB,mDAAmD;;;;;IAEnD,wEAAwE;;sBAE1D,OAAO;QACnB,oFAAoF;wBACpE,OAAO,KAAG,IAAI;QAC9B,0EAA0E;oBAChE,IAAI;qBACH,IAAI;;IAEjB,wEAAwE;;IAExE,iCAAiC;iBACtB,OAAO,CAAC,IAAI,CAAC;CACzB,CAAA"}
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/facades/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,wBAAwB,CAAA;AAMjD,eAAO,MAAM,OAAO;IAClB,mDAAmD;;;;;;IAEnD;;;;OAIG;;QAED,qCAAqC;sBACzB,OAAO;QACnB,0FAA0F;wBAC1E,OAAO,KAAG,IAAI;QAE9B,oFAAoF;oBAC1E,IAAI;QAGd,mDAAmD;qBACxC,IAAI;;IAIjB,wEAAwE;;IAExE,iCAAiC;iBACtB,OAAO,CAAC,IAAI,CAAC;CACzB,CAAA"}

package/build/facades/display.js

@@ -5,19 +5,33 @@
  * the engine DisplayProcessor / layout system, not these).
  */
 import BluetoothSdk from "@glassly/bluetooth-sdk";
-import dashboardCoordinator from "../services/DashboardCoordinator";
+import { sendGesture } from "../services/GlassesTouchInput";
+import localMiniappRuntime from "../services/LocalMiniappRuntime";
+import { useDisplayStore } from "../stores/display";
 import { displayMirror } from "./displayMirror";
 export const display = {
     /** Mirrored-view read-model (current/onMirror). */
     mirror: displayMirror,
-    /** Phone-composed dashboard controls (simulated head-up, dev tools). */
+    /**
+     * Dashboard controls for the simulator and dev tools. The dashboard is a
+     * miniapp's (ADR-0006): these replay the wearer's own inputs, so they do
+     * whatever the running apps make of them.
+     */
     dashboard: {
-        isOpen: () => dashboardCoordinator.isOpen,
-        /** Open/close as if the head was raised/lowered (respects contextual_dashboard). */
-        setHeadUp: (up) => dashboardCoordinator.setHeadUp(up),
-        /** Force open/close, ignoring contextual_dashboard (simulator button). */
-        open: () => dashboardCoordinator.open(),
-        close: () => dashboardCoordinator.close(),
+        /** An overlay app holds the slot. */
+        isOpen: () => useDisplayStore.getState().overlayOwner !== null,
+        /** As if the head was raised/lowered (the dashboard app applies contextual_dashboard). */
+        setHeadUp: (up) => localMiniappRuntime.forwardEvent("head_up", { position: up ? "up" : "down", timestamp: Date.now() }),
+        /** A double tap on the empty screen: the dashboard app opens (simulator button). */
+        open: () => {
+            if (!display.dashboard.isOpen())
+                sendGesture("double_tap");
+        },
+        /** A double tap on the showing page: it closes. */
+        close: () => {
+            if (display.dashboard.isOpen())
+                sendGesture("double_tap");
+        },
     },
     /** Write raw text to the glasses display at (x, y) with a font size. */
     text: (...args) => BluetoothSdk.displayText(...args),

package/build/facades/display.js.map

@@ -1 +1 @@
-{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/facades/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,wBAAwB,CAAA;AACjD,OAAO,oBAAoB,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,mDAAmD;IACnD,MAAM,EAAE,aAAa;IACrB,wEAAwE;IACxE,SAAS,EAAE;QACT,MAAM,EAAE,GAAY,EAAE,CAAC,oBAAoB,CAAC,MAAM;QAClD,oFAAoF;QACpF,SAAS,EAAE,CAAC,EAAW,EAAQ,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,0EAA0E;QAC1E,IAAI,EAAE,GAAS,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAC7C,KAAK,EAAE,GAAS,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE;KAChD;IACD,wEAAwE;IACxE,IAAI,EAAE,CAAC,GAAG,IAAiD,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjG,iCAAiC;IACjC,KAAK,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE;CACxD,CAAA","sourcesContent":["/**\n * display facade — `engine.display`: the host/OEM display surface. `mirror`\n * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the\n * glasses display for dev tools and escape-hatch use (normal rendering goes through\n * the engine DisplayProcessor / layout system, not these).\n */\nimport BluetoothSdk from \"@glassly/bluetooth-sdk\"\nimport dashboardCoordinator from \"../services/DashboardCoordinator\"\nimport {displayMirror} from \"./displayMirror\"\n\nexport const display = {\n  /** Mirrored-view read-model (current/onMirror). */\n  mirror: displayMirror,\n  /** Phone-composed dashboard controls (simulated head-up, dev tools). */\n  dashboard: {\n    isOpen: (): boolean => dashboardCoordinator.isOpen,\n    /** Open/close as if the head was raised/lowered (respects contextual_dashboard). */\n    setHeadUp: (up: boolean): void => dashboardCoordinator.setHeadUp(up),\n    /** Force open/close, ignoring contextual_dashboard (simulator button). */\n    open: (): void => dashboardCoordinator.open(),\n    close: (): void => dashboardCoordinator.close(),\n  },\n  /** Write raw text to the glasses display at (x, y) with a font size. */\n  text: (...args: Parameters<typeof BluetoothSdk.displayText>) => BluetoothSdk.displayText(...args),\n  /** Clear the glasses display. */\n  clear: (): Promise<void> => BluetoothSdk.clearDisplay(),\n}\n"]}
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/facades/display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAC,WAAW,EAAC,MAAM,+BAA+B,CAAA;AACzD,OAAO,mBAAmB,MAAM,iCAAiC,CAAA;AACjE,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,mDAAmD;IACnD,MAAM,EAAE,aAAa;IACrB;;;;OAIG;IACH,SAAS,EAAE;QACT,qCAAqC;QACrC,MAAM,EAAE,GAAY,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,YAAY,KAAK,IAAI;QACvE,0FAA0F;QAC1F,SAAS,EAAE,CAAC,EAAW,EAAQ,EAAE,CAC/B,mBAAmB,CAAC,YAAY,CAAC,SAAS,EAAE,EAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAC,CAAC;QACpG,oFAAoF;QACpF,IAAI,EAAE,GAAS,EAAE;YACf,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;gBAAE,WAAW,CAAC,YAAY,CAAC,CAAA;QAC5D,CAAC;QACD,mDAAmD;QACnD,KAAK,EAAE,GAAS,EAAE;YAChB,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;gBAAE,WAAW,CAAC,YAAY,CAAC,CAAA;QAC3D,CAAC;KACF;IACD,wEAAwE;IACxE,IAAI,EAAE,CAAC,GAAG,IAAiD,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACjG,iCAAiC;IACjC,KAAK,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE;CACxD,CAAA","sourcesContent":["/**\n * display facade — `engine.display`: the host/OEM display surface. `mirror`\n * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the\n * glasses display for dev tools and escape-hatch use (normal rendering goes through\n * the engine DisplayProcessor / layout system, not these).\n */\nimport BluetoothSdk from \"@glassly/bluetooth-sdk\"\nimport {sendGesture} from \"../services/GlassesTouchInput\"\nimport localMiniappRuntime from \"../services/LocalMiniappRuntime\"\nimport {useDisplayStore} from \"../stores/display\"\nimport {displayMirror} from \"./displayMirror\"\n\nexport const display = {\n  /** Mirrored-view read-model (current/onMirror). */\n  mirror: displayMirror,\n  /**\n   * Dashboard controls for the simulator and dev tools. The dashboard is a\n   * miniapp's (ADR-0006): these replay the wearer's own inputs, so they do\n   * whatever the running apps make of them.\n   */\n  dashboard: {\n    /** An overlay app holds the slot. */\n    isOpen: (): boolean => useDisplayStore.getState().overlayOwner !== null,\n    /** As if the head was raised/lowered (the dashboard app applies contextual_dashboard). */\n    setHeadUp: (up: boolean): void =>\n      localMiniappRuntime.forwardEvent(\"head_up\", {position: up ? \"up\" : \"down\", timestamp: Date.now()}),\n    /** A double tap on the empty screen: the dashboard app opens (simulator button). */\n    open: (): void => {\n      if (!display.dashboard.isOpen()) sendGesture(\"double_tap\")\n    },\n    /** A double tap on the showing page: it closes. */\n    close: (): void => {\n      if (display.dashboard.isOpen()) sendGesture(\"double_tap\")\n    },\n  },\n  /** Write raw text to the glasses display at (x, y) with a font size. */\n  text: (...args: Parameters<typeof BluetoothSdk.displayText>) => BluetoothSdk.displayText(...args),\n  /** Clear the glasses display. */\n  clear: (): Promise<void> => BluetoothSdk.clearDisplay(),\n}\n"]}