@glassly/engine 0.1.0-dev.99 → 0.2.9-beta.448

package/build/utils/hardware/hardware.js

@@ -58,7 +58,7 @@ export class HardwareCompatibility {
             case HardwareType.DISPLAY:
                 return capabilities.hasDisplay;
             case HardwareType.MICROPHONE:
-                // GlasslyOS always provides an audio-input path. When the connected
+                // Glassly always provides an audio-input path. When the connected
                 // glasses do not have an onboard microphone, the engine falls back to
                 // the phone microphone. Keep `capabilities.hasMicrophone` reserved for
                 // physical-device/source selection; app compatibility is about whether

package/build/utils/hardware/hardware.js.map

@@ -1 +1 @@
-{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Capabilities,\n  HardwareRequirement,\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  simulatedGlasses,\n} from \"../../types\"\n\n/**\n * Result of a hardware compatibility check\n */\nexport interface CompatibilityResult {\n  isCompatible: boolean\n  missingRequired: HardwareRequirement[]\n  missingOptional: HardwareRequirement[]\n  warnings: string[]\n}\n\n/**\n * Service for checking hardware compatibility between apps and glasses\n */\nexport class HardwareCompatibility {\n  /**\n   * Check if app is compatible with given device capabilities\n   * @param app The app to check\n   * @param capabilities The device capabilities (null if no device connected)\n   * @returns Detailed compatibility result\n   */\n  static checkCompatibility(\n    hardwareRequirements: HardwareRequirement[],\n    capabilities: Capabilities | null,\n  ): CompatibilityResult {\n    const result: CompatibilityResult = {\n      isCompatible: true,\n      missingRequired: [],\n      missingOptional: [],\n      warnings: [],\n    }\n\n    // If no hardware requirements specified, app is compatible with any hardware\n    if (hardwareRequirements.length === 0) {\n      return result\n    }\n\n    // If no capabilities available assume simulated glasses:\n    if (!capabilities) {\n      capabilities = simulatedGlasses\n    }\n\n    // Check each hardware requirement\n    for (const requirement of hardwareRequirements) {\n      const hasHardware = this.checkHardwareAvailable(requirement.type, capabilities!)\n      if (!hasHardware) {\n        if (requirement.level === HardwareRequirementLevel.REQUIRED) {\n          result.missingRequired.push(requirement)\n          result.isCompatible = false\n        } else {\n          result.missingOptional.push(requirement)\n        }\n      }\n    }\n\n    return result\n  }\n\n  /**\n   * Check if specific hardware is available in capabilities\n   * @param hardwareType The type of hardware to check\n   * @param capabilities The device capabilities\n   * @returns true if hardware is available\n   */\n  private static checkHardwareAvailable(hardwareType: HardwareType, capabilities: Capabilities): boolean {\n    if (hardwareType === HardwareType.EXIST) {\n      if (capabilities.modelName === DeviceTypes.NONE) {\n        return false\n      }\n      return true\n    }\n\n    switch (hardwareType) {\n      case HardwareType.CAMERA:\n        return capabilities.hasCamera\n\n      case HardwareType.DISPLAY:\n        return capabilities.hasDisplay\n\n      case HardwareType.MICROPHONE:\n        // GlasslyOS always provides an audio-input path. When the connected\n        // glasses do not have an onboard microphone, the engine falls back to\n        // the phone microphone. Keep `capabilities.hasMicrophone` reserved for\n        // physical-device/source selection; app compatibility is about whether\n        // the requested input is available to the miniapp.\n        return true\n\n      case HardwareType.SPEAKER:\n        return capabilities.hasSpeaker\n\n      case HardwareType.IMU:\n        return capabilities.hasIMU\n\n      case HardwareType.BUTTON:\n        return capabilities.hasButton\n\n      case HardwareType.LIGHT:\n        return capabilities.hasLight\n\n      case HardwareType.WIFI:\n        return capabilities.hasWifi\n\n      default:\n        // Unknown hardware type - assume not available\n        return false\n    }\n  }\n\n  /**\n   * Get human-readable compatibility message\n   * @param result The compatibility check result\n   * @returns User-friendly message about compatibility\n   */\n  static getCompatibilityMessage(result: CompatibilityResult): string {\n    if (result.isCompatible) {\n      if (result.missingOptional.length > 0) {\n        const optionalHardware = result.missingOptional.map((req) => req.type.toLowerCase()).join(\", \")\n        return `This app works with your glasses but has optional features that require: ${optionalHardware}`\n      }\n      return \"This app is fully compatible with your glasses\"\n    }\n\n    const requiredHardware = result.missingRequired.map((req) => req.type.toLowerCase()).join(\", \")\n\n    if (result.missingRequired.length === 1) {\n      return `This app requires a ${requiredHardware} which is not available on your connected glasses`\n    } else {\n      return `This app requires the following hardware which is not available on your connected glasses: ${requiredHardware}`\n    }\n  }\n\n  /**\n   * Get detailed compatibility messages including descriptions\n   * @param result The compatibility check result\n   * @returns Array of detailed messages\n   */\n  static getDetailedMessages(result: CompatibilityResult): string[] {\n    const messages: string[] = []\n\n    // Add warnings first\n    messages.push(...result.warnings)\n\n    // Add missing required hardware\n    for (const req of result.missingRequired) {\n      let message = `❌ Missing required ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    // Add missing optional hardware\n    for (const req of result.missingOptional) {\n      let message = `⚠️ Missing optional ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    return messages\n  }\n}\n"]}
+{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../src/utils/hardware/hardware.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EACZ,wBAAwB,EACxB,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAYpB;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,oBAA2C,EAC3C,YAAiC;QAEjC,MAAM,MAAM,GAAwB;YAClC,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,EAAE;YACnB,eAAe,EAAE,EAAE;YACnB,QAAQ,EAAE,EAAE;SACb,CAAA;QAED,6EAA6E;QAC7E,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,yDAAyD;QACzD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,gBAAgB,CAAA;QACjC,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,IAAI,EAAE,YAAa,CAAC,CAAA;YAChF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,WAAW,CAAC,KAAK,KAAK,wBAAwB,CAAC,QAAQ,EAAE,CAAC;oBAC5D,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;oBACxC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAA;gBAC7B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,sBAAsB,CAAC,YAA0B,EAAE,YAA0B;QAC1F,IAAI,YAAY,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;YACxC,IAAI,YAAY,CAAC,SAAS,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;gBAChD,OAAO,KAAK,CAAA;YACd,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QAED,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,YAAY,CAAC,MAAM;gBACtB,OAAO,YAAY,CAAC,SAAS,CAAA;YAE/B,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,YAAY,CAAC,UAAU,CAAA;YAEhC,KAAK,YAAY,CAAC,UAAU;gBAC1B,kEAAkE;gBAClE,sEAAsE;gBACtE,uEAAuE;gBACvE,uEAAuE;gBACvE,mDAAmD;gBACnD,OAAO,IAAI,CAAA;YAEb,KAAK,YAAY,CAAC,OAAO;gBACvB,OAAO,YAAY,CAAC,UAAU,CAAA;YAEhC,KAAK,YAAY,CAAC,GAAG;gBACnB,OAAO,YAAY,CAAC,MAAM,CAAA;YAE5B,KAAK,YAAY,CAAC,MAAM;gBACtB,OAAO,YAAY,CAAC,SAAS,CAAA;YAE/B,KAAK,YAAY,CAAC,KAAK;gBACrB,OAAO,YAAY,CAAC,QAAQ,CAAA;YAE9B,KAAK,YAAY,CAAC,IAAI;gBACpB,OAAO,YAAY,CAAC,OAAO,CAAA;YAE7B;gBACE,+CAA+C;gBAC/C,OAAO,KAAK,CAAA;QAChB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAA2B;QACxD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC/F,OAAO,4EAA4E,gBAAgB,EAAE,CAAA;YACvG,CAAC;YACD,OAAO,gDAAgD,CAAA;QACzD,CAAC;QAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE/F,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO,uBAAuB,gBAAgB,mDAAmD,CAAA;QACnG,CAAC;aAAM,CAAC;YACN,OAAO,8FAA8F,gBAAgB,EAAE,CAAA;QACzH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAA2B;QACpD,MAAM,QAAQ,GAAa,EAAE,CAAA;QAE7B,qBAAqB;QACrB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;QAEjC,gCAAgC;QAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACzC,IAAI,OAAO,GAAG,sBAAsB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;YAC5D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,CAAA;YACnC,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QAED,gCAAgC;QAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACzC,IAAI,OAAO,GAAG,uBAAuB,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;YAC7D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,OAAO,IAAI,KAAK,GAAG,CAAC,WAAW,EAAE,CAAA;YACnC,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF","sourcesContent":["import {\n  Capabilities,\n  HardwareRequirement,\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  simulatedGlasses,\n} from \"../../types\"\n\n/**\n * Result of a hardware compatibility check\n */\nexport interface CompatibilityResult {\n  isCompatible: boolean\n  missingRequired: HardwareRequirement[]\n  missingOptional: HardwareRequirement[]\n  warnings: string[]\n}\n\n/**\n * Service for checking hardware compatibility between apps and glasses\n */\nexport class HardwareCompatibility {\n  /**\n   * Check if app is compatible with given device capabilities\n   * @param app The app to check\n   * @param capabilities The device capabilities (null if no device connected)\n   * @returns Detailed compatibility result\n   */\n  static checkCompatibility(\n    hardwareRequirements: HardwareRequirement[],\n    capabilities: Capabilities | null,\n  ): CompatibilityResult {\n    const result: CompatibilityResult = {\n      isCompatible: true,\n      missingRequired: [],\n      missingOptional: [],\n      warnings: [],\n    }\n\n    // If no hardware requirements specified, app is compatible with any hardware\n    if (hardwareRequirements.length === 0) {\n      return result\n    }\n\n    // If no capabilities available assume simulated glasses:\n    if (!capabilities) {\n      capabilities = simulatedGlasses\n    }\n\n    // Check each hardware requirement\n    for (const requirement of hardwareRequirements) {\n      const hasHardware = this.checkHardwareAvailable(requirement.type, capabilities!)\n      if (!hasHardware) {\n        if (requirement.level === HardwareRequirementLevel.REQUIRED) {\n          result.missingRequired.push(requirement)\n          result.isCompatible = false\n        } else {\n          result.missingOptional.push(requirement)\n        }\n      }\n    }\n\n    return result\n  }\n\n  /**\n   * Check if specific hardware is available in capabilities\n   * @param hardwareType The type of hardware to check\n   * @param capabilities The device capabilities\n   * @returns true if hardware is available\n   */\n  private static checkHardwareAvailable(hardwareType: HardwareType, capabilities: Capabilities): boolean {\n    if (hardwareType === HardwareType.EXIST) {\n      if (capabilities.modelName === DeviceTypes.NONE) {\n        return false\n      }\n      return true\n    }\n\n    switch (hardwareType) {\n      case HardwareType.CAMERA:\n        return capabilities.hasCamera\n\n      case HardwareType.DISPLAY:\n        return capabilities.hasDisplay\n\n      case HardwareType.MICROPHONE:\n        // Glassly always provides an audio-input path. When the connected\n        // glasses do not have an onboard microphone, the engine falls back to\n        // the phone microphone. Keep `capabilities.hasMicrophone` reserved for\n        // physical-device/source selection; app compatibility is about whether\n        // the requested input is available to the miniapp.\n        return true\n\n      case HardwareType.SPEAKER:\n        return capabilities.hasSpeaker\n\n      case HardwareType.IMU:\n        return capabilities.hasIMU\n\n      case HardwareType.BUTTON:\n        return capabilities.hasButton\n\n      case HardwareType.LIGHT:\n        return capabilities.hasLight\n\n      case HardwareType.WIFI:\n        return capabilities.hasWifi\n\n      default:\n        // Unknown hardware type - assume not available\n        return false\n    }\n  }\n\n  /**\n   * Get human-readable compatibility message\n   * @param result The compatibility check result\n   * @returns User-friendly message about compatibility\n   */\n  static getCompatibilityMessage(result: CompatibilityResult): string {\n    if (result.isCompatible) {\n      if (result.missingOptional.length > 0) {\n        const optionalHardware = result.missingOptional.map((req) => req.type.toLowerCase()).join(\", \")\n        return `This app works with your glasses but has optional features that require: ${optionalHardware}`\n      }\n      return \"This app is fully compatible with your glasses\"\n    }\n\n    const requiredHardware = result.missingRequired.map((req) => req.type.toLowerCase()).join(\", \")\n\n    if (result.missingRequired.length === 1) {\n      return `This app requires a ${requiredHardware} which is not available on your connected glasses`\n    } else {\n      return `This app requires the following hardware which is not available on your connected glasses: ${requiredHardware}`\n    }\n  }\n\n  /**\n   * Get detailed compatibility messages including descriptions\n   * @param result The compatibility check result\n   * @returns Array of detailed messages\n   */\n  static getDetailedMessages(result: CompatibilityResult): string[] {\n    const messages: string[] = []\n\n    // Add warnings first\n    messages.push(...result.warnings)\n\n    // Add missing required hardware\n    for (const req of result.missingRequired) {\n      let message = `❌ Missing required ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    // Add missing optional hardware\n    for (const req of result.missingOptional) {\n      let message = `⚠️ Missing optional ${req.type.toLowerCase()}`\n      if (req.description) {\n        message += `: ${req.description}`\n      }\n      messages.push(message)\n    }\n\n    return messages\n  }\n}\n"]}

package/build/utils/timers/timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAwHA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAoJA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}

package/build/utils/timers/timers.js

@@ -21,7 +21,29 @@
 //     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS
 //     suspends the whole process in background anyway, so background timing
 //     there is handled by native per-device queues, not JS timers.
-import { Alert, Platform } from "react-native";
+//
+// react-native is loaded lazily, not imported. Every engine service runs its
+// timers through this module, and the engine's bun test suites load those
+// services in a plain JS runtime that cannot parse react-native's Flow
+// source. A static import would force every such suite to mock this module;
+// with the lazy load, a runtime without react-native simply gets the JS
+// timers, which is the correct answer there anyway.
+let reactNative;
+function getReactNative() {
+    if (reactNative !== undefined) {
+        return reactNative;
+    }
+    try {
+        reactNative = require("react-native");
+    }
+    catch {
+        reactNative = null;
+    }
+    return reactNative;
+}
+function isDev() {
+    return typeof __DEV__ !== "undefined" && __DEV__;
+}
 let nitroTimer;
 let nitroDisabled = false;
 let failedLoud = false;
@@ -42,12 +64,12 @@ function failUnavailable(reason) {
         "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
         "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.";
     console.error(message);
-    if (__DEV__) {
+    if (isDev()) {
         // A stale dev client may ALSO show the library's own require-time red box
         // (bridgeless LogBox surfaces it even though we catch below) — this alert
         // is the actionable one: it names the fix.
         try {
-            Alert.alert("Background timers unavailable", message);
+            getReactNative()?.Alert?.alert("Background timers unavailable", message);
         }
         catch {
             /* Alert not available (tests / headless) — the console.error stands. */
@@ -55,7 +77,7 @@ function failUnavailable(reason) {
     }
 }
 function getNitroTimer() {
-    if (nitroDisabled || Platform.OS !== "android") {
+    if (nitroDisabled || getReactNative()?.Platform.OS !== "android") {
         return null;
     }
     if (nitroTimer !== undefined) {

package/build/utils/timers/timers.js.map

@@ -1 +1 @@
-{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// BgTimer — background-safe timers for the engine.\n//\n// Everything timing-critical in the engine runs through this class: the\n// miniapp liveness watchdog, display durationMs expiries, boot windows,\n// auth-token refresh. On Android, React Native PAUSES plain JS timers while\n// the app is backgrounded, so those features only keep working in the\n// background when the native implementation (react-native-nitro-bg-timer)\n// is active.\n//\n// Who actually gets native timers:\n//   - Android, dev AND release: always attempted — dev must match production\n//     background behavior. There is no opt-in/opt-out env var. If the native\n//     module is unavailable (a dev client whose binary predates it, or a\n//     broken release binary), the failure is LOUD: a console.error with the\n//     remediation, plus a blocking dev alert. The JS-timer fallback still\n//     engages so foreground behavior keeps working, but backgrounded\n//     behavior is broken until the native rebuild — the error says exactly\n//     that. (A silent dev fallback previously cost a full debugging day of\n//     phantom \"zombie miniapp\" bugs; see OS-1790.)\n//   - iOS: never, dev or prod — the package is disabled pending\n//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS\n//     suspends the whole process in background anyway, so background timing\n//     there is handled by native per-device queues, not JS timers.\n\nimport {Alert, Platform} from \"react-native\"\n\ntype NitroTimerApi = {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nlet nitroTimer: NitroTimerApi | null | undefined\nlet nitroDisabled = false\nlet failedLoud = false\n\n/**\n * The native background timer is unavailable — say so ONCE, loudly, with the\n * remediation. The JS-timer fallback keeps foreground behavior working, but\n * everything timing-driven freezes while the app is backgrounded, which\n * presents as phantom miniapp bugs (frozen captions, missed wake words,\n * watchdog kills on resume). A quiet warning here has already cost a full\n * debugging day; never downgrade this to console.warn.\n */\nfunction failUnavailable(reason: string) {\n  if (failedLoud) {\n    return\n  }\n  failedLoud = true\n  const message =\n    `BgTimer: native background timer unavailable (${reason}). ` +\n    \"Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. \" +\n    \"Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.\"\n  console.error(message)\n  if (__DEV__) {\n    // A stale dev client may ALSO show the library's own require-time red box\n    // (bridgeless LogBox surfaces it even though we catch below) — this alert\n    // is the actionable one: it names the fix.\n    try {\n      Alert.alert(\"Background timers unavailable\", message)\n    } catch {\n      /* Alert not available (tests / headless) — the console.error stands. */\n    }\n  }\n}\n\nfunction getNitroTimer(): NitroTimerApi | null {\n  if (nitroDisabled || Platform.OS !== \"android\") {\n    return null\n  }\n\n  if (nitroTimer !== undefined) {\n    return nitroTimer\n  }\n\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) {\n      nitroTimer = null\n      failUnavailable(\"nitro runtime is not alive\")\n      return nitroTimer\n    }\n\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: NitroTimerApi}\n    nitroTimer =\n      BackgroundTimer &&\n      typeof BackgroundTimer.setTimeout === \"function\" &&\n      typeof BackgroundTimer.setInterval === \"function\" &&\n      typeof BackgroundTimer.clearTimeout === \"function\" &&\n      typeof BackgroundTimer.clearInterval === \"function\"\n        ? BackgroundTimer\n        : null\n  } catch {\n    nitroTimer = null\n    nitroDisabled = true\n  }\n\n  if (!nitroTimer) {\n    failUnavailable(\"react-native-nitro-bg-timer failed to load\")\n  }\n  return nitroTimer\n}\n\nfunction withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {\n  const api = getNitroTimer()\n  if (!api) {\n    return fallback()\n  }\n  try {\n    return run(api)\n  } catch (error) {\n    nitroDisabled = true\n    nitroTimer = null\n    failedLoud = false // a mid-session failure is new information — re-announce\n    failUnavailable(`nitro timer call threw: ${String(error)}`)\n    return fallback()\n  }\n}\n\nexport class BgTimer {\n  static setInterval(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setInterval(callback, delay),\n      () => setInterval(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearInterval(intervalId: number): void {\n    withNitro(\n      (api) => api.clearInterval(intervalId),\n      () => clearInterval(intervalId),\n    )\n  }\n\n  static setTimeout(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setTimeout(callback, delay),\n      () => setTimeout(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearTimeout(timeoutId: number): void {\n    withNitro(\n      (api) => api.clearTimeout(timeoutId),\n      () => clearTimeout(timeoutId),\n    )\n  }\n}\n\nexport function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let lastCalled = 0\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now()\n    if (now - lastCalled >= ms) {\n      lastCalled = now\n      fn(...args)\n    }\n  }\n}\n\nexport function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let timeoutId: number | null = null\n\n  return (...args: Parameters<T>) => {\n    if (timeoutId) {\n      BgTimer.clearTimeout(timeoutId)\n    }\n    timeoutId = BgTimer.setTimeout(() => {\n      fn(...args)\n      timeoutId = null\n    }, ms)\n  }\n}\n"]}
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// BgTimer — background-safe timers for the engine.\n//\n// Everything timing-critical in the engine runs through this class: the\n// miniapp liveness watchdog, display durationMs expiries, boot windows,\n// auth-token refresh. On Android, React Native PAUSES plain JS timers while\n// the app is backgrounded, so those features only keep working in the\n// background when the native implementation (react-native-nitro-bg-timer)\n// is active.\n//\n// Who actually gets native timers:\n//   - Android, dev AND release: always attempted — dev must match production\n//     background behavior. There is no opt-in/opt-out env var. If the native\n//     module is unavailable (a dev client whose binary predates it, or a\n//     broken release binary), the failure is LOUD: a console.error with the\n//     remediation, plus a blocking dev alert. The JS-timer fallback still\n//     engages so foreground behavior keeps working, but backgrounded\n//     behavior is broken until the native rebuild — the error says exactly\n//     that. (A silent dev fallback previously cost a full debugging day of\n//     phantom \"zombie miniapp\" bugs; see OS-1790.)\n//   - iOS: never, dev or prod — the package is disabled pending\n//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS\n//     suspends the whole process in background anyway, so background timing\n//     there is handled by native per-device queues, not JS timers.\n//\n// react-native is loaded lazily, not imported. Every engine service runs its\n// timers through this module, and the engine's bun test suites load those\n// services in a plain JS runtime that cannot parse react-native's Flow\n// source. A static import would force every such suite to mock this module;\n// with the lazy load, a runtime without react-native simply gets the JS\n// timers, which is the correct answer there anyway.\n\ntype ReactNativeSubset = {\n  Platform: {OS: string}\n  Alert?: {alert: (title: string, message?: string) => void}\n}\n\nlet reactNative: ReactNativeSubset | null | undefined\n\nfunction getReactNative(): ReactNativeSubset | null {\n  if (reactNative !== undefined) {\n    return reactNative\n  }\n  try {\n    reactNative = require(\"react-native\") as ReactNativeSubset\n  } catch {\n    reactNative = null\n  }\n  return reactNative\n}\n\nfunction isDev(): boolean {\n  return typeof __DEV__ !== \"undefined\" && __DEV__\n}\n\ntype NitroTimerApi = {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nlet nitroTimer: NitroTimerApi | null | undefined\nlet nitroDisabled = false\nlet failedLoud = false\n\n/**\n * The native background timer is unavailable — say so ONCE, loudly, with the\n * remediation. The JS-timer fallback keeps foreground behavior working, but\n * everything timing-driven freezes while the app is backgrounded, which\n * presents as phantom miniapp bugs (frozen captions, missed wake words,\n * watchdog kills on resume). A quiet warning here has already cost a full\n * debugging day; never downgrade this to console.warn.\n */\nfunction failUnavailable(reason: string) {\n  if (failedLoud) {\n    return\n  }\n  failedLoud = true\n  const message =\n    `BgTimer: native background timer unavailable (${reason}). ` +\n    \"Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. \" +\n    \"Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.\"\n  console.error(message)\n  if (isDev()) {\n    // A stale dev client may ALSO show the library's own require-time red box\n    // (bridgeless LogBox surfaces it even though we catch below) — this alert\n    // is the actionable one: it names the fix.\n    try {\n      getReactNative()?.Alert?.alert(\"Background timers unavailable\", message)\n    } catch {\n      /* Alert not available (tests / headless) — the console.error stands. */\n    }\n  }\n}\n\nfunction getNitroTimer(): NitroTimerApi | null {\n  if (nitroDisabled || getReactNative()?.Platform.OS !== \"android\") {\n    return null\n  }\n\n  if (nitroTimer !== undefined) {\n    return nitroTimer\n  }\n\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) {\n      nitroTimer = null\n      failUnavailable(\"nitro runtime is not alive\")\n      return nitroTimer\n    }\n\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: NitroTimerApi}\n    nitroTimer =\n      BackgroundTimer &&\n      typeof BackgroundTimer.setTimeout === \"function\" &&\n      typeof BackgroundTimer.setInterval === \"function\" &&\n      typeof BackgroundTimer.clearTimeout === \"function\" &&\n      typeof BackgroundTimer.clearInterval === \"function\"\n        ? BackgroundTimer\n        : null\n  } catch {\n    nitroTimer = null\n    nitroDisabled = true\n  }\n\n  if (!nitroTimer) {\n    failUnavailable(\"react-native-nitro-bg-timer failed to load\")\n  }\n  return nitroTimer\n}\n\nfunction withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {\n  const api = getNitroTimer()\n  if (!api) {\n    return fallback()\n  }\n  try {\n    return run(api)\n  } catch (error) {\n    nitroDisabled = true\n    nitroTimer = null\n    failedLoud = false // a mid-session failure is new information — re-announce\n    failUnavailable(`nitro timer call threw: ${String(error)}`)\n    return fallback()\n  }\n}\n\nexport class BgTimer {\n  static setInterval(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setInterval(callback, delay),\n      () => setInterval(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearInterval(intervalId: number): void {\n    withNitro(\n      (api) => api.clearInterval(intervalId),\n      () => clearInterval(intervalId),\n    )\n  }\n\n  static setTimeout(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setTimeout(callback, delay),\n      () => setTimeout(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearTimeout(timeoutId: number): void {\n    withNitro(\n      (api) => api.clearTimeout(timeoutId),\n      () => clearTimeout(timeoutId),\n    )\n  }\n}\n\nexport function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let lastCalled = 0\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now()\n    if (now - lastCalled >= ms) {\n      lastCalled = now\n      fn(...args)\n    }\n  }\n}\n\nexport function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let timeoutId: number | null = null\n\n  return (...args: Parameters<T>) => {\n    if (timeoutId) {\n      BgTimer.clearTimeout(timeoutId)\n    }\n    timeoutId = BgTimer.setTimeout(() => {\n      fn(...args)\n      timeoutId = null\n    }, ms)\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.1.0-dev.99",
+  "version": "0.2.9-beta.448",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,23 +97,23 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.1.0-dev.99",
-    "@glassly/cloud-client": "0.1.0-dev.99",
-    "@glassly/cloud-protocol": "0.1.0-dev.99",
-    "@glassly/crust": "0.1.0-dev.99",
-    "@glassly/miniapp": "0.1.0-dev.99",
+    "@glassly/bluetooth-sdk": "0.2.9-beta.448",
+    "@glassly/cloud-client": "0.2.9-beta.448",
+    "@glassly/cloud-protocol": "0.2.9-beta.448",
+    "@glassly/crust": "0.2.9-beta.448",
+    "@glassly/miniapp": "0.2.9-beta.448",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.1.0-dev.99"
+    "@glassly/llm-providers": "0.2.9-beta.448"
   },
   "devDependencies": {
     "@glassly/llm-providers": "workspace:*",
     "@types/semver": "^7.7.1",
     "expo-module-scripts": "^56.0.3",
-    "expo-modules-core": "57.0.7",
+    "expo-modules-core": "^57.0.7",
     "react-native-nitro-modules": "^0.31.10",
     "typescript": "~5.9.2"
   },

package/src/engine.ts

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

package/src/facades/dev.ts

@@ -20,6 +20,8 @@ import {getConfigValues} from "../runtime/bootstrap"
 import {decideDevLaunchRoute} from "../utils/devMiniappLaunch"
 import {deriveDevPackageId, registerDevApp, DEV_APP_PACKAGE_NAME, type DevAppRecord} from "../services/AppRegistry"
 import {useAppStatusStore} from "../stores/apps"
+import {sendGesture} from "../services/GlassesTouchInput"
+import dashboardOpenTrace, {type DashboardOpenReport} from "../services/debug/DashboardOpenTrace"
 
 type CloudUrlOverrides = {core?: string; runtime?: string}
 
@@ -90,6 +92,8 @@ function projectRuntimeStatus() {
 export type DevRuntimeStatusSnapshot = ReturnType<typeof projectRuntimeStatus>
 
 export const dev = {
+  /** Inject a glasses gesture through the normal dashboard/miniapp input policy. */
+  sendGesture,
   /** The cloud-v2 core/runtime URL overrides. */
   cloudUrls: (): {core?: string; runtime?: string} => {
     const s = useSettingsStore.getState()
@@ -210,4 +214,10 @@ export const dev = {
       unsubscribers.forEach((unsubscribe) => unsubscribe())
     }
   },
+
+  /**
+   * Each finished dashboard open while the debug_dashboard_open_timing setting
+   * is on: a ready-made title/body plus the stage timings. Returns an unsubscribe.
+   */
+  onDashboardOpenTrace: (cb: (report: DashboardOpenReport) => void): (() => void) => dashboardOpenTrace.onReport(cb),
 }

package/src/facades/display.ts

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

package/src/facades/displayMirror.ts

@@ -7,10 +7,20 @@
  * The raw store is also exposed as `engine.displayStore` (the Glassly-app
  * escape hatch).
  */
+import displayProcessor from "../services/DisplayProcessor"
+import {getEffectiveCapabilities} from "../services/effectiveCapabilities"
 import {useDisplayStore} from "../stores/display"
+import {useGlassesStore} from "../stores/glasses"
+import {SETTINGS, useSettingsStore} from "../stores/settings"
+import {DeviceTypes} from "../types"
 
 export type DisplayMirrorEvent = Record<string, unknown> & {view?: string; layout?: any}
 
+export interface DisplayMirrorCanvas {
+  width: number
+  height: number
+}
+
 export const displayMirror = {
   /** The display event currently on the glasses (snapshot). */
   current(): DisplayMirrorEvent {
@@ -22,4 +32,23 @@ export const displayMirror = {
   onMirror(cb: (event: DisplayMirrorEvent) => void): () => void {
     return useDisplayStore.subscribe((s) => s.currentEvent, cb)
   },
+
+  /**
+   * Drawable canvas of the selected glasses, in device px — the space scene
+   * frames and positioned layouts are laid out in (same source SceneRenderer
+   * sends CONNECT_ACK from). Falls back to the text profile's line width.
+   * `previewModel` previews a model that is not selected yet (pairing prep).
+   */
+  canvas(previewModel?: string): DisplayMirrorCanvas {
+    const model =
+      previewModel ??
+      (useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key) as string | undefined) ??
+      (useGlassesStore.getState().deviceModel as string | undefined)
+    const display = getEffectiveCapabilities((model ?? DeviceTypes.NONE) as DeviceTypes)?.display
+    const profile = displayProcessor.getProfile()
+    return {
+      width: display?.width ?? display?.resolution?.width ?? profile.displayWidthPx,
+      height: display?.height ?? display?.resolution?.height ?? profile.displayHeightPx ?? profile.displayWidthPx / 2,
+    }
+  },
 }

package/src/facades/glasses.ts

@@ -11,7 +11,14 @@
 // surface, not the public entry. Relative path (the alias doesn't resolve in engine's
 // standalone build); jest moduleNameMapper + tsconfig both resolve it.
 import BluetoothSdk from "@glassly/bluetooth-sdk/internal"
-import type {ButtonPressEvent, ConnectOptions, Device, TouchEvent} from "@glassly/bluetooth-sdk"
+import type {
+  ButtonPressEvent,
+  ConnectOptions,
+  Device,
+  KeyboardAdvertEvent,
+  KeyboardPairingEvent,
+  TouchEvent,
+} from "@glassly/bluetooth-sdk"
 import {useGlassesStore} from "../stores/glasses"
 import {useSettingsStore, SETTINGS} from "../stores/settings"
 import {hasDefaultDevice} from "../services/DeviceStoreHydration"
@@ -50,6 +57,20 @@ function projectControllerStatus() {
   }
 }
 
+function projectKeyboardStatus() {
+  const s = useGlassesStore.getState()
+  return {
+    /** Connected glasses run a firmware that can host a keyboard (G2 Glassly CFW 39+). */
+    available: s.keyboardBridge === true,
+    connected: s.keyboardConnected === true,
+    name: s.keyboardName ?? "",
+    /** A keyboard is remembered and reconnects automatically. */
+    saved: s.keyboardSaved === true,
+    state: s.keyboardState ?? "idle",
+    error: s.keyboardError ?? "",
+  }
+}
+
 function projectInfo() {
   const s = useGlassesStore.getState()
   return {
@@ -77,6 +98,7 @@ function projectInfo() {
 
 export type GlassesStatusSnapshot = ReturnType<typeof projectStatus>
 export type ControllerStatusSnapshot = ReturnType<typeof projectControllerStatus>
+export type KeyboardStatusSnapshot = ReturnType<typeof projectKeyboardStatus>
 export type GlassesInfoSnapshot = ReturnType<typeof projectInfo>
 
 export const glasses = {
@@ -189,6 +211,44 @@ export const glasses = {
     return () => sub.remove()
   },
 
+  // --- BLE keyboard bridged through G2 Glassly CFW (revision 39+) ---
+  keyboard: {
+    /** Five-second scan; distinct advertisers, HID ones flagged. Also streams via onAdvert. */
+    scan: (): Promise<KeyboardAdvertEvent[]> => BluetoothSdk.g2KeyboardScan(),
+    /** Connect, pair and subscribe; the keyboard is remembered and auto-reconnected. */
+    connect: async (device: {address: string; addressType: number; name: string}): Promise<void> => {
+      await BluetoothSdk.g2KeyboardConnect(device.address, device.addressType, device.name)
+      useSettingsStore.getState().setSetting(SETTINGS.keyboard_name.key, device.name)
+    },
+    reconnect: (): Promise<void> => BluetoothSdk.g2KeyboardReconnect(),
+    disconnect: (): Promise<void> => BluetoothSdk.g2KeyboardDisconnect(),
+    forget: async (): Promise<void> => {
+      await BluetoothSdk.g2KeyboardForget()
+      useSettingsStore.getState().setSetting(SETTINGS.keyboard_name.key, "")
+    },
+    passkey: (pin: number): Promise<void> => BluetoothSdk.g2KeyboardPasskey(pin),
+    compare: (accept: boolean): Promise<void> => BluetoothSdk.g2KeyboardCompare(accept),
+    status: (): KeyboardStatusSnapshot => projectKeyboardStatus(),
+    onStatus: (cb: (status: KeyboardStatusSnapshot) => void): (() => void) => {
+      let last = JSON.stringify(projectKeyboardStatus())
+      return useGlassesStore.subscribe(() => {
+        const snap = projectKeyboardStatus()
+        const key = JSON.stringify(snap)
+        if (key === last) return
+        last = key
+        cb(snap)
+      })
+    },
+    onAdvert: (cb: (advert: KeyboardAdvertEvent) => void): (() => void) => {
+      const sub = BluetoothSdk.addListener("keyboard_advert", cb)
+      return () => sub.remove()
+    },
+    onPairing: (cb: (prompt: KeyboardPairingEvent) => void): (() => void) => {
+      const sub = BluetoothSdk.addListener("keyboard_pairing", cb)
+      return () => sub.remove()
+    },
+  },
+
   // --- ring controller (optional input device) ---
   controller: {
     connectDefault: (): Promise<void> => BluetoothSdk.connectDefaultController(),

package/src/facades/memory.ts

@@ -7,8 +7,7 @@
 import type {MemoryEntry, MemorySession} from "@glassly/miniapp"
 
 import type {MemoryStats} from "../services/MemoryStore"
-import {EXTENDED_RETENTION, STANDARD_RETENTION} from "../services/MemoryStore"
-import {isMemoryRetentionExtended, memoryStore, setMemoryRetentionExtended} from "../services/memoryStoreInstance"
+import {memoryStore} from "../services/memoryStoreInstance"
 
 export const memory = {
   /** All note entries, newest first. */
@@ -33,14 +32,4 @@ export const memory = {
   clearAll: (): Promise<void> => memoryStore.clear(),
   /** Subscribe to store mutations (from miniapps or Settings). */
   onChanged: (listener: () => void): (() => void) => memoryStore.onChanged(listener),
-  /** Whether the extended (Plus/Pro) retention window is active. */
-  retentionExtended: (): boolean => isMemoryRetentionExtended(),
-  /** Retention window in days for the given (or current) tier, for UI copy. */
-  retentionDays: (extended?: boolean): number =>
-    Math.round(
-      ((extended ?? isMemoryRetentionExtended()) ? EXTENDED_RETENTION : STANDARD_RETENTION).maxAgeMs /
-        (24 * 60 * 60 * 1000),
-    ),
-  /** Flip retention on subscription change. Host app (RevenueCat sync) only. */
-  setRetentionExtended: (extended: boolean): void => setMemoryRetentionExtended(extended),
 }

package/src/facades/miniapps.ts

@@ -5,7 +5,7 @@
  *
  * The miniapp WebView is a HOST component (engine ships the bridge, not the view) —
  * the bridge primitives (`buildMiniappGlobalsScript`, `buildUiShim`, the
- * GlasslyJS router) are exported from `@glassly/engine` directly; the host mounts a
+ * JSRuntime router) are exported from `@glassly/engine` directly; the host mounts a
  * `<WebView>` wired to them. This facade is the lifecycle half.
  */
 import {useAppStatusStore} from "../stores/apps"
@@ -59,4 +59,7 @@ export const miniapps = {
   /** Hide/show a miniapp on the home surfaces. */
   setHiddenStatus: (...args: Parameters<AppsState["setHiddenStatus"]>) =>
     useAppStatusStore.getState().setHiddenStatus(...args),
+  /** Mark a miniapp persistent (starts at launch, stops only from the switcher pill), persisted for the next boot. */
+  setPersistent: (...args: Parameters<AppsState["setPersistent"]>) =>
+    useAppStatusStore.getState().setPersistent(...args),
 }

package/src/facades/pairing.ts

@@ -31,6 +31,8 @@ import {pushAllBluetoothSettings} from "../services/GlassesSettingsSync"
 import {ControllerTypes} from "../types"
 import {submitAutomaticReport} from "./reports"
 
+import {BgTimer} from "../utils/timers"
+
 export type {IdentitySnapshot} from "../services/PairingIdentity"
 
 export interface PairingReadyWaitOptions {
@@ -110,13 +112,13 @@ async function waitForTargetReady(options: PairingReadyWaitOptions, timeoutMs: n
     }
 
     let settled = false
-    let timeout: ReturnType<typeof setTimeout> | null = null
+    let timeout: number | null = null
     let unsubscribe: (() => void) | null = null
     let onAbort: (() => void) | null = null
     const finish = (ready: boolean) => {
       if (settled) return
       settled = true
-      if (timeout) clearTimeout(timeout)
+      if (timeout) BgTimer.clearTimeout(timeout)
       if (unsubscribe) unsubscribe()
       if (onAbort && options.signal) options.signal.removeEventListener("abort", onAbort)
       resolve(ready)
@@ -129,7 +131,7 @@ async function waitForTargetReady(options: PairingReadyWaitOptions, timeoutMs: n
       onAbort = () => finish(false)
       options.signal.addEventListener("abort", onAbort)
     }
-    timeout = setTimeout(() => finish(projectTargetReady(options)), timeoutMs)
+    timeout = BgTimer.setTimeout(() => finish(projectTargetReady(options)), timeoutMs)
   })
 }
 
@@ -218,14 +220,14 @@ async function waitForBluetoothClassic(
     }
 
     let settled = false
-    let timeout: ReturnType<typeof setTimeout> | null = null
+    let timeout: number | null = null
     let unsubscribe: (() => void) | null = null
     let onAbort: (() => void) | null = null
 
     const finish = (value: boolean) => {
       if (settled) return
       settled = true
-      if (timeout) clearTimeout(timeout)
+      if (timeout) BgTimer.clearTimeout(timeout)
       if (unsubscribe) unsubscribe()
       if (onAbort && options.signal) options.signal.removeEventListener("abort", onAbort)
       resolve(value)
@@ -243,7 +245,7 @@ async function waitForBluetoothClassic(
       },
     )
 
-    timeout = setTimeout(() => {
+    timeout = BgTimer.setTimeout(() => {
       finish(useGlassesStore.getState().bluetoothClassicConnected)
     }, timeoutMs)
   })