@glassly/engine 0.4.0-beta.1052 → 0.4.0-beta.1076

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.4.0-beta.1052",
+  "version": "0.4.0-beta.1076",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,26 +97,26 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.4.0-beta.1052",
-    "@glassly/cloud-client": "0.4.0-beta.1052",
-    "@glassly/cloud-protocol": "0.4.0-beta.1052",
-    "@glassly/crust": "0.4.0-beta.1052",
-    "@glassly/miniapp": "0.4.0-beta.1052",
+    "@glassly/bluetooth-sdk": "0.4.0-beta.1076",
+    "@glassly/cloud-client": "0.4.0-beta.1076",
+    "@glassly/cloud-protocol": "0.4.0-beta.1076",
+    "@glassly/crust": "0.4.0-beta.1076",
+    "@glassly/miniapp": "0.4.0-beta.1076",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
-    "react-native-marked": "8.3.2",
-    "semver": "^7.7.4",
+    "react-native-marked": "8.3.4",
+    "semver": "^7.8.6",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.4.0-beta.1052",
-    "@huggingface/jinja": "^0.5.9",
-    "jsonrepair": "^3.12.0"
+    "@glassly/llm-providers": "0.4.0-beta.1076",
+    "@huggingface/jinja": "^0.5.12",
+    "jsonrepair": "^3.15.0"
   },
   "devDependencies": {
     "@glassly/llm-providers": "workspace:*",
-    "@types/semver": "^7.7.1",
+    "@types/semver": "^7.8.0",
     "expo-module-scripts": "^56.0.3",
-    "expo-modules-core": "^58.0.23",
-    "react-native-nitro-modules": "^0.37.1",
+    "expo-modules-core": "^58.0.30",
+    "react-native-nitro-modules": "^0.37.2",
     "typescript": "~6.0.3"
   },
   "peerDependencies": {
@@ -155,7 +155,7 @@
     "@dr.pogodin/react-native-fs": "*",
     "@craftzdog/react-native-buffer": "*",
     "axios": "*",
-    "react-native-executorch": ">=0.10.5 <0.11",
+    "react-native-executorch": ">=0.11.0 <0.12",
     "react-native-blob-util": "*"
   }
 }

package/src/facades/permissions.ts

@@ -125,14 +125,12 @@ export const permissions = {
           features.add(PermissionFeatures.CALENDAR)
           features.add(PermissionFeatures.LOCATION)
           features.add(PermissionFeatures.BACKGROUND_LOCATION)
-          features.add(PermissionFeatures.POST_NOTIFICATIONS)
           features.add("read_notifications")
           break
         case "MICROPHONE":
         case "CALENDAR":
         case "LOCATION":
         case "BACKGROUND_LOCATION":
-        case "POST_NOTIFICATIONS":
           features.add(PermissionFeatures[permission.type])
           break
         case "READ_NOTIFICATIONS":

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/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.4.0",
-  "releaseIdentity": "0.4.0-beta.1052",
-  "releaseSetId": "glassly-0.4.0-beta.1052",
-  "sourceCommit": "0e343b6f2c083cb6e4ce58f4fa533cf84cae4760",
+  "releaseIdentity": "0.4.0-beta.1076",
+  "releaseSetId": "glassly-0.4.0-beta.1076",
+  "sourceCommit": "3021c69f679562e3de8a57d76c806d1c8173c22a",
   "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"

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}`)
       }

package/src/services/LocalMiniappRuntime.ts

@@ -83,6 +83,13 @@ import overlayPages from "./pages/OverlayPages"
 import dashboardOpenTrace from "./debug/DashboardOpenTrace"
 import {isAppForegrounded, isPhoneActive, onAppForegroundChange, onPhoneActivityChange} from "./PhoneActivity"
 import {installedNotificationApps} from "./PhoneNotificationsSync"
+import {
+  emitMiniappNotification,
+  MINIAPP_NOTIFICATION_CONTENT_MAX,
+  MINIAPP_NOTIFICATION_ID_MAX,
+  MINIAPP_NOTIFICATION_TITLE_MAX,
+  miniappNotificationId,
+} from "./notifications/miniappNotifications"
 import {MiniappIcons} from "./MiniappIcons"
 import {pairedControllersFrom, readyControllersKey} from "./controllers"
 import {
@@ -1513,6 +1520,12 @@ class LocalMiniappRuntime {
       case MiniappRequestType.NOTIFICATION_APPS_LIST:
         void this.handleNotificationAppsList(packageName, requestId)
         break
+      case MiniappRequestType.NOTIFICATION_POST:
+        this.handleNotificationPost(packageName, payload, requestId)
+        break
+      case MiniappRequestType.NOTIFICATION_DISMISS:
+        this.handleNotificationDismiss(packageName, payload, requestId)
+        break
       case MiniappRequestType.NATIVE_NAV:
         this.handleNativeNav(packageName, payload, requestId)
         break
@@ -2792,7 +2805,17 @@ class LocalMiniappRuntime {
       return
     }
     try {
-      this.sendResult(packageName, requestId, true, await installedNotificationApps())
+      const posters = this.interopApps().filter(
+        (app) => app.packageName && app.permissions?.some((permission) => permission.type === "POST_NOTIFICATIONS"),
+      )
+      const miniapps = await Promise.all(
+        posters.map(async (app) => ({
+          packageName: app.packageName,
+          appName: app.name || app.packageName,
+          icon: (await this.miniappIcons.read(app)) ?? null,
+        })),
+      )
+      this.sendResult(packageName, requestId, true, [...(await installedNotificationApps()), ...miniapps])
     } catch (err) {
       this.sendResult(packageName, requestId, false, undefined, {
         code: MiniappErrorCode.INTERNAL,
@@ -2801,6 +2824,60 @@ class LocalMiniappRuntime {
     }
   }
 
+  private handleNotificationPost(packageName: string, payload: Record<string, unknown>, requestId?: string): void {
+    if (!this.requirePermission(packageName, requestId, "POST_NOTIFICATIONS", "to post notifications")) return
+    const title = typeof payload.title === "string" ? payload.title.slice(0, MINIAPP_NOTIFICATION_TITLE_MAX) : ""
+    const content =
+      typeof payload.content === "string" ? payload.content.slice(0, MINIAPP_NOTIFICATION_CONTENT_MAX) : ""
+    if (!title.trim() && !content.trim()) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: "A notification needs a title or content",
+      })
+      return
+    }
+    if (payload.id !== undefined && (typeof payload.id !== "string" || !payload.id.trim())) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: "A notification id must be a non-empty string",
+      })
+      return
+    }
+    const id =
+      typeof payload.id === "string"
+        ? payload.id.trim().slice(0, MINIAPP_NOTIFICATION_ID_MAX)
+        : `${Date.now().toString(36)}-${++this.notificationSeq}`
+    const app = this.interopApps().find((candidate) => candidate.packageName === packageName)
+    emitMiniappNotification({
+      type: "posted",
+      notificationId: miniappNotificationId(packageName, id),
+      source: packageName,
+      app: app?.name || packageName,
+      title,
+      content,
+      timestamp: Date.now(),
+    })
+    this.sendResult(packageName, requestId, true, {id})
+  }
+
+  private handleNotificationDismiss(packageName: string, payload: Record<string, unknown>, requestId?: string): void {
+    if (!this.requirePermission(packageName, requestId, "POST_NOTIFICATIONS", "to dismiss notifications")) return
+    if (typeof payload.id !== "string" || !payload.id.trim()) {
+      this.sendResult(packageName, requestId, false, undefined, {
+        code: MiniappErrorCode.INVALID_ARGUMENT,
+        message: "dismiss needs the id post() returned",
+      })
+      return
+    }
+    emitMiniappNotification({
+      type: "dismissed",
+      notificationId: miniappNotificationId(packageName, payload.id.trim().slice(0, MINIAPP_NOTIFICATION_ID_MAX)),
+      source: packageName,
+      timestamp: Date.now(),
+    })
+    this.sendResult(packageName, requestId, true)
+  }
+
   /**
    * Push bridged settings as they change: stored keys from the store, the
    * derived keys whenever their inputs move (phone activity, the display,
@@ -6269,6 +6346,7 @@ class LocalMiniappRuntime {
   }
 
   private miniappIcons = new MiniappIcons()
+  private notificationSeq = 0
 
   private async handleMiniappsList(
     packageName: string,
@@ -6775,8 +6853,7 @@ class LocalMiniappRuntime {
 
   /** A miniapp disconnected: as a host its placements go, as a provider its boxes are forgotten and its frames kept. */
   private onWidgetPartyGone(packageName: string): void {
-    const providersBefore = placedProviders(this.widgetPlacements)
-    this.widgetPlacements = dropWidgetHost(this.widgetPlacements, packageName)
+    this.releaseWidgetHost(packageName)
     this.widgetPlacements = dropWidgetProvider(this.widgetPlacements, packageName)
     miniappWidgetMode.setPlaced(packageName, false)
     miniappWidgetMode.setWidgetOnly(packageName, false)
@@ -6791,8 +6868,13 @@ class LocalMiniappRuntime {
         })
       }
     }
+  }
+
+  public releaseWidgetHost(hostPackageName: string): void {
+    const providersBefore = placedProviders(this.widgetPlacements)
+    this.widgetPlacements = dropWidgetHost(this.widgetPlacements, hostPackageName)
     for (const provider of providersBefore) {
-      if (provider !== packageName) void this.settleWidgetProvider(provider)
+      if (provider !== hostPackageName) void this.settleWidgetProvider(provider)
     }
   }
 

package/src/services/notifications/miniappNotifications.ts

@@ -0,0 +1,53 @@
+/**
+ * Notifications miniapps post (`session.phone.notifications.post`) on their
+ * way into the host's phone-notification path. The runtime validates and
+ * emits here; the host subscribes through `engine.phoneNotifications` and
+ * feeds them to the same fan-out as the phone's own, with `system: false`
+ * and `source` set, so the dashboard, other readers and presentation treat
+ * them alike.
+ */
+export interface MiniappNotificationPosted {
+  type: "posted"
+  notificationId: string
+  source: string
+  app: string
+  title: string
+  content: string
+  timestamp: number
+}
+
+export interface MiniappNotificationDismissed {
+  type: "dismissed"
+  notificationId: string
+  source: string
+  timestamp: number
+}
+
+export type MiniappNotificationEvent = MiniappNotificationPosted | MiniappNotificationDismissed
+
+export const MINIAPP_NOTIFICATION_TITLE_MAX = 200
+export const MINIAPP_NOTIFICATION_CONTENT_MAX = 2_000
+export const MINIAPP_NOTIFICATION_ID_MAX = 128
+
+const listeners = new Set<(event: MiniappNotificationEvent) => void>()
+
+export function miniappNotificationId(source: string, id: string): string {
+  return `${source}:${id}`
+}
+
+export function emitMiniappNotification(event: MiniappNotificationEvent): void {
+  for (const listener of listeners) {
+    try {
+      listener(event)
+    } catch (err) {
+      console.warn(`miniappNotifications: listener threw: ${(err as Error)?.message ?? err}`)
+    }
+  }
+}
+
+export function onMiniappNotification(listener: (event: MiniappNotificationEvent) => void): () => void {
+  listeners.add(listener)
+  return () => {
+    listeners.delete(listener)
+  }
+}

package/src/services/pages/pageEligibility.ts

@@ -21,11 +21,12 @@ export function isCfwFirmwareVersion(firmwareVersion: string | null | undefined)
 
 /**
  * Only models that ship a Glassly custom firmware, and only while they run it.
- * Stock firmware on those models and every other model (NIMO, G1, ...) are
- * intentionally excluded.
+ * Stock firmware and every other model are intentionally excluded.
  */
 export function isCustomDashboardEligible(info: {model?: string | null; firmwareVersion?: string | null}): boolean {
   if (!info.model) return false
+  // The NIMO drivers draw no scenes through its CFW yet; the dashboard would land on the text page.
+  if (info.model === DeviceTypes.NIMO) return false
   if (info.model === DeviceTypes.MEMOMIND_ONE) {
     const match = /^GLASSLYCFW\/([0-9]+)$/.exec(info.firmwareVersion ?? "")
     const revision = match ? Number(match[1]) : 0

package/src/services/uiShim.ts

@@ -304,6 +304,13 @@ export function buildUiShim(options: UiShimOptions): string {
     postEnvelope({ type: 'set_background', color: color });
   }
 
+  var backHandler = null;
+
+  function setBackActionFn(handler) {
+    backHandler = typeof handler === 'function' ? handler : null;
+    postEnvelope({ type: 'set_back_action', shown: backHandler !== null });
+  }
+
   function fireChannel(channel, payload) {
     var list = channelHandlers[channel];
     if (!list || list.length === 0) {
@@ -348,6 +355,12 @@ export function buildUiShim(options: UiShimOptions): string {
       }
       return;
     }
+    if (type === 'back') {
+      if (backHandler) {
+        try { backHandler(); } catch (e) {}
+      }
+      return;
+    }
     if (type === 'cancel' && typeof envelope.requestId === 'string') {
       // Background-side cancel (reserved; currently unused). If we had a
       // future bidirectional RPC this would abort an in-flight UI handler.
@@ -366,6 +379,7 @@ export function buildUiShim(options: UiShimOptions): string {
     onClose: onClose,
     ready: readyFn,
     setBackgroundColor: setBackgroundColorFn,
+    setBackAction: setBackActionFn,
     /** @internal — packageName for diagnostic logs only. */
     _packageName: packageName,
   };

package/src/stores/settings.ts

@@ -132,13 +132,6 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: true,
     persist: true,
   },
-  memomind_accessory_picker: {
-    key: "memomind_accessory_picker",
-    defaultValue: () => true,
-    writable: true,
-    saveOnServer: false,
-    persist: true,
-  },
   debug_console: {
     key: "debug_console",
     defaultValue: () => false,
@@ -950,6 +943,13 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
+  debug_mirror_rail: {
+    key: "debug_mirror_rail",
+    defaultValue: () => false,
+    writable: true,
+    saveOnServer: false,
+    persist: true,
+  },
   home_offline_card: {
     key: "home_offline_card",
     defaultValue: () => true,
@@ -1274,7 +1274,6 @@ export const BLUETOOTH_SETTING_KEYS: string[] = [
   SETTINGS.cfw_scene_renderer.key,
   SETTINGS.cfw_fast_ble.key,
   SETTINGS.perf_logs.key,
-  SETTINGS.memomind_accessory_picker.key,
   SETTINGS.ring_via_glasses.key,
   SETTINGS.display_max_fps.key,
   SETTINGS.twelve_hour_time.key,

package/src/types/capabilities/nimo.ts

@@ -95,4 +95,7 @@ export const nimo: Capabilities = {
 
   // OTA capabilities - Nimo firmware updates are not driven by the ASG OTA flow
   hasOta: false,
+
+  // The drivers flash a bundled Glassly CFW over the GATT OTA characteristics.
+  hasCustomFirmware: true,
 }