@glassly/engine 0.4.0 → 0.4.1-dev.1137

package/src/facades/phoneNotifications.ts

@@ -23,6 +23,9 @@ import {
   nativeNotificationsSupported,
   uploadPhoneNotification,
 } from "../services/PhoneNotificationsSync"
+import {onMiniappNotification, type MiniappNotificationEvent} from "../services/notifications/miniappNotifications"
+
+export type {MiniappNotificationEvent} from "../services/notifications/miniappNotifications"
 
 export const phoneNotifications = {
   /**
@@ -65,6 +68,13 @@ export const phoneNotifications = {
    * surface runs and draw only when the answer is `host`.
    */
   presentationOwner: currentPresentationOwner,
+  /**
+   * Notifications miniapps post and dismiss. Hosts feed them to the same
+   * fan-out as the phone's, marked `system: false` with `source` set.
+   */
+  onMiniappNotification: (listener: (event: MiniappNotificationEvent) => void): (() => void) =>
+    onMiniappNotification(listener),
+
   /** Hand a captured notification to firmware that presents uploaded content (owner `firmware`, Android). */
   uploadToGlasses: (event: PhoneNotificationEvent): Promise<void> => uploadPhoneNotification(event),
 

package/src/facades/providerKeys.ts

@@ -1,7 +1,7 @@
 /**
  * providerKeys facade — `engine.providerKeys.{anthropic,gemini,openai,deepseek,elevenlabs}`:
  * validate-before-save probes for the user-supplied AI/voice provider keys
- * (Settings > API Keys). Same per-provider shape as `engine.maps.mapbox` /
+ * (Settings > Privacy > API Keys). Same per-provider shape as `engine.maps.mapbox` /
  * `engine.speech.sonioxDirect` so the Keys screen treats providers uniformly.
  */
 import {

package/src/facades/reports.ts

@@ -169,10 +169,51 @@ async function submitReportInternal(input: InternalSubmitReportInput): Promise<R
   return {status: "submitted", reportId, reportStatus}
 }
 
+/** A debug-console log upload: the report it went to, and whether it replaced an earlier upload. */
+export type LogUploadResult =
+  | {status: "created" | "updated"; reportId: string}
+  | {status: "busy"}
+  | {status: "failed"; error: string}
+
+/** Uploads within this window after a report's creation replace its phone logs. */
+export const LOG_UPLOAD_WINDOW_MS = 5 * 60_000
+let logUpload: {reportId: string; createdAt: number} | null = null
+let logUploadInFlight = false
+
+/** Phone logs only, as a manual bug report; repeated taps cannot spam reports. */
+async function uploadLogs(): Promise<LogUploadResult> {
+  if (logUploadInFlight) return {status: "busy"}
+  logUploadInFlight = true
+  try {
+    const logs = logBuffer.getRecentLogs()
+    const now = Date.now()
+    if (logUpload && now - logUpload.createdAt < LOG_UPLOAD_WINDOW_MS) {
+      await cloudClientService.core.reports.addLogs(logUpload.reportId, "phone", logs, {replace: true})
+      return {status: "updated", reportId: logUpload.reportId}
+    }
+    const context = await collectDiagnosticContext()
+    const res = await cloudClientService.core.reports.submit({
+      kind: "bug",
+      trigger: {type: "manual", source: "debug_console", reason: "log_upload"},
+      report: {actualBehavior: "Debug console log upload"},
+      context,
+    })
+    logUpload = {reportId: res.reportId, createdAt: now}
+    if (logs.length > 0) await cloudClientService.core.reports.addLogs(res.reportId, "phone", logs)
+    await cloudClientService.core.reports.complete(res.reportId)
+    return {status: "created", reportId: res.reportId}
+  } catch (error) {
+    return {status: "failed", error: error instanceof Error ? error.message : String(error)}
+  } finally {
+    logUploadInFlight = false
+  }
+}
+
 export const reports = {
   submit(input: EngineSubmitReportInput): Promise<ReportSubmitResult> {
     return submitReportInternal(input)
   },
+  uploadLogs,
 }
 
 export function submitAutomaticReport(input: EngineSubmitAutomaticReportInput): Promise<ReportSubmitResult> {

package/src/facades/settings.ts

@@ -2,7 +2,7 @@
  * settings facade — `engine.settings`: the typed keyed user-settings surface over
  * the engine-owned settings store. This is the OEM contract.
  *
- * Keys + their schema live in `SETTINGS` (theme, devMode, metric/twelveHourTime,
+ * Keys + their schema live in `SETTINGS` (theme, devMode, metric_system,
  * notifications, onboarding flags, …); `descriptor(key)`/`keys()` expose them.
  */
 import {useSettingsStore, SETTINGS} from "../stores/settings"

package/src/generated/releaseMetadata.ts

@@ -11,10 +11,10 @@ export interface EngineReleaseMetadata {
 
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
-  "familyBaseVersion": "0.4.0",
-  "releaseIdentity": "0.4.0",
-  "releaseSetId": "glassly-0.4.0",
-  "sourceCommit": "b0de6d1f62b32238f0b7e916113ecc5164c4bd28",
+  "familyBaseVersion": "0.4.1",
+  "releaseIdentity": "0.4.1-dev.1137",
+  "releaseSetId": "glassly-0.4.1-dev.1137",
+  "sourceCommit": "71bec7fa9156ff40639ef61147d437c9f8db3c07",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/index.ts

@@ -23,6 +23,7 @@ export type {
 } from "./facades/reports"
 export type {IslandNotification, IslandNotificationKind} from "./facades/notifications"
 export type {PresentationOwner} from "./services/notifications/notificationPolicy"
+export type {MiniappNotificationEvent} from "./services/notifications/miniappNotifications"
 export {DEFAULT_HIDDEN_PACKAGES, isGatedByDevTools, isSystemMiniapp} from "./stores/appVisibility"
 export type {WifiSearchResult} from "./facades/glassesWifi"
 export type {IdentitySnapshot} from "./services/PairingIdentity"
@@ -230,6 +231,7 @@ export {
   authEntryUrl,
   callbackMatches,
   callbackQuery,
+  callbackShape,
   decryptBlob,
   isLoginCallback,
   login,

package/src/react/useMentraLiveOta.ts

@@ -48,10 +48,7 @@ export type MentraLiveOtaScreen =
   | "disconnected"
 
 export type MentraLiveOtaErrorCode =
-  | "check_failed"
-  | "update_info_unavailable"
-  | "install_failed"
-  | "bes_restart_required"
+  "check_failed" | "update_info_unavailable" | "install_failed" | "bes_restart_required"
 
 export type MentraLiveOtaError = {
   code: MentraLiveOtaErrorCode

package/src/runtime/config.ts

@@ -66,12 +66,7 @@ export type NavErrorEvent = {kind: "error"; message: string}
 /** Synthesized by the host when the trip is cancelled outside the miniapp (e.g. wearer exited nav mode on the glasses). */
 export type NavCancelledEvent = {kind: "cancelled"; reason?: string}
 export type NavUpdate =
-  | NavManeuverEvent
-  | NavOffRouteEvent
-  | NavReroutingEvent
-  | NavArrivedEvent
-  | NavErrorEvent
-  | NavCancelledEvent
+  NavManeuverEvent | NavOffRouteEvent | NavReroutingEvent | NavArrivedEvent | NavErrorEvent | NavCancelledEvent
 
 export type NavLocation = {
   lat: number

package/src/services/AiTierResolution.ts

@@ -51,7 +51,7 @@ export const TIER_MODEL_OPTIONS: Record<AiTier, TierModelOption[]> = {
   ],
 }
 
-/** Which providers currently have a user key saved (Settings > API Keys). */
+/** Which providers currently have a user key saved (Settings > Privacy > API Keys). */
 export type SavedLlmKeys = Record<AiTierProvider, boolean>
 
 /**

package/src/services/AppRegistry.ts

@@ -143,12 +143,19 @@ interface InstalledLma {
 }
 
 export interface MiniappReleaseIdentity {
-  source: "direct_download" | "bundled_asset" | "preinstalled_registry" | "dev_snapshot" | "store"
+  source: "direct_download" | "bundled_asset" | "preinstalled_registry" | "dev_snapshot" | "store" | "sideload"
   releaseId?: string
   bundleSha256?: string
   channel?: string
 }
 
+export interface MiniappZipManifest {
+  packageName: string
+  version: string
+  name: string
+  permissions: Array<{type: string; required?: boolean}>
+}
+
 function releaseIdentityKey(packageName: string, version: string): string {
   return `miniapp_release_identity:${packageName}:${version}`
 }
@@ -480,6 +487,36 @@ class AppRegistry {
     })
   }
 
+  /** Reads miniapp.json out of a local zip without installing anything. */
+  public inspectLocalZip(zipPath: string): AsyncResult<MiniappZipManifest, Error> {
+    return Res.try_async(async () => {
+      const peekDir = new Directory(Paths.cache, "lma_peek")
+      if (peekDir.exists) peekDir.delete()
+      peekDir.create()
+      try {
+        await unzip(zipPath, peekDir.uri)
+        const manifestFile = new File(peekDir, "miniapp.json")
+        if (!manifestFile.exists) throw new Error("miniapp.json missing at zip root")
+        const manifest = JSON.parse(manifestFile.textSync()) as Record<string, unknown>
+        const {packageName, version, name} = manifest
+        if (typeof packageName !== "string" || !packageName) throw new Error("miniapp.json missing packageName")
+        if (typeof version !== "string" || !version) throw new Error("miniapp.json missing version")
+        const permissions = Array.isArray(manifest.permissions)
+          ? manifest.permissions.filter(
+              (entry): entry is {type: string; required?: boolean} => typeof entry?.type === "string",
+            )
+          : []
+        return {packageName, version, name: typeof name === "string" && name ? name : packageName, permissions}
+      } finally {
+        try {
+          peekDir.delete()
+        } catch {
+          // cache only
+        }
+      }
+    })
+  }
+
   /**
    * Post-install bookkeeping shared by every install path: clear stale dev
    * artifacts on release installs, point the active-version at the just-

package/src/services/AutomaticReportResult.ts

@@ -1,9 +1,7 @@
 import type {ReportSubmitResult} from "../facades/reports"
 
 export type AutomaticReportSubmissionStatus =
-  | {status: "filed"; reportId: string}
-  | {status: "skipped"; reason: string}
-  | {status: "failed"; error: string}
+  {status: "filed"; reportId: string} | {status: "skipped"; reason: string} | {status: "failed"; error: string}
 
 export function toAutomaticReportSubmissionStatus(result: ReportSubmitResult): AutomaticReportSubmissionStatus {
   if (result.status === "submitted") {

package/src/services/CloudClientService.ts

@@ -20,6 +20,7 @@ import type {
   StoreCatalogResponse,
   StoreListing,
   StoreReleasesResponse,
+  StoreHostOptions,
 } from "@glassly/cloud-client/react-native"
 import type {SubjectTokenType} from "@glassly/cloud-client"
 import {AppState, Platform} from "react-native"
@@ -190,9 +191,16 @@ function resolveEndpoints(): {core: string; runtime: string} {
   }
 }
 
+// Via init(), never construct(): init() holds the disable-cloud gate, and a
+// client built past it opens the runtime socket and retries it forever.
+function requireClient(): CloudClient {
+  if (!client) cloudClientService.init()
+  if (!client) throw new Error("Glassly cloud is disabled")
+  return client
+}
+
 function getCoreClient(): CloudCore {
-  if (!client) construct()
-  const core = client?.core
+  const core = requireClient().core
   if (!core) throw new Error("cloud client core not configured")
   return core
 }
@@ -207,9 +215,7 @@ function syncCoreAccessTokenToBluetooth(): Promise<string> {
 }
 
 async function syncCoreAccessTokenToBluetoothInternal(): Promise<string> {
-  if (!client) construct()
-  const c = client
-  if (!c) throw new Error("cloud client not initialized")
+  const c = requireClient()
 
   const token = await c.auth.getCoreToken()
   if (c !== client) {
@@ -765,25 +771,25 @@ export const cloudClientService = {
     return c.core.miniapps.getRegistry()
   },
 
-  async getStoreCatalog(): Promise<StoreCatalogResponse> {
+  async getStoreCatalog(opts?: StoreHostOptions): Promise<StoreCatalogResponse> {
     if (!client) this.init()
     const c = client
     if (!c?.core) throw new Error("cloud client core is unavailable")
-    return c.core.store.list()
+    return c.core.store.list(opts)
   },
 
-  async getStoreListing(packageName: string): Promise<StoreListing> {
+  async getStoreListing(packageName: string, opts?: StoreHostOptions): Promise<StoreListing> {
     if (!client) this.init()
     const c = client
     if (!c?.core) throw new Error("cloud client core is unavailable")
-    return c.core.store.get(packageName)
+    return c.core.store.get(packageName, opts)
   },
 
-  async getStoreReleases(packageName: string): Promise<StoreReleasesResponse> {
+  async getStoreReleases(packageName: string, opts?: StoreHostOptions): Promise<StoreReleasesResponse> {
     if (!client) this.init()
     const c = client
     if (!c?.core) throw new Error("cloud client core is unavailable")
-    return c.core.store.releases(packageName)
+    return c.core.store.releases(packageName, opts)
   },
 
   /** Bytes of a store icon or screenshot; these routes need the user Bearer. */

package/src/services/DisplayProcessor.ts

@@ -21,6 +21,7 @@ import {
   NEX_PROFILE,
   RAYNEO_IO_PROFILE,
   MEMOMIND_ONE_PROFILE,
+  NIMO_PROFILE,
   RAYNEO_IO_CFW_PROFILE,
   TextMeasurer,
   TextWrapper,
@@ -206,6 +207,7 @@ const DEVICE_PROFILES: Partial<Record<DeviceTypes, DisplayProfile>> = {
   [DeviceTypes.MACH1]: Z100_PROFILE, // Mach1 uses same hardware as Vuzix Z100
   [DeviceTypes.RAYNEO_IO]: RAYNEO_IO_PROFILE,
   [DeviceTypes.MEMOMIND_ONE]: MEMOMIND_ONE_PROFILE,
+  [DeviceTypes.NIMO]: NIMO_PROFILE,
 }
 
 /**

package/src/services/GestureDotsService.ts

@@ -50,7 +50,7 @@ const MIDDLE_FINGER_GLYPHS: Partial<Record<GestureDotGlyph, GestureDotGlyph>> =
 
 /** `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
+  return finger === 1 ? (MIDDLE_FINGER_GLYPHS[glyph] ?? glyph) : glyph
 }
 
 function fingerKey(controllerId: string | undefined, finger: number): string {

package/src/services/HotspotOtaTransport.ts

@@ -1,7 +1,6 @@
 import BluetoothSdk, {isEnabledHotspotStatus} from "@glassly/bluetooth-sdk"
 import {otaServer} from "@glassly/bluetooth-sdk/ota-transport"
 // One coordinator selects the native Android or iOS staging implementation at runtime.
-// eslint-disable-next-line react-native/split-platform-components
 import {PermissionsAndroid, Platform} from "react-native"
 import type {OtaCheckCurrentGlassesResult} from "./OtaUpdateCheckService"
 import {
@@ -24,10 +23,7 @@ export type HotspotOtaProgress = {
 }
 
 export type HotspotOtaErrorCode =
-  | "hotspot_wifi_permission_denied"
-  | "hotspot_start_failed"
-  | "hotspot_join_failed"
-  | "hotspot_server_failed"
+  "hotspot_wifi_permission_denied" | "hotspot_start_failed" | "hotspot_join_failed" | "hotspot_server_failed"
 
 export class HotspotOtaTransportError extends Error {
   constructor(

package/src/services/JSRouter.ts

@@ -381,6 +381,8 @@ export class JSRouter {
       BgTimer.clearTimeout(pending)
       this.respawnTimers.delete(packageName)
     }
+    miniappRunningRegistry.remove(packageName)
+    this.runtime.releaseWidgetHost(packageName)
     await this.runtime.notifyWillDisconnect(packageName, "stopped")
     this.spawnCache.delete(packageName)
     this.crashController?.onKill(packageName)
@@ -388,8 +390,6 @@ export class JSRouter {
     // drop out of native nav mode (crash-respawns don't take this path).
     this.runtime.unregisterApp(packageName, {endNavigation: true})
     this.registered.delete(packageName)
-    // JSContext torn down → miniapp is no longer "running".
-    miniappRunningRegistry.remove(packageName)
     if (this.crust.jsKill) {
       try {
         await this.crust.jsKill(packageName)

package/src/services/LocalLlmModelManager.ts

@@ -56,9 +56,10 @@ export interface LocalLlmDownloadStatus {
 }
 
 // XNNPACK 8da4w exports from software-mansion/react-native-executorch-qwen-3,
-// pinned to the v0.10.0 release tag that react-native-executorch 0.10.x
-// expects. modelBytes are the .pte sizes on the Hub; sizeBytes adds the
-// tokenizer files (~11 MB).
+// pinned to the v0.10.0 release tag. They export every method the 0.11 text
+// runner validates; moving to the v0.11.0 re-exports changes the file sizes and
+// makes every existing download re-fetch. modelBytes are the .pte sizes on the
+// Hub; sizeBytes adds the tokenizer files (~11 MB).
 const QWEN3_BASE = "https://huggingface.co/software-mansion/react-native-executorch-qwen-3/resolve/v0.10.0"
 const TOKENIZER_BYTES = 11_431_080
 const MB = 1024 * 1024

package/src/services/LocalLlmProvider.ts

@@ -33,7 +33,7 @@ type Rne = typeof import("react-native-executorch")
 // The runner API lives on the `llm` namespace; derive its types from there so
 // the import stays a type-only reference (no native module at load time).
 type Tokenizer = ReturnType<Rne["nlp"]["loadTokenizer"]>
-type LLMRunner = ReturnType<Rne["llm"]["createLLMRunner"]>
+type LLMRunner = Awaited<ReturnType<Rne["llm"]["createLLMRunner"]>>
 type LLMGenerationStats = ReturnType<LLMRunner["generate"]>
 type LLMGenerationConfig = NonNullable<Parameters<LLMRunner["generate"]>[1]>
 
@@ -238,15 +238,15 @@ class LocalLlmProvider {
 
       const elapsedMs = Date.now() - startedAt
       console.log(
-        `${LOG_TAG}: ${model.modelId} prompt=${generated.stats.numPromptTokens} out=${generated.stats.numGeneratedTokens} tokens in ${elapsedMs} ms`,
+        `${LOG_TAG}: ${model.modelId} prompt=${generated.stats.prefill.numTokens} out=${generated.stats.numTokens} tokens in ${elapsedMs} ms`,
       )
 
       const seed = `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 6)}`
       const completion = finalizeLocalResult(
         {
           text: generated.text,
-          promptTokens: generated.stats.numPromptTokens,
-          generatedTokens: generated.stats.numGeneratedTokens,
+          promptTokens: generated.stats.prefill.numTokens,
+          generatedTokens: generated.stats.numTokens,
           maxNewTokens,
         },
         {jsonMode, toolsOffered: Boolean(tools), makeToolCallId: (index) => `local_${seed}_${index}`},
@@ -290,11 +290,10 @@ class LocalLlmProvider {
     const template = new Template(tokenizerConfig.chatTemplate)
 
     const startedAt = Date.now()
-    const createRunner = rne.wrapAsync(rne.llm.createLLMRunner)
-    const runner = await createRunner(paths.model, paths.tokenizer, [])
+    const runner = await rne.llm.createLLMRunner(paths.model, paths.tokenizer, [])
     let tokenizer: Tokenizer | undefined
     try {
-      const maxSeqLen = runner.getKVCacheState().maxSeqLen
+      const maxSeqLen = runner.getKVCacheState().maxContextLen
       if (!Number.isInteger(maxSeqLen) || maxSeqLen <= CONTEXT_MARGIN_TOKENS + 16) {
         throw new Error(`On-device model ${modelId} reported an invalid context size: ${maxSeqLen}`)
       }