@glassly/engine 0.3.0-beta.489 → 0.3.0-dev.460

package/build/services/MiniappLauncher.d.ts

@@ -114,8 +114,6 @@ declare class MiniappLauncher {
      *
      * Always On apps (the dashboard) start whether or not they were running
      * when the app was last killed, and get a switcher card like any other app.
-     * A dashboard that does not hold the role (ADR-0009) is not started by its
-     * Always On flag.
      * Both restore paths skip apps missing required OS permissions without
      * prompting or clearing their saved running/Always On choice.
      */

package/build/services/MiniappLauncher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MiniappLauncher.d.ts","sourceRoot":"","sources":["../../src/services/MiniappLauncher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,OAA4B,EAAC,KAAK,wBAAwB,EAAC,MAAM,uBAAuB,CAAA;AAExF,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAA;AAExC,UAAU,YAAY;IACpB,oEAAoE;IACpE,MAAM,EAAE,QAAQ,CAAA;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;IAC5C,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAA4B;IAExC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE,uEAAuE;IACvE,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAInC,OAAO,CAAC,aAAa;IAOrB,yEAAyE;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8G7F;;;;;;;;;;OAUG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBpF,iFAAiF;YACnE,KAAK;IAkCnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC7C;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzG,mDAAmD;IAC7C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C,OAAO,CAAC,YAAY;IAKpB,4EAA4E;IAC5E,OAAO,CAAC,cAAc;CASvB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAA"}
+{"version":3,"file":"MiniappLauncher.d.ts","sourceRoot":"","sources":["../../src/services/MiniappLauncher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,OAA4B,EAAC,KAAK,wBAAwB,EAAC,MAAM,uBAAuB,CAAA;AACxF,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,kBAAkB,CAAA;AACzD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAA;AAExC,UAAU,YAAY;IACpB,oEAAoE;IACpE,MAAM,EAAE,QAAQ,CAAA;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,mBAAmB,CAAA;CACnC;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;IAC5C,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAA4B;IAExC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE,uEAAuE;IACvE,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAInC,OAAO,CAAC,aAAa;IAOrB,yEAAyE;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8G7F;;;;;;;;;;OAUG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBpF,iFAAiF;YACnE,KAAK;IAkCnB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC7C;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzG,mDAAmD;IAC7C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C,OAAO,CAAC,YAAY;IAKpB,4EAA4E;IAC5E,OAAO,CAAC,cAAc;CASvB;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAA"}

package/build/services/MiniappLauncher.js

@@ -29,7 +29,6 @@ import { storage } from "../utils/storage/storage";
 import appRegistry, { getLocalAppRunningState, saveLocalAppRunningState } from "./AppRegistry";
 import devServerBridge from "./DevServerBridge";
 import localMiniappRuntime from "./LocalMiniappRuntime";
-import { activeDashboardAmong } from "./pages/activeDashboard";
 class MiniappLauncher {
     deps = null;
     /**
@@ -246,22 +245,18 @@ class MiniappLauncher {
      *
      * Always On apps (the dashboard) start whether or not they were running
      * when the app was last killed, and get a switcher card like any other app.
-     * A dashboard that does not hold the role (ADR-0009) is not started by its
-     * Always On flag.
      * Both restore paths skip apps missing required OS permissions without
      * prompting or clearing their saved running/Always On choice.
      */
     async autostartLocalMiniapps() {
         const apps = await appRegistry.getInstalledMiniapps();
-        const activeDashboard = activeDashboardAmong(apps);
         for (const app of apps) {
             // Only phone-hosted miniapps have a JSContext to re-spawn. Offline
             // built-ins (`local:false, offline:true`) restore their native running
             // state elsewhere and have no bundle to launch.
             if (!app.local)
                 continue;
-            const alwaysOn = app.alwaysOn && (app.type !== "dashboard" || app.packageName === activeDashboard);
-            if (!alwaysOn && !getLocalAppRunningState(app.packageName))
+            if (!app.alwaysOn && !getLocalAppRunningState(app.packageName))
                 continue;
             if (this.isRunning(app.packageName))
                 continue;

package/build/services/MiniappLauncher.js.map

@@ -1 +1 @@
-{"version":3,"file":"MiniappLauncher.js","sourceRoot":"","sources":["../../src/services/MiniappLauncher.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MiniappLauncher — headless launch/teardown of a local miniapp's background\n * JS context.\n *\n * This is the one piece of \"run a miniapp\" that used to live inside the\n * `LocalMiniappView` React component (resolve the bundle → read the manifest →\n * `spawnAndRegister`), triggered only when the Compositor mounted that\n * component on foreground. Pulling it into the runtime means:\n *\n *   - `start()` can actually spawn an app even when nothing foregrounds it\n *     (e.g. a system app launching another miniapp via `session.miniapps`).\n *   - the action broker can wake a stopped target headlessly — no UI at all.\n *   - the dev hot-reload respawn path and the WebView mount path share one\n *     resolve+spawn recipe instead of three copies.\n *\n * The launcher is **headless**: no React, no RN components. The engine-owned\n * MiniappEngine hands it the {@link JSRouter} instance once during\n * engine construction. OEMs embedding the runtime drive miniapp lifecycle\n * through the engine facade and stores, not a separate launcher configure API.\n *\n * Boundary: the launcher owns the **background** context. WebView *rendering*\n * (the UI layer) stays with the host — the launcher just hands back the\n * resolved UI entry so the host can mount its `<WebView>`.\n */\n\nimport {File} from \"expo-file-system\"\n\nimport {permissions} from \"../facades/permissions\"\nimport {decideDevLaunchRoute} from \"../utils/devMiniappLaunch\"\nimport {storage} from \"../utils/storage/storage\"\nimport appRegistry, {getLocalAppRunningState, saveLocalAppRunningState} from \"./AppRegistry\"\nimport devServerBridge from \"./DevServerBridge\"\nimport localMiniappRuntime, {type InstalledMiniappManifest} from \"./LocalMiniappRuntime\"\nimport {activeDashboardAmong} from \"./pages/activeDashboard\"\nimport type {MiniappLaunchSource} from \"@glassly/miniapp\"\nimport type {JSRouter} from \"./JSRouter\"\n\ninterface LauncherDeps {\n  /** The host-constructed router (needs the native Crust binding). */\n  router: JSRouter\n}\n\n/** Hints the host may pass from a view's props to avoid re-deriving them. */\nexport interface LaunchHints {\n  devUrl?: string\n  version?: string\n  devPort?: string\n  /** Who started the app; reported to the miniapp on connect. */\n  launchSource?: MiniappLaunchSource\n}\n\n/** Everything the launcher resolved for a package — bg source + UI entry. */\nexport interface ResolvedBundle {\n  bgSource: string\n  uiUri: string | null\n  uiBaseDir: string | null\n  declaredPermissions: string[]\n  installedManifest?: InstalledMiniappManifest\n  /** Set for dev miniapps (HTTP off the dev server); null for released. */\n  devUrl: string | null\n  devPort: number | null\n}\n\n/** What the host needs back to render the UI layer. */\nexport interface LaunchResult {\n  uiUri: string | null\n  uiBaseDir: string | null\n}\n\nclass MiniappLauncher {\n  private deps: LauncherDeps | null = null\n\n  /**\n   * In-flight launches keyed by packageName. Both apps.ts start() and the\n   * WebView mount call ensureRunning() before the first spawnAndRegister\n   * resolves — without this, neither sees the package in registeredPackages()\n   * yet and both spawn the same context (a clobber/double-spawn). Concurrent\n   * callers share the same promise.\n   */\n  private readonly inFlight = new Map<string, Promise<LaunchResult>>()\n\n  /** Wire the router in. Called once from MiniappEngine construction. */\n  configure(deps: LauncherDeps): void {\n    this.deps = deps\n  }\n\n  private requireRouter(): JSRouter {\n    if (!this.deps) {\n      throw new Error(\"MiniappLauncher not configured — ensureMiniappEngine() has not run\")\n    }\n    return this.deps.router\n  }\n\n  /** True iff the package's background JS context is currently spawned. */\n  isRunning(packageName: string): boolean {\n    return this.deps?.router.registeredPackages().includes(packageName) ?? false\n  }\n\n  /**\n   * Resolve the background JS source + UI entry + declared permissions for a\n   * package. Handles both dev (HTTP off the running dev server) and released\n   * (file:// from the installed snapshot). Reads disk/network/storage; does\n   * NOT spawn. Returns null when the bundle can't be resolved (dev server\n   * unreachable, missing entry, no installed version).\n   */\n  async resolveBundle(packageName: string, hints?: LaunchHints): Promise<ResolvedBundle | null> {\n    const devUrl = hints?.devUrl ?? this.storedDevUrl(packageName)\n\n    // --- Dev: load directly off the local dev server over HTTP. ---\n    if (devUrl) {\n      const route = await decideDevLaunchRoute(packageName, devUrl)\n      if (route.decision === \"offline\" || !route.manifest) return null\n      const manifest = route.manifest\n      const entry = manifest.entry as {background?: string; ui?: string} | undefined\n      if (!entry?.background) return null\n\n      // Use the host that actually answered — may differ from the stored IP\n      // after a laptop Wi-Fi change (mDNS / Metro failover inside decideDevLaunchRoute).\n      const base = route.resolvedUrl.replace(/\\/$/, \"\")\n      // entry.* are bundle-root paths (dist/ stripped); the dev server serves\n      // files relative to cwd, so prepend dist/.\n      const bgUrl = `${base}/dist/${entry.background.replace(/^\\.?\\/+/, \"\")}`\n      const uiUri = entry.ui ? `${base}/dist/${entry.ui.replace(/^\\.?\\/+/, \"\")}` : null\n\n      const perms = manifest.permissions as Array<{type?: string} | string> | undefined\n      const declaredPermissions = (perms ?? [])\n        .map((p) => (typeof p === \"string\" ? p : p?.type))\n        .filter((t): t is string => typeof t === \"string\")\n      const installedManifest: InstalledMiniappManifest = {\n        packageName: typeof manifest.packageName === \"string\" ? manifest.packageName : packageName,\n        name: manifest.name,\n        version: typeof manifest.version === \"string\" ? manifest.version : undefined,\n        sdkVersion: typeof manifest.sdkVersion === \"string\" ? manifest.sdkVersion : undefined,\n        minHostVersion: typeof manifest.minHostVersion === \"string\" ? manifest.minHostVersion : undefined,\n        type: typeof manifest.type === \"string\" ? manifest.type : undefined,\n        entry: manifest.entry as InstalledMiniappManifest[\"entry\"],\n        permissions: manifest.permissions as InstalledMiniappManifest[\"permissions\"],\n        hardwareRequirements: manifest.hardwareRequirements as InstalledMiniappManifest[\"hardwareRequirements\"],\n        actions: manifest.actions as InstalledMiniappManifest[\"actions\"],\n      }\n\n      let bgSource: string\n      try {\n        const res = await fetch(bgUrl)\n        if (!res.ok) return null\n        bgSource = await res.text()\n      } catch {\n        return null\n      }\n\n      return {\n        bgSource,\n        uiUri,\n        uiBaseDir: uiUri ? uiUri.replace(/\\/[^/]+$/, \"/\") : null,\n        declaredPermissions,\n        installedManifest,\n        devUrl: route.resolvedUrl,\n        devPort: this.resolveDevPort(hints?.devPort, packageName),\n      }\n    }\n\n    // --- Released: resolve from the installed file:// snapshot. ---\n    const version = hints?.version ?? (await appRegistry.getActiveVersion(packageName))\n    if (!version) return null\n    const entryPaths = appRegistry.getMiniappEntryPaths(packageName, version)\n    if (!entryPaths?.background) return null\n\n    const manifest = appRegistry.getMiniappManifest(packageName, version) as {\n      packageName?: string\n      name?: string\n      version?: string\n      sdkVersion?: string\n      minHostVersion?: string\n      type?: string\n      entry?: {background?: string; ui?: string}\n      permissions?: Array<{type: string; required?: boolean; description?: string}>\n      hardwareRequirements?: Array<{type: string; level: string; description?: string}>\n      actions?: Array<{id?: unknown; description?: unknown; parameters?: unknown; outputSchema?: unknown}>\n    } | null\n    const declaredPermissions = (manifest?.permissions ?? [])\n      .map((p) => p.type)\n      .filter((t): t is string => typeof t === \"string\")\n    const installedManifest: InstalledMiniappManifest | undefined = manifest\n      ? {\n          packageName: manifest.packageName ?? packageName,\n          name: manifest.name,\n          version: manifest.version ?? version,\n          sdkVersion: manifest.sdkVersion,\n          minHostVersion: manifest.minHostVersion,\n          type: manifest.type,\n          entry: manifest.entry,\n          permissions: manifest.permissions,\n          hardwareRequirements: manifest.hardwareRequirements,\n          actions: manifest.actions,\n        }\n      : undefined\n\n    let bgSource: string\n    try {\n      bgSource = new File(entryPaths.background).textSync()\n    } catch {\n      return null\n    }\n\n    return {\n      bgSource,\n      uiUri: entryPaths.ui ?? null,\n      uiBaseDir: entryPaths.ui ? entryPaths.ui.replace(/\\/[^/]+$/, \"/\") : null,\n      declaredPermissions,\n      installedManifest,\n      devUrl: null,\n      devPort: null,\n    }\n  }\n\n  /**\n   * Ensure a miniapp's background JS context is spawned. Idempotent — if the\n   * context is already alive this is a no-op spawn-wise (it still resolves the\n   * UI entry so a re-mounting host gets its `<WebView>` source back).\n   *\n   * Resolves once the context is SPAWNED. It does NOT block on the context's\n   * CONNECT handshake — the host's WebView mount shouldn't wait on background\n   * JS. Callers that need the context to be connected and ready to receive\n   * messages (the action broker) follow up with\n   * {@link LocalMiniappRuntime.waitForConnect}.\n   */\n  async ensureRunning(packageName: string, hints?: LaunchHints): Promise<LaunchResult> {\n    const router = this.requireRouter()\n\n    // Already spawned: best-effort resolve for the UI entry, never throw —\n    // a headless caller that doesn't need UI gets {null, null} fast even if\n    // the dev server has since dropped.\n    if (router.registeredPackages().includes(packageName)) {\n      const existing = await this.resolveBundle(packageName, hints).catch(() => null)\n      return {uiUri: existing?.uiUri ?? null, uiBaseDir: existing?.uiBaseDir ?? null}\n    }\n\n    // Coalesce concurrent launches of the same package onto one promise.\n    const pending = this.inFlight.get(packageName)\n    if (pending) return pending\n\n    const launch = this.spawn(packageName, hints)\n    this.inFlight.set(packageName, launch)\n    try {\n      return await launch\n    } finally {\n      this.inFlight.delete(packageName)\n    }\n  }\n\n  /** Resolve the bundle and spawn the context. Serialized via {@link inFlight}. */\n  private async spawn(packageName: string, hints?: LaunchHints): Promise<LaunchResult> {\n    const router = this.requireRouter()\n    const resolved = await this.resolveBundle(packageName, hints)\n    if (!resolved) {\n      throw new Error(`MiniappLauncher: cannot resolve bundle for ${packageName}`)\n    }\n\n    // Re-check after the async resolve: a different path may have spawned it\n    // while we were fetching/reading the bundle.\n    if (!router.registeredPackages().includes(packageName)) {\n      const ok = await router.spawnAndRegister(packageName, resolved.bgSource, {\n        permissions: resolved.declaredPermissions,\n        installedManifest: resolved.installedManifest,\n        launchSource: hints?.launchSource,\n      })\n      if (!ok) {\n        throw new Error(`MiniappLauncher: spawn failed for ${packageName}`)\n      }\n\n      // Dev: wire the hot-reload + log-forwarding sidecar. No-op in prod\n      // (devServerBridge silently drops when no sidecar is up).\n      if (resolved.devUrl && resolved.devPort != null) {\n        devServerBridge.connect(packageName, resolved.devUrl, resolved.devPort)\n      } else if (resolved.devUrl) {\n        // Dev miniapp with no resolvable port — it still launches, but hot\n        // reload + log forwarding won't connect. Surface it instead of failing\n        // silently (the old inline path hard-failed with \"no dev port\").\n        console.warn(`MiniappLauncher: ${packageName} has no dev port — hot reload + log forwarding disabled`)\n      }\n    }\n\n    return {uiUri: resolved.uiUri, uiBaseDir: resolved.uiBaseDir}\n  }\n\n  /**\n   * Re-spawn local miniapps that were running when the app was last killed.\n   *\n   * Miniapps run in the phone's own JS engine, so a host-process kill tears\n   * down their JSContext with nothing to resurrect them. Without this they\n   * would silently stay stopped on the next launch even though the user left\n   * them running.\n   *\n   * Each local miniapp persists its running flag to disk on start/stop\n   * (`saveLocalAppRunningState`, via the applet's `onStart`/`onStop`). We read\n   * those flags back and re-spawn the background context headlessly (no\n   * foreground, no navigation) — the spawn registers the package so the home\n   * tray/switcher project it as running, exactly as a normal start would. The\n   * WebView, if any, re-attaches lazily when the user opens the app.\n   *\n   * Idempotent and best-effort: skips already-spawned contexts, and clears the\n   * persisted flag for any app whose bundle can no longer be resolved\n   * (uninstalled, or dev server gone) so a dead entry doesn't retry every boot.\n   * Not compatibility-gated: a previously-running background app shouldn't be\n   * dropped just because glasses are momentarily disconnected at boot — it\n   * resumes when they reconnect, same as mid-session.\n   *\n   * Always On apps (the dashboard) start whether or not they were running\n   * when the app was last killed, and get a switcher card like any other app.\n   * A dashboard that does not hold the role (ADR-0009) is not started by its\n   * Always On flag.\n   * Both restore paths skip apps missing required OS permissions without\n   * prompting or clearing their saved running/Always On choice.\n   */\n  async autostartLocalMiniapps(): Promise<void> {\n    const apps = await appRegistry.getInstalledMiniapps()\n    const activeDashboard = activeDashboardAmong(apps)\n    for (const app of apps) {\n      // Only phone-hosted miniapps have a JSContext to re-spawn. Offline\n      // built-ins (`local:false, offline:true`) restore their native running\n      // state elsewhere and have no bundle to launch.\n      if (!app.local) continue\n      const alwaysOn = app.alwaysOn && (app.type !== \"dashboard\" || app.packageName === activeDashboard)\n      if (!alwaysOn && !getLocalAppRunningState(app.packageName)) continue\n      if (this.isRunning(app.packageName)) continue\n      try {\n        const missing = await permissions.missingRequired(app.permissions ?? [])\n        if (missing.length > 0) {\n          console.info(\n            `MiniappLauncher: skipping autostart for ${app.packageName} — missing required permissions: ${missing.join(\n              \", \",\n            )}`,\n          )\n          continue\n        }\n      } catch (e) {\n        console.warn(`MiniappLauncher: skipping autostart for ${app.packageName} — permission check failed`, e)\n        continue\n      }\n      try {\n        await this.ensureRunning(app.packageName)\n      } catch (e) {\n        console.warn(`MiniappLauncher: autostart failed for ${app.packageName} — clearing stale running flag`, e)\n        saveLocalAppRunningState(app.packageName, false)\n      }\n    }\n  }\n\n  /**\n   * Ensure the context is running AND has completed its CONNECT handshake.\n   * Used by the action broker, which must not deliver to a context that hasn't\n   * come up yet. Throws on spawn failure or connect timeout.\n   */\n  async ensureConnected(packageName: string, connectTimeoutMs = 10_000, hints?: LaunchHints): Promise<void> {\n    await this.ensureRunning(packageName, hints)\n    await localMiniappRuntime.waitForConnect(packageName, connectTimeoutMs)\n  }\n\n  /** Tear down a miniapp's background JS context. */\n  async stop(packageName: string): Promise<void> {\n    // If a launch is in flight, let it finish first. Otherwise unregister()\n    // no-ops on the not-yet-registered package and the pending spawn then\n    // re-registers the context — leaving it running despite the stop.\n    const pending = this.inFlight.get(packageName)\n    if (pending) {\n      try {\n        await pending\n      } catch {\n        // Launch failed — nothing got registered, so nothing to tear down.\n      }\n    }\n    await this.deps?.router.unregister(packageName)\n  }\n\n  // --- internals -----------------------------------------------------------\n\n  private storedDevUrl(packageName: string): string | undefined {\n    const r = storage.load<string>(`${packageName}_dev_url`)\n    return r.is_ok() ? r.value : undefined\n  }\n\n  /** resolveDevPort — moved verbatim from the old LocalMiniappView helper. */\n  private resolveDevPort(searchParam: string | undefined, packageName: string): number | null {\n    if (searchParam) {\n      const n = parseInt(searchParam, 10)\n      if (Number.isFinite(n)) return n\n    }\n    const stored = storage.load<number>(`${packageName}_dev_port`)\n    if (stored.is_ok()) return stored.value\n    return null\n  }\n}\n\nexport const miniappLauncher = new MiniappLauncher()\n"]}
+{"version":3,"file":"MiniappLauncher.js","sourceRoot":"","sources":["../../src/services/MiniappLauncher.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MiniappLauncher — headless launch/teardown of a local miniapp's background\n * JS context.\n *\n * This is the one piece of \"run a miniapp\" that used to live inside the\n * `LocalMiniappView` React component (resolve the bundle → read the manifest →\n * `spawnAndRegister`), triggered only when the Compositor mounted that\n * component on foreground. Pulling it into the runtime means:\n *\n *   - `start()` can actually spawn an app even when nothing foregrounds it\n *     (e.g. a system app launching another miniapp via `session.miniapps`).\n *   - the action broker can wake a stopped target headlessly — no UI at all.\n *   - the dev hot-reload respawn path and the WebView mount path share one\n *     resolve+spawn recipe instead of three copies.\n *\n * The launcher is **headless**: no React, no RN components. The engine-owned\n * MiniappEngine hands it the {@link JSRouter} instance once during\n * engine construction. OEMs embedding the runtime drive miniapp lifecycle\n * through the engine facade and stores, not a separate launcher configure API.\n *\n * Boundary: the launcher owns the **background** context. WebView *rendering*\n * (the UI layer) stays with the host — the launcher just hands back the\n * resolved UI entry so the host can mount its `<WebView>`.\n */\n\nimport {File} from \"expo-file-system\"\n\nimport {permissions} from \"../facades/permissions\"\nimport {decideDevLaunchRoute} from \"../utils/devMiniappLaunch\"\nimport {storage} from \"../utils/storage/storage\"\nimport appRegistry, {getLocalAppRunningState, saveLocalAppRunningState} from \"./AppRegistry\"\nimport devServerBridge from \"./DevServerBridge\"\nimport localMiniappRuntime, {type InstalledMiniappManifest} from \"./LocalMiniappRuntime\"\nimport type {MiniappLaunchSource} from \"@glassly/miniapp\"\nimport type {JSRouter} from \"./JSRouter\"\n\ninterface LauncherDeps {\n  /** The host-constructed router (needs the native Crust binding). */\n  router: JSRouter\n}\n\n/** Hints the host may pass from a view's props to avoid re-deriving them. */\nexport interface LaunchHints {\n  devUrl?: string\n  version?: string\n  devPort?: string\n  /** Who started the app; reported to the miniapp on connect. */\n  launchSource?: MiniappLaunchSource\n}\n\n/** Everything the launcher resolved for a package — bg source + UI entry. */\nexport interface ResolvedBundle {\n  bgSource: string\n  uiUri: string | null\n  uiBaseDir: string | null\n  declaredPermissions: string[]\n  installedManifest?: InstalledMiniappManifest\n  /** Set for dev miniapps (HTTP off the dev server); null for released. */\n  devUrl: string | null\n  devPort: number | null\n}\n\n/** What the host needs back to render the UI layer. */\nexport interface LaunchResult {\n  uiUri: string | null\n  uiBaseDir: string | null\n}\n\nclass MiniappLauncher {\n  private deps: LauncherDeps | null = null\n\n  /**\n   * In-flight launches keyed by packageName. Both apps.ts start() and the\n   * WebView mount call ensureRunning() before the first spawnAndRegister\n   * resolves — without this, neither sees the package in registeredPackages()\n   * yet and both spawn the same context (a clobber/double-spawn). Concurrent\n   * callers share the same promise.\n   */\n  private readonly inFlight = new Map<string, Promise<LaunchResult>>()\n\n  /** Wire the router in. Called once from MiniappEngine construction. */\n  configure(deps: LauncherDeps): void {\n    this.deps = deps\n  }\n\n  private requireRouter(): JSRouter {\n    if (!this.deps) {\n      throw new Error(\"MiniappLauncher not configured — ensureMiniappEngine() has not run\")\n    }\n    return this.deps.router\n  }\n\n  /** True iff the package's background JS context is currently spawned. */\n  isRunning(packageName: string): boolean {\n    return this.deps?.router.registeredPackages().includes(packageName) ?? false\n  }\n\n  /**\n   * Resolve the background JS source + UI entry + declared permissions for a\n   * package. Handles both dev (HTTP off the running dev server) and released\n   * (file:// from the installed snapshot). Reads disk/network/storage; does\n   * NOT spawn. Returns null when the bundle can't be resolved (dev server\n   * unreachable, missing entry, no installed version).\n   */\n  async resolveBundle(packageName: string, hints?: LaunchHints): Promise<ResolvedBundle | null> {\n    const devUrl = hints?.devUrl ?? this.storedDevUrl(packageName)\n\n    // --- Dev: load directly off the local dev server over HTTP. ---\n    if (devUrl) {\n      const route = await decideDevLaunchRoute(packageName, devUrl)\n      if (route.decision === \"offline\" || !route.manifest) return null\n      const manifest = route.manifest\n      const entry = manifest.entry as {background?: string; ui?: string} | undefined\n      if (!entry?.background) return null\n\n      // Use the host that actually answered — may differ from the stored IP\n      // after a laptop Wi-Fi change (mDNS / Metro failover inside decideDevLaunchRoute).\n      const base = route.resolvedUrl.replace(/\\/$/, \"\")\n      // entry.* are bundle-root paths (dist/ stripped); the dev server serves\n      // files relative to cwd, so prepend dist/.\n      const bgUrl = `${base}/dist/${entry.background.replace(/^\\.?\\/+/, \"\")}`\n      const uiUri = entry.ui ? `${base}/dist/${entry.ui.replace(/^\\.?\\/+/, \"\")}` : null\n\n      const perms = manifest.permissions as Array<{type?: string} | string> | undefined\n      const declaredPermissions = (perms ?? [])\n        .map((p) => (typeof p === \"string\" ? p : p?.type))\n        .filter((t): t is string => typeof t === \"string\")\n      const installedManifest: InstalledMiniappManifest = {\n        packageName: typeof manifest.packageName === \"string\" ? manifest.packageName : packageName,\n        name: manifest.name,\n        version: typeof manifest.version === \"string\" ? manifest.version : undefined,\n        sdkVersion: typeof manifest.sdkVersion === \"string\" ? manifest.sdkVersion : undefined,\n        minHostVersion: typeof manifest.minHostVersion === \"string\" ? manifest.minHostVersion : undefined,\n        type: typeof manifest.type === \"string\" ? manifest.type : undefined,\n        entry: manifest.entry as InstalledMiniappManifest[\"entry\"],\n        permissions: manifest.permissions as InstalledMiniappManifest[\"permissions\"],\n        hardwareRequirements: manifest.hardwareRequirements as InstalledMiniappManifest[\"hardwareRequirements\"],\n        actions: manifest.actions as InstalledMiniappManifest[\"actions\"],\n      }\n\n      let bgSource: string\n      try {\n        const res = await fetch(bgUrl)\n        if (!res.ok) return null\n        bgSource = await res.text()\n      } catch {\n        return null\n      }\n\n      return {\n        bgSource,\n        uiUri,\n        uiBaseDir: uiUri ? uiUri.replace(/\\/[^/]+$/, \"/\") : null,\n        declaredPermissions,\n        installedManifest,\n        devUrl: route.resolvedUrl,\n        devPort: this.resolveDevPort(hints?.devPort, packageName),\n      }\n    }\n\n    // --- Released: resolve from the installed file:// snapshot. ---\n    const version = hints?.version ?? (await appRegistry.getActiveVersion(packageName))\n    if (!version) return null\n    const entryPaths = appRegistry.getMiniappEntryPaths(packageName, version)\n    if (!entryPaths?.background) return null\n\n    const manifest = appRegistry.getMiniappManifest(packageName, version) as {\n      packageName?: string\n      name?: string\n      version?: string\n      sdkVersion?: string\n      minHostVersion?: string\n      type?: string\n      entry?: {background?: string; ui?: string}\n      permissions?: Array<{type: string; required?: boolean; description?: string}>\n      hardwareRequirements?: Array<{type: string; level: string; description?: string}>\n      actions?: Array<{id?: unknown; description?: unknown; parameters?: unknown; outputSchema?: unknown}>\n    } | null\n    const declaredPermissions = (manifest?.permissions ?? [])\n      .map((p) => p.type)\n      .filter((t): t is string => typeof t === \"string\")\n    const installedManifest: InstalledMiniappManifest | undefined = manifest\n      ? {\n          packageName: manifest.packageName ?? packageName,\n          name: manifest.name,\n          version: manifest.version ?? version,\n          sdkVersion: manifest.sdkVersion,\n          minHostVersion: manifest.minHostVersion,\n          type: manifest.type,\n          entry: manifest.entry,\n          permissions: manifest.permissions,\n          hardwareRequirements: manifest.hardwareRequirements,\n          actions: manifest.actions,\n        }\n      : undefined\n\n    let bgSource: string\n    try {\n      bgSource = new File(entryPaths.background).textSync()\n    } catch {\n      return null\n    }\n\n    return {\n      bgSource,\n      uiUri: entryPaths.ui ?? null,\n      uiBaseDir: entryPaths.ui ? entryPaths.ui.replace(/\\/[^/]+$/, \"/\") : null,\n      declaredPermissions,\n      installedManifest,\n      devUrl: null,\n      devPort: null,\n    }\n  }\n\n  /**\n   * Ensure a miniapp's background JS context is spawned. Idempotent — if the\n   * context is already alive this is a no-op spawn-wise (it still resolves the\n   * UI entry so a re-mounting host gets its `<WebView>` source back).\n   *\n   * Resolves once the context is SPAWNED. It does NOT block on the context's\n   * CONNECT handshake — the host's WebView mount shouldn't wait on background\n   * JS. Callers that need the context to be connected and ready to receive\n   * messages (the action broker) follow up with\n   * {@link LocalMiniappRuntime.waitForConnect}.\n   */\n  async ensureRunning(packageName: string, hints?: LaunchHints): Promise<LaunchResult> {\n    const router = this.requireRouter()\n\n    // Already spawned: best-effort resolve for the UI entry, never throw —\n    // a headless caller that doesn't need UI gets {null, null} fast even if\n    // the dev server has since dropped.\n    if (router.registeredPackages().includes(packageName)) {\n      const existing = await this.resolveBundle(packageName, hints).catch(() => null)\n      return {uiUri: existing?.uiUri ?? null, uiBaseDir: existing?.uiBaseDir ?? null}\n    }\n\n    // Coalesce concurrent launches of the same package onto one promise.\n    const pending = this.inFlight.get(packageName)\n    if (pending) return pending\n\n    const launch = this.spawn(packageName, hints)\n    this.inFlight.set(packageName, launch)\n    try {\n      return await launch\n    } finally {\n      this.inFlight.delete(packageName)\n    }\n  }\n\n  /** Resolve the bundle and spawn the context. Serialized via {@link inFlight}. */\n  private async spawn(packageName: string, hints?: LaunchHints): Promise<LaunchResult> {\n    const router = this.requireRouter()\n    const resolved = await this.resolveBundle(packageName, hints)\n    if (!resolved) {\n      throw new Error(`MiniappLauncher: cannot resolve bundle for ${packageName}`)\n    }\n\n    // Re-check after the async resolve: a different path may have spawned it\n    // while we were fetching/reading the bundle.\n    if (!router.registeredPackages().includes(packageName)) {\n      const ok = await router.spawnAndRegister(packageName, resolved.bgSource, {\n        permissions: resolved.declaredPermissions,\n        installedManifest: resolved.installedManifest,\n        launchSource: hints?.launchSource,\n      })\n      if (!ok) {\n        throw new Error(`MiniappLauncher: spawn failed for ${packageName}`)\n      }\n\n      // Dev: wire the hot-reload + log-forwarding sidecar. No-op in prod\n      // (devServerBridge silently drops when no sidecar is up).\n      if (resolved.devUrl && resolved.devPort != null) {\n        devServerBridge.connect(packageName, resolved.devUrl, resolved.devPort)\n      } else if (resolved.devUrl) {\n        // Dev miniapp with no resolvable port — it still launches, but hot\n        // reload + log forwarding won't connect. Surface it instead of failing\n        // silently (the old inline path hard-failed with \"no dev port\").\n        console.warn(`MiniappLauncher: ${packageName} has no dev port — hot reload + log forwarding disabled`)\n      }\n    }\n\n    return {uiUri: resolved.uiUri, uiBaseDir: resolved.uiBaseDir}\n  }\n\n  /**\n   * Re-spawn local miniapps that were running when the app was last killed.\n   *\n   * Miniapps run in the phone's own JS engine, so a host-process kill tears\n   * down their JSContext with nothing to resurrect them. Without this they\n   * would silently stay stopped on the next launch even though the user left\n   * them running.\n   *\n   * Each local miniapp persists its running flag to disk on start/stop\n   * (`saveLocalAppRunningState`, via the applet's `onStart`/`onStop`). We read\n   * those flags back and re-spawn the background context headlessly (no\n   * foreground, no navigation) — the spawn registers the package so the home\n   * tray/switcher project it as running, exactly as a normal start would. The\n   * WebView, if any, re-attaches lazily when the user opens the app.\n   *\n   * Idempotent and best-effort: skips already-spawned contexts, and clears the\n   * persisted flag for any app whose bundle can no longer be resolved\n   * (uninstalled, or dev server gone) so a dead entry doesn't retry every boot.\n   * Not compatibility-gated: a previously-running background app shouldn't be\n   * dropped just because glasses are momentarily disconnected at boot — it\n   * resumes when they reconnect, same as mid-session.\n   *\n   * Always On apps (the dashboard) start whether or not they were running\n   * when the app was last killed, and get a switcher card like any other app.\n   * Both restore paths skip apps missing required OS permissions without\n   * prompting or clearing their saved running/Always On choice.\n   */\n  async autostartLocalMiniapps(): Promise<void> {\n    const apps = await appRegistry.getInstalledMiniapps()\n    for (const app of apps) {\n      // Only phone-hosted miniapps have a JSContext to re-spawn. Offline\n      // built-ins (`local:false, offline:true`) restore their native running\n      // state elsewhere and have no bundle to launch.\n      if (!app.local) continue\n      if (!app.alwaysOn && !getLocalAppRunningState(app.packageName)) continue\n      if (this.isRunning(app.packageName)) continue\n      try {\n        const missing = await permissions.missingRequired(app.permissions ?? [])\n        if (missing.length > 0) {\n          console.info(\n            `MiniappLauncher: skipping autostart for ${app.packageName} — missing required permissions: ${missing.join(\n              \", \",\n            )}`,\n          )\n          continue\n        }\n      } catch (e) {\n        console.warn(`MiniappLauncher: skipping autostart for ${app.packageName} — permission check failed`, e)\n        continue\n      }\n      try {\n        await this.ensureRunning(app.packageName)\n      } catch (e) {\n        console.warn(`MiniappLauncher: autostart failed for ${app.packageName} — clearing stale running flag`, e)\n        saveLocalAppRunningState(app.packageName, false)\n      }\n    }\n  }\n\n  /**\n   * Ensure the context is running AND has completed its CONNECT handshake.\n   * Used by the action broker, which must not deliver to a context that hasn't\n   * come up yet. Throws on spawn failure or connect timeout.\n   */\n  async ensureConnected(packageName: string, connectTimeoutMs = 10_000, hints?: LaunchHints): Promise<void> {\n    await this.ensureRunning(packageName, hints)\n    await localMiniappRuntime.waitForConnect(packageName, connectTimeoutMs)\n  }\n\n  /** Tear down a miniapp's background JS context. */\n  async stop(packageName: string): Promise<void> {\n    // If a launch is in flight, let it finish first. Otherwise unregister()\n    // no-ops on the not-yet-registered package and the pending spawn then\n    // re-registers the context — leaving it running despite the stop.\n    const pending = this.inFlight.get(packageName)\n    if (pending) {\n      try {\n        await pending\n      } catch {\n        // Launch failed — nothing got registered, so nothing to tear down.\n      }\n    }\n    await this.deps?.router.unregister(packageName)\n  }\n\n  // --- internals -----------------------------------------------------------\n\n  private storedDevUrl(packageName: string): string | undefined {\n    const r = storage.load<string>(`${packageName}_dev_url`)\n    return r.is_ok() ? r.value : undefined\n  }\n\n  /** resolveDevPort — moved verbatim from the old LocalMiniappView helper. */\n  private resolveDevPort(searchParam: string | undefined, packageName: string): number | null {\n    if (searchParam) {\n      const n = parseInt(searchParam, 10)\n      if (Number.isFinite(n)) return n\n    }\n    const stored = storage.load<number>(`${packageName}_dev_port`)\n    if (stored.is_ok()) return stored.value\n    return null\n  }\n}\n\nexport const miniappLauncher = new MiniappLauncher()\n"]}

package/build/services/pages/OverlayPages.d.ts

@@ -1,14 +1,3 @@
-/**
- * The overlay app's page (ADR-0006, ADR-0009): one Page per dashboard that
- * has taken the slot, the only Page implementation the page host shows. The
- * engine keeps the slot and the eligibility watch; a page only relays:
- * holding the slot is reported to its app as a view change, and the app's
- * frames reach the slot through `renderOverlay` under its package name. Only
- * the dashboard that holds the role may show; when the role moves, the
- * previous holder hears it was replaced. The runtime supplies the sink that
- * delivers to apps, so this module never imports it.
- */
-import { type PageHiddenReason } from "./PageHost";
 export type DashboardViewChangeReason = "shown" | "hidden" | "replaced" | "ineligible";
 export interface OverlayPagesSink {
     /** Deliver a display_view event to the app. */
@@ -24,8 +13,8 @@ declare class OverlayPages {
     get showingPackage(): string | null;
     /** Give the app the slot (a no-op when it already shows or pages are not eligible). */
     show(packageName: string): boolean;
-    /** Release the slot if the app holds it; "replaced" when the dashboard role moved on. */
-    hide(packageName: string, reason?: PageHiddenReason): void;
+    /** Release the slot if the app holds it. */
+    hide(packageName: string): void;
     /** The app stopped: release the slot without telling it, and forget its page. */
     remove(packageName: string): void;
     private pageFor;

package/build/services/pages/OverlayPages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayPages.d.ts","sourceRoot":"","sources":["../../../src/services/pages/OverlayPages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAiB,EAAY,KAAK,gBAAgB,EAAC,MAAM,YAAY,CAAA;AAIrE,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAChE;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,KAAK,CAA0B;IACvC,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAoB;IAElC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAI5C,kDAAkD;IAClD,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAKlC;IAED,uFAAuF;IACvF,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAOlC,yFAAyF;IACzF,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,gBAA2B,GAAG,IAAI;IAKpE,iFAAiF;IACjF,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAYjC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,IAAI;CAIb;AAED,QAAA,MAAM,YAAY,cAAqB,CAAA;AACvC,eAAe,YAAY,CAAA;AAC3B,OAAO,EAAC,YAAY,EAAC,CAAA"}
+{"version":3,"file":"OverlayPages.d.ts","sourceRoot":"","sources":["../../../src/services/pages/OverlayPages.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAChE;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,KAAK,CAA0B;IACvC,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAoB;IAElC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAI5C,kDAAkD;IAClD,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAKlC;IAED,uFAAuF;IACvF,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAOlC,4CAA4C;IAC5C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK/B,iFAAiF;IACjF,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAYjC,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,IAAI;CAIb;AAED,QAAA,MAAM,YAAY,cAAqB,CAAA;AACvC,eAAe,YAAY,CAAA;AAC3B,OAAO,EAAC,YAAY,EAAC,CAAA"}

package/build/services/pages/OverlayPages.js

@@ -1,12 +1,11 @@
 /**
- * The overlay app's page (ADR-0006, ADR-0009): one Page per dashboard that
- * has taken the slot, the only Page implementation the page host shows. The
- * engine keeps the slot and the eligibility watch; a page only relays:
- * holding the slot is reported to its app as a view change, and the app's
- * frames reach the slot through `renderOverlay` under its package name. Only
- * the dashboard that holds the role may show; when the role moves, the
- * previous holder hears it was replaced. The runtime supplies the sink that
- * delivers to apps, so this module never imports it.
+ * The overlay apps' pages (ADR-0006): one Page per app that has taken the
+ * slot, the only Page implementation the page host shows. The engine keeps
+ * the slot and the eligibility watch; a page only relays: holding the slot
+ * is reported to its app as a view change, and the app's frames reach the
+ * slot through `renderOverlay` under its package name. Whichever app asked
+ * last holds the slot; the previous one hears it was replaced. The runtime
+ * supplies the sink that delivers to apps, so this module never imports it.
  */
 import pageHost from "./PageHost";
 import { isOverlayApp } from "./overlayApps";
@@ -37,11 +36,11 @@ class OverlayPages {
         pageHost.show(page);
         return pageHost.showing === page;
     }
-    /** Release the slot if the app holds it; "replaced" when the dashboard role moved on. */
-    hide(packageName, reason = "hidden") {
+    /** Release the slot if the app holds it. */
+    hide(packageName) {
         const page = this.pages.get(packageName);
         if (page)
-            pageHost.hide(page, reason);
+            pageHost.hide(page);
     }
     /** The app stopped: release the slot without telling it, and forget its page. */
     remove(packageName) {

package/build/services/pages/OverlayPages.js.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayPages.js","sourceRoot":"","sources":["../../../src/services/pages/OverlayPages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The overlay app's page (ADR-0006, ADR-0009): one Page per dashboard that\n * has taken the slot, the only Page implementation the page host shows. The\n * engine keeps the slot and the eligibility watch; a page only relays:\n * holding the slot is reported to its app as a view change, and the app's\n * frames reach the slot through `renderOverlay` under its package name. Only\n * the dashboard that holds the role may show; when the role moves, the\n * previous holder hears it was replaced. The runtime supplies the sink that\n * delivers to apps, so this module never imports it.\n */\nimport pageHost, {type Page, type PageHiddenReason} from \"./PageHost\"\nimport {isOverlayApp} from \"./overlayApps\"\nimport {pagesEligible} from \"./pageEligibility\"\n\nexport type DashboardViewChangeReason = \"shown\" | \"hidden\" | \"replaced\" | \"ineligible\"\n\nexport interface OverlayPagesSink {\n  /** Deliver a display_view event to the app. */\n  send(packageName: string, event: Record<string, unknown>): void\n}\n\nclass OverlayPages {\n  private sink: OverlayPagesSink | null = null\n  private pages = new Map<string, Page>()\n  /** Set while an app's page is torn down with the app; it hears nothing then. */\n  private silent = new Set<string>()\n\n  setSink(sink: OverlayPagesSink | null): void {\n    this.sink = sink\n  }\n\n  /** The app whose page holds the slot, or null. */\n  get showingPackage(): string | null {\n    const showing = pageHost.showing\n    if (!showing) return null\n    for (const [packageName, page] of this.pages) if (page === showing) return packageName\n    return null\n  }\n\n  /** Give the app the slot (a no-op when it already shows or pages are not eligible). */\n  show(packageName: string): boolean {\n    if (!isOverlayApp(packageName) || !pagesEligible()) return false\n    const page = this.pageFor(packageName)\n    pageHost.show(page)\n    return pageHost.showing === page\n  }\n\n  /** Release the slot if the app holds it; \"replaced\" when the dashboard role moved on. */\n  hide(packageName: string, reason: PageHiddenReason = \"hidden\"): void {\n    const page = this.pages.get(packageName)\n    if (page) pageHost.hide(page, reason)\n  }\n\n  /** The app stopped: release the slot without telling it, and forget its page. */\n  remove(packageName: string): void {\n    const page = this.pages.get(packageName)\n    if (!page) return\n    this.silent.add(packageName)\n    try {\n      pageHost.hide(page)\n    } finally {\n      this.silent.delete(packageName)\n    }\n    this.pages.delete(packageName)\n  }\n\n  private pageFor(packageName: string): Page {\n    let page = this.pages.get(packageName)\n    if (page) return page\n    page = {\n      id: packageName,\n      onShown: () => this.emit(packageName, {kind: \"change\", view: \"dashboard\", reason: \"shown\"}),\n      onHidden: (reason: PageHiddenReason) => this.emit(packageName, {kind: \"change\", view: \"main\", reason}),\n    }\n    this.pages.set(packageName, page)\n    return page\n  }\n\n  private emit(packageName: string, event: Record<string, unknown>): void {\n    if (this.silent.has(packageName) || !isOverlayApp(packageName)) return\n    this.sink?.send(packageName, event)\n  }\n}\n\nconst overlayPages = new OverlayPages()\nexport default overlayPages\nexport {OverlayPages}\n"]}
+{"version":3,"file":"OverlayPages.js","sourceRoot":"","sources":["../../../src/services/pages/OverlayPages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The overlay apps' pages (ADR-0006): one Page per app that has taken the\n * slot, the only Page implementation the page host shows. The engine keeps\n * the slot and the eligibility watch; a page only relays: holding the slot\n * is reported to its app as a view change, and the app's frames reach the\n * slot through `renderOverlay` under its package name. Whichever app asked\n * last holds the slot; the previous one hears it was replaced. The runtime\n * supplies the sink that delivers to apps, so this module never imports it.\n */\nimport pageHost, {type Page, type PageHiddenReason} from \"./PageHost\"\nimport {isOverlayApp} from \"./overlayApps\"\nimport {pagesEligible} from \"./pageEligibility\"\n\nexport type DashboardViewChangeReason = \"shown\" | \"hidden\" | \"replaced\" | \"ineligible\"\n\nexport interface OverlayPagesSink {\n  /** Deliver a display_view event to the app. */\n  send(packageName: string, event: Record<string, unknown>): void\n}\n\nclass OverlayPages {\n  private sink: OverlayPagesSink | null = null\n  private pages = new Map<string, Page>()\n  /** Set while an app's page is torn down with the app; it hears nothing then. */\n  private silent = new Set<string>()\n\n  setSink(sink: OverlayPagesSink | null): void {\n    this.sink = sink\n  }\n\n  /** The app whose page holds the slot, or null. */\n  get showingPackage(): string | null {\n    const showing = pageHost.showing\n    if (!showing) return null\n    for (const [packageName, page] of this.pages) if (page === showing) return packageName\n    return null\n  }\n\n  /** Give the app the slot (a no-op when it already shows or pages are not eligible). */\n  show(packageName: string): boolean {\n    if (!isOverlayApp(packageName) || !pagesEligible()) return false\n    const page = this.pageFor(packageName)\n    pageHost.show(page)\n    return pageHost.showing === page\n  }\n\n  /** Release the slot if the app holds it. */\n  hide(packageName: string): void {\n    const page = this.pages.get(packageName)\n    if (page) pageHost.hide(page)\n  }\n\n  /** The app stopped: release the slot without telling it, and forget its page. */\n  remove(packageName: string): void {\n    const page = this.pages.get(packageName)\n    if (!page) return\n    this.silent.add(packageName)\n    try {\n      pageHost.hide(page)\n    } finally {\n      this.silent.delete(packageName)\n    }\n    this.pages.delete(packageName)\n  }\n\n  private pageFor(packageName: string): Page {\n    let page = this.pages.get(packageName)\n    if (page) return page\n    page = {\n      id: packageName,\n      onShown: () => this.emit(packageName, {kind: \"change\", view: \"dashboard\", reason: \"shown\"}),\n      onHidden: (reason: PageHiddenReason) => this.emit(packageName, {kind: \"change\", view: \"main\", reason}),\n    }\n    this.pages.set(packageName, page)\n    return page\n  }\n\n  private emit(packageName: string, event: Record<string, unknown>): void {\n    if (this.silent.has(packageName) || !isOverlayApp(packageName)) return\n    this.sink?.send(packageName, event)\n  }\n}\n\nconst overlayPages = new OverlayPages()\nexport default overlayPages\nexport {OverlayPages}\n"]}

package/build/services/pages/PageHost.d.ts

@@ -20,7 +20,7 @@ declare class PageHost {
     /** Give `page` the slot; no-op when it already shows or pages are not eligible. */
     show(page: Page): void;
     /** Release the slot if `page` holds it. */
-    hide(page: Page, reason?: PageHiddenReason): void;
+    hide(page: Page): void;
     onChange(listener: (page: Page | null) => void): () => void;
     private release;
     private emit;

package/build/services/pages/PageHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHost.d.ts","sourceRoot":"","sources":["../../../src/services/pages/PageHost.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEnE,MAAM,WAAW,IAAI;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,OAAO,IAAI,IAAI,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACzC;AAED,cAAM,QAAQ;IACZ,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAQ;IAEvB,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAOZ,IAAI,OAAO,IAAI,IAAI,GAAG,IAAI,CAEzB;IAED,mFAAmF;IACnF,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAYtB,2CAA2C;IAC3C,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,gBAA2B,GAAG,IAAI;IAO3D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAO3D,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;CAUhB;AAED,QAAA,MAAM,QAAQ,UAAiB,CAAA;AAC/B,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAC,QAAQ,EAAC,CAAA"}
+{"version":3,"file":"PageHost.d.ts","sourceRoot":"","sources":["../../../src/services/pages/PageHost.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAEnE,MAAM,WAAW,IAAI;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,OAAO,IAAI,IAAI,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACzC;AAED,cAAM,QAAQ;IACZ,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAQ;IAEvB,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAOZ,IAAI,OAAO,IAAI,IAAI,GAAG,IAAI,CAEzB;IAED,mFAAmF;IACnF,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAYtB,2CAA2C;IAC3C,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAOtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAO3D,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;CAUhB;AAED,QAAA,MAAM,QAAQ,UAAiB,CAAA;AAC/B,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAC,QAAQ,EAAC,CAAA"}

package/build/services/pages/PageHost.js

@@ -53,11 +53,11 @@ class PageHost {
         });
     }
     /** Release the slot if `page` holds it. */
-    hide(page, reason = "hidden") {
+    hide(page) {
         this.enqueue(() => {
             if (this.showingPage !== page)
                 return;
-            this.release(reason);
+            this.release("hidden");
         });
     }
     onChange(listener) {

package/build/services/pages/PageHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"PageHost.js","sourceRoot":"","sources":["../../../src/services/pages/PageHost.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The page host owns the overlay slot: the single native view above the main\n * content. At most one page shows at a time; showing a page replaces whatever\n * was showing, hiding releases the slot and the main content replays. Which\n * app gets the wearer's gestures is the gesture claims' business, not the\n * host's. Show and hide run through one queue so a page\n * that hides itself from inside its own transition is hidden afterwards, never\n * re-entered. Eligibility (Glassly CFW, dashboard enabled) is checked before a\n * show and watched while a page is up.\n */\nimport {useGlassesStore} from \"../../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../../stores/settings\"\nimport localDisplayManager from \"../LocalDisplayManager\"\nimport {pagesEligible} from \"./pageEligibility\"\n\nexport type PageHiddenReason = \"hidden\" | \"replaced\" | \"ineligible\"\n\nexport interface Page {\n  /** Scene app id; the overlay owner while the page shows. */\n  readonly id: string\n  /** The page holds the slot: draw the first frame. */\n  onShown(): void\n  /** The slot was released, taken by another page, or lost with eligibility. */\n  onHidden(reason: PageHiddenReason): void\n}\n\nclass PageHost {\n  private showingPage: Page | null = null\n  private ops: Array<() => void> = []\n  private draining = false\n  private listeners = new Set<(page: Page | null) => void>()\n  private unsubs: Array<() => void> = []\n  private started = false\n\n  start(): void {\n    if (this.started) return\n    this.started = true\n    const check = () => {\n      if (this.showingPage && !pagesEligible()) this.release(\"ineligible\")\n    }\n    this.unsubs.push(\n      useGlassesStore.subscribe(\n        (state) => `${state.connection.state}:${state.deviceModel}:${state.firmwareVersion}`,\n        check,\n      ),\n      useSettingsStore.subscribe((state) => state.getSetting(SETTINGS.custom_dashboard_enabled.key), check),\n    )\n  }\n\n  stop(): void {\n    for (const unsub of this.unsubs) unsub()\n    this.unsubs = []\n    this.release(\"hidden\")\n    this.started = false\n  }\n\n  get showing(): Page | null {\n    return this.showingPage\n  }\n\n  /** Give `page` the slot; no-op when it already shows or pages are not eligible. */\n  show(page: Page): void {\n    this.enqueue(() => {\n      if (this.showingPage === page || !pagesEligible()) return\n      const previous = this.showingPage\n      this.showingPage = page\n      localDisplayManager.setOverlayOwner(page.id)\n      previous?.onHidden(\"replaced\")\n      page.onShown()\n      this.emit()\n    })\n  }\n\n  /** Release the slot if `page` holds it. */\n  hide(page: Page, reason: PageHiddenReason = \"hidden\"): void {\n    this.enqueue(() => {\n      if (this.showingPage !== page) return\n      this.release(reason)\n    })\n  }\n\n  onChange(listener: (page: Page | null) => void): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  private release(reason: PageHiddenReason): void {\n    const page = this.showingPage\n    if (!page) return\n    this.showingPage = null\n    localDisplayManager.setOverlayOwner(null)\n    page.onHidden(reason)\n    this.emit()\n  }\n\n  private emit(): void {\n    for (const listener of Array.from(this.listeners)) listener(this.showingPage)\n  }\n\n  private enqueue(op: () => void): void {\n    this.ops.push(op)\n    if (this.draining) return\n    this.draining = true\n    try {\n      while (this.ops.length) (this.ops.shift() as () => void)()\n    } finally {\n      this.draining = false\n    }\n  }\n}\n\nconst pageHost = new PageHost()\nexport default pageHost\nexport {PageHost}\n"]}
+{"version":3,"file":"PageHost.js","sourceRoot":"","sources":["../../../src/services/pages/PageHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAC,QAAQ,EAAE,gBAAgB,EAAC,MAAM,uBAAuB,CAAA;AAChE,OAAO,mBAAmB,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAA;AAa/C,MAAM,QAAQ;IACJ,WAAW,GAAgB,IAAI,CAAA;IAC/B,GAAG,GAAsB,EAAE,CAAA;IAC3B,QAAQ,GAAG,KAAK,CAAA;IAChB,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAA;IAClD,MAAM,GAAsB,EAAE,CAAA;IAC9B,OAAO,GAAG,KAAK,CAAA;IAEvB,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,aAAa,EAAE;gBAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QACtE,CAAC,CAAA;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,eAAe,CAAC,SAAS,CACvB,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,eAAe,EAAE,EACpF,KAAK,CACN,EACD,gBAAgB,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CACtG,CAAA;IACH,CAAC;IAED,IAAI;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,EAAE,CAAA;QACxC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;IACtB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,mFAAmF;IACnF,IAAI,CAAC,IAAU;QACb,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE;gBAAE,OAAM;YACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAA;YACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;YACvB,mBAAmB,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC5C,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAA;YAC9B,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,IAAI,CAAC,IAAI,EAAE,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC,IAAU;QACb,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;gBAAE,OAAM;YACrC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACxB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,QAAQ,CAAC,QAAqC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;IAEO,OAAO,CAAC,MAAwB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAA;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,mBAAmB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACrB,IAAI,CAAC,IAAI,EAAE,CAAA;IACb,CAAC;IAEO,IAAI;QACV,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC/E,CAAC;IAEO,OAAO,CAAC,EAAc;QAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACjB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM;gBAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAiB,EAAE,CAAA;QAC5D,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACvB,CAAC;IACH,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA;AAC/B,eAAe,QAAQ,CAAA;AACvB,OAAO,EAAC,QAAQ,EAAC,CAAA","sourcesContent":["/**\n * The page host owns the overlay slot: the single native view above the main\n * content. At most one page shows at a time; showing a page replaces whatever\n * was showing, hiding releases the slot and the main content replays. Which\n * app gets the wearer's gestures is the gesture claims' business, not the\n * host's. Show and hide run through one queue so a page\n * that hides itself from inside its own transition is hidden afterwards, never\n * re-entered. Eligibility (Glassly CFW, dashboard enabled) is checked before a\n * show and watched while a page is up.\n */\nimport {useGlassesStore} from \"../../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../../stores/settings\"\nimport localDisplayManager from \"../LocalDisplayManager\"\nimport {pagesEligible} from \"./pageEligibility\"\n\nexport type PageHiddenReason = \"hidden\" | \"replaced\" | \"ineligible\"\n\nexport interface Page {\n  /** Scene app id; the overlay owner while the page shows. */\n  readonly id: string\n  /** The page holds the slot: draw the first frame. */\n  onShown(): void\n  /** The slot was released, taken by another page, or lost with eligibility. */\n  onHidden(reason: PageHiddenReason): void\n}\n\nclass PageHost {\n  private showingPage: Page | null = null\n  private ops: Array<() => void> = []\n  private draining = false\n  private listeners = new Set<(page: Page | null) => void>()\n  private unsubs: Array<() => void> = []\n  private started = false\n\n  start(): void {\n    if (this.started) return\n    this.started = true\n    const check = () => {\n      if (this.showingPage && !pagesEligible()) this.release(\"ineligible\")\n    }\n    this.unsubs.push(\n      useGlassesStore.subscribe(\n        (state) => `${state.connection.state}:${state.deviceModel}:${state.firmwareVersion}`,\n        check,\n      ),\n      useSettingsStore.subscribe((state) => state.getSetting(SETTINGS.custom_dashboard_enabled.key), check),\n    )\n  }\n\n  stop(): void {\n    for (const unsub of this.unsubs) unsub()\n    this.unsubs = []\n    this.release(\"hidden\")\n    this.started = false\n  }\n\n  get showing(): Page | null {\n    return this.showingPage\n  }\n\n  /** Give `page` the slot; no-op when it already shows or pages are not eligible. */\n  show(page: Page): void {\n    this.enqueue(() => {\n      if (this.showingPage === page || !pagesEligible()) return\n      const previous = this.showingPage\n      this.showingPage = page\n      localDisplayManager.setOverlayOwner(page.id)\n      previous?.onHidden(\"replaced\")\n      page.onShown()\n      this.emit()\n    })\n  }\n\n  /** Release the slot if `page` holds it. */\n  hide(page: Page): void {\n    this.enqueue(() => {\n      if (this.showingPage !== page) return\n      this.release(\"hidden\")\n    })\n  }\n\n  onChange(listener: (page: Page | null) => void): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  private release(reason: PageHiddenReason): void {\n    const page = this.showingPage\n    if (!page) return\n    this.showingPage = null\n    localDisplayManager.setOverlayOwner(null)\n    page.onHidden(reason)\n    this.emit()\n  }\n\n  private emit(): void {\n    for (const listener of Array.from(this.listeners)) listener(this.showingPage)\n  }\n\n  private enqueue(op: () => void): void {\n    this.ops.push(op)\n    if (this.draining) return\n    this.draining = true\n    try {\n      while (this.ops.length) (this.ops.shift() as () => void)()\n    } finally {\n      this.draining = false\n    }\n  }\n}\n\nconst pageHost = new PageHost()\nexport default pageHost\nexport {PageHost}\n"]}

package/build/services/pages/overlayApps.d.ts

@@ -1,30 +1,23 @@
 /**
- * The overlay app: the connected miniapp that holds the dashboard role
- * (ADR-0009). It alone may take the overlay slot through
- * `session.display.showView("dashboard")` and has "dashboard" in its
- * `display.views` capability while the glasses are eligible. The runtime
- * records each dashboard miniapp (manifest type "dashboard") as it connects
- * and stops, and who holds the role; the engine never knows what a dashboard
- * draws. Kept free of imports so the runtime and the notification policy can
- * both read it without a cycle.
+ * The overlay apps: the connected miniapps whose manifest type is
+ * "system_dashboard" (the dashboard). They alone may take the overlay slot
+ * through `session.display.showView("dashboard")` and have "dashboard" in
+ * their `display.views` capability while the glasses are eligible. The runtime adds an app when it connects and
+ * removes it when it stops; the engine never knows what any of them draws.
+ * Kept free of imports so the runtime and the notification policy can both
+ * read it without a cycle.
  */
 export type DisplayView = "main" | "dashboard";
-/** `packageName` holds the dashboard role and is connected. */
 export declare function isOverlayApp(packageName: string): boolean;
-/** `packageName` is a connected dashboard miniapp, whether or not it holds the role. */
-export declare function isDashboardApp(packageName: string): boolean;
 export declare function overlayApps(): readonly string[];
-/** The package that holds the dashboard role, connected or not. */
-export declare function activeDashboard(): string | null;
-export declare function setActiveDashboard(packageName: string | null): void;
-export declare function addDashboardApp(packageName: string): void;
-export declare function removeDashboardApp(packageName: string): void;
-/** Record whether a dashboard subscribes to phone notifications (the overlay app is the viewer while it does). */
-export declare function setOverlayViewer(packageName: string, subscribed: boolean): void;
-/** The overlay app presents phone notifications. */
+export declare function addOverlayApp(packageName: string): void;
+export declare function removeOverlayApp(packageName: string): void;
+/** Record whether an overlay app subscribes to phone notifications (it is a viewer while it does). */
+export declare function setOverlayViewer(packageName: string, listening: boolean): void;
+/** An overlay app that presents phone notifications is running. */
 export declare function overlayViewerRunning(): boolean;
 export declare function onOverlayAppsChange(listener: () => void): () => void;
-/** The views `packageName` may draw: main for everyone, the dashboard for the overlay app on eligible glasses. */
+/** The views `packageName` may draw: main for everyone, the dashboard for overlay apps on eligible glasses. */
 export declare function displayViewsFor(packageName: string, eligible: boolean): DisplayView[];
 /** Tests only. */
 export declare function _resetOverlayAppsForTest(): void;

package/build/services/pages/overlayApps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlayApps.d.ts","sourceRoot":"","sources":["../../../src/services/pages/overlayApps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAA;AAS9C,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,WAAW,IAAI,SAAS,MAAM,EAAE,CAE/C;AAED,mEAAmE;AACnE,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAInE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAIzD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,kHAAkH;AAClH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAK/E;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKpE;AAED,kHAAkH;AAClH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,WAAW,EAAE,CAErF;AAMD,kBAAkB;AAClB,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C"}
+{"version":3,"file":"overlayApps.d.ts","sourceRoot":"","sources":["../../../src/services/pages/overlayApps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAA;AAO9C,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,WAAW,IAAI,SAAS,MAAM,EAAE,CAE/C;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAK9E;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKpE;AAED,+GAA+G;AAC/G,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,WAAW,EAAE,CAErF;AAMD,kBAAkB;AAClB,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}

package/build/services/pages/overlayApps.js

@@ -1,65 +1,47 @@
 /**
- * The overlay app: the connected miniapp that holds the dashboard role
- * (ADR-0009). It alone may take the overlay slot through
- * `session.display.showView("dashboard")` and has "dashboard" in its
- * `display.views` capability while the glasses are eligible. The runtime
- * records each dashboard miniapp (manifest type "dashboard") as it connects
- * and stops, and who holds the role; the engine never knows what a dashboard
- * draws. Kept free of imports so the runtime and the notification policy can
- * both read it without a cycle.
+ * The overlay apps: the connected miniapps whose manifest type is
+ * "system_dashboard" (the dashboard). They alone may take the overlay slot
+ * through `session.display.showView("dashboard")` and have "dashboard" in
+ * their `display.views` capability while the glasses are eligible. The runtime adds an app when it connects and
+ * removes it when it stops; the engine never knows what any of them draws.
+ * Kept free of imports so the runtime and the notification policy can both
+ * read it without a cycle.
  */
-/** Connected dashboard miniapps, role or not. */
-const connected = new Set();
-/** Connected dashboards listening to the phone's notifications. */
-const listening = new Set();
-let active = null;
+const apps = new Set();
+/** Overlay apps listening to the phone's notifications: something on the glasses presents them. */
+const viewers = new Set();
 const listeners = new Set();
-/** `packageName` holds the dashboard role and is connected. */
 export function isOverlayApp(packageName) {
-    return packageName === active && connected.has(packageName);
-}
-/** `packageName` is a connected dashboard miniapp, whether or not it holds the role. */
-export function isDashboardApp(packageName) {
-    return connected.has(packageName);
+    return apps.has(packageName);
 }
 export function overlayApps() {
-    return active !== null && connected.has(active) ? [active] : [];
-}
-/** The package that holds the dashboard role, connected or not. */
-export function activeDashboard() {
-    return active;
-}
-export function setActiveDashboard(packageName) {
-    if (active === packageName)
-        return;
-    active = packageName;
-    emit();
+    return [...apps];
 }
-export function addDashboardApp(packageName) {
-    if (connected.has(packageName))
+export function addOverlayApp(packageName) {
+    if (apps.has(packageName))
         return;
-    connected.add(packageName);
+    apps.add(packageName);
     emit();
 }
-export function removeDashboardApp(packageName) {
-    listening.delete(packageName);
-    if (!connected.delete(packageName))
+export function removeOverlayApp(packageName) {
+    viewers.delete(packageName);
+    if (!apps.delete(packageName))
         return;
     emit();
 }
-/** Record whether a dashboard subscribes to phone notifications (the overlay app is the viewer while it does). */
-export function setOverlayViewer(packageName, subscribed) {
-    const was = overlayViewerRunning();
-    if (subscribed && connected.has(packageName))
-        listening.add(packageName);
+/** Record whether an overlay app subscribes to phone notifications (it is a viewer while it does). */
+export function setOverlayViewer(packageName, listening) {
+    const was = viewers.has(packageName);
+    if (listening && apps.has(packageName))
+        viewers.add(packageName);
     else
-        listening.delete(packageName);
-    if (was !== overlayViewerRunning())
+        viewers.delete(packageName);
+    if (was !== viewers.has(packageName))
         emit();
 }
-/** The overlay app presents phone notifications. */
+/** An overlay app that presents phone notifications is running. */
 export function overlayViewerRunning() {
-    return active !== null && connected.has(active) && listening.has(active);
+    return viewers.size > 0;
 }
 export function onOverlayAppsChange(listener) {
     listeners.add(listener);
@@ -67,9 +49,9 @@ export function onOverlayAppsChange(listener) {
         listeners.delete(listener);
     };
 }
-/** The views `packageName` may draw: main for everyone, the dashboard for the overlay app on eligible glasses. */
+/** The views `packageName` may draw: main for everyone, the dashboard for overlay apps on eligible glasses. */
 export function displayViewsFor(packageName, eligible) {
-    return isOverlayApp(packageName) && eligible ? ["main", "dashboard"] : ["main"];
+    return apps.has(packageName) && eligible ? ["main", "dashboard"] : ["main"];
 }
 function emit() {
     for (const listener of Array.from(listeners))
@@ -77,8 +59,7 @@ function emit() {
 }
 /** Tests only. */
 export function _resetOverlayAppsForTest() {
-    connected.clear();
-    listening.clear();
-    active = null;
+    apps.clear();
+    viewers.clear();
 }
 //# sourceMappingURL=overlayApps.js.map

package/build/services/pages/overlayApps.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlayApps.js","sourceRoot":"","sources":["../../../src/services/pages/overlayApps.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The overlay app: the connected miniapp that holds the dashboard role\n * (ADR-0009). It alone may take the overlay slot through\n * `session.display.showView(\"dashboard\")` and has \"dashboard\" in its\n * `display.views` capability while the glasses are eligible. The runtime\n * records each dashboard miniapp (manifest type \"dashboard\") as it connects\n * and stops, and who holds the role; the engine never knows what a dashboard\n * draws. Kept free of imports so the runtime and the notification policy can\n * both read it without a cycle.\n */\n\nexport type DisplayView = \"main\" | \"dashboard\"\n\n/** Connected dashboard miniapps, role or not. */\nconst connected = new Set<string>()\n/** Connected dashboards listening to the phone's notifications. */\nconst listening = new Set<string>()\nlet active: string | null = null\nconst listeners = new Set<() => void>()\n\n/** `packageName` holds the dashboard role and is connected. */\nexport function isOverlayApp(packageName: string): boolean {\n  return packageName === active && connected.has(packageName)\n}\n\n/** `packageName` is a connected dashboard miniapp, whether or not it holds the role. */\nexport function isDashboardApp(packageName: string): boolean {\n  return connected.has(packageName)\n}\n\nexport function overlayApps(): readonly string[] {\n  return active !== null && connected.has(active) ? [active] : []\n}\n\n/** The package that holds the dashboard role, connected or not. */\nexport function activeDashboard(): string | null {\n  return active\n}\n\nexport function setActiveDashboard(packageName: string | null): void {\n  if (active === packageName) return\n  active = packageName\n  emit()\n}\n\nexport function addDashboardApp(packageName: string): void {\n  if (connected.has(packageName)) return\n  connected.add(packageName)\n  emit()\n}\n\nexport function removeDashboardApp(packageName: string): void {\n  listening.delete(packageName)\n  if (!connected.delete(packageName)) return\n  emit()\n}\n\n/** Record whether a dashboard subscribes to phone notifications (the overlay app is the viewer while it does). */\nexport function setOverlayViewer(packageName: string, subscribed: boolean): void {\n  const was = overlayViewerRunning()\n  if (subscribed && connected.has(packageName)) listening.add(packageName)\n  else listening.delete(packageName)\n  if (was !== overlayViewerRunning()) emit()\n}\n\n/** The overlay app presents phone notifications. */\nexport function overlayViewerRunning(): boolean {\n  return active !== null && connected.has(active) && listening.has(active)\n}\n\nexport function onOverlayAppsChange(listener: () => void): () => void {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/** The views `packageName` may draw: main for everyone, the dashboard for the overlay app on eligible glasses. */\nexport function displayViewsFor(packageName: string, eligible: boolean): DisplayView[] {\n  return isOverlayApp(packageName) && eligible ? [\"main\", \"dashboard\"] : [\"main\"]\n}\n\nfunction emit(): void {\n  for (const listener of Array.from(listeners)) listener()\n}\n\n/** Tests only. */\nexport function _resetOverlayAppsForTest(): void {\n  connected.clear()\n  listening.clear()\n  active = null\n}\n"]}
+{"version":3,"file":"overlayApps.js","sourceRoot":"","sources":["../../../src/services/pages/overlayApps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;AAC9B,mGAAmG;AACnG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;AACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;AAEvC,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAM;IACjC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACrB,IAAI,EAAE,CAAA;AACR,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,OAAM;IACrC,IAAI,EAAE,CAAA;AACR,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,SAAkB;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACpC,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;;QAC3D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAChC,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,IAAI,EAAE,CAAA;AAC9C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAoB;IACtD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC,CAAA;AACH,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,QAAiB;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,IAAI;IACX,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,QAAQ,EAAE,CAAA;AAC1D,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC,KAAK,EAAE,CAAA;IACZ,OAAO,CAAC,KAAK,EAAE,CAAA;AACjB,CAAC","sourcesContent":["/**\n * The overlay apps: the connected miniapps whose manifest type is\n * \"system_dashboard\" (the dashboard). They alone may take the overlay slot\n * through `session.display.showView(\"dashboard\")` and have \"dashboard\" in\n * their `display.views` capability while the glasses are eligible. The runtime adds an app when it connects and\n * removes it when it stops; the engine never knows what any of them draws.\n * Kept free of imports so the runtime and the notification policy can both\n * read it without a cycle.\n */\n\nexport type DisplayView = \"main\" | \"dashboard\"\n\nconst apps = new Set<string>()\n/** Overlay apps listening to the phone's notifications: something on the glasses presents them. */\nconst viewers = new Set<string>()\nconst listeners = new Set<() => void>()\n\nexport function isOverlayApp(packageName: string): boolean {\n  return apps.has(packageName)\n}\n\nexport function overlayApps(): readonly string[] {\n  return [...apps]\n}\n\nexport function addOverlayApp(packageName: string): void {\n  if (apps.has(packageName)) return\n  apps.add(packageName)\n  emit()\n}\n\nexport function removeOverlayApp(packageName: string): void {\n  viewers.delete(packageName)\n  if (!apps.delete(packageName)) return\n  emit()\n}\n\n/** Record whether an overlay app subscribes to phone notifications (it is a viewer while it does). */\nexport function setOverlayViewer(packageName: string, listening: boolean): void {\n  const was = viewers.has(packageName)\n  if (listening && apps.has(packageName)) viewers.add(packageName)\n  else viewers.delete(packageName)\n  if (was !== viewers.has(packageName)) emit()\n}\n\n/** An overlay app that presents phone notifications is running. */\nexport function overlayViewerRunning(): boolean {\n  return viewers.size > 0\n}\n\nexport function onOverlayAppsChange(listener: () => void): () => void {\n  listeners.add(listener)\n  return () => {\n    listeners.delete(listener)\n  }\n}\n\n/** The views `packageName` may draw: main for everyone, the dashboard for overlay apps on eligible glasses. */\nexport function displayViewsFor(packageName: string, eligible: boolean): DisplayView[] {\n  return apps.has(packageName) && eligible ? [\"main\", \"dashboard\"] : [\"main\"]\n}\n\nfunction emit(): void {\n  for (const listener of Array.from(listeners)) listener()\n}\n\n/** Tests only. */\nexport function _resetOverlayAppsForTest(): void {\n  apps.clear()\n  viewers.clear()\n}\n"]}

package/build/services/settingsBridge.d.ts

@@ -1,29 +1,28 @@
 /**
  * The settings bridge's vocabulary (session.settings): which engine settings
- * a miniapp with the PLATFORM_SETTINGS permission may read or write, the
- * derived read-only keys the engine computes rather than stores, and the
- * request validation. Pure, so the runtime's handlers stay thin and this can
- * be tested without the native import surface the runtime pulls in.
+ * a system miniapp may read or write, the derived read-only keys the engine
+ * computes rather than stores, and the request validation. Pure, so the
+ * runtime's handlers stay thin and this can be tested without the native
+ * import surface the runtime pulls in.
  *
- * A dashboard miniapp is the usual consumer: it edits the notification and
- * glasses-menu keys the phone's settings screens used to, through the store,
- * so persistence, server sync and the Bluetooth sync of `menu_apps` behave as
- * if a phone screen wrote them. A dashboard's own look is not here; it keeps
- * that in its storage.
+ * The dashboard miniapp is the consumer: it edits the same dashboard,
+ * notification and glasses-menu keys the phone's settings screens used to,
+ * through the store, so persistence, server sync and the Bluetooth sync of
+ * `menu_apps` behave as if a phone screen wrote them.
  */
 export type SettingsBridgeAccess = "read" | "write";
-/** Stored settings the bridge serves, by key, with what a permitted app may do to each. */
+/** Stored settings the bridge serves, by key, with what a system app may do to each. */
 export declare const SETTINGS_BRIDGE_KEYS: Readonly<Record<string, SettingsBridgeAccess>>;
 /**
  * Read-only keys the engine computes: whether the wearer can see the phone,
- * whether the foreground miniapp is drawing on the glasses, the ring's
- * battery, and the package that holds the dashboard role (null for nobody).
- * They change on their own clocks; the runtime pushes them like stored keys.
+ * whether the foreground miniapp is drawing on the glasses, and the ring's
+ * battery. They change on their own clocks; the runtime pushes them like
+ * stored keys.
  */
-export declare const DERIVED_SETTINGS_KEYS: readonly ["phone_active", "foreground_app_on_screen", "ring_battery", "active_dashboard"];
+export declare const DERIVED_SETTINGS_KEYS: readonly ["phone_active", "foreground_app_on_screen", "ring_battery"];
 export type DerivedSettingsKey = (typeof DERIVED_SETTINGS_KEYS)[number];
 export declare function isDerivedSettingsKey(key: string): key is DerivedSettingsKey;
-/** What a permitted app may do with `key`, or null when the bridge does not serve it. */
+/** What a system app may do with `key`, or null when the bridge does not serve it. */
 export declare function settingsBridgeAccess(key: string): SettingsBridgeAccess | null;
 /** Every key the bridge serves, stored then derived. */
 export declare function allSettingsBridgeKeys(): string[];