@glassly/engine 0.3.3-dev.669 → 0.3.4-dev.674

package/build/engine.d.ts

@@ -56,26 +56,33 @@ export declare const engine: {
             onAdvert: (cb: (advert: import("@glassly/bluetooth-sdk").KeyboardAdvertEvent) => void) => (() => void);
             onPairing: (cb: (prompt: import("@glassly/bluetooth-sdk").KeyboardPairingEvent) => void) => (() => void);
         };
-        controller: {
-            connectDefault: () => Promise<void>;
-            disconnect: () => Promise<void>;
-            forget: () => Promise<void>;
-            status: () => import("./facades/glasses").ControllerStatusSnapshot;
-            onStatus: (cb: (status: import("./facades/glasses").ControllerStatusSnapshot) => void) => (() => void);
+        controllers: {
+            list: () => import("@glassly/bluetooth-sdk").PairedController[];
+            onList: (cb: (controllers: import("@glassly/bluetooth-sdk").PairedController[]) => void) => (() => void);
+            statuses: () => Record<string, import("@glassly/bluetooth-sdk").ControllerStatus>;
+            status: (id: string) => import("@glassly/bluetooth-sdk").ControllerStatus | undefined;
+            onStatus: (cb: (statuses: Record<string, import("@glassly/bluetooth-sdk").ControllerStatus>) => void) => (() => void);
+            connected: () => import("@glassly/bluetooth-sdk").ControllerStatus[];
+            isConnected: (model?: string) => boolean;
+            connect: (id: string) => Promise<void>;
+            connectAll: () => Promise<void>;
+            cancelAttempt: () => Promise<void>;
+            disconnect: (id: string) => Promise<void>;
+            forget: (id: string) => Promise<void>;
         };
         neuralBand: {
             setMetaSession: (accessToken: string, userId: string) => Promise<void>;
             clearMetaSession: () => Promise<void>;
             hasMetaSession: () => Promise<boolean>;
-            isClaimed: () => Promise<boolean>;
+            isClaimed: (id: string) => Promise<boolean>;
             claimStatus: () => import(".").NeuralBandClaimStatus;
             resetClaim: () => void;
             onClaimStatus: (cb: (status: import(".").NeuralBandClaimStatus) => void) => (() => void);
-            setHandwriting: (enabled: boolean) => Promise<void>;
-            handwritingStatus: () => import(".").NeuralBandHandwritingStatus;
-            onHandwritingStatus: (cb: (status: import(".").NeuralBandHandwritingStatus) => void) => (() => void);
-            setPointer: (enabled: boolean) => Promise<void>;
-            setHand: (hand: "left" | "right") => Promise<void>;
+            setHandwriting: (id: string, enabled: boolean) => Promise<void>;
+            handwritingStatus: (id: string) => import(".").NeuralBandHandwritingStatus;
+            onHandwritingStatus: (cb: (update: import(".").NeuralBandHandwritingUpdate) => void) => (() => void);
+            setPointer: (id: string, enabled: boolean) => Promise<void>;
+            setHand: (id: string, hand: "left" | "right") => Promise<void>;
         };
         audio: {
             getMediaVolume: () => Promise<import("@glassly/bluetooth-sdk").GlassesMediaVolumeGetResult>;
@@ -139,6 +146,24 @@ export declare const engine: {
             deleteModel: (_code?: string | undefined) => Promise<void>;
         };
     };
+    /** On-device LLM model management (Settings > AI Models). */
+    ai: {
+        local: {
+            models: () => import(".").LocalLlmModelConfig[];
+            selectedModelId: () => import(".").LocalLlmModelId;
+            select: (id: import(".").LocalLlmModelId) => Promise<void>;
+            isDownloaded: (id?: import(".").LocalLlmModelId) => Promise<boolean>;
+            downloadedModelIds: () => Promise<import(".").LocalLlmModelId[]>;
+            download: (id?: import(".").LocalLlmModelId) => Promise<void>;
+            cancelDownload: () => Promise<void>;
+            deleteModel: (id?: import(".").LocalLlmModelId) => Promise<void>;
+            status: () => import(".").LocalLlmDownloadStatus | null;
+            onStatusChanged: (listener: (status: import(".").LocalLlmDownloadStatus | null) => void) => (() => void);
+            isLoaded: () => boolean;
+            unload: () => Promise<void>;
+            formatBytes: (bytes: number) => string;
+        };
+    };
     /** Cloud live-session status + account ops — engine owns the client. */
     session: {
         status: () => import(".").CloudClientStatusSnapshot;
@@ -265,8 +290,6 @@ export declare const engine: {
         scan: (model: import("@glassly/bluetooth-sdk").DeviceModel) => Promise<void>;
         scanning: () => boolean;
         onScanning: (cb: (scanning: boolean) => void) => (() => void);
-        scanningController: () => boolean;
-        onScanningController: (cb: (scanning: boolean) => void) => (() => void);
         otherBtConnected: () => boolean;
         onOtherBtConnected: (cb: (connected: boolean) => void) => (() => void);
         searchResults: () => {
@@ -285,6 +308,7 @@ export declare const engine: {
         setDefault: (device: import("@glassly/bluetooth-sdk").Device | null) => Promise<void>;
         setBluetoothClassicTarget: (device: import("@glassly/bluetooth-sdk").Device) => Promise<void>;
         abandonAttempt: () => Promise<void>;
+        abandonControllerAttempt: () => Promise<void>;
         onPairFailure: (cb: (event: import("@glassly/bluetooth-sdk").PairFailureEvent) => void) => (() => void);
         onGlassesNotReady: (cb: (event: import("@glassly/bluetooth-sdk").GlassesNotReadyEvent) => void) => (() => void);
         waitForReady: (options?: import("./facades/pairing").PairingReadyWaitOptions) => Promise<boolean>;

package/build/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,SAAS,EAAkD,aAAa,EAAC,MAAM,qBAAqB,CAAA;AA4C5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IAgG7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmCrC,wEAAwE;;;;;;;;IAExE,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;;gBA5HV,CAAC;mBAAiB,CAAC;;;gBAM5F,CADA;mBAAiB,CAAC;;;;;;;;;;;;;;;;;IAyHpB,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;;IAE9E,qFAAqF;;;;IAErF,4EAA4E;;;;;;;;;;;IAE5E,+EAA+E;;;;;;;;;;;;IAE/E,kFAAkF;;;;;+BAlJ3D,CAAC;;;+BAUf,CAAC;;;;;;;;;;;;IA0IV,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGpF,CAAA"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,SAAS,EAAkD,aAAa,EAAC,MAAM,qBAAqB,CAAA;AA6C5G,eAAO,MAAM,MAAM;IACjB,2EAA2E;;IAE3E,8EAA8E;;IAE9E;iDAC6C;;IAgG7C;;yCAEqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmCrC,6DAA6D;;;;;;;;;;;;;;;;;;IAE7D,wEAAwE;;;;;;;;IAExE,sEAAsE;;;;;;;;;;;;IAEtE,qFAAqF;;;;gBA9HzC,CAAA;mBAAiB,CAAC;;;gBAId,CAAC;mBAAiB,CAAC;;;;;;;;;;;;;;;;;IA4HnE,qEAAqE;;;;IAErE,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtF,6EAA6E;;;;;;;;;;;;IAE7E,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;IAEjF,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9C,uDAAuD;;;;;;;;;;;;;;;;IAEvD,8EAA8E;;;;;;;;IAE9E,qFAAqF;;;;IAErF,4EAA4E;;;;;;;;;;;IAE5E,+EAA+E;;;;;;;;;;;;IAE/E,kFAAkF;;;;;+BArJxD,CAAA;;;+BAUyC,CAAC;;;;;;;;;;;;IA6IpE,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGpF,CAAA"}

package/build/engine.js

@@ -33,6 +33,7 @@ import { gallerySyncService } from "./services/asg/gallerySyncService";
 import { glasses } from "./facades/glasses";
 import { display } from "./facades/display";
 import { speech } from "./facades/speech";
+import { ai } from "./facades/ai";
 import { session } from "./facades/session";
 import { settings } from "./facades/settings";
 import { dev } from "./facades/dev";
@@ -189,6 +190,8 @@ export const engine = {
     },
     glasses,
     speech,
+    /** On-device LLM model management (Settings > AI Models). */
+    ai,
     /** Cloud live-session status + account ops — engine owns the client. */
     session,
     /** Typed keyed user settings over the engine-owned settings store. */

package/build/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `engine` — the namespaced OEM-facing engine API (the \"(A) host API\" from the\n * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a\n * typed facade over the runtime. (Exported from the `@glassly/engine` module, whose\n * name stays `engine` in code; the public API surface is `engine`.)\n *\n * It grows one facade at a time. The migration-era flat store/service exports\n * remain in a private Glassly host package; they shrink as screens move onto\n * `engine.*`.\n */\nimport {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from \"./runtime/bootstrap\"\nimport {cloudClientService} from \"./services/CloudClientService\"\nimport {hydrateDeviceStore, demoteOrphanedDefaultWearable} from \"./services/DeviceStoreHydration\"\nimport {startPairedGlassesLatch, stopPairedGlassesLatch} from \"./services/PairedGlassesLatch\"\nimport {startMiniappPauseCoordinator, stopMiniappPauseCoordinator} from \"./services/MiniappPauseCoordinator\"\nimport {startGlassesSettingsSync, stopGlassesSettingsSync} from \"./services/GlassesSettingsSync\"\nimport {startGlassesStatusProjection, stopGlassesStatusProjection} from \"./services/GlassesStatusProjection\"\nimport {startOtaService, stopOtaService} from \"./services/OtaService\"\nimport {startAudioCloudUplink, stopAudioCloudUplink} from \"./services/AudioCloudUplink\"\nimport sonioxDirectService from \"./services/soniox/SonioxDirectService\"\nimport {startSupportProfileSync, stopSupportProfileSync} from \"./services/SupportProfileSync\"\nimport {startDeviceEventRouter, stopDeviceEventRouter} from \"./services/DeviceEventRouter\"\nimport {startPhoneActivityTracking, stopPhoneActivityTracking} from \"./services/PhoneActivity\"\nimport {startPhoneNotificationsSync, stopPhoneNotificationsSync} from \"./services/PhoneNotificationsSync\"\nimport {startSpeakerIdSync, stopSpeakerIdSync} from \"./services/SpeakerIdSync\"\nimport {startNeuralBandSettingsSync, stopNeuralBandSettingsSync} from \"./services/neuralBand/NeuralBandSettingsSync\"\nimport {startCaptionsTesterReportService, stopCaptionsTesterReportService} from \"./services/CaptionsTesterReportService\"\nimport {startJSCrashloopReportService, stopJSCrashloopReportService} from \"./services/JSCrashloopReportService\"\nimport {ensureMiniappEngine, stopMiniappEngine} from \"./services/MiniappEngine\"\nimport localMiniappRuntime from \"./services/LocalMiniappRuntime\"\nimport displayProcessor from \"./services/DisplayProcessor\"\nimport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nimport {glasses} from \"./facades/glasses\"\nimport {display} from \"./facades/display\"\nimport {speech} from \"./facades/speech\"\nimport {session} from \"./facades/session\"\nimport {settings} from \"./facades/settings\"\nimport {dev} from \"./facades/dev\"\nimport {reports} from \"./facades/reports\"\nimport {ota} from \"./facades/ota\"\nimport {gallery} from \"./facades/gallery\"\nimport {miniapps} from \"./facades/miniapps\"\nimport {pairing} from \"./facades/pairing\"\nimport {phoneNotifications} from \"./facades/phoneNotifications\"\nimport {permissions} from \"./facades/permissions\"\nimport {notifications} from \"./facades/notifications\"\nimport {maps} from \"./facades/maps\"\nimport {memory} from \"./facades/memory\"\nimport {speakers} from \"./facades/speakers\"\nimport {providerKeys} from \"./facades/providerKeys\"\nimport {logBuffer} from \"./utils/devLogging\"\nimport pageHost from \"./services/pages/PageHost\"\nimport gestureDotsService from \"./services/GestureDotsService\"\n\nexport const engine = {\n  /** Front door — hand engine auth + config, then start/stop the runtime. */\n  configure,\n  /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */\n  updateUiSeams,\n  /** Start the runtime: mark started + construct/connect the cloud client + begin\n   * syncing device settings to the glasses. */\n  async start() {\n    // Reports attach recent phone logs, so engine owns console interception for\n    // OEM hosts too. Idempotent; the Glassly host may start it earlier.\n    logBuffer.startConsoleInterception()\n    await bootstrapStart()\n    // Construct + connect the cloud client so the documented configure()+start()\n    // lifecycle yields a live engine.session for OEMs. Idempotent for repeated\n    // start() calls.\n    cloudClientService.init()\n    // Project native device status -> the engine stores (the inbound feed the rest\n    // of the runtime reads). Established first so the stores are live before the\n    // syncs below react to them.\n    startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent(\"glasses_connection_state\", changed))\n    // Lock + foreground state, read by the dashboard's notification gate and\n    // the G2 notification ctrl below; up before either consumer.\n    startPhoneActivityTracking()\n    // The overlay slot's owner: the designated dashboard miniapp's page shows\n    // through it (ADR-0006), so it is up before the miniapp runtime.\n    pageHost.start()\n    gestureDotsService.start()\n    // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,\n    // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->\n    // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the\n    // Glassly app's MantleManager.\n    startDeviceEventRouter()\n    // Hydration contract: the native DeviceStore is in-memory and starts empty\n    // every launch; seed it from the persisted settings BEFORE start() resolves\n    // so every post-start getDefaultDevice() read is a trustworthy two-state\n    // answer (no false \"absent\" for genuinely-paired users at cold start).\n    // Ordered before startGlassesSettingsSync so the settings load can't\n    // double-push through the change subscription. A failed hydration must not\n    // brick the runtime: start() continues, and the guards that consume\n    // hasDefaultDevice() see the rejection and fail open.\n    try {\n      await hydrateDeviceStore()\n      // Boot repair: a persisted default_wearable without a native default\n      // device (identity abandoned mid-pairing, or resurrected from the server\n      // before identity stopped syncing) demotes to pending_wearable so hosts\n      // render finish-pairing instead of a connect that would throw.\n      await demoteOrphanedDefaultWearable()\n    } catch (error) {\n      console.warn(\"engine.start: device-store hydration failed:\", error instanceof Error ? error.message : error)\n    }\n    // After the settings load so an already-paired phone latches on this start.\n    startPairedGlassesLatch()\n    // Pause local miniapps while the paired glasses stay disconnected. Reads\n    // the pairing identity, so after the settings load like the latch.\n    startMiniappPauseCoordinator()\n    // Project the glasses' OTA events into the store for the engine.ota read surface.\n    startOtaService()\n    // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription\n    // works for any host (not just the Glassly app's host-side MantleManager fork).\n    startAudioCloudUplink()\n    // Phone -> Soniox direct transcription (user-supplied API key). Started\n    // after device-store hydration so the persisted key is already loaded.\n    sonioxDirectService.start()\n    // Not awaited: the exchange behind it is a Core round trip with no client\n    // deadline, and start() must resolve offline. The glasses get the token\n    // when it lands; identity resolution joins the same single-flight exchange.\n    void cloudClientService.syncCoreTokenToBluetooth().catch((error) => {\n      console.warn(\n        \"engine.start: initial Cloud core token sync failed:\",\n        error instanceof Error ? error.message : error,\n      )\n    })\n    startSupportProfileSync()\n    // Push device-setting changes to the glasses for ANY host, so\n    // engine.glasses.settings.set() reaches the device (not just the Glassly app).\n    startGlassesSettingsSync()\n    // Same for phone-notification config -> the native listener (Android).\n    startPhoneNotificationsSync()\n    // On-device speaker identification: sync the enabled setting + enrolled\n    // profile centroids to the native SpeakerIdEngine, and start the resolver\n    // that annotates cloud transcripts with resolved speaker identities.\n    startSpeakerIdSync()\n    // Meta Neural Band: push the air mouse and wearing-hand settings to the band on connect.\n    startNeuralBandSettingsSync()\n    // Android internal/e2e: laptop captions tester can broadcast a failure intent;\n    // engine owns turning that into a Cloud report.\n    startCaptionsTesterReportService()\n    // JSRuntime crashloop-disabled is runtime state; engine owns filing the\n    // automatic report while hosts only render alert/telemetry side effects.\n    startJSCrashloopReportService()\n    // Bring up the local-miniapp engine so a bare OEM can run JSRuntime miniapps:\n    // the LocalMiniappRuntime (registry + WebView bridge), the JSRuntime router\n    // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor\n    // (layout arbitration over the engine stores), and the gallery-sync service.\n    // All idempotent — when the Glassly app's host bootstrap also calls these, the\n    // second call is a no-op. Host-only crashloop telemetry is attached\n    // separately by the Glassly app.\n    localMiniappRuntime.initialize()\n    ensureMiniappEngine()\n    displayProcessor.attachToRuntime()\n    gallerySyncService.initialize()\n  },\n  /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.\n   * Each step is guarded so one failing teardown can't skip the rest and leak\n   * the remaining runtime services. */\n  async stop() {\n    const safely = async (label: string, step: () => unknown): Promise<void> => {\n      try {\n        await step()\n      } catch (error) {\n        console.warn(`engine.stop: ${label} failed:`, error)\n      }\n    }\n    await safely(\"glasses settings sync\", stopGlassesSettingsSync)\n    await safely(\"paired glasses latch\", stopPairedGlassesLatch)\n    await safely(\"miniapp pause coordinator\", stopMiniappPauseCoordinator)\n    await safely(\"glasses status projection\", stopGlassesStatusProjection)\n    await safely(\"device event router\", stopDeviceEventRouter)\n    await safely(\"page host\", () => pageHost.stop())\n    await safely(\"gesture dots service\", () => gestureDotsService.stop())\n    await safely(\"ota service\", stopOtaService)\n    await safely(\"audio cloud uplink\", stopAudioCloudUplink)\n    await safely(\"soniox direct service\", () => sonioxDirectService.stop())\n    await safely(\"support profile sync\", stopSupportProfileSync)\n    await safely(\"phone notifications sync\", stopPhoneNotificationsSync)\n    await safely(\"phone activity tracking\", stopPhoneActivityTracking)\n    await safely(\"speaker id sync\", stopSpeakerIdSync)\n    await safely(\"neural band settings sync\", stopNeuralBandSettingsSync)\n    await safely(\"captions tester report service\", stopCaptionsTesterReportService)\n    await safely(\"js crashloop report service\", stopJSCrashloopReportService)\n    await safely(\"miniapp engine\", stopMiniappEngine)\n    await safely(\"local miniapp runtime\", () => localMiniappRuntime.cleanup())\n    await safely(\"display processor\", () => displayProcessor.detachFromRuntime())\n    await safely(\"gallery sync service\", () => gallerySyncService.cleanup())\n    await safely(\"cloud client\", () => cloudClientService.shutdown())\n    await safely(\"bootstrap\", bootstrapStop)\n  },\n  glasses,\n  speech,\n  /** Cloud live-session status + account ops — engine owns the client. */\n  session,\n  /** Typed keyed user settings over the engine-owned settings store. */\n  settings,\n  /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */\n  dev,\n  /** Bug-report, automatic runtime report, and feedback submission. */\n  reports,\n  /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */\n  ota,\n  /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */\n  gallery,\n  /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */\n  miniapps,\n  /** First-time glasses discovery + pairing. */\n  pairing,\n  /** Phone→glasses notification forwarding (Android). */\n  phoneNotifications,\n  /** OS permissions (check/request/openSettings + per-miniapp requirements). */\n  permissions,\n  /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */\n  notifications,\n  /** Maps providers — user-supplied Mapbox access token (Settings > Keys). */\n  maps,\n  /** Shared user-scoped memory timeline (Settings > Memory + session.memory). */\n  memory,\n  /** Device-local voice profiles for on-device speaker ID (Settings > Speakers). */\n  speakers,\n  /** AI/voice provider key validation — user-supplied keys (Settings > API Keys). */\n  providerKeys,\n  display,\n}\n"]}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `engine` — the namespaced OEM-facing engine API (the \"(A) host API\" from the\n * Phase-1 contract). Host UI calls `engine.<domain>.<method>()`; each domain is a\n * typed facade over the runtime. (Exported from the `@glassly/engine` module, whose\n * name stays `engine` in code; the public API surface is `engine`.)\n *\n * It grows one facade at a time. The migration-era flat store/service exports\n * remain in a private Glassly host package; they shrink as screens move onto\n * `engine.*`.\n */\nimport {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from \"./runtime/bootstrap\"\nimport {cloudClientService} from \"./services/CloudClientService\"\nimport {hydrateDeviceStore, demoteOrphanedDefaultWearable} from \"./services/DeviceStoreHydration\"\nimport {startPairedGlassesLatch, stopPairedGlassesLatch} from \"./services/PairedGlassesLatch\"\nimport {startMiniappPauseCoordinator, stopMiniappPauseCoordinator} from \"./services/MiniappPauseCoordinator\"\nimport {startGlassesSettingsSync, stopGlassesSettingsSync} from \"./services/GlassesSettingsSync\"\nimport {startGlassesStatusProjection, stopGlassesStatusProjection} from \"./services/GlassesStatusProjection\"\nimport {startOtaService, stopOtaService} from \"./services/OtaService\"\nimport {startAudioCloudUplink, stopAudioCloudUplink} from \"./services/AudioCloudUplink\"\nimport sonioxDirectService from \"./services/soniox/SonioxDirectService\"\nimport {startSupportProfileSync, stopSupportProfileSync} from \"./services/SupportProfileSync\"\nimport {startDeviceEventRouter, stopDeviceEventRouter} from \"./services/DeviceEventRouter\"\nimport {startPhoneActivityTracking, stopPhoneActivityTracking} from \"./services/PhoneActivity\"\nimport {startPhoneNotificationsSync, stopPhoneNotificationsSync} from \"./services/PhoneNotificationsSync\"\nimport {startSpeakerIdSync, stopSpeakerIdSync} from \"./services/SpeakerIdSync\"\nimport {startNeuralBandSettingsSync, stopNeuralBandSettingsSync} from \"./services/neuralBand/NeuralBandSettingsSync\"\nimport {startCaptionsTesterReportService, stopCaptionsTesterReportService} from \"./services/CaptionsTesterReportService\"\nimport {startJSCrashloopReportService, stopJSCrashloopReportService} from \"./services/JSCrashloopReportService\"\nimport {ensureMiniappEngine, stopMiniappEngine} from \"./services/MiniappEngine\"\nimport localMiniappRuntime from \"./services/LocalMiniappRuntime\"\nimport displayProcessor from \"./services/DisplayProcessor\"\nimport {gallerySyncService} from \"./services/asg/gallerySyncService\"\nimport {glasses} from \"./facades/glasses\"\nimport {display} from \"./facades/display\"\nimport {speech} from \"./facades/speech\"\nimport {ai} from \"./facades/ai\"\nimport {session} from \"./facades/session\"\nimport {settings} from \"./facades/settings\"\nimport {dev} from \"./facades/dev\"\nimport {reports} from \"./facades/reports\"\nimport {ota} from \"./facades/ota\"\nimport {gallery} from \"./facades/gallery\"\nimport {miniapps} from \"./facades/miniapps\"\nimport {pairing} from \"./facades/pairing\"\nimport {phoneNotifications} from \"./facades/phoneNotifications\"\nimport {permissions} from \"./facades/permissions\"\nimport {notifications} from \"./facades/notifications\"\nimport {maps} from \"./facades/maps\"\nimport {memory} from \"./facades/memory\"\nimport {speakers} from \"./facades/speakers\"\nimport {providerKeys} from \"./facades/providerKeys\"\nimport {logBuffer} from \"./utils/devLogging\"\nimport pageHost from \"./services/pages/PageHost\"\nimport gestureDotsService from \"./services/GestureDotsService\"\n\nexport const engine = {\n  /** Front door — hand engine auth + config, then start/stop the runtime. */\n  configure,\n  /** Merge host-UI seams on a running runtime (scan overlay, wifi setup, …). */\n  updateUiSeams,\n  /** Start the runtime: mark started + construct/connect the cloud client + begin\n   * syncing device settings to the glasses. */\n  async start() {\n    // Reports attach recent phone logs, so engine owns console interception for\n    // OEM hosts too. Idempotent; the Glassly host may start it earlier.\n    logBuffer.startConsoleInterception()\n    await bootstrapStart()\n    // Construct + connect the cloud client so the documented configure()+start()\n    // lifecycle yields a live engine.session for OEMs. Idempotent for repeated\n    // start() calls.\n    cloudClientService.init()\n    // Project native device status -> the engine stores (the inbound feed the rest\n    // of the runtime reads). Established first so the stores are live before the\n    // syncs below react to them.\n    startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent(\"glasses_connection_state\", changed))\n    // Lock + foreground state, read by the dashboard's notification gate and\n    // the G2 notification ctrl below; up before either consumer.\n    startPhoneActivityTracking()\n    // The overlay slot's owner: the designated dashboard miniapp's page shows\n    // through it (ADR-0006), so it is up before the miniapp runtime.\n    pageHost.start()\n    gestureDotsService.start()\n    // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,\n    // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->\n    // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the\n    // Glassly app's MantleManager.\n    startDeviceEventRouter()\n    // Hydration contract: the native DeviceStore is in-memory and starts empty\n    // every launch; seed it from the persisted settings BEFORE start() resolves\n    // so every post-start getDefaultDevice() read is a trustworthy two-state\n    // answer (no false \"absent\" for genuinely-paired users at cold start).\n    // Ordered before startGlassesSettingsSync so the settings load can't\n    // double-push through the change subscription. A failed hydration must not\n    // brick the runtime: start() continues, and the guards that consume\n    // hasDefaultDevice() see the rejection and fail open.\n    try {\n      await hydrateDeviceStore()\n      // Boot repair: a persisted default_wearable without a native default\n      // device (identity abandoned mid-pairing, or resurrected from the server\n      // before identity stopped syncing) demotes to pending_wearable so hosts\n      // render finish-pairing instead of a connect that would throw.\n      await demoteOrphanedDefaultWearable()\n    } catch (error) {\n      console.warn(\"engine.start: device-store hydration failed:\", error instanceof Error ? error.message : error)\n    }\n    // After the settings load so an already-paired phone latches on this start.\n    startPairedGlassesLatch()\n    // Pause local miniapps while the paired glasses stay disconnected. Reads\n    // the pairing identity, so after the settings load like the latch.\n    startMiniappPauseCoordinator()\n    // Project the glasses' OTA events into the store for the engine.ota read surface.\n    startOtaService()\n    // Forward glasses mic_lc3 frames to the v2 cloud session so cloud transcription\n    // works for any host (not just the Glassly app's host-side MantleManager fork).\n    startAudioCloudUplink()\n    // Phone -> Soniox direct transcription (user-supplied API key). Started\n    // after device-store hydration so the persisted key is already loaded.\n    sonioxDirectService.start()\n    // Not awaited: the exchange behind it is a Core round trip with no client\n    // deadline, and start() must resolve offline. The glasses get the token\n    // when it lands; identity resolution joins the same single-flight exchange.\n    void cloudClientService.syncCoreTokenToBluetooth().catch((error) => {\n      console.warn(\n        \"engine.start: initial Cloud core token sync failed:\",\n        error instanceof Error ? error.message : error,\n      )\n    })\n    startSupportProfileSync()\n    // Push device-setting changes to the glasses for ANY host, so\n    // engine.glasses.settings.set() reaches the device (not just the Glassly app).\n    startGlassesSettingsSync()\n    // Same for phone-notification config -> the native listener (Android).\n    startPhoneNotificationsSync()\n    // On-device speaker identification: sync the enabled setting + enrolled\n    // profile centroids to the native SpeakerIdEngine, and start the resolver\n    // that annotates cloud transcripts with resolved speaker identities.\n    startSpeakerIdSync()\n    // Meta Neural Band: push the air mouse and wearing-hand settings to the band on connect.\n    startNeuralBandSettingsSync()\n    // Android internal/e2e: laptop captions tester can broadcast a failure intent;\n    // engine owns turning that into a Cloud report.\n    startCaptionsTesterReportService()\n    // JSRuntime crashloop-disabled is runtime state; engine owns filing the\n    // automatic report while hosts only render alert/telemetry side effects.\n    startJSCrashloopReportService()\n    // Bring up the local-miniapp engine so a bare OEM can run JSRuntime miniapps:\n    // the LocalMiniappRuntime (registry + WebView bridge), the JSRuntime router\n    // (crust-bound spawn/dispatch pump + launcher wiring), the DisplayProcessor\n    // (layout arbitration over the engine stores), and the gallery-sync service.\n    // All idempotent — when the Glassly app's host bootstrap also calls these, the\n    // second call is a no-op. Host-only crashloop telemetry is attached\n    // separately by the Glassly app.\n    localMiniappRuntime.initialize()\n    ensureMiniappEngine()\n    displayProcessor.attachToRuntime()\n    gallerySyncService.initialize()\n  },\n  /** Stop the runtime: tear down the settings sync + cloud client + mark stopped.\n   * Each step is guarded so one failing teardown can't skip the rest and leak\n   * the remaining runtime services. */\n  async stop() {\n    const safely = async (label: string, step: () => unknown): Promise<void> => {\n      try {\n        await step()\n      } catch (error) {\n        console.warn(`engine.stop: ${label} failed:`, error)\n      }\n    }\n    await safely(\"glasses settings sync\", stopGlassesSettingsSync)\n    await safely(\"paired glasses latch\", stopPairedGlassesLatch)\n    await safely(\"miniapp pause coordinator\", stopMiniappPauseCoordinator)\n    await safely(\"glasses status projection\", stopGlassesStatusProjection)\n    await safely(\"device event router\", stopDeviceEventRouter)\n    await safely(\"page host\", () => pageHost.stop())\n    await safely(\"gesture dots service\", () => gestureDotsService.stop())\n    await safely(\"ota service\", stopOtaService)\n    await safely(\"audio cloud uplink\", stopAudioCloudUplink)\n    await safely(\"soniox direct service\", () => sonioxDirectService.stop())\n    await safely(\"support profile sync\", stopSupportProfileSync)\n    await safely(\"phone notifications sync\", stopPhoneNotificationsSync)\n    await safely(\"phone activity tracking\", stopPhoneActivityTracking)\n    await safely(\"speaker id sync\", stopSpeakerIdSync)\n    await safely(\"neural band settings sync\", stopNeuralBandSettingsSync)\n    await safely(\"captions tester report service\", stopCaptionsTesterReportService)\n    await safely(\"js crashloop report service\", stopJSCrashloopReportService)\n    await safely(\"miniapp engine\", stopMiniappEngine)\n    await safely(\"local miniapp runtime\", () => localMiniappRuntime.cleanup())\n    await safely(\"display processor\", () => displayProcessor.detachFromRuntime())\n    await safely(\"gallery sync service\", () => gallerySyncService.cleanup())\n    await safely(\"cloud client\", () => cloudClientService.shutdown())\n    await safely(\"bootstrap\", bootstrapStop)\n  },\n  glasses,\n  speech,\n  /** On-device LLM model management (Settings > AI Models). */\n  ai,\n  /** Cloud live-session status + account ops — engine owns the client. */\n  session,\n  /** Typed keyed user settings over the engine-owned settings store. */\n  settings,\n  /** Developer/debug surface (backend+cloud URL overrides, reconnect, min version). */\n  dev,\n  /** Bug-report, automatic runtime report, and feedback submission. */\n  reports,\n  /** Firmware OTA read/observe surface (updateAvailable/status + on* subscriptions). */\n  ota,\n  /** Gallery sync: status/onStatus · onNotice (host renders) · sync/cancel. */\n  gallery,\n  /** Miniapp lifecycle (the WebView bridge primitives are exported separately). */\n  miniapps,\n  /** First-time glasses discovery + pairing. */\n  pairing,\n  /** Phone→glasses notification forwarding (Android). */\n  phoneNotifications,\n  /** OS permissions (check/request/openSettings + per-miniapp requirements). */\n  permissions,\n  /** Inbound alerts engine→host (crashloop, version-incompatible, connection loss). */\n  notifications,\n  /** Maps providers — user-supplied Mapbox access token (Settings > Keys). */\n  maps,\n  /** Shared user-scoped memory timeline (Settings > Memory + session.memory). */\n  memory,\n  /** Device-local voice profiles for on-device speaker ID (Settings > Speakers). */\n  speakers,\n  /** AI/voice provider key validation — user-supplied keys (Settings > API Keys). */\n  providerKeys,\n  display,\n}\n"]}

package/build/facades/ai.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ai facade — `engine.ai.local`: the on-device LLM model that serves
+ * session.ai calls routed to the phone (forceLocal / localFallback). Thin
+ * passthrough over LocalLlmModelManager and LocalLlmProvider so Settings >
+ * AI Models can list, pick, download, and delete models without reaching
+ * into engine internals.
+ */
+import { type LocalLlmDownloadStatus, type LocalLlmModelConfig, type LocalLlmModelId } from "../services/LocalLlmModelManager";
+export declare const ai: {
+    local: {
+        /** The catalog, in dropdown order. */
+        models: () => LocalLlmModelConfig[];
+        /** The Settings > AI Models pick. */
+        selectedModelId: () => LocalLlmModelId;
+        select: (id: LocalLlmModelId) => Promise<void>;
+        isDownloaded: (id?: LocalLlmModelId) => Promise<boolean>;
+        downloadedModelIds: () => Promise<LocalLlmModelId[]>;
+        download: (id?: LocalLlmModelId) => Promise<void>;
+        cancelDownload: () => Promise<void>;
+        /** Removes the files and drops the resident runner if it was this model. */
+        deleteModel: (id?: LocalLlmModelId) => Promise<void>;
+        status: () => LocalLlmDownloadStatus | null;
+        /** Subscribe to download status changes; fires immediately, returns an unsubscribe. */
+        onStatusChanged: (listener: (status: LocalLlmDownloadStatus | null) => void) => (() => void);
+        /** Whether a model is resident in memory right now. */
+        isLoaded: () => boolean;
+        /** Drop the resident model (memory pressure, debugging). */
+        unload: () => Promise<void>;
+        formatBytes: (bytes: number) => string;
+    };
+};
+//# sourceMappingURL=ai.d.ts.map

package/build/facades/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/facades/ai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAA6B,EAE3B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAA;AAGzC,eAAO,MAAM,EAAE;;QAEX,sCAAsC;sBAC1B,mBAAmB,EAAE;QACjC,qCAAqC;+BAChB,eAAe;qBACvB,eAAe,KAAG,OAAO,CAAC,IAAI,CAAC;4BACxB,eAAe,KAAG,OAAO,CAAC,OAAO,CAAC;kCAC9B,OAAO,CAAC,eAAe,EAAE,CAAC;wBAClC,eAAe,KAAG,OAAO,CAAC,IAAI,CAAC;8BAC3B,OAAO,CAAC,IAAI,CAAC;QACjC,4EAA4E;2BACnD,eAAe,KAAG,OAAO,CAAC,IAAI,CAAC;sBAK5C,sBAAsB,GAAG,IAAI;QACzC,uFAAuF;oCAC3D,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;QAE1F,uDAAuD;wBACzC,OAAO;QACrB,4DAA4D;sBAChD,OAAO,CAAC,IAAI,CAAC;6BACJ,MAAM,KAAG,MAAM;;CAEvC,CAAA"}

package/build/facades/ai.js

@@ -0,0 +1,38 @@
+/**
+ * ai facade — `engine.ai.local`: the on-device LLM model that serves
+ * session.ai calls routed to the phone (forceLocal / localFallback). Thin
+ * passthrough over LocalLlmModelManager and LocalLlmProvider so Settings >
+ * AI Models can list, pick, download, and delete models without reaching
+ * into engine internals.
+ */
+import localLlmModelManager, { LocalLlmModelManager, } from "../services/LocalLlmModelManager";
+import localLlmProvider from "../services/LocalLlmProvider";
+export const ai = {
+    local: {
+        /** The catalog, in dropdown order. */
+        models: () => localLlmModelManager.models(),
+        /** The Settings > AI Models pick. */
+        selectedModelId: () => localLlmModelManager.selectedModelId(),
+        select: (id) => localLlmModelManager.select(id),
+        isDownloaded: (id) => localLlmModelManager.isModelAvailable(id),
+        downloadedModelIds: () => localLlmModelManager.downloadedModelIds(),
+        download: (id) => localLlmModelManager.downloadModel(id),
+        cancelDownload: () => localLlmModelManager.cancelDownload(),
+        /** Removes the files and drops the resident runner if it was this model. */
+        deleteModel: async (id) => {
+            const target = id ?? localLlmModelManager.selectedModelId();
+            if (localLlmProvider.loadedModelId() === target)
+                await localLlmProvider.unload();
+            await localLlmModelManager.deleteModel(target);
+        },
+        status: () => localLlmModelManager.getStatus(),
+        /** Subscribe to download status changes; fires immediately, returns an unsubscribe. */
+        onStatusChanged: (listener) => localLlmModelManager.subscribe(listener),
+        /** Whether a model is resident in memory right now. */
+        isLoaded: () => localLlmProvider.isLoaded(),
+        /** Drop the resident model (memory pressure, debugging). */
+        unload: () => localLlmProvider.unload(),
+        formatBytes: (bytes) => LocalLlmModelManager.formatBytes(bytes),
+    },
+};
+//# sourceMappingURL=ai.js.map

package/build/facades/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/facades/ai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,oBAAoB,EAAE,EAC3B,oBAAoB,GAIrB,MAAM,kCAAkC,CAAA;AACzC,OAAO,gBAAgB,MAAM,8BAA8B,CAAA;AAE3D,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,KAAK,EAAE;QACL,sCAAsC;QACtC,MAAM,EAAE,GAA0B,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE;QAClE,qCAAqC;QACrC,eAAe,EAAE,GAAoB,EAAE,CAAC,oBAAoB,CAAC,eAAe,EAAE;QAC9E,MAAM,EAAE,CAAC,EAAmB,EAAiB,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,YAAY,EAAE,CAAC,EAAoB,EAAoB,EAAE,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnG,kBAAkB,EAAE,GAA+B,EAAE,CAAC,oBAAoB,CAAC,kBAAkB,EAAE;QAC/F,QAAQ,EAAE,CAAC,EAAoB,EAAiB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;QACzF,cAAc,EAAE,GAAkB,EAAE,CAAC,oBAAoB,CAAC,cAAc,EAAE;QAC1E,4EAA4E;QAC5E,WAAW,EAAE,KAAK,EAAE,EAAoB,EAAiB,EAAE;YACzD,MAAM,MAAM,GAAG,EAAE,IAAI,oBAAoB,CAAC,eAAe,EAAE,CAAA;YAC3D,IAAI,gBAAgB,CAAC,aAAa,EAAE,KAAK,MAAM;gBAAE,MAAM,gBAAgB,CAAC,MAAM,EAAE,CAAA;YAChF,MAAM,oBAAoB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAChD,CAAC;QACD,MAAM,EAAE,GAAkC,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE;QAC7E,uFAAuF;QACvF,eAAe,EAAE,CAAC,QAAyD,EAAgB,EAAE,CAC3F,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC1C,uDAAuD;QACvD,QAAQ,EAAE,GAAY,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE;QACpD,4DAA4D;QAC5D,MAAM,EAAE,GAAkB,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE;QACtD,WAAW,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,oBAAoB,CAAC,WAAW,CAAC,KAAK,CAAC;KAChF;CACF,CAAA","sourcesContent":["/**\n * ai facade — `engine.ai.local`: the on-device LLM model that serves\n * session.ai calls routed to the phone (forceLocal / localFallback). Thin\n * passthrough over LocalLlmModelManager and LocalLlmProvider so Settings >\n * AI Models can list, pick, download, and delete models without reaching\n * into engine internals.\n */\nimport localLlmModelManager, {\n  LocalLlmModelManager,\n  type LocalLlmDownloadStatus,\n  type LocalLlmModelConfig,\n  type LocalLlmModelId,\n} from \"../services/LocalLlmModelManager\"\nimport localLlmProvider from \"../services/LocalLlmProvider\"\n\nexport const ai = {\n  local: {\n    /** The catalog, in dropdown order. */\n    models: (): LocalLlmModelConfig[] => localLlmModelManager.models(),\n    /** The Settings > AI Models pick. */\n    selectedModelId: (): LocalLlmModelId => localLlmModelManager.selectedModelId(),\n    select: (id: LocalLlmModelId): Promise<void> => localLlmModelManager.select(id),\n    isDownloaded: (id?: LocalLlmModelId): Promise<boolean> => localLlmModelManager.isModelAvailable(id),\n    downloadedModelIds: (): Promise<LocalLlmModelId[]> => localLlmModelManager.downloadedModelIds(),\n    download: (id?: LocalLlmModelId): Promise<void> => localLlmModelManager.downloadModel(id),\n    cancelDownload: (): Promise<void> => localLlmModelManager.cancelDownload(),\n    /** Removes the files and drops the resident runner if it was this model. */\n    deleteModel: async (id?: LocalLlmModelId): Promise<void> => {\n      const target = id ?? localLlmModelManager.selectedModelId()\n      if (localLlmProvider.loadedModelId() === target) await localLlmProvider.unload()\n      await localLlmModelManager.deleteModel(target)\n    },\n    status: (): LocalLlmDownloadStatus | null => localLlmModelManager.getStatus(),\n    /** Subscribe to download status changes; fires immediately, returns an unsubscribe. */\n    onStatusChanged: (listener: (status: LocalLlmDownloadStatus | null) => void): (() => void) =>\n      localLlmModelManager.subscribe(listener),\n    /** Whether a model is resident in memory right now. */\n    isLoaded: (): boolean => localLlmProvider.isLoaded(),\n    /** Drop the resident model (memory pressure, debugging). */\n    unload: (): Promise<void> => localLlmProvider.unload(),\n    formatBytes: (bytes: number): string => LocalLlmModelManager.formatBytes(bytes),\n  },\n}\n"]}

package/build/facades/glasses.d.ts

@@ -1,5 +1,5 @@
-import type { ButtonPressEvent, ConnectOptions, Device, KeyboardAdvertEvent, KeyboardPairingEvent, TouchEvent } from "@glassly/bluetooth-sdk";
-import { type NeuralBandClaimStatus, type NeuralBandHandwritingStatus } from "../services/neuralBand/NeuralBandInput";
+import type { ButtonPressEvent, ConnectOptions, ControllerStatus, Device, KeyboardAdvertEvent, KeyboardPairingEvent, PairedController, TouchEvent } from "@glassly/bluetooth-sdk";
+import { type NeuralBandClaimStatus, type NeuralBandHandwritingStatus, type NeuralBandHandwritingUpdate } from "../services/neuralBand/NeuralBandInput";
 declare function projectStatus(): {
     state: "connecting" | "connected" | "disconnected" | "scanning" | "bonding";
     fullyBooted: boolean;
@@ -17,12 +17,6 @@ declare function projectStatus(): {
     btClassic: boolean;
     ancsAuthorized: boolean;
 };
-declare function projectControllerStatus(): {
-    connected: boolean;
-    fullyBooted: boolean;
-    battery: number;
-    signal: number;
-};
 declare function projectKeyboardStatus(): {
     /** Connected glasses run a firmware that can host a keyboard (G2 Glassly CFW 39+). */
     available: boolean;
@@ -62,7 +56,6 @@ declare function projectInfo(): {
     };
 };
 export type GlassesStatusSnapshot = ReturnType<typeof projectStatus>;
-export type ControllerStatusSnapshot = ReturnType<typeof projectControllerStatus>;
 export type KeyboardStatusSnapshot = ReturnType<typeof projectKeyboardStatus>;
 export type GlassesInfoSnapshot = ReturnType<typeof projectInfo>;
 export declare const glasses: {
@@ -133,31 +126,44 @@ export declare const glasses: {
         onAdvert: (cb: (advert: KeyboardAdvertEvent) => void) => (() => void);
         onPairing: (cb: (prompt: KeyboardPairingEvent) => void) => (() => void);
     };
-    controller: {
-        connectDefault: () => Promise<void>;
-        disconnect: () => Promise<void>;
-        forget: () => Promise<void>;
-        status: () => ControllerStatusSnapshot;
-        onStatus: (cb: (status: ControllerStatusSnapshot) => void) => (() => void);
+    controllers: {
+        /** Paired controllers in pairing order. */
+        list: () => PairedController[];
+        onList: (cb: (controllers: PairedController[]) => void) => (() => void);
+        /** Live driver statuses by id; a paired controller without an entry is idle. */
+        statuses: () => Record<string, ControllerStatus>;
+        status: (id: string) => ControllerStatus | undefined;
+        onStatus: (cb: (statuses: Record<string, ControllerStatus>) => void) => (() => void);
+        /** Controllers delivering input (linked, route or claim done). */
+        connected: () => ControllerStatus[];
+        isConnected: (model?: string) => boolean;
+        connect: (id: string) => Promise<void>;
+        /** Reconnect every paired controller that is not connected. */
+        connectAll: () => Promise<void>;
+        /** Drop an in-flight controller scan or pairing; paired records are untouched. */
+        cancelAttempt: () => Promise<void>;
+        /** Disconnect; the controller stays paired. */
+        disconnect: (id: string) => Promise<void>;
+        forget: (id: string) => Promise<void>;
     };
     neuralBand: {
-        /** Store the Meta account session the one-time band claim uses. */
+        /** Store the Meta account session the one-time band claim uses (account-wide). */
         setMetaSession: (accessToken: string, userId: string) => Promise<void>;
         clearMetaSession: () => Promise<void>;
         hasMetaSession: () => Promise<boolean>;
-        /** A band identity is stored on this phone, so the remembered band connects without a claim. */
-        isClaimed: () => Promise<boolean>;
-        /** The latest claim progress, kept across screens. */
+        /** This band's identity is stored on this phone, so it reconnects without a claim. */
+        isClaimed: (id: string) => Promise<boolean>;
+        /** The latest claim progress of any band (with its `controllerId`), kept across screens. */
         claimStatus: () => NeuralBandClaimStatus;
         resetClaim: () => void;
         onClaimStatus: (cb: (status: NeuralBandClaimStatus) => void) => (() => void);
         /** The band's handwriting model; writing arrives on the miniapp keyboard stream. */
-        setHandwriting: (enabled: boolean) => Promise<void>;
-        handwritingStatus: () => NeuralBandHandwritingStatus;
-        onHandwritingStatus: (cb: (status: NeuralBandHandwritingStatus) => void) => (() => void);
+        setHandwriting: (id: string, enabled: boolean) => Promise<void>;
+        handwritingStatus: (id: string) => NeuralBandHandwritingStatus;
+        onHandwritingStatus: (cb: (update: NeuralBandHandwritingUpdate) => void) => (() => void);
         /** The band's air mouse; movement reaches miniapps on the pointer stream. */
-        setPointer: (enabled: boolean) => Promise<void>;
-        setHand: (hand: "left" | "right") => Promise<void>;
+        setPointer: (id: string, enabled: boolean) => Promise<void>;
+        setHand: (id: string, hand: "left" | "right") => Promise<void>;
     };
     audio: {
         /** Read the glasses' current media volume. */

package/build/facades/glasses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"glasses.d.ts","sourceRoot":"","sources":["../../src/facades/glasses.ts"],"names":[],"mappings":"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"}

package/build/facades/glasses.js

@@ -18,6 +18,7 @@ import micStateCoordinator from "../services/MicStateCoordinator";
 import { projectPairingIdentity } from "../services/PairingIdentity";
 import { isGlassesConnected, isGlassesReady } from "../services/GlassesReadiness";
 import { pushAllBluetoothSettings } from "../services/GlassesSettingsSync";
+import { isControllerReady, pairedControllersFrom, readyControllers } from "../services/controllers";
 import neuralBandInput from "../services/neuralBand/NeuralBandInput";
 import { recordSupportProfileConnectionFailure } from "../services/SupportProfileSync";
 import { getModelCapabilities } from "../types";
@@ -41,14 +42,16 @@ function projectStatus() {
         ancsAuthorized: Boolean(s.ancsAuthorized),
     };
 }
-function projectControllerStatus() {
-    const s = useGlassesStore.getState();
-    return {
-        connected: s.controllerConnected,
-        fullyBooted: s.controllerFullyBooted,
-        battery: s.controllerBatteryLevel,
-        signal: s.controllerSignalStrength,
-    };
+function projectControllerList() {
+    return pairedControllersFrom(useSettingsStore.getState().getSetting(SETTINGS.controllers.key));
+}
+// Copies: snapshots must not hand callers mutable references into the store.
+function projectControllerStatuses() {
+    const statuses = {};
+    for (const [id, status] of Object.entries(useGlassesStore.getState().controllers ?? {})) {
+        statuses[id] = { ...status };
+    }
+    return statuses;
 }
 function projectKeyboardStatus() {
     const s = useGlassesStore.getState();
@@ -241,43 +244,59 @@ export const glasses = {
             return () => sub.remove();
         },
     },
-    // --- ring controller (optional input device) ---
-    controller: {
-        connectDefault: () => BluetoothSdk.connectDefaultController(),
-        disconnect: () => BluetoothSdk.disconnectController(),
-        forget: () => BluetoothSdk.forgetController(),
-        status: () => projectControllerStatus(),
-        onStatus: (cb) => {
-            let last = JSON.stringify(projectControllerStatus());
-            return useGlassesStore.subscribe(() => {
-                const snap = projectControllerStatus();
-                const key = JSON.stringify(snap);
+    // --- controllers (input accessories linked to the phone), by registry id ---
+    controllers: {
+        /** Paired controllers in pairing order. */
+        list: () => projectControllerList(),
+        onList: (cb) => {
+            let last = JSON.stringify(projectControllerList());
+            return useSettingsStore.subscribe(() => {
+                const list = projectControllerList();
+                const key = JSON.stringify(list);
                 if (key === last)
                     return;
                 last = key;
-                cb(snap);
+                cb(list);
             });
         },
+        /** Live driver statuses by id; a paired controller without an entry is idle. */
+        statuses: () => projectControllerStatuses(),
+        status: (id) => projectControllerStatuses()[id],
+        onStatus: (cb) => useGlassesStore.subscribe((s) => s.controllers, () => cb(projectControllerStatuses())),
+        /** Controllers delivering input (linked, route or claim done). */
+        connected: () => readyControllers(projectControllerStatuses()),
+        isConnected: (model) => Object.values(useGlassesStore.getState().controllers ?? {}).some((status) => isControllerReady(status) && (model === undefined || status.model === model)),
+        connect: (id) => BluetoothSdk.connectController(id),
+        /** Reconnect every paired controller that is not connected. */
+        connectAll: () => BluetoothSdk.connectControllers(),
+        /** Drop an in-flight controller scan or pairing; paired records are untouched. */
+        cancelAttempt: () => BluetoothSdk.cancelControllerAttempt(),
+        /** Disconnect; the controller stays paired. */
+        disconnect: (id) => BluetoothSdk.disconnectController(id),
+        forget: async (id) => {
+            await BluetoothSdk.forgetController(id);
+            neuralBandInput.forget(id);
+        },
     },
-    // --- Meta Neural Band (a controller with a claim step and its own features) ---
+    // --- Meta Neural Band (a controller with a claim step and its own features), by controller id ---
     neuralBand: {
-        /** Store the Meta account session the one-time band claim uses. */
+        /** Store the Meta account session the one-time band claim uses (account-wide). */
         setMetaSession: (accessToken, userId) => BluetoothSdk.neuralBandSetMetaSession(accessToken, userId),
         clearMetaSession: () => BluetoothSdk.neuralBandClearMetaSession(),
         hasMetaSession: () => BluetoothSdk.neuralBandHasMetaSession(),
-        /** A band identity is stored on this phone, so the remembered band connects without a claim. */
-        isClaimed: () => BluetoothSdk.neuralBandIsClaimed(),
-        /** The latest claim progress, kept across screens. */
-        claimStatus: () => neuralBandInput.claimStatus(),
+        /** This band's identity is stored on this phone, so it reconnects without a claim. */
+        isClaimed: (id) => BluetoothSdk.neuralBandIsClaimed(id),
+        /** The latest claim progress of any band (with its `controllerId`), kept across screens. */
+        claimStatus: () => ({ ...neuralBandInput.claimStatus() }),
         resetClaim: () => neuralBandInput.resetClaim(),
         onClaimStatus: (cb) => neuralBandInput.onClaimStatus(cb),
         /** The band's handwriting model; writing arrives on the miniapp keyboard stream. */
-        setHandwriting: (enabled) => BluetoothSdk.neuralBandSetHandwriting(enabled),
-        handwritingStatus: () => neuralBandInput.handwritingStatus(),
+        setHandwriting: (id, enabled) => BluetoothSdk.neuralBandSetHandwriting(id, enabled),
+        handwritingStatus: (id) => ({ ...neuralBandInput.handwritingStatus(id) }),
         onHandwritingStatus: (cb) => neuralBandInput.onHandwritingStatus(cb),
         /** The band's air mouse; movement reaches miniapps on the pointer stream. */
-        setPointer: (enabled) => BluetoothSdk.neuralBandSetPointer(enabled),
-        setHand: (hand) => BluetoothSdk.neuralBandSetHand(hand),
+        setPointer: (id, enabled) => BluetoothSdk.neuralBandSetPointer(id, enabled),
+        setHand: (id, hand) => BluetoothSdk.neuralBandSetHand(id, hand),
     },
     // --- audio (glasses media-volume, own-app playback hint, live mic level) ---
     audio: {