@glassly/engine 0.3.3-beta.639 → 0.3.3-beta.656

package/src/index.ts

@@ -201,7 +201,7 @@ export {
   type DevManifest,
 } from "./utils/devMiniappLaunch"
 export {HardwareCompatibility, type CompatibilityResult} from "./utils/hardware"
-export {BgTimer, throttle, debounce} from "./utils/timers"
+export {BgTimer} from "./utils/timers"
 // Meta Neural Band: the account sign-in a claim needs (the WebView lives in the host).
 export {
   MetaAuthError,

package/src/services/AiTierResolution.ts

@@ -42,7 +42,7 @@ export const TIER_MODEL_OPTIONS: Record<AiTier, TierModelOption[]> = {
   ],
   frontier: [
     {provider: "anthropic", model: "claude-sonnet-5", label: "Claude Sonnet 5"},
-    {provider: "gemini", model: "gemini-3.5-pro", label: "Gemini 3.5 Pro"},
+    {provider: "gemini", model: "gemini-3.1-pro-preview", label: "Gemini 3.1 Pro"},
     {provider: "openai", model: "gpt-5.1", label: "GPT-5.1"},
   ],
 }
@@ -60,6 +60,14 @@ export interface ResolvedTierModel {
   model?: string
 }
 
+/**
+ * Stored dropdown picks for model ids the provider never served, mapped to the
+ * curated replacement. gemini-3.5-pro 404s on generateContent.
+ */
+const RETIRED_MODELS: Record<string, string> = {
+  "gemini-3.5-pro": "gemini-3.1-pro-preview",
+}
+
 /** Coerce an untrusted wire value into a tier; anything else is "balanced". */
 export function normalizeAiTier(value: unknown): AiTier {
   return value === "quick" || value === "frontier" ? value : "balanced"
@@ -71,8 +79,9 @@ export function parseTierSetting(value: unknown): {provider: AiTierProvider; mod
   const sep = value.indexOf(":")
   if (sep <= 0) return null
   const provider = value.slice(0, sep)
-  const model = value.slice(sep + 1).trim()
-  if (!model) return null
+  const stored = value.slice(sep + 1).trim()
+  if (!stored) return null
+  const model = RETIRED_MODELS[stored] ?? stored
   if (provider !== "anthropic" && provider !== "gemini" && provider !== "openai") return null
   return {provider, model}
 }

package/src/services/GestureDotsService.ts

@@ -5,7 +5,8 @@
  * (cleared after a short pulse), a bullseye for a recognized long press.
  * Controllers that report press edges (touch_down … tap_end) show the press
  * itself instead: a dot while pressed, the bullseye once held, cleared at
- * release. The Neural Band's middle finger (index 1) draws the same shapes hollow. Extracted from
+ * release. The Neural Band's middle finger (index 1) draws the same shapes
+ * hollow: a ring for its tap, the bullseye without its center for its hold. Extracted from
  * the CFW dashboard service; it renders through
  * the ordinary scene pipeline, so it works on any positioning device (stock
  * G2 included), and is gated by the gesture_dots debug setting.
@@ -41,7 +42,16 @@ const FLASH_GLYPHS: Record<string, GestureDotGlyph> = {
   swipe_right: "right",
 }
 /** The band's middle finger draws the filled shapes hollow. */
-const MIDDLE_FINGER_GLYPHS: Partial<Record<GestureDotGlyph, GestureDotGlyph>> = {dot: "ring", double: "doubleRing"}
+const MIDDLE_FINGER_GLYPHS: Partial<Record<GestureDotGlyph, GestureDotGlyph>> = {
+  dot: "ring",
+  double: "doubleRing",
+  hold: "holdRing",
+}
+
+/** `glyph` as `finger` draws it: the middle finger's shapes are hollow. */
+function fingerGlyph(glyph: GestureDotGlyph, finger: number): GestureDotGlyph {
+  return finger === 1 ? (MIDDLE_FINGER_GLYPHS[glyph] ?? glyph) : glyph
+}
 
 class GestureDotsService {
   private started = false
@@ -135,12 +145,12 @@ class GestureDotsService {
       if (press) {
         // Both reports describe one press: after touch_down, tap_start means it is held.
         if (gestureName === "touch_down") press.raw = true
-        else if (press.raw) press.glyph = "hold"
+        else if (press.raw) press.glyph = fingerGlyph("hold", finger)
         this.render()
         return
       }
       this.clearFlash()
-      this.presses.set(finger, {raw: gestureName === "touch_down", glyph: finger === 1 ? "ring" : "dot"})
+      this.presses.set(finger, {raw: gestureName === "touch_down", glyph: fingerGlyph("dot", finger)})
       this.render()
       return
     }
@@ -152,14 +162,14 @@ class GestureDotsService {
       return
     }
     const shape = FLASH_GLYPHS[gestureName]
-    const glyph = shape && finger === 1 ? MIDDLE_FINGER_GLYPHS[shape] ?? shape : shape
+    const glyph = shape ? fingerGlyph(shape, finger) : shape
     // The press already showed its own tap and hold; the device's report of
     // them follows after its double-tap window, often after release.
     const shownByPress = gestureName === "single_tap" || gestureName === "long_press"
     if (press?.raw && (!glyph || shownByPress)) {
       // Pinch-and-turn reports do not release a finger. A recognized hold
       // stays visible until tap_end instead of expiring halfway through it.
-      if (gestureName === "long_press") press.glyph = "hold"
+      if (gestureName === "long_press") press.glyph = fingerGlyph("hold", finger)
       this.render()
       return
     }

package/src/services/gestureDotGlyphs.ts

@@ -4,7 +4,7 @@
  */
 export const GESTURE_DOT_GLYPH_SIZE = 24
 
-export type GestureDotGlyph = "dot" | "double" | "ring" | "doubleRing" | "up" | "down" | "left" | "right" | "hold" | "blank"
+export type GestureDotGlyph = "dot" | "double" | "ring" | "doubleRing" | "up" | "down" | "left" | "right" | "hold" | "holdRing" | "blank"
 
 export const GESTURE_DOT_GLYPHS: Record<GestureDotGlyph, string> = {
   dot: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAALklEQVR4nM2QsQ0AAAjC/P/pmrhqZ+xIF6DqBQyWbwO3gduAmKjQuj7QL/ETEzQmMptl7Q9NBAAAAABJRU5ErkJggg==",
@@ -16,5 +16,6 @@ export const GESTURE_DOT_GLYPHS: Record<GestureDotGlyph, string> = {
   left: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAI0lEQVR4nGNgoCv4j0sch8RAiTP8RwPESOAwajDI4JKgGQAAKO05x7DqJxIAAAAASUVORK5CYII=",
   right: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAIElEQVR4nGNgoDf4j1NiMMn8RwOEJYizZKDEcQc7bQAAS7w5x+ro2lsAAAAASUVORK5CYII=",
   hold: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAR0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKl0Z0Lof7DKbgMhBpQCZzOxedBHEGCMxAJBTXhKGRAA9hFMQEANr7jHQU9fO0AAAAASUVORK5CYII=",
+  holdRing: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAQ0lEQVR4nGNgIAj+gwF2UUy5//+xyyDzcLGRedjMhTEwXAKlMd2IVQNMaEAlcDoXnwdxBAnOQCQU1ISjEIvjsYhiAgAo9KdZzePY3AAAAABJRU5ErkJggg==",
   blank: "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAAAAADFHGIkAAAAD0lEQVR4nGNgGAWjgPoAAAJYAAGgxYwDAAAAAElFTkSuQmCC",
 }

package/src/stores/glasses.ts

@@ -146,6 +146,7 @@ const initialState: GlassesStore = {
   sceneVector: false,
   sceneSettle: false,
   volumeGate: false,
+  firmwareUpdateAvailable: false,
   // wifi info
   wifi: {state: "disconnected"},
   wifiStatusKnown: false,

package/src/types/capabilities/even-realities-g2.ts

@@ -42,7 +42,7 @@ export const evenRealitiesG2: Capabilities = {
     // envelope). Pathological sizes needing more than the 4-container pool are
     // dropped SGC-side with a log.
     shapes: ["rect"], // bordered empty container ≈ rect
-    intensityLevels: 2,
+    intensityLevels: 16,
     partialUpdate: true,
   },
 

package/src/types/capabilities/mentra-display.ts

@@ -39,7 +39,7 @@ export const mentraDisplay: Capabilities = {
     maxImageElements: 4, // firmware BITMAP pool ids 10-13
     maxImagePx: {width: 200, height: 200}, // CANVAS_IMAGE_MAX_I1_BYTES / NAV_IMAGE_MAX_W/H
     shapes: ["rect"], // bordered empty TEXTBOX ≈ rect (no shape primitive)
-    intensityLevels: 2, // 1-bpp panel today
+    intensityLevels: 16,
     partialUpdate: true,
   },
 

package/src/types/capabilities/rayneo-io.ts

@@ -39,7 +39,7 @@ export const rayneoIO: Capabilities = {
     canPosition: true,
     maxTextElements: 6,
     maxImageElements: 4,
-    intensityLevels: 2,
+    intensityLevels: 16,
     partialUpdate: true,
   },
 

package/src/utils/timers/index.ts

@@ -1,2 +1 @@
-import {BgTimer, throttle, debounce} from "./timers"
-export {BgTimer, throttle, debounce}
+export {BgTimer} from "./timers"

package/src/utils/timers/timers.ts

@@ -1,203 +1,128 @@
-// BgTimer — background-safe timers for the engine.
+// BgTimer: every engine timer (miniapp liveness watchdog, display expiries,
+// boot windows, token refresh) goes through here. Android pauses plain JS
+// timers while the app is backgrounded, so on a device these run on the
+// native react-native-nitro-bg-timer instead. iOS needs that package at
+// >= 0.2.0: earlier versions cleared each timer right after scheduling it
+// (https://github.com/tconns/react-native-nitro-bg-timer/issues/2).
 //
-// Everything timing-critical in the engine runs through this class: the
-// miniapp liveness watchdog, display durationMs expiries, boot windows,
-// auth-token refresh. On Android, React Native PAUSES plain JS timers while
-// the app is backgrounded, so those features only keep working in the
-// background when the native implementation (react-native-nitro-bg-timer)
-// is active.
+// Dev and release behave the same; there is no env switch. A missing native
+// module falls back to JS timers so the foreground keeps working, and says so
+// once, loudly: a quiet fallback already cost a day of phantom "zombie
+// miniapp" bugs (OS-1790). Never downgrade that report to a warning.
 //
-// Who actually gets native timers:
-//   - Android, dev AND release: always attempted — dev must match production
-//     background behavior. There is no opt-in/opt-out env var. If the native
-//     module is unavailable (a dev client whose binary predates it, or a
-//     broken release binary), the failure is LOUD: a console.error with the
-//     remediation, plus a blocking dev alert. The JS-timer fallback still
-//     engages so foreground behavior keeps working, but backgrounded
-//     behavior is broken until the native rebuild — the error says exactly
-//     that. (A silent dev fallback previously cost a full debugging day of
-//     phantom "zombie miniapp" bugs; see OS-1790.)
-//   - iOS: never, dev or prod — the package is disabled pending
-//     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.
-//
-// 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.
+// react-native and the nitro packages are require()d lazily. The engine's bun
+// suites run services in a plain JS runtime that cannot parse react-native;
+// there the native lookup finds no platform and JS timers are the right answer.
+
+type TimerApi = {
+  setTimeout(callback: () => void, delay: number): number
+  clearTimeout(id: number): void
+  setInterval(callback: () => void, delay: number): number
+  clearInterval(id: number): void
+}
 
 type ReactNativeSubset = {
   Platform: {OS: string}
-  Alert?: {alert: (title: string, message?: string) => void}
+  Alert?: {alert(title: string, message?: string): void}
 }
 
-let reactNative: ReactNativeSubset | null | undefined
+const TIMER_METHODS = ["setTimeout", "clearTimeout", "setInterval", "clearInterval"] as const
 
-function getReactNative(): ReactNativeSubset | null {
-  if (reactNative !== undefined) {
-    return reactNative
-  }
-  try {
-    reactNative = require("react-native") as ReactNativeSubset
-  } catch {
-    reactNative = null
-  }
-  return reactNative
+const jsTimers: TimerApi = {
+  setTimeout: (callback, delay) => setTimeout(callback, delay) as unknown as number,
+  clearTimeout: (id) => clearTimeout(id),
+  setInterval: (callback, delay) => setInterval(callback, delay) as unknown as number,
+  clearInterval: (id) => clearInterval(id),
 }
 
-function isDev(): boolean {
-  return typeof __DEV__ !== "undefined" && __DEV__
-}
+let reactNative: ReactNativeSubset | null | undefined
+// undefined = not looked up yet, null = unavailable (JS timers from here on).
+let nativeTimers: TimerApi | null | undefined
+let reported = false
 
-type NitroTimerApi = {
-  setInterval: (callback: () => void, delay: number) => number
-  clearInterval: (intervalId: number) => void
-  setTimeout: (callback: () => void, delay: number) => number
-  clearTimeout: (timeoutId: number) => void
+function loadReactNative(): ReactNativeSubset | null {
+  if (reactNative === undefined) {
+    try {
+      reactNative = require("react-native") as ReactNativeSubset
+    } catch {
+      reactNative = null
+    }
+  }
+  return reactNative
 }
 
-let nitroTimer: NitroTimerApi | null | undefined
-let nitroDisabled = false
-let failedLoud = false
-
-/**
- * The native background timer is unavailable — say so ONCE, loudly, with the
- * remediation. The JS-timer fallback keeps foreground behavior working, but
- * everything timing-driven freezes while the app is backgrounded, which
- * presents as phantom miniapp bugs (frozen captions, missed wake words,
- * watchdog kills on resume). A quiet warning here has already cost a full
- * debugging day; never downgrade this to console.warn.
- */
-function failUnavailable(reason: string) {
-  if (failedLoud) {
-    return
-  }
-  failedLoud = true
+function reportUnavailable(reason: string): void {
+  if (reported) return
+  reported = true
+  const rn = loadReactNative()
+  const platform = rn?.Platform.OS === "ios" ? "ios" : "android"
   const message =
     `BgTimer: native background timer unavailable (${reason}). ` +
-    "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
+    `Backgrounded behavior IS BROKEN until you rebuild the app: run \`bun ${platform}\`. ` +
     "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded."
   console.error(message)
-  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.
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    // A stale dev client may also red-box inside the library itself; this
+    // alert is the one that names the fix.
     try {
-      getReactNative()?.Alert?.alert("Background timers unavailable", message)
+      rn?.Alert?.alert("Background timers unavailable", message)
     } catch {
-      /* Alert not available (tests / headless) — the console.error stands. */
+      // Headless runtime: the console.error stands.
     }
   }
 }
 
-function getNitroTimer(): NitroTimerApi | null {
-  if (nitroDisabled || getReactNative()?.Platform.OS !== "android") {
+function loadNativeTimers(): TimerApi | null {
+  if (nativeTimers !== undefined) return nativeTimers
+  const platform = loadReactNative()?.Platform.OS
+  if (platform !== "android" && platform !== "ios") {
+    nativeTimers = null
     return null
   }
-
-  if (nitroTimer !== undefined) {
-    return nitroTimer
-  }
-
   try {
     const {isRuntimeAlive} = require("react-native-nitro-modules") as {isRuntimeAlive?: () => boolean}
-    if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
-      nitroTimer = null
-      failUnavailable("nitro runtime is not alive")
-      return nitroTimer
+    if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) throw new Error("nitro runtime is not alive")
+    const {BackgroundTimer} = require("react-native-nitro-bg-timer") as {BackgroundTimer?: Partial<TimerApi>}
+    for (const method of TIMER_METHODS) {
+      if (typeof BackgroundTimer?.[method] !== "function") throw new Error(`BackgroundTimer.${method} missing`)
     }
-
-    const {BackgroundTimer} = require("react-native-nitro-bg-timer") as {BackgroundTimer?: NitroTimerApi}
-    nitroTimer =
-      BackgroundTimer &&
-      typeof BackgroundTimer.setTimeout === "function" &&
-      typeof BackgroundTimer.setInterval === "function" &&
-      typeof BackgroundTimer.clearTimeout === "function" &&
-      typeof BackgroundTimer.clearInterval === "function"
-        ? BackgroundTimer
-        : null
-  } catch {
-    nitroTimer = null
-    nitroDisabled = true
-  }
-
-  if (!nitroTimer) {
-    failUnavailable("react-native-nitro-bg-timer failed to load")
+    nativeTimers = BackgroundTimer as TimerApi
+  } catch (error) {
+    nativeTimers = null
+    reportUnavailable(error instanceof Error ? error.message : String(error))
   }
-  return nitroTimer
+  return nativeTimers
 }
 
-function withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {
-  const api = getNitroTimer()
-  if (!api) {
-    return fallback()
-  }
+// A native call that throws mid-session is new information: drop to JS timers
+// and announce again.
+function call<T>(run: (timers: TimerApi) => T): T {
+  const native = loadNativeTimers()
+  if (!native) return run(jsTimers)
   try {
-    return run(api)
+    return run(native)
   } catch (error) {
-    nitroDisabled = true
-    nitroTimer = null
-    failedLoud = false // a mid-session failure is new information — re-announce
-    failUnavailable(`nitro timer call threw: ${String(error)}`)
-    return fallback()
+    nativeTimers = null
+    reported = false
+    reportUnavailable(`native timer call threw: ${String(error)}`)
+    return run(jsTimers)
   }
 }
 
 export class BgTimer {
-  static setInterval(callback: () => void, delay: number): number {
-    return withNitro(
-      (api) => api.setInterval(callback, delay),
-      () => setInterval(callback, delay) as unknown as number,
-    )
-  }
-
-  static clearInterval(intervalId: number): void {
-    withNitro(
-      (api) => api.clearInterval(intervalId),
-      () => clearInterval(intervalId),
-    )
-  }
-
   static setTimeout(callback: () => void, delay: number): number {
-    return withNitro(
-      (api) => api.setTimeout(callback, delay),
-      () => setTimeout(callback, delay) as unknown as number,
-    )
+    return call((timers) => timers.setTimeout(callback, delay))
   }
 
-  static clearTimeout(timeoutId: number): void {
-    withNitro(
-      (api) => api.clearTimeout(timeoutId),
-      () => clearTimeout(timeoutId),
-    )
+  static clearTimeout(id: number): void {
+    call((timers) => timers.clearTimeout(id))
   }
-}
 
-export function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
-  let lastCalled = 0
-
-  return (...args: Parameters<T>) => {
-    const now = Date.now()
-    if (now - lastCalled >= ms) {
-      lastCalled = now
-      fn(...args)
-    }
+  static setInterval(callback: () => void, delay: number): number {
+    return call((timers) => timers.setInterval(callback, delay))
   }
-}
 
-export function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
-  let timeoutId: number | null = null
-
-  return (...args: Parameters<T>) => {
-    if (timeoutId) {
-      BgTimer.clearTimeout(timeoutId)
-    }
-    timeoutId = BgTimer.setTimeout(() => {
-      fn(...args)
-      timeoutId = null
-    }, ms)
+  static clearInterval(id: number): void {
+    call((timers) => timers.clearInterval(id))
   }
 }