@glassly/engine 0.1.0-dev.0

package/build/engine.js

@@ -0,0 +1,198 @@
+/**
+ * `engine` — the namespaced OEM-facing engine API (the "(A) host API" from the
+ * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a
+ * typed facade over the runtime. (Exported from the `@glassly/engine` module, whose
+ * 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.*`.
+ */
+import { configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams } from "./runtime/bootstrap";
+import { cloudClientService } from "./services/CloudClientService";
+import { hydrateDeviceStore, demoteOrphanedDefaultWearable } from "./services/DeviceStoreHydration";
+import { startGlassesSettingsSync, stopGlassesSettingsSync } from "./services/GlassesSettingsSync";
+import { startGlassesStatusProjection, stopGlassesStatusProjection } from "./services/GlassesStatusProjection";
+import { startOtaService, stopOtaService } from "./services/OtaService";
+import { startAudioCloudUplink, stopAudioCloudUplink } from "./services/AudioCloudUplink";
+import sonioxDirectService from "./services/soniox/SonioxDirectService";
+import { startSupportProfileSync, stopSupportProfileSync } from "./services/SupportProfileSync";
+import { startDeviceEventRouter, stopDeviceEventRouter } from "./services/DeviceEventRouter";
+import { startPhoneNotificationsSync, stopPhoneNotificationsSync } from "./services/PhoneNotificationsSync";
+import { startSpeakerIdSync, stopSpeakerIdSync } from "./services/SpeakerIdSync";
+import { startCaptionsTesterReportService, stopCaptionsTesterReportService } from "./services/CaptionsTesterReportService";
+import { startJSCrashloopReportService, stopJSCrashloopReportService } from "./services/JSCrashloopReportService";
+import { ensureMiniappEngine, stopMiniappEngine } from "./services/MiniappEngine";
+import localMiniappRuntime from "./services/LocalMiniappRuntime";
+import displayProcessor from "./services/DisplayProcessor";
+import { gallerySyncService } from "./services/asg/gallerySyncService";
+import { glasses } from "./facades/glasses";
+import { display } from "./facades/display";
+import { speech } from "./facades/speech";
+import { session } from "./facades/session";
+import { settings } from "./facades/settings";
+import { dev } from "./facades/dev";
+import { reports } from "./facades/reports";
+import { ota } from "./facades/ota";
+import { gallery } from "./facades/gallery";
+import { miniapps } from "./facades/miniapps";
+import { pairing } from "./facades/pairing";
+import { phoneNotifications } from "./facades/phoneNotifications";
+import { permissions } from "./facades/permissions";
+import { notifications } from "./facades/notifications";
+import { maps } from "./facades/maps";
+import { memory } from "./facades/memory";
+import { speakers } from "./facades/speakers";
+import { providerKeys } from "./facades/providerKeys";
+import { logBuffer } from "./utils/devLogging";
+export const engine = {
+    /** Front door — hand engine auth + config, then start/stop the runtime. */
+    configure,
+    /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */
+    updateUiSeams,
+    /** Start the runtime: mark started + construct/connect the cloud client + begin
+     * syncing device settings to the glasses. */
+    async start() {
+        // Reports attach recent phone logs, so engine owns console interception for
+        // OEM hosts too. Idempotent; the Glassly host may start it earlier.
+        logBuffer.startConsoleInterception();
+        await bootstrapStart();
+        // Construct + connect the cloud client so the documented configure()+start()
+        // lifecycle yields a live engine.session for OEMs. Idempotent for repeated
+        // start() calls.
+        cloudClientService.init();
+        // 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();
+        // 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
+        // Glassly app's MantleManager.
+        startDeviceEventRouter();
+        // Hydration contract: the native DeviceStore is in-memory and starts empty
+        // every launch; seed it from the persisted settings BEFORE start() resolves
+        // so every post-start getDefaultDevice() read is a trustworthy two-state
+        // answer (no false "absent" for genuinely-paired users at cold start).
+        // Ordered before startGlassesSettingsSync so the settings load can't
+        // double-push through the change subscription. A failed hydration must not
+        // brick the runtime: start() continues, and the guards that consume
+        // hasDefaultDevice() see the rejection and fail open.
+        try {
+            await hydrateDeviceStore();
+            // Boot repair: a persisted default_wearable without a native default
+            // device (identity abandoned mid-pairing, or resurrected from the server
+            // before identity stopped syncing) demotes to pending_wearable so hosts
+            // render finish-pairing instead of a connect that would throw.
+            await demoteOrphanedDefaultWearable();
+        }
+        catch (error) {
+            console.warn("engine.start: device-store hydration failed:", error instanceof Error ? error.message : error);
+        }
+        // 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
+        // works for any host (not just the Glassly app's host-side MantleManager fork).
+        startAudioCloudUplink();
+        // 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) {
+            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).
+        startGlassesSettingsSync();
+        // Same for phone-notification config -> the native listener (Android).
+        startPhoneNotificationsSync();
+        // On-device speaker identification: sync the enabled setting + enrolled
+        // profile centroids to the native SpeakerIdEngine, and start the resolver
+        // that annotates cloud transcripts with resolved speaker identities.
+        startSpeakerIdSync();
+        // 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
+        // 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
+        // (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
+        // second call is a no-op. Host-only crashloop telemetry is attached
+        // separately by the Glassly app.
+        localMiniappRuntime.initialize();
+        ensureMiniappEngine();
+        displayProcessor.attachToRuntime();
+        gallerySyncService.initialize();
+    },
+    /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.
+     * Each step is guarded so one failing teardown can't skip the rest and leak
+     * the remaining runtime services. */
+    async stop() {
+        const safely = async (label, step) => {
+            try {
+                await step();
+            }
+            catch (error) {
+                console.warn(`engine.stop: ${label} failed:`, error);
+            }
+        };
+        await safely("glasses settings sync", stopGlassesSettingsSync);
+        await safely("glasses status projection", stopGlassesStatusProjection);
+        await safely("device event router", stopDeviceEventRouter);
+        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("speaker id sync", stopSpeakerIdSync);
+        await safely("captions tester report service", stopCaptionsTesterReportService);
+        await safely("glasslyjs crashloop report service", stopJSCrashloopReportService);
+        await safely("miniapp engine", stopMiniappEngine);
+        await safely("local miniapp runtime", () => localMiniappRuntime.cleanup());
+        await safely("display processor", () => displayProcessor.detachFromRuntime());
+        await safely("gallery sync service", () => gallerySyncService.cleanup());
+        await safely("cloud client", () => cloudClientService.shutdown());
+        await safely("bootstrap", bootstrapStop);
+    },
+    glasses,
+    speech,
+    /** Cloud (cloud-v2) live-session status + account ops — engine owns the client. */
+    session,
+    /** Typed keyed user settings over the engine-owned settings store. */
+    settings,
+    /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */
+    dev,
+    /** Bug-report, automatic runtime report, and feedback submission. */
+    reports,
+    /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */
+    ota,
+    /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */
+    gallery,
+    /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */
+    miniapps,
+    /** First-time glasses discovery + pairing. */
+    pairing,
+    /** Phone→glasses notification forwarding (Android). */
+    phoneNotifications,
+    /** OS permissions (check/request/openSettings + per-miniapp requirements). */
+    permissions,
+    /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */
+    notifications,
+    /** Maps providers — user-supplied Mapbox access token (Settings > Keys). */
+    maps,
+    /** Shared user-scoped memory timeline (Settings > Memory + session.memory). */
+    memory,
+    /** Device-local voice profiles for on-device speaker ID (Settings > Speakers). */
+    speakers,
+    /** AI/voice provider key validation — user-supplied keys (Settings > API Keys). */
+    providerKeys,
+    display,
+};
+//# sourceMappingURL=engine.js.map

package/build/engine.js.map

@@ -0,0 +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"]}

package/build/facades/dev.d.ts

@@ -0,0 +1,69 @@
+declare function projectRuntimeStatus(): {
+    searching: boolean;
+    micRanking: import("@glassly/bluetooth-sdk").MicMode[];
+    currentMic: "" | import("@glassly/bluetooth-sdk").MicMode | null;
+    systemMicUnavailable: boolean;
+    glassesConnected: boolean;
+    glassesFullyBooted: boolean;
+    bluetoothClassicConnected: boolean;
+    coreStatus: import("..").WebSocketStatus;
+    cloudClientStatus: import("@glassly/cloud-client").RuntimeStatus;
+    cloudClientAudioTransport: import("@glassly/cloud-client").RuntimeAudioTransport;
+    transcriptionSubscribers: string[];
+    translationSubscribers: string[];
+    recentTranscriptSources: {
+        cloud: boolean;
+        direct: boolean;
+        local: boolean;
+    };
+    cloudAudioSubscriptionWrite: {
+        status: import("../stores/transcriptionDebug").CloudAudioSubscriptionWriteStatus;
+        count: number;
+    };
+};
+export type DevRuntimeStatusSnapshot = ReturnType<typeof projectRuntimeStatus>;
+export declare const dev: {
+    /** The cloud-v2 core/runtime URL overrides. */
+    cloudUrls: () => {
+        core?: string;
+        runtime?: string;
+    };
+    /** Override the cloud-v2 URLs and reconnect the live client onto them. */
+    setCloudUrls: (urls: {
+        core?: string;
+        runtime?: string;
+    }) => void;
+    /** Tear down + rebuild the live cloud client (the dev "reconnect" button). */
+    reconnectCloud: () => void;
+    /** Current native (BLE-process) memory usage in MB — a dev/diagnostics gauge. */
+    getMemoryMB: () => number;
+    /**
+     * Phone-side bluetooth runtime snapshot (the core store read-model: scan/mic/
+     * search state) — the diagnostics/data-export surface. Shallow copy.
+     */
+    bluetoothStatus: () => Record<string, unknown>;
+    /**
+     * Side-load a miniapp being served from a dev machine (the `glassly dev` / CLI
+     * flow) by its URL: probes `<url>/miniapp.json`, and on a reachable manifest
+     * registers it under its manifest package so it appears in `engine.miniapps`
+     * and can coexist with other dev miniapps. This is the OEM-host equivalent
+     * of the first-party
+     * developer-URL screen — the registration itself is engine-internal, so a
+     * host reaches it here rather than the internal registry. Rendering still
+     * flows through the normal display path once the miniapp is started.
+     */
+    loadDevMiniapp: (url: string, name?: string) => Promise<{
+        ok: true;
+        packageName: string;
+        name: string;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    /** Current engine runtime status for engine-owned debug surfaces. */
+    runtimeStatus: () => DevRuntimeStatusSnapshot;
+    /** Subscribe to the projected engine runtime status; returns an unsubscribe. */
+    onRuntimeStatus: (cb: (status: DevRuntimeStatusSnapshot) => void) => (() => void);
+};
+export {};
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +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"}

package/build/facades/dev.js

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

package/build/facades/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/facades/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,YAAY,MAAM,iCAAiC,CAAA;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAC,0BAA0B,EAAC,MAAM,8BAA8B,CAAA;AACvE,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAC,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAoB,MAAM,yBAAyB,CAAA;AACnH,OAAO,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAA;AAIhD;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,OAA0B,wBAAwB,EAAE;IAClF,MAAM,QAAQ,GAAG,8BAA8B,CAAC,IAAI,CAAC,CAAA;IACrD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAA;IACxG,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAA;IACrC,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC5D,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;KACnE,CAAA;AACH,CAAC;AAED,SAAS,8BAA8B,CAAC,IAAuB;IAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAEvC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;IAChC,MAAM,YAAY,GAAG,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;IACnD,MAAM,eAAe,GAAG,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,CAAA;IAC5D,OAAO,YAAY,IAAI,eAAe,CAAC,CAAC,CAAC,EAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACxF,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAA;IAC1C,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAA;IAChD,MAAM,WAAW,GAAG,yBAAyB,CAAC,QAAQ,EAAE,CAAA;IACxD,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,CAAA;IAChE,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,+EAA+E;QAC/E,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QAChC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,gBAAgB,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,KAAK,WAAW;QAC1D,kBAAkB,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC;QACtD,yBAAyB,EAAE,OAAO,CAAC,yBAAyB;QAC5D,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,iBAAiB,EAAE,WAAW,CAAC,MAAM;QACrC,yBAAyB,EAAE,WAAW,CAAC,cAAc;QACrD,wBAAwB,EAAE,CAAC,GAAG,kBAAkB,CAAC,wBAAwB,CAAC;QAC1E,sBAAsB,EAAE,CAAC,GAAG,kBAAkB,CAAC,sBAAsB,CAAC;QACtE,uBAAuB,EAAE,EAAC,GAAG,kBAAkB,CAAC,uBAAuB,EAAC;QACxE,2BAA2B,EAAE,EAAC,GAAG,kBAAkB,CAAC,2BAA2B,EAAC;KACjF,CAAA;AACH,CAAC;AAID,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,+CAA+C;IAC/C,SAAS,EAAE,GAAsC,EAAE;QACjD,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAA;QACrC,OAAO,EAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAC,CAAA;IACjH,CAAC;IACD,0EAA0E;IAC1E,YAAY,EAAE,CAAC,IAAuC,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,EAAC,GAAG,wBAAwB,EAAE,EAAE,GAAG,IAAI,EAAC,CAAA;QACrD,MAAM,QAAQ,GAAG,8BAA8B,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,gGAAgG,CAAC,CAAA;YAC9G,OAAM;QACR,CAAC;QAED,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAA;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACjF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACpC,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,cAAc,EAAE,GAAS,EAAE,CAAC,sBAAsB,EAAE;IAEpD,iFAAiF;IACjF,WAAW,EAAE,GAAW,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE;IACrD;;;OAGG;IACH,eAAe,EAAE,GAA4B,EAAE;QAC7C,MAAM,EAAC,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAA;QACpF,OAAO,EAAC,GAAG,KAAK,EAAC,CAAA;IACnB,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,EAAE,KAAK,EACnB,GAAW,EACX,IAAa,EACwE,EAAE;QACvF,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,MAAM;YAAE,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAC,CAAA;QACnD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QACrD,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yDAAyD,EAAC,CAAA;QACtF,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;QAChC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,aAAa,CAAA;QACtD,MAAM,WAAW,GAAI,QAAQ,CAAC,WAAkC,IAAI,oBAAoB,CAAA;QACxF,yEAAyE;QACzE,gEAAgE;QAChE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAA;QAChD,0EAA0E;QAC1E,wEAAwE;QACxE,0BAA0B;QAC1B,IAAI,OAA2B,CAAA;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAA;YAChD,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,SAAS,CAAA;QACrB,CAAC;QACD,yEAAyE;QACzE,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;QACpD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,YAAY,CAAC,CAAA;QAClG,IAAI,QAAQ,EAAE,OAAO;YAAE,MAAM,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC5E,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;YAClC,WAAW;YACX,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,WAAW;YACzG,2DAA2D;YAC3D,MAAM,EAAE,WAAW;YACnB,OAAO;YACP,IAAI,EAAE,QAAQ,CAAC,IAA4B;YAC3C,WAAW,EAAE,QAAQ,CAAC,WAA0C;YAChE,oBAAoB,EAAE,QAAQ,CAAC,oBAA4D;YAC3F,OAAO,EAAE,QAAQ,CAAC,OAAkC;SACrD,CAAC,CAAA;QACF,MAAM,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAA;QAC5C,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAC,CAAA;IACnE,CAAC;IAED,qEAAqE;IACrE,aAAa,EAAE,GAA6B,EAAE,CAAC,oBAAoB,EAAE;IAErE,gFAAgF;IAChF,eAAe,EAAE,CAAC,EAA8C,EAAgB,EAAE;QAChF,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC,CAAA;QACjD,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAA;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,IAAI,GAAG,GAAG,CAAA;YACV,EAAE,CAAC,IAAI,CAAC,CAAA;QACV,CAAC,CAAA;QACD,MAAM,aAAa,GAAG;YACpB,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC;YAC9B,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC;YACjC,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC;YACpC,yBAAyB,CAAC,SAAS,CAAC,MAAM,CAAC;YAC3C,0BAA0B,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7C,CAAA;QACD,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;QACvD,CAAC,CAAA;IACH,CAAC;CACF,CAAA","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"]}

package/build/facades/display.d.ts

@@ -0,0 +1,21 @@
+/**
+ * display facade — `engine.display`: the host/OEM display surface. `mirror`
+ * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the
+ * 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";
+export declare const display: {
+    /** Mirrored-view read-model (current/onMirror/view/setView). */
+    mirror: {
+        current(): import("./displayMirror").DisplayMirrorEvent;
+        onMirror(cb: (event: import("./displayMirror").DisplayMirrorEvent) => void): () => void;
+        view(): string;
+        setView(view: "main" | "dashboard"): void;
+    };
+    /** Write raw text to the glasses display at (x, y) with a font size. */
+    text: (text: string, x?: number | undefined, y?: number | undefined, size?: number | undefined) => Promise<void>;
+    /** Clear the glasses display. */
+    clear: () => Promise<void>;
+};
+//# sourceMappingURL=display.d.ts.map

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

@@ -0,0 +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"}

package/build/facades/display.js

@@ -0,0 +1,17 @@
+/**
+ * display facade — `engine.display`: the host/OEM display surface. `mirror`
+ * exposes the mirrored-view read-model; `text`/`clear` are raw passthroughs to the
+ * 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 { displayMirror } from "./displayMirror";
+export const display = {
+    /** Mirrored-view read-model (current/onMirror/view/setView). */
+    mirror: displayMirror,
+    /** Write raw text to the glasses display at (x, y) with a font size. */
+    text: (...args) => BluetoothSdk.displayText(...args),
+    /** Clear the glasses display. */
+    clear: () => BluetoothSdk.clearDisplay(),
+};
+//# sourceMappingURL=display.js.map

package/build/facades/display.js.map

@@ -0,0 +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"]}

package/build/facades/displayMirror.d.ts

@@ -0,0 +1,15 @@
+export type DisplayMirrorEvent = Record<string, unknown> & {
+    view?: string;
+    layout?: any;
+};
+export declare const displayMirror: {
+    /** The display event currently shown on the previewed view (snapshot). */
+    current(): DisplayMirrorEvent;
+    /** Subscribe to changes of the previewed display event; returns an unsubscribe. */
+    onMirror(cb: (event: DisplayMirrorEvent) => void): () => void;
+    /** Which view is previewed — the main screen or the dashboard. */
+    view(): string;
+    /** Switch the previewed view between `"main"` and `"dashboard"`. */
+    setView(view: "main" | "dashboard"): void;
+};
+//# sourceMappingURL=displayMirror.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"displayMirror.d.ts","sourceRoot":"","sources":["../../src/facades/displayMirror.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAC,CAAA;AAExF,eAAO,MAAM,aAAa;IACxB,0EAA0E;eAC/D,kBAAkB;IAK7B,mFAAmF;iBACtE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAI7D,kEAAkE;YAC1D,MAAM;IAGd,oEAAoE;kBACtD,MAAM,GAAG,WAAW,GAAG,IAAI;CAG1C,CAAA"}