@glassly/engine 0.1.0-dev.1 → 0.1.0-dev.26

package/README.md

@@ -21,7 +21,8 @@ npm install @glassly/engine
 
 ## Entry points
 
-The package exposes three entry points (declared in `package.json` `exports`,
+The package exposes its Engine entry points and a supported Bluetooth SDK
+facade (declared in `package.json` `exports`,
 with the `react-native` condition pointing at `src/` so Metro, tsc and jest
 resolve live TypeScript source):
 
@@ -32,15 +33,15 @@ resolve live TypeScript source):
   OTA policy constants, hardware capability tables, `BgTimer`). Judgment rule:
   read models, commands, pure functions and types are main; anything that
   mutates runtime state or exposes a store/service is not.
-- **`@glassly/engine/internal`** (`src/internal.ts`) — the migration-era
-  runtime surface: raw zustand stores (`useCoreStore`, `useSettingsStore`,
-  `useAppStatusStore`, …) and service singletons (`appRegistry`, `restComms`,
-  `cloudClientService`, the gallery cluster, the miniapp engine, …). The
-  host's `@/stores/*` shims re-export from here. New host code should use
-  `engine.*` instead; `scripts/check-mobile-runtime-boundary.sh` counts every
-  `/internal` import in `mobile/src` (report-only) as the burn-down metric.
-- **`@glassly/engine/devtools`** (`src/devtools.ts`) — debug-only singletons
-  (`miniappRunningRegistry`, `devServerBridge`) for the internal dev screens.
+- **`@glassly/engine/ota`** (`src/react/index.ts`) — the complete Mentra Live OTA
+  controller plus its stock full-screen renderer. `useMentraLiveOta` owns the
+  check, hotspot or Wi-Fi install, APK/MTK/BES progress, reboot, retry, and final
+  verification behavior. `MentraLiveOtaFlow` renders that same public hook.
+- **`@glassly/engine/bluetooth-sdk`** (`src/bluetooth-sdk/index.ts`) — the
+  complete public Bluetooth SDK surface, re-exported without a wrapper so it
+  has the same singleton identity as `@glassly/bluetooth-sdk`. The supported
+  SDK `react`, `types`, `photo-receiver`, `ota-transport`, and `debug` subpaths are mirrored
+  below this path. The SDK's `internal` entrypoint is deliberately not exposed.
 
 See `cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md`
 §D for the burn-down plan.
@@ -59,19 +60,52 @@ sockets.
 
 ```ts
 import {engine, decideDevLaunchRoute} from "@glassly/engine"
-import {webviewBridge, buildMiniappGlobalsScript} from "@glassly/engine/internal"
-import {miniappRunningRegistry} from "@glassly/engine/devtools"
+import BluetoothSdk from "@glassly/engine/bluetooth-sdk"
 ```
 
-- `webviewBridge` — registers per-package WebView message handlers so any
-  service can `postMessage` JSON into a specific miniapp.
-- `miniappRunningRegistry` — session-scoped set of currently-mounted local
-  miniapp packageNames (foreground + background).
-- `buildMiniappGlobalsScript` — builds the `window.Glassly` injection script
-  (and CSS variables / console-tap shim) used by every miniapp WebView.
 - `decideDevLaunchRoute` — pre-flight a dev URL's `miniapp.json` to decide
   whether to mount live or take the user to the offline screen.
 
+### Mentra Live OTA flow
+
+Bluetooth-only hosts can render the OTA flow without configuring or starting
+the authenticated cloud/miniapp runtime:
+
+```tsx
+import {MentraLiveOtaFlow} from "@glassly/engine/ota"
+;<MentraLiveOtaFlow onFinished={() => setShowOta(false)} onOpenWifiSetup={() => setShowWifiSetup(true)} />
+```
+
+The component starts only the glasses-status and OTA projections. A host that
+already called `engine.start()` should pass `initializeRuntime={false}`. Show
+the flow after a Mentra Live connects. Hosts must provide `onOpenWifiSetup`;
+the flow invokes it only for older glasses that cannot provide the OTA hotspot
+transport.
+
+Apps that need different pages can render the same controller directly:
+
+```tsx
+import {useMentraLiveOta} from "@glassly/engine/ota"
+
+const ota = useMentraLiveOta({onFinished, onOpenWifiSetup})
+// Render ota.state.screen and invoke ota.install(), retryInstall(), finish(), etc.
+```
+
+Customize presentation only. Engine must remain responsible for OTA ordering,
+hotspot staging, restart recovery, retries, and verification. The canonical
+stock and custom integration guide is
+[Update Mentra Live](https://docs.glassly.com/mentra-live/software-update).
+
+Released Engine packages contain a literal immutable OTA manifest URL and
+SHA-256 generated by coordinated release CI. Modern-glasses manifest selection
+is developer override, host-app release pin, then Engine release pin. It does
+not derive a URL from the Bluetooth SDK version or fall through to a
+glasses-reported or mutable production URL. An unpinned source build has OTA
+disabled unless an Expo/React Native host explicitly sets
+`EXPO_PUBLIC_ASG_OTA_VERSION_URL`; native source hosts use the Bluetooth SDK's
+debug `setOtaVersionUrl` surface. Pre-39 glasses retain their separate legacy
+path because those clients ignore the URL sent by the phone.
+
 ## Imports
 
 Inside `mobile/modules/engine/src/`, use **relative paths** (`./services/...`,
@@ -93,4 +127,4 @@ combined run. Per-file processes give every suite an isolated registry.
 
 The same rule applies when writing tests: it is fine to `mock.module` any
 specifier your suite needs, but never rely on a mock installed by a
-*different* test file — each file must set up everything it imports.
+_different_ test file — each file must set up everything it imports.

package/build/bluetooth-sdk/debug.d.ts

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/debug";
+//# sourceMappingURL=debug.d.ts.map

package/build/bluetooth-sdk/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/bluetooth-sdk/debug.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}

package/build/bluetooth-sdk/debug.js

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/debug";
+//# sourceMappingURL=debug.js.map

package/build/bluetooth-sdk/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/bluetooth-sdk/debug.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA","sourcesContent":["export * from \"@glassly/bluetooth-sdk/debug\"\n"]}

package/build/bluetooth-sdk/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from "@glassly/bluetooth-sdk";
+export * from "@glassly/bluetooth-sdk";
+//# sourceMappingURL=index.d.ts.map

package/build/bluetooth-sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bluetooth-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAC9C,cAAc,wBAAwB,CAAA"}

package/build/bluetooth-sdk/index.js

@@ -0,0 +1,3 @@
+export { default } from "@glassly/bluetooth-sdk";
+export * from "@glassly/bluetooth-sdk";
+//# sourceMappingURL=index.js.map

package/build/bluetooth-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bluetooth-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAC9C,cAAc,wBAAwB,CAAA","sourcesContent":["export {default} from \"@glassly/bluetooth-sdk\"\nexport * from \"@glassly/bluetooth-sdk\"\n"]}

package/build/bluetooth-sdk/ota-transport.d.ts

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/ota-transport";
+//# sourceMappingURL=ota-transport.d.ts.map

package/build/bluetooth-sdk/ota-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ota-transport.d.ts","sourceRoot":"","sources":["../../src/bluetooth-sdk/ota-transport.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA"}

package/build/bluetooth-sdk/ota-transport.js

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/ota-transport";
+//# sourceMappingURL=ota-transport.js.map

package/build/bluetooth-sdk/ota-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ota-transport.js","sourceRoot":"","sources":["../../src/bluetooth-sdk/ota-transport.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA","sourcesContent":["export * from \"@glassly/bluetooth-sdk/ota-transport\"\n"]}

package/build/bluetooth-sdk/photo-receiver.d.ts

@@ -0,0 +1,3 @@
+export { default } from "@glassly/bluetooth-sdk/photo-receiver";
+export * from "@glassly/bluetooth-sdk/photo-receiver";
+//# sourceMappingURL=photo-receiver.d.ts.map

package/build/bluetooth-sdk/photo-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo-receiver.d.ts","sourceRoot":"","sources":["../../src/bluetooth-sdk/photo-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,uCAAuC,CAAA;AAC7D,cAAc,uCAAuC,CAAA"}

package/build/bluetooth-sdk/photo-receiver.js

@@ -0,0 +1,3 @@
+export { default } from "@glassly/bluetooth-sdk/photo-receiver";
+export * from "@glassly/bluetooth-sdk/photo-receiver";
+//# sourceMappingURL=photo-receiver.js.map

package/build/bluetooth-sdk/photo-receiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo-receiver.js","sourceRoot":"","sources":["../../src/bluetooth-sdk/photo-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,uCAAuC,CAAA;AAC7D,cAAc,uCAAuC,CAAA","sourcesContent":["export {default} from \"@glassly/bluetooth-sdk/photo-receiver\"\nexport * from \"@glassly/bluetooth-sdk/photo-receiver\"\n"]}

package/build/bluetooth-sdk/react.d.ts

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/react";
+//# sourceMappingURL=react.d.ts.map

package/build/bluetooth-sdk/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/bluetooth-sdk/react.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}

package/build/bluetooth-sdk/react.js

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/react";
+//# sourceMappingURL=react.js.map

package/build/bluetooth-sdk/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/bluetooth-sdk/react.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA","sourcesContent":["export * from \"@glassly/bluetooth-sdk/react\"\n"]}

package/build/bluetooth-sdk/types.d.ts

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/types";
+//# sourceMappingURL=types.d.ts.map

package/build/bluetooth-sdk/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bluetooth-sdk/types.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA"}

package/build/bluetooth-sdk/types.js

@@ -0,0 +1,2 @@
+export * from "@glassly/bluetooth-sdk/types";
+//# sourceMappingURL=types.js.map

package/build/bluetooth-sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bluetooth-sdk/types.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA","sourcesContent":["export * from \"@glassly/bluetooth-sdk/types\"\n"]}

package/build/engine.d.ts

@@ -5,8 +5,8 @@
  * 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
- * live on the `@glassly/engine/internal` entry (and the debug singletons on
- * `@glassly/engine/devtools`); they shrink as screens move onto `engine.*`.
+ * remain in a private GlasslyOS host package; they shrink as screens move onto
+ * `engine.*`.
  */
 import { configure, updateUiSeams } from "./runtime/bootstrap";
 export declare const engine: {
@@ -25,7 +25,7 @@ export declare const engine: {
         connectDefault: () => Promise<void>;
         disconnect: () => Promise<void>;
         forget: () => Promise<void>;
-        connect: (device: import("@glassly/bluetooth-sdk").Device, options?: import("@glassly/bluetooth-sdk").ConnectOptions | undefined) => Promise<void>;
+        connect: (device: import("@glassly/bluetooth-sdk").Device, options?: import("@glassly/bluetooth-sdk").ConnectOptions) => Promise<void>;
         connectSimulated: () => Promise<void>;
         setDefault: (device: import("@glassly/bluetooth-sdk").Device | null) => Promise<void>;
         reconnect: () => Promise<boolean>;
@@ -71,14 +71,14 @@ export declare const engine: {
         restartTranscriber: () => Promise<void>;
         stt: {
             currentLanguage: () => string;
-            languages: () => import("./internal").SttLanguageConfig[];
-            languageInfo: () => Promise<import("./internal").SttLanguageInfo[]>;
-            download: (code?: string | undefined, onProgress?: ((progress: import("./internal").SttDownloadProgress) => void) | undefined, onExtractionProgress?: ((progress: import("./internal").SttExtractionProgress) => void) | undefined) => Promise<void>;
+            languages: () => import("./services/STTModelManager").LanguageConfig[];
+            languageInfo: () => Promise<import("./services/STTModelManager").LanguageInfo[]>;
+            download: (code?: string | undefined, onProgress?: ((progress: import("./services/STTModelManager").DownloadProgress) => void) | undefined, onExtractionProgress?: ((progress: import("./services/STTModelManager").ExtractionProgress) => void) | undefined) => Promise<void>;
             activate: (code: string) => void;
             cancelDownload: () => Promise<void>;
             deleteModel: (code?: string | undefined) => Promise<void>;
-            status: () => import("./internal").OfflineModelDownloadStatus | null;
-            onStatusChanged: (listener: (status: import("./internal").OfflineModelDownloadStatus | null) => void) => () => void;
+            status: () => import("./services/OfflineSpeechModelService").DownloadStatus | null;
+            onStatusChanged: (listener: (status: import("./services/OfflineSpeechModelService").DownloadStatus | null) => void) => (() => void);
         };
         sonioxDirect: {
             getStatus: () => import("./services/soniox/SonioxDirectService").SonioxDirectStatus;
@@ -150,12 +150,14 @@ export declare const engine: {
     };
     /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */
     ota: {
-        install: (otaVersionUrl?: string | null | undefined) => Promise<import("@glassly/bluetooth-sdk").OtaStartAckEvent>;
+        initialize: () => Promise<void>;
+        install: (otaVersionUrl?: string | null) => Promise<import("@glassly/bluetooth-sdk").OtaStartAckEvent>;
         ping: () => Promise<void>;
         checkForUpdates: (options?: import(".").OtaCheckCurrentGlassesOptions) => Promise<import(".").OtaCheckCurrentGlassesResult>;
+        getReleaseChangelogs: (fromVersion?: string | null, toVersion?: string | null) => import("@glassly/bluetooth-sdk").ReleaseChangelog[];
         clearUpdateAvailable: () => void;
         clearProgress: () => void;
-        replacePendingUpdateSequence: (updates: import("@glassly/bluetooth-sdk/internal").OtaUpdateInfo["updates"]) => import("@glassly/bluetooth-sdk/internal").OtaUpdateInfo | null;
+        replacePendingUpdateSequence: (updates: import("@glassly/bluetooth-sdk").OtaUpdateInfo["updates"]) => import("@glassly/bluetooth-sdk").OtaUpdateInfo | null;
         clearBuildNumberForNextCheck: () => void;
         markMtkUpdatedThisSession: (updated: boolean) => void;
         installSession: {
@@ -163,15 +165,15 @@ export declare const engine: {
             attach: () => void;
             detach: () => void;
             retry: () => void;
-            finish: () => void;
-            discard: () => void;
+            finish: () => Promise<void>;
+            discard: () => Promise<void>;
             snapshot: () => import(".").OtaInstallSnapshot;
             onSnapshot: (cb: (snapshot: import(".").OtaInstallSnapshot) => void) => (() => void);
         };
-        updateAvailable: () => import("@glassly/bluetooth-sdk/internal").OtaUpdateInfo | null;
+        updateAvailable: () => import("@glassly/bluetooth-sdk").OtaUpdateInfo | null;
         status: () => import("@glassly/bluetooth-sdk").OtaStatus | null;
         snapshot: () => import(".").OtaSnapshot;
-        onUpdateAvailable: (cb: (info: import("@glassly/bluetooth-sdk/internal").OtaUpdateInfo | null) => void) => (() => void);
+        onUpdateAvailable: (cb: (info: import("@glassly/bluetooth-sdk").OtaUpdateInfo | null) => void) => (() => void);
         onStatus: (cb: (status: import("@glassly/bluetooth-sdk").OtaStatus | null) => void) => (() => void);
         onSnapshot: (cb: (snapshot: import(".").OtaSnapshot) => void) => (() => void);
     };
@@ -210,6 +212,8 @@ export declare const engine: {
     pairing: {
         readiness: () => import("./facades/pairing").PairingReadinessSnapshot;
         onReadiness: (cb: (readiness: import("./facades/pairing").PairingReadinessSnapshot) => void) => (() => void);
+        targetReady: (options: Pick<import("./facades/pairing").PairingReadyWaitOptions, "deviceModel" | "deviceName">) => boolean;
+        onTargetReady: (options: Pick<import("./facades/pairing").PairingReadyWaitOptions, "deviceModel" | "deviceName">, cb: (ready: boolean) => void) => (() => void);
         identity: () => import(".").IdentitySnapshot;
         onIdentity: (cb: (identity: import(".").IdentitySnapshot) => void) => (() => void);
         markPendingSelection: (model: string) => import("typesafe-ts").AsyncResult<void, Error>;
@@ -227,8 +231,11 @@ export declare const engine: {
             address?: string;
             projectName?: string;
             rssi?: number;
+            pairingMode?: boolean;
+            pairingCode?: string;
+            securePairingCapable?: boolean;
         }[];
-        onFound: (cb: (results: ReturnType<() => import("./stores/core").CoreState>["searchResults"]) => void) => (() => void);
+        onFound: (cb: (results: import("@glassly/bluetooth-sdk").Device[]) => void) => (() => void);
         pair: (device: import("@glassly/bluetooth-sdk").Device, options?: import("@glassly/bluetooth-sdk").ConnectOptions) => Promise<void>;
         setDefault: (device: import("@glassly/bluetooth-sdk").Device | null) => Promise<void>;
         setBluetoothClassicTarget: (device: import("@glassly/bluetooth-sdk").Device) => Promise<void>;
@@ -299,7 +306,7 @@ export declare const engine: {
         }) => Promise<import(".").EnrollOutcome>;
         removeSelf: () => Promise<boolean>;
         cancelEnrollment: () => void;
-        onEnrollProgress: (listener: (progress: import("@glassly/bluetooth-sdk/internal").SpeakerEnrollProgressEvent) => void) => (() => void);
+        onEnrollProgress: (listener: (progress: import("@glassly/bluetooth-sdk").SpeakerEnrollProgressEvent) => void) => (() => void);
         model: {
             isAvailable: () => Promise<boolean>;
             sizeBytes: () => number;

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;AAsC5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IAiF7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6BrC,mFAAmF;;;;;;;;IAEnF,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;gBApGV,CAAC;mBACvE,CAAA;;;gBAIyD,CAAC;mBAM7D,CALC;;;;;;;;;;;;;;;;IAgGH,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;IAE9E,qFAAqF;;;;IAErF,4EAA4E;;;;;;;;;;;IAE5E,+EAA+E;;;;;;;;;;;;;;;IAE/E,kFAAkF;;;;;+BAtH/B,CAAC;;;+BAUmB,CAAA;;;;;;;;;;;;IA8GvE,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;AAwC5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IAmF7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BrC,mFAAmF;;;;;;;;IAEnF,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;gBAxGvD,CAAC;mBAAkB,CAAA;;;gBAa/C,CARD;mBAAiB,CAAC;;;;;;;;;;;;;;;;IAqGnB,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;IAE9E,qFAAqF;;;;IAErF,4EAA4E;;;;;;;;;;;IAE5E,+EAA+E;;;;;;;;;;;;;;;IAE/E,kFAAkF;;;;;+BA5H7B,CAAC;;;+BAUtC,CAAC;;;;;;;;;;;;IAoHjB,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;CAGpF,CAAA"}

package/build/engine.js

@@ -5,8 +5,8 @@
  * 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
- * live on the `@glassly/engine/internal` entry (and the debug singletons on
- * `@glassly/engine/devtools`); they shrink as screens move onto `engine.*`.
+ * remain in a private GlasslyOS 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";
@@ -45,6 +45,8 @@ 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 gestureDotsService from "./services/GestureDotsService";
 export const engine = {
     /** Front door — hand engine auth + config, then start/stop the runtime. */
     configure,
@@ -64,7 +66,9 @@ export const engine = {
         // Project native device status -> the engine stores (the inbound feed the rest
         // of the runtime reads). Established first so the stores are live before the
         // syncs below react to them.
-        startGlassesStatusProjection();
+        startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent("glasses_connection_state", changed));
+        customDashboardService.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 ->
         // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the
@@ -146,6 +150,8 @@ export const engine = {
         await safely("glasses settings sync", stopGlassesSettingsSync);
         await safely("glasses status projection", stopGlassesStatusProjection);
         await safely("device event router", stopDeviceEventRouter);
+        await safely("custom dashboard service", () => customDashboardService.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());

package/build/engine.js.map

@@ -1 +1 @@
-{"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 * live on the `@glassly/engine/internal` entry (and the debug singletons on\n * `@glassly/engine/devtools`); they shrink as screens move onto `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\"\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()\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(\"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 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 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    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(\"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"]}

package/build/facades/dev.d.ts

@@ -13,8 +13,8 @@ declare function projectRuntimeStatus(): {
     translationSubscribers: string[];
     recentTranscriptSources: {
         cloud: boolean;
-        direct: boolean;
         local: boolean;
+        direct: boolean;
     };
     cloudAudioSubscriptionWrite: {
         status: import("../stores/transcriptionDebug").CloudAudioSubscriptionWriteStatus;

package/build/facades/display.d.ts

@@ -4,7 +4,7 @@
  * glasses display for dev tools and escape-hatch use (normal rendering goes through
  * the engine DisplayProcessor / layout system, not these).
  */
-import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import BluetoothSdk from "@glassly/bluetooth-sdk";
 export declare const display: {
     /** Mirrored-view read-model (current/onMirror/view/setView). */
     mirror: {

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,iCAAiC,CAAA;AAG1D,eAAO,MAAM,OAAO;IAClB,gEAAgE;;;;;;;IAEhE,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;AAGjD,eAAO,MAAM,OAAO;IAClB,gEAAgE;;;;;;;IAEhE,wEAAwE;;IAExE,iCAAiC;iBACtB,OAAO,CAAC,IAAI,CAAC;CACzB,CAAA"}

package/build/facades/display.js

@@ -4,7 +4,7 @@
  * glasses display for dev tools and escape-hatch use (normal rendering goes through
  * the engine DisplayProcessor / layout system, not these).
  */
-import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import BluetoothSdk from "@glassly/bluetooth-sdk";
 import { displayMirror } from "./displayMirror";
 export const display = {
     /** Mirrored-view read-model (current/onMirror/view/setView). */

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,iCAAiC,CAAA;AAC1D,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gEAAgE;IAChE,MAAM,EAAE,aAAa;IACrB,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/internal\"\nimport {displayMirror} from \"./displayMirror\"\n\nexport const display = {\n  /** Mirrored-view read-model (current/onMirror/view/setView). */\n  mirror: displayMirror,\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,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gEAAgE;IAChE,MAAM,EAAE,aAAa;IACrB,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 {displayMirror} from \"./displayMirror\"\n\nexport const display = {\n  /** Mirrored-view read-model (current/onMirror/view/setView). */\n  mirror: displayMirror,\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"]}

package/build/facades/glasses.d.ts

@@ -1,14 +1,4 @@
-/**
- * glasses facade — the core `engine.glasses.*` surface: connection actions (over
- * the bluetooth-sdk passthrough), a curated status/info read-model (projected from
- * the engine-owned glasses store), capabilities (from the model table), and the
- * discrete input events. The `wifi` sub-facade is nested here.
- *
- * Read-models project the raw glasses store into the stable shape OEM UIs consume,
- * so the device store's field layout doesn't leak into every screen.
- */
-import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
-import type { ButtonPressEvent, TouchEvent } from "@glassly/bluetooth-sdk/internal";
+import type { ButtonPressEvent, ConnectOptions, Device, TouchEvent } from "@glassly/bluetooth-sdk";
 declare function projectStatus(): {
     state: "connecting" | "connected" | "disconnected" | "scanning" | "bonding";
     fullyBooted: boolean;
@@ -47,6 +37,8 @@ declare function projectInfo(): {
     wifiMac: string;
     leftMac: string;
     rightMac: string;
+    sceneCanvasWidth: number | undefined;
+    sceneCanvasHeight: number | undefined;
     wifi: {
         state: "disconnected";
     } | {
@@ -68,11 +60,11 @@ export declare const glasses: {
     disconnect: () => Promise<void>;
     forget: () => Promise<void>;
     /** Connect to a specific (discovered) device. */
-    connect: (device: import("@glassly/bluetooth-sdk").Device, options?: import("@glassly/bluetooth-sdk").ConnectOptions | undefined) => Promise<void>;
+    connect: (device: Device, options?: ConnectOptions) => Promise<void>;
     /** Connect the built-in simulated glasses (dev/testing). */
     connectSimulated: () => Promise<void>;
     /** Set a device as the `connectDefault()` target. */
-    setDefault: (device: import("@glassly/bluetooth-sdk").Device | null) => Promise<void>;
+    setDefault: (device: Device | null) => Promise<void>;
     /**
      * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
      * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered

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

@@ -1 +1 @@
-{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,YAAY,MAAM,iCAAiC,CAAA;AAC1D,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAA;AAYjF,iBAAS,aAAa;;;;;;;;;;;;;;;EAarB;AAED,iBAAS,uBAAuB;;;;;EAQ/B;AAED,iBAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;EAqBnB;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACjF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhE,eAAO,MAAM,OAAO;IAElB;;;;OAIG;0BACuB,OAAO,CAAC,IAAI,CAAC;sBASvB,OAAO,CAAC,IAAI,CAAC;kBACjB,OAAO,CAAC,IAAI,CAAC;IACzB,iDAAiD;yIACkB,OAAO,CAAC,IAAI,CAAC;IAShF,4DAA4D;4BACtC,OAAO,CAAC,IAAI,CAAC;IACnC,qDAAqD;;IAErD;;;;;;OAMG;qBACkB,OAAO,CAAC,OAAO,CAAC;IAcrC;;;iEAG6D;0BACzC,OAAO;IAC3B;;;;;;;;;;OAUG;4BACmB,OAAO,CAAC,OAAO,CAAC;kBAG1B,qBAAqB;mBAClB,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;gBAY3D,mBAAmB;iBAChB,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAW/D,iFAAiF;;wBAI7D,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;yBAI/C,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;8BAOzC,OAAO,CAAC,IAAI,CAAC;0BACjB,OAAO,CAAC,IAAI,CAAC;sBACjB,OAAO,CAAC,IAAI,CAAC;sBACb,wBAAwB;uBACrB,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;;QAcxE,8CAA8C;;QAE9C,qCAAqC;gCACb,MAAM;QAC9B,6EAA6E;oCACjD,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;CAMtD,CAAA"}
+{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAC,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAA;AAYhG,iBAAS,aAAa;;;;;;;;;;;;;;;EAarB;AAED,iBAAS,uBAAuB;;;;;EAQ/B;AAED,iBAAS,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;EAuBnB;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACjF,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhE,eAAO,MAAM,OAAO;IAElB;;;;OAIG;0BACuB,OAAO,CAAC,IAAI,CAAC;sBASvB,OAAO,CAAC,IAAI,CAAC;kBACjB,OAAO,CAAC,IAAI,CAAC;IACzB,iDAAiD;sBACzB,MAAM,YAAY,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;IASxE,4DAA4D;4BACtC,OAAO,CAAC,IAAI,CAAC;IACnC,qDAAqD;yBAChC,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;IAClD;;;;;;OAMG;qBACkB,OAAO,CAAC,OAAO,CAAC;IAcrC;;;iEAG6D;0BACzC,OAAO;IAC3B;;;;;;;;;;OAUG;4BACmB,OAAO,CAAC,OAAO,CAAC;kBAG1B,qBAAqB;mBAClB,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;gBAY3D,mBAAmB;iBAChB,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;IAW/D,iFAAiF;;wBAI7D,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;yBAI/C,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;8BAOzC,OAAO,CAAC,IAAI,CAAC;0BACjB,OAAO,CAAC,IAAI,CAAC;sBACjB,OAAO,CAAC,IAAI,CAAC;sBACb,wBAAwB;uBACrB,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;;;QAcxE,8CAA8C;;QAE9C,qCAAqC;gCACb,MAAM;QAC9B,6EAA6E;oCACjD,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;CAMtD,CAAA"}

package/build/facades/glasses.js

@@ -62,6 +62,8 @@ function projectInfo() {
         wifiMac: s.wifiMacAddress,
         leftMac: s.leftMacAddress,
         rightMac: s.rightMacAddress,
+        sceneCanvasWidth: s.sceneCanvasWidth,
+        sceneCanvasHeight: s.sceneCanvasHeight,
         // Copy: the snapshot must not hand callers a mutable reference into the store.
         wifi: { ...s.wifi },
     };
@@ -86,10 +88,10 @@ export const glasses = {
     disconnect: () => BluetoothSdk.disconnect(),
     forget: () => BluetoothSdk.forget(),
     /** Connect to a specific (discovered) device. */
-    connect: async (...args) => {
+    connect: async (device, options) => {
         try {
             await pushAllBluetoothSettings();
-            await BluetoothSdk.connect(...args);
+            await BluetoothSdk.connect(device, options);
         }
         catch (error) {
             recordSupportProfileConnectionFailure(error, "connect");
@@ -99,7 +101,7 @@ export const glasses = {
     /** Connect the built-in simulated glasses (dev/testing). */
     connectSimulated: () => BluetoothSdk.connectSimulated(),
     /** Set a device as the `connectDefault()` target. */
-    setDefault: (...args) => BluetoothSdk.setDefaultDevice(...args),
+    setDefault: (device) => BluetoothSdk.setDefaultDevice(device),
     /**
      * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
      * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered