@glassly/engine 0.1.0-dev.98 → 0.2.8-dev.445

package/build/services/LocalSttFallbackCoordinator.d.ts

@@ -33,6 +33,7 @@ declare class LocalSttFallbackCoordinator {
      */
     private cloudConnected;
     private localActive;
+    private starting;
     private cloudAdapterAttached;
     /**
      * Soniox-direct (user API key) state, pushed by SonioxDirectService. While
@@ -51,6 +52,7 @@ declare class LocalSttFallbackCoordinator {
      */
     private sttQuotaBlocked;
     private constructor();
+    private retryAfterModelReady;
     /**
      * Lazy-attach the engine cloud connection listener. The coordinator is
      * constructed at module load, before engine.start() brings up the cloud
@@ -92,6 +94,7 @@ declare class LocalSttFallbackCoordinator {
     private currentReason;
     private publishReason;
     private startLocalStt;
+    private activateLocalStt;
     private stopLocalStt;
     private shouldUseLocalStt;
     private log;

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

@@ -1 +1 @@
-{"version":3,"file":"LocalSttFallbackCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/LocalSttFallbackCoordinator.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,oBAAoB,GACpB,gBAAgB,GAChB,WAAW,GACX,sBAAsB,CAAA;AAE1B,cAAM,2BAA2B;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,OAAO,CAAC,4BAA4B,CAAQ;IAC5C,OAAO,CAAC,yBAAyB,CAAQ;IACzC,OAAO,CAAC,cAAc,CAAsB;IAC5C;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,oBAAoB,CAAQ;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,mBAAmB,CAAO;IAClC;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAAQ;IAE/B,OAAO;IASP;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAajC,MAAM,CAAC,WAAW,IAAI,2BAA2B;IAOjD,QAAQ,IAAI,OAAO;IAInB,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC,mEAAmE;IACnE,SAAS,IAAI,sBAAsB,GAAG,IAAI;IAI1C,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,UAAQ,GAAG,IAAI;IAQrG;;;;;;OAMG;IACH,iBAAiB,IAAI,IAAI;IAEzB;;;;OAIG;IACG,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,iBAAiB,IAAI,OAAO;IAI5B,uEAAuE;IACvE,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQnE;2CACuC;IACvC,OAAO,CAAC,SAAS;YAWH,SAAS;IAcvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;YAQP,aAAa;IA0B3B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,GAAG;CAGZ;AAED,QAAA,MAAM,2BAA2B,6BAA4C,CAAA;AAC7E,eAAe,2BAA2B,CAAA"}
+{"version":3,"file":"LocalSttFallbackCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/LocalSttFallbackCoordinator.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,oBAAoB,GACpB,gBAAgB,GAChB,WAAW,GACX,sBAAsB,CAAA;AAE1B,cAAM,2BAA2B;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,OAAO,CAAC,4BAA4B,CAAQ;IAC5C,OAAO,CAAC,yBAAyB,CAAQ;IACzC,OAAO,CAAC,cAAc,CAAsB;IAC5C;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,oBAAoB,CAAQ;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,mBAAmB,CAAO;IAClC;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAAQ;IAE/B,OAAO;YAYO,oBAAoB;IAQlC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAajC,MAAM,CAAC,WAAW,IAAI,2BAA2B;IAOjD,QAAQ,IAAI,OAAO;IAInB,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC,mEAAmE;IACnE,SAAS,IAAI,sBAAsB,GAAG,IAAI;IAI1C,oBAAoB,CAAC,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,UAAQ,GAAG,IAAI;IAQrG;;;;;;OAMG;IACH,iBAAiB,IAAI,IAAI;IAEzB;;;;OAIG;IACG,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,iBAAiB,IAAI,OAAO;IAI5B,uEAAuE;IACvE,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQnE;2CACuC;IACvC,OAAO,CAAC,SAAS;YAWH,SAAS;IAmBvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;YAQP,aAAa;YASb,gBAAgB;IAqB9B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,GAAG;CAGZ;AAED,QAAA,MAAM,2BAA2B,6BAA4C,CAAA;AAC7E,eAAe,2BAA2B,CAAA"}

package/build/services/LocalSttFallbackCoordinator.js

@@ -16,6 +16,7 @@ class LocalSttFallbackCoordinator {
      */
     cloudConnected = true;
     localActive = false;
+    starting = null;
     cloudAdapterAttached = false;
     /**
      * Soniox-direct (user API key) state, pushed by SonioxDirectService. While
@@ -40,6 +41,16 @@ class LocalSttFallbackCoordinator {
         // registered a subscription.
         useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, false);
         useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason, "");
+        sttModelManager.onModelReady(() => {
+            void this.retryAfterModelReady();
+        });
+    }
+    async retryAfterModelReady() {
+        // A model can finish downloading while the initial availability check is
+        // still pending. Wait for that attempt before retrying so readiness is
+        // never lost and native restarts cannot overlap.
+        await this.starting;
+        await this.reconcile();
     }
     /**
      * Lazy-attach the engine cloud connection listener. The coordinator is
@@ -132,7 +143,12 @@ class LocalSttFallbackCoordinator {
         this.attachCloudAdapterIfReady();
         const shouldBeActive = this.shouldUseLocalStt();
         if (shouldBeActive && !this.localActive) {
-            await this.startLocalStt();
+            if (!this.starting) {
+                this.starting = this.startLocalStt().finally(() => {
+                    this.starting = null;
+                });
+            }
+            await this.starting;
         }
         else if (!shouldBeActive && this.localActive) {
             this.stopLocalStt(this.hasTranscriptionSubscription ? "primary transcription recovered" : "subscription gone");
@@ -168,6 +184,14 @@ class LocalSttFallbackCoordinator {
     }
     async startLocalStt() {
         this.log("starting local stt");
+        try {
+            await this.activateLocalStt();
+        }
+        catch (err) {
+            this.log(`local stt startup failed: ${err}`);
+        }
+    }
+    async activateLocalStt() {
         const modelAvailable = await sttModelManager.isModelAvailable();
         if (!modelAvailable) {
             this.log("local stt model is not available yet — skipping activation");
@@ -177,13 +201,8 @@ class LocalSttFallbackCoordinator {
             this.log("local stt activation skipped: routing changed before start completed");
             return;
         }
-        try {
-            // Direct btsdk call now (was a host restartTranscriber hook).
-            await BluetoothSdk.restartTranscriber();
-        }
-        catch (err) {
-            this.log(`restartTranscriber failed: ${err}`);
-        }
+        // Native rejects unless the recognizer and its processing loop are ready.
+        await BluetoothSdk.restartTranscriber();
         if (!this.shouldUseLocalStt()) {
             this.log("local stt activation skipped: routing changed during transcriber restart");
             return;

package/build/services/LocalSttFallbackCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalSttFallbackCoordinator.js","sourceRoot":"","sources":["../../src/services/LocalSttFallbackCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport {ISLAND_SETTINGS_KEYS} from \"../runtime/config\"\nimport {useSettingsStore} from \"../stores/settings\"\nimport {cloudClientService} from \"./CloudClientService\"\nimport sttModelManager from \"./STTModelManager\"\n\n/**\n * Decides whether on-device Sherpa STT should produce transcripts for local\n * miniapps, instead of (or in addition to) cloud transcription. Local STT is\n * active when the cloud is unavailable (disconnected or refusing STT for plan\n * quota) or any subscription requires `forceLocal`.\n *\n * Activation flips `localSttFallbackActive` in the settings store, which\n * the bluetooth-sdk native side reads to decide whether to feed PCM into\n * the SherpaOnnxTranscriber. Local transcripts then flow back through the\n * `local_transcription` Bridge event; the host wires that event to\n * `localMiniappRuntime.forwardEvent`, with this coordinator providing the\n * subscription-active gate so we never publish transcripts to miniapps that\n * aren't asking for them. LocalMiniappRuntime filters mixed local/cloud\n * delivery per miniapp.\n */\n/**\n * Why local STT is currently active, mirrored into the\n * `local_stt_fallback_reason` setting (\"\" while inactive) so UI can show it.\n * When several causes hold at once, the primary-path outage wins over\n * `force_local` (a forced subscription would keep local STT on either way).\n */\nexport type LocalSttFallbackReason =\n  | \"force_local\"\n  | \"cloud_disconnected\"\n  | \"cloud_disabled\"\n  | \"stt_quota\"\n  | \"provider_unreachable\"\n\nclass LocalSttFallbackCoordinator {\n  private static instance: LocalSttFallbackCoordinator\n\n  private hasTranscriptionSubscription = false\n  private hasForceLocalSubscription = false\n  private activeLanguage: string | null = null\n  /**\n   * Default to \"cloud is up\" so we never accidentally activate local STT before\n   * the cloud client has had a chance to start. We attach lazily on the first\n   * subscription/reconcile pass; once attached, this field reflects the real\n   * cloud-client runtime status.\n   */\n  private cloudConnected = true\n  private localActive = false\n  private cloudAdapterAttached = false\n  /**\n   * Soniox-direct (user API key) state, pushed by SonioxDirectService. While\n   * enabled, IT is the primary transcription path — cloud connectivity is\n   * irrelevant and sherpa engages on Soniox health instead. Defaults healthy\n   * for the same reason cloudConnected defaults true: never activate local STT\n   * before the primary has had a chance to come up.\n   */\n  private sonioxDirectEnabled = false\n  private sonioxDirectHealthy = true\n  /**\n   * Cloud STT refused for plan quota (`stream.quota` blocked=true). The cloud\n   * connection stays up, so this is tracked separately from `cloudConnected`:\n   * for transcription purposes the cloud path is down, and sherpa takes over\n   * if its model is on-device. Soniox-direct is unmetered and unaffected.\n   */\n  private sttQuotaBlocked = false\n\n  private constructor() {\n    // Reset the persisted mirror flag on boot — the in-memory state in this\n    // coordinator is the source of truth, and a stale \"true\" left from the\n    // previous session would cause native to feed Sherpa before any miniapp\n    // registered a subscription.\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, false)\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason, \"\")\n  }\n\n  /**\n   * Lazy-attach the engine cloud connection listener. The coordinator is\n   * constructed at module load, before engine.start() brings up the cloud\n   * client, so we defer until the first reconcile.\n   */\n  private attachCloudAdapterIfReady(): void {\n    if (this.cloudAdapterAttached) return\n    this.cloudConnected = cloudClientService.isConnected()\n    cloudClientService.onStatusChanged((status) => {\n      const connected = status.status === \"connected\"\n      if (this.cloudConnected === connected) return\n      this.log(`cloud connection -> ${connected ? \"up\" : \"down\"}`)\n      this.cloudConnected = connected\n      void this.reconcile()\n    })\n    this.cloudAdapterAttached = true\n  }\n\n  static getInstance(): LocalSttFallbackCoordinator {\n    if (!LocalSttFallbackCoordinator.instance) {\n      LocalSttFallbackCoordinator.instance = new LocalSttFallbackCoordinator()\n    }\n    return LocalSttFallbackCoordinator.instance\n  }\n\n  isActive(): boolean {\n    return this.localActive\n  }\n\n  getActiveLanguage(): string | null {\n    return this.activeLanguage\n  }\n\n  /** The cause of the current activation, or null while inactive. */\n  getReason(): LocalSttFallbackReason | null {\n    return this.localActive ? this.currentReason() : null\n  }\n\n  onSubscriptionChange(hasTranscription: boolean, language: string | null, hasForceLocal = false): void {\n    this.log(`onSubscriptionChange(hasTx=${hasTranscription}, lang=${language}, forceLocal=${hasForceLocal})`)\n    this.hasTranscriptionSubscription = hasTranscription\n    this.hasForceLocalSubscription = hasTranscription && hasForceLocal\n    this.activeLanguage = hasTranscription ? language : null\n    void this.reconcile()\n  }\n\n  /**\n   * Informational hook, retained for API stability. No longer called: the\n   * authoritative switching signal is the cloud-client adapter (local miniapps\n   * are powered only by V2). v1 cloud transcripts deliberately do NOT drive this\n   * coordinator anymore. Kept for future hysteresis if connection-state alone\n   * proves too coarse.\n   */\n  onCloudTranscript(): void {}\n\n  /**\n   * Pushed when the cloud announces/clears an STT quota block. Awaitable so\n   * the caller can inspect `isActive()` afterwards to phrase its user notice\n   * (\"continuing on-device\" vs \"transcription paused\").\n   */\n  async onSttQuotaBlockedChange(blocked: boolean): Promise<void> {\n    if (this.sttQuotaBlocked === blocked) return\n    this.log(`stt quota -> ${blocked ? \"blocked\" : \"restored\"}`)\n    this.sttQuotaBlocked = blocked\n    await this.reconcile()\n  }\n\n  isSttQuotaBlocked(): boolean {\n    return this.sttQuotaBlocked\n  }\n\n  /** Pushed by SonioxDirectService on every enable/health transition. */\n  onSonioxDirectStateChange(enabled: boolean, healthy: boolean): void {\n    if (this.sonioxDirectEnabled === enabled && this.sonioxDirectHealthy === healthy) return\n    this.log(`soniox-direct -> enabled=${enabled} healthy=${healthy}`)\n    this.sonioxDirectEnabled = enabled\n    this.sonioxDirectHealthy = healthy\n    void this.reconcile()\n  }\n\n  /** Whether the primary transcription path (Soniox-direct when a user key is\n   *  set, the cloud otherwise) is up. */\n  private primaryUp(): boolean {\n    // Cloud turned off in Privacy settings: the cloud path is not merely down,\n    // it is never coming back, so on-device STT is the primary. Checked ahead\n    // of `cloudConnected` because that field defaults to true (so local STT\n    // doesn't pre-empt cloud at boot) and would otherwise report a path that\n    // will never connect as up. Soniox-direct is a user-supplied third-party\n    // key, not Glassly cloud, so it stays available.\n    if (!this.sonioxDirectEnabled && cloudClientService.isCloudDisabled()) return false\n    return this.sonioxDirectEnabled ? this.sonioxDirectHealthy : this.cloudConnected && !this.sttQuotaBlocked\n  }\n\n  private async reconcile(): Promise<void> {\n    this.attachCloudAdapterIfReady()\n    const shouldBeActive = this.shouldUseLocalStt()\n    if (shouldBeActive && !this.localActive) {\n      await this.startLocalStt()\n    } else if (!shouldBeActive && this.localActive) {\n      this.stopLocalStt(this.hasTranscriptionSubscription ? \"primary transcription recovered\" : \"subscription gone\")\n    } else if (shouldBeActive && this.localActive) {\n      // Still active, but the cause may have shifted (e.g. quota block landing\n      // while already offline for a disconnect) — keep the mirror current.\n      this.publishReason()\n    }\n  }\n\n  /**\n   * Ranks the concurrent causes: a dead-forever cloud path first, then the\n   * primary provider's own failure, then transient outages, with `force_local`\n   * only when the primary is actually up. Mirrors `primaryUp()`.\n   */\n  private currentReason(): LocalSttFallbackReason {\n    if (!this.sonioxDirectEnabled && cloudClientService.isCloudDisabled()) return \"cloud_disabled\"\n    if (this.sonioxDirectEnabled && !this.sonioxDirectHealthy) return \"provider_unreachable\"\n    if (!this.sonioxDirectEnabled && !this.cloudConnected) return \"cloud_disconnected\"\n    if (!this.sonioxDirectEnabled && this.sttQuotaBlocked) return \"stt_quota\"\n    return \"force_local\"\n  }\n\n  private publishReason(): void {\n    const reason = this.localActive ? this.currentReason() : \"\"\n    const store = useSettingsStore.getState()\n    if (store.getSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason) !== reason) {\n      store.setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason, reason)\n    }\n  }\n\n  private async startLocalStt(): Promise<void> {\n    this.log(\"starting local stt\")\n    const modelAvailable = await sttModelManager.isModelAvailable()\n    if (!modelAvailable) {\n      this.log(\"local stt model is not available yet — skipping activation\")\n      return\n    }\n    if (!this.shouldUseLocalStt()) {\n      this.log(\"local stt activation skipped: routing changed before start completed\")\n      return\n    }\n    try {\n      // Direct btsdk call now (was a host restartTranscriber hook).\n      await BluetoothSdk.restartTranscriber()\n    } catch (err) {\n      this.log(`restartTranscriber failed: ${err}`)\n    }\n    if (!this.shouldUseLocalStt()) {\n      this.log(\"local stt activation skipped: routing changed during transcriber restart\")\n      return\n    }\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, true)\n    this.localActive = true\n    this.publishReason()\n  }\n\n  private stopLocalStt(reason: string): void {\n    this.log(`stopping local stt: ${reason}`)\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, false)\n    this.localActive = false\n    this.publishReason()\n  }\n\n  private shouldUseLocalStt(): boolean {\n    return this.hasTranscriptionSubscription && (this.hasForceLocalSubscription || !this.primaryUp())\n  }\n\n  private log(msg: string): void {\n    console.log(`[LocalSttFallback] ${msg}`)\n  }\n}\n\nconst localSttFallbackCoordinator = LocalSttFallbackCoordinator.getInstance()\nexport default localSttFallbackCoordinator\n"]}
+{"version":3,"file":"LocalSttFallbackCoordinator.js","sourceRoot":"","sources":["../../src/services/LocalSttFallbackCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\nimport {ISLAND_SETTINGS_KEYS} from \"../runtime/config\"\nimport {useSettingsStore} from \"../stores/settings\"\nimport {cloudClientService} from \"./CloudClientService\"\nimport sttModelManager from \"./STTModelManager\"\n\n/**\n * Decides whether on-device Sherpa STT should produce transcripts for local\n * miniapps, instead of (or in addition to) cloud transcription. Local STT is\n * active when the cloud is unavailable (disconnected or refusing STT for plan\n * quota) or any subscription requires `forceLocal`.\n *\n * Activation flips `localSttFallbackActive` in the settings store, which\n * the bluetooth-sdk native side reads to decide whether to feed PCM into\n * the SherpaOnnxTranscriber. Local transcripts then flow back through the\n * `local_transcription` Bridge event; the host wires that event to\n * `localMiniappRuntime.forwardEvent`, with this coordinator providing the\n * subscription-active gate so we never publish transcripts to miniapps that\n * aren't asking for them. LocalMiniappRuntime filters mixed local/cloud\n * delivery per miniapp.\n */\n/**\n * Why local STT is currently active, mirrored into the\n * `local_stt_fallback_reason` setting (\"\" while inactive) so UI can show it.\n * When several causes hold at once, the primary-path outage wins over\n * `force_local` (a forced subscription would keep local STT on either way).\n */\nexport type LocalSttFallbackReason =\n  | \"force_local\"\n  | \"cloud_disconnected\"\n  | \"cloud_disabled\"\n  | \"stt_quota\"\n  | \"provider_unreachable\"\n\nclass LocalSttFallbackCoordinator {\n  private static instance: LocalSttFallbackCoordinator\n\n  private hasTranscriptionSubscription = false\n  private hasForceLocalSubscription = false\n  private activeLanguage: string | null = null\n  /**\n   * Default to \"cloud is up\" so we never accidentally activate local STT before\n   * the cloud client has had a chance to start. We attach lazily on the first\n   * subscription/reconcile pass; once attached, this field reflects the real\n   * cloud-client runtime status.\n   */\n  private cloudConnected = true\n  private localActive = false\n  private starting: Promise<void> | null = null\n  private cloudAdapterAttached = false\n  /**\n   * Soniox-direct (user API key) state, pushed by SonioxDirectService. While\n   * enabled, IT is the primary transcription path — cloud connectivity is\n   * irrelevant and sherpa engages on Soniox health instead. Defaults healthy\n   * for the same reason cloudConnected defaults true: never activate local STT\n   * before the primary has had a chance to come up.\n   */\n  private sonioxDirectEnabled = false\n  private sonioxDirectHealthy = true\n  /**\n   * Cloud STT refused for plan quota (`stream.quota` blocked=true). The cloud\n   * connection stays up, so this is tracked separately from `cloudConnected`:\n   * for transcription purposes the cloud path is down, and sherpa takes over\n   * if its model is on-device. Soniox-direct is unmetered and unaffected.\n   */\n  private sttQuotaBlocked = false\n\n  private constructor() {\n    // Reset the persisted mirror flag on boot — the in-memory state in this\n    // coordinator is the source of truth, and a stale \"true\" left from the\n    // previous session would cause native to feed Sherpa before any miniapp\n    // registered a subscription.\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, false)\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason, \"\")\n    sttModelManager.onModelReady(() => {\n      void this.retryAfterModelReady()\n    })\n  }\n\n  private async retryAfterModelReady(): Promise<void> {\n    // A model can finish downloading while the initial availability check is\n    // still pending. Wait for that attempt before retrying so readiness is\n    // never lost and native restarts cannot overlap.\n    await this.starting\n    await this.reconcile()\n  }\n\n  /**\n   * Lazy-attach the engine cloud connection listener. The coordinator is\n   * constructed at module load, before engine.start() brings up the cloud\n   * client, so we defer until the first reconcile.\n   */\n  private attachCloudAdapterIfReady(): void {\n    if (this.cloudAdapterAttached) return\n    this.cloudConnected = cloudClientService.isConnected()\n    cloudClientService.onStatusChanged((status) => {\n      const connected = status.status === \"connected\"\n      if (this.cloudConnected === connected) return\n      this.log(`cloud connection -> ${connected ? \"up\" : \"down\"}`)\n      this.cloudConnected = connected\n      void this.reconcile()\n    })\n    this.cloudAdapterAttached = true\n  }\n\n  static getInstance(): LocalSttFallbackCoordinator {\n    if (!LocalSttFallbackCoordinator.instance) {\n      LocalSttFallbackCoordinator.instance = new LocalSttFallbackCoordinator()\n    }\n    return LocalSttFallbackCoordinator.instance\n  }\n\n  isActive(): boolean {\n    return this.localActive\n  }\n\n  getActiveLanguage(): string | null {\n    return this.activeLanguage\n  }\n\n  /** The cause of the current activation, or null while inactive. */\n  getReason(): LocalSttFallbackReason | null {\n    return this.localActive ? this.currentReason() : null\n  }\n\n  onSubscriptionChange(hasTranscription: boolean, language: string | null, hasForceLocal = false): void {\n    this.log(`onSubscriptionChange(hasTx=${hasTranscription}, lang=${language}, forceLocal=${hasForceLocal})`)\n    this.hasTranscriptionSubscription = hasTranscription\n    this.hasForceLocalSubscription = hasTranscription && hasForceLocal\n    this.activeLanguage = hasTranscription ? language : null\n    void this.reconcile()\n  }\n\n  /**\n   * Informational hook, retained for API stability. No longer called: the\n   * authoritative switching signal is the cloud-client adapter (local miniapps\n   * are powered only by V2). v1 cloud transcripts deliberately do NOT drive this\n   * coordinator anymore. Kept for future hysteresis if connection-state alone\n   * proves too coarse.\n   */\n  onCloudTranscript(): void {}\n\n  /**\n   * Pushed when the cloud announces/clears an STT quota block. Awaitable so\n   * the caller can inspect `isActive()` afterwards to phrase its user notice\n   * (\"continuing on-device\" vs \"transcription paused\").\n   */\n  async onSttQuotaBlockedChange(blocked: boolean): Promise<void> {\n    if (this.sttQuotaBlocked === blocked) return\n    this.log(`stt quota -> ${blocked ? \"blocked\" : \"restored\"}`)\n    this.sttQuotaBlocked = blocked\n    await this.reconcile()\n  }\n\n  isSttQuotaBlocked(): boolean {\n    return this.sttQuotaBlocked\n  }\n\n  /** Pushed by SonioxDirectService on every enable/health transition. */\n  onSonioxDirectStateChange(enabled: boolean, healthy: boolean): void {\n    if (this.sonioxDirectEnabled === enabled && this.sonioxDirectHealthy === healthy) return\n    this.log(`soniox-direct -> enabled=${enabled} healthy=${healthy}`)\n    this.sonioxDirectEnabled = enabled\n    this.sonioxDirectHealthy = healthy\n    void this.reconcile()\n  }\n\n  /** Whether the primary transcription path (Soniox-direct when a user key is\n   *  set, the cloud otherwise) is up. */\n  private primaryUp(): boolean {\n    // Cloud turned off in Privacy settings: the cloud path is not merely down,\n    // it is never coming back, so on-device STT is the primary. Checked ahead\n    // of `cloudConnected` because that field defaults to true (so local STT\n    // doesn't pre-empt cloud at boot) and would otherwise report a path that\n    // will never connect as up. Soniox-direct is a user-supplied third-party\n    // key, not Glassly cloud, so it stays available.\n    if (!this.sonioxDirectEnabled && cloudClientService.isCloudDisabled()) return false\n    return this.sonioxDirectEnabled ? this.sonioxDirectHealthy : this.cloudConnected && !this.sttQuotaBlocked\n  }\n\n  private async reconcile(): Promise<void> {\n    this.attachCloudAdapterIfReady()\n    const shouldBeActive = this.shouldUseLocalStt()\n    if (shouldBeActive && !this.localActive) {\n      if (!this.starting) {\n        this.starting = this.startLocalStt().finally(() => {\n          this.starting = null\n        })\n      }\n      await this.starting\n    } else if (!shouldBeActive && this.localActive) {\n      this.stopLocalStt(this.hasTranscriptionSubscription ? \"primary transcription recovered\" : \"subscription gone\")\n    } else if (shouldBeActive && this.localActive) {\n      // Still active, but the cause may have shifted (e.g. quota block landing\n      // while already offline for a disconnect) — keep the mirror current.\n      this.publishReason()\n    }\n  }\n\n  /**\n   * Ranks the concurrent causes: a dead-forever cloud path first, then the\n   * primary provider's own failure, then transient outages, with `force_local`\n   * only when the primary is actually up. Mirrors `primaryUp()`.\n   */\n  private currentReason(): LocalSttFallbackReason {\n    if (!this.sonioxDirectEnabled && cloudClientService.isCloudDisabled()) return \"cloud_disabled\"\n    if (this.sonioxDirectEnabled && !this.sonioxDirectHealthy) return \"provider_unreachable\"\n    if (!this.sonioxDirectEnabled && !this.cloudConnected) return \"cloud_disconnected\"\n    if (!this.sonioxDirectEnabled && this.sttQuotaBlocked) return \"stt_quota\"\n    return \"force_local\"\n  }\n\n  private publishReason(): void {\n    const reason = this.localActive ? this.currentReason() : \"\"\n    const store = useSettingsStore.getState()\n    if (store.getSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason) !== reason) {\n      store.setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackReason, reason)\n    }\n  }\n\n  private async startLocalStt(): Promise<void> {\n    this.log(\"starting local stt\")\n    try {\n      await this.activateLocalStt()\n    } catch (err) {\n      this.log(`local stt startup failed: ${err}`)\n    }\n  }\n\n  private async activateLocalStt(): Promise<void> {\n    const modelAvailable = await sttModelManager.isModelAvailable()\n    if (!modelAvailable) {\n      this.log(\"local stt model is not available yet — skipping activation\")\n      return\n    }\n    if (!this.shouldUseLocalStt()) {\n      this.log(\"local stt activation skipped: routing changed before start completed\")\n      return\n    }\n    // Native rejects unless the recognizer and its processing loop are ready.\n    await BluetoothSdk.restartTranscriber()\n    if (!this.shouldUseLocalStt()) {\n      this.log(\"local stt activation skipped: routing changed during transcriber restart\")\n      return\n    }\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, true)\n    this.localActive = true\n    this.publishReason()\n  }\n\n  private stopLocalStt(reason: string): void {\n    this.log(`stopping local stt: ${reason}`)\n    useSettingsStore.getState().setSetting(ISLAND_SETTINGS_KEYS.localSttFallbackActive, false)\n    this.localActive = false\n    this.publishReason()\n  }\n\n  private shouldUseLocalStt(): boolean {\n    return this.hasTranscriptionSubscription && (this.hasForceLocalSubscription || !this.primaryUp())\n  }\n\n  private log(msg: string): void {\n    console.log(`[LocalSttFallback] ${msg}`)\n  }\n}\n\nconst localSttFallbackCoordinator = LocalSttFallbackCoordinator.getInstance()\nexport default localSttFallbackCoordinator\n"]}

package/build/services/MemoryStore.d.ts

@@ -18,24 +18,16 @@
  */
 import type { MemoryEntry, MemoryNoteSource, MemorySession, MemorySummary } from "@glassly/miniapp";
 /**
- * How much timeline a tier can SEE. Retention gating is a read window, not a
- * delete: pruning always keeps {@link EXTENDED_RETENTION}'s worth of data, and
- * the active policy decides how far back reads reach. A lapsed subscriber's
- * older timeline is frozen, not lost — upgrading again restores it instantly.
+ * Physical bounds. There is no age cap: the timeline stays until the user
+ * deletes it (clear()/removeScope). The entry cap bounds the write cost —
+ * every persist re-serializes the whole timeline, so it is a perf ceiling as
+ * much as a product number — and the summary cap keeps one row per hour for
+ * about half a year of round-the-clock use, far longer at a normal pace.
  */
-export interface MemoryRetentionPolicy {
-    maxAgeMs: number;
+export declare const MEMORY_BOUNDS: {
     maxEntries: number;
     maxSummaries: number;
-}
-/** Free-tier visibility: a 14-day rolling window. */
-export declare const STANDARD_RETENTION: MemoryRetentionPolicy;
-/**
- * Plus/Pro visibility — and the store's PHYSICAL bounds for every tier. The
- * entry cap also bounds the write cost — every persist re-serializes the
- * whole timeline, so this cap is a perf ceiling as much as a product number.
- */
-export declare const EXTENDED_RETENTION: MemoryRetentionPolicy;
+};
 export interface MemoryStoreBackend {
     get(key: string): unknown | null;
     set(key: string, value: unknown): void;
@@ -50,13 +42,6 @@ export interface MemoryStoreHooks {
      * utterance. Set to 0 to persist synchronously (tests).
      */
     writeDebounceMs?: number;
-    /**
-     * Visibility policy resolver, consulted at every read. A function (not a
-     * value) so the host can flip between STANDARD and EXTENDED as the user's
-     * subscription changes without rebuilding the store. Absent = standard.
-     * Never affects what is STORED — pruning is fixed at EXTENDED bounds.
-     */
-    getRetention?: () => MemoryRetentionPolicy;
 }
 export interface MemoryStats {
     entryCount: number;
@@ -157,17 +142,7 @@ export declare class MemoryStore {
      * are left in place; its new build reads through the memory bridge instead.
      */
     private migrateFromAssist;
-    private retention;
-    /** Entries inside the active tier's visibility window, oldest first. */
-    private visibleEntries;
-    private visibleSummaries;
-    /**
-     * Physical bounds, ALWAYS the extended policy regardless of tier. A free or
-     * lapsed user's older timeline stays on disk (reads just can't see past
-     * their window) so upgrading — or re-upgrading — restores it rather than
-     * finding it deleted. Deleting remains the user's call: clear()/removeScope
-     * operate on the physical store.
-     */
+    /** Keep the newest MEMORY_BOUNDS.maxEntries; nothing goes for age — deleting is the user's call. */
     private prune;
     private key;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../src/services/MemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,kBAAkB,CAAA;AAqBjG;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,EAAE,qBAIhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,qBAIhC,CAAA;AAWD,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAChC,OAAO,EAAE,kBAAkB,CAAA;IAC3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,qBAAqB,CAAA;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI7C;AAMD,qBAAa,WAAW;IAWV,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVlC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAsB;IACvC,6EAA6E;IAC7E,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,gEAAgE;IAChE,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,QAAQ,CAAQ;gBAEK,KAAK,EAAE,gBAAgB;IAEpD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAOrC,UAAU,CAAC,KAAK,EAAE;QACtB,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,yEAAyE;QACzE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,EAAE,EAAE,MAAM,CAAA;KACX,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjB;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,GAAE,MAAmB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAkB3G,+DAA+D;IACzD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYtD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/C,4EAA4E;IACtE,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatE,+DAA+D;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvD,kDAAkD;IAC5C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKnF,+DAA+D;IACzD,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAO/B,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAanC,4DAA4D;IACtD,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAwB7C;;;;;OAKG;IACG,KAAK,CAAC,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1B;;;;OAIG;IACG,MAAM,CAAC,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC;IAYpD,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAK7C,qEAAqE;IAC/D,kBAAkB,CAAC,KAAK,GAAE,MAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAc5E,4DAA4D;IACtD,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAkClE,YAAY;YAYZ,OAAO;IAoBrB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAyDzB,OAAO,CAAC,SAAS;IAIjB,wEAAwE;IACxE,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,gBAAgB;IAKxB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,GAAG;IAIX;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;YAgBZ,UAAU;YAWV,gBAAgB;IAK9B,OAAO,CAAC,WAAW;CASpB"}
+{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../src/services/MemoryStore.ts"],"names":[],"mappings":"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"}

package/build/services/MemoryStore.js

@@ -17,10 +17,16 @@
  * user-scoped keys so existing history survives the move.
  */
 import { searchMemoryEntries } from "../utils/memory/search";
+import { BgTimer } from "../utils/timers";
 const KEY_ROOT = "memory_";
 const LOG_SUFFIX = "log";
 const SUMMARY_SUFFIX = "summaries";
-/** The pre-memory-layer Assist miniapp whose storage namespace we migrate. */
+/**
+ * The pre-memory-layer Assist miniapp whose storage namespace we migrate.
+ * Assist now ships as com.glassly.assistant; the timeline it reads is
+ * user-scoped (KEY_ROOT below), so the rename needs no second migration and
+ * this constant stays pinned to the old namespace.
+ */
 const LEGACY_ASSIST_PACKAGE = "com.tetramo.assistant";
 const LEGACY_STORAGE_ROOT = "localstorage_";
 const LEGACY_LOG_KEY = "assistant:session-log";
@@ -30,22 +36,16 @@ const LEGACY_SUMMARY_KEY = "assistant:hourly-summaries";
 const LEGACY_TRANSCRIPT_KEY = "assistant:transcript-log";
 const LEGACY_NOTES_KEY = "assistant:notes";
 const HOUR_MS = 60 * 60 * 1000;
-const DAY_MS = 24 * HOUR_MS;
-/** Free-tier visibility: a 14-day rolling window. */
-export const STANDARD_RETENTION = {
-    maxAgeMs: 14 * DAY_MS,
-    maxEntries: 4000,
-    maxSummaries: 24 * 14,
-};
 /**
- * Plus/Pro visibility — and the store's PHYSICAL bounds for every tier. The
- * entry cap also bounds the write cost — every persist re-serializes the
- * whole timeline, so this cap is a perf ceiling as much as a product number.
+ * Physical bounds. There is no age cap: the timeline stays until the user
+ * deletes it (clear()/removeScope). The entry cap bounds the write cost —
+ * every persist re-serializes the whole timeline, so it is a perf ceiling as
+ * much as a product number — and the summary cap keeps one row per hour for
+ * about half a year of round-the-clock use, far longer at a normal pace.
  */
-export const EXTENDED_RETENTION = {
-    maxAgeMs: 180 * DAY_MS,
+export const MEMORY_BOUNDS = {
     maxEntries: 24_000,
-    maxSummaries: 24 * 180,
+    maxSummaries: 4320,
 };
 const QUERY_LIMIT_CAP = 200;
 const QUERY_LIMIT_DEFAULT = 60;
@@ -87,7 +87,7 @@ export class MemoryStore {
      */
     async flush() {
         if (this.logFlushTimer) {
-            clearTimeout(this.logFlushTimer);
+            BgTimer.clearTimeout(this.logFlushTimer);
             this.logFlushTimer = null;
         }
         if (this.logDirty)
@@ -190,7 +190,7 @@ export class MemoryStore {
     }
     async addSummary(summary) {
         await this.ensureLoaded();
-        const { maxSummaries } = EXTENDED_RETENTION;
+        const { maxSummaries } = MEMORY_BOUNDS;
         this.summaries = this.summaries.filter((s) => s.hourStart !== summary.hourStart);
         this.summaries.push(summary);
         if (this.summaries.length > maxSummaries) {
@@ -199,32 +199,26 @@ export class MemoryStore {
         await this.persistSummaries();
         this.emitChanged();
     }
-    // === Reads ===
-    //
-    // Every read goes through the VISIBLE view: entries inside the active
-    // tier's window. Older data may still be stored (see prune) — it is frozen,
-    // not deleted, so an upgrade widens these views instantly.
+    // === Reads === (the whole stored timeline; nothing is hidden by age)
     /** Entries in [sinceMs, untilMs), newest last. */
     async window(sinceMs, untilMs = Date.now()) {
         await this.ensureLoaded();
-        return this.visibleEntries().filter((e) => e.at >= sinceMs && e.at < untilMs);
+        return this.entries.filter((e) => e.at >= sinceMs && e.at < untilMs);
     }
     /** All note entries, newest first (Settings > Memory list). */
     async notes() {
         await this.ensureLoaded();
-        return this.visibleEntries()
-            .filter((e) => e.kind === "note")
-            .sort((a, b) => b.at - a.at);
+        return this.entries.filter((e) => e.kind === "note").sort((a, b) => b.at - a.at);
     }
     async stats() {
         await this.ensureLoaded();
-        const visible = this.visibleEntries();
+        const visible = this.entries;
         const noteCount = visible.filter((e) => e.kind === "note").length;
         return {
             entryCount: visible.length,
             lineCount: visible.length - noteCount,
             noteCount,
-            summaryCount: this.visibleSummaries().filter((s) => s.text.trim()).length,
+            summaryCount: this.summaries.filter((s) => s.text.trim()).length,
             oldestAt: visible.length > 0 ? visible[0].at : null,
         };
     }
@@ -232,13 +226,13 @@ export class MemoryStore {
     async sessionList() {
         await this.ensureLoaded();
         const byHour = new Map();
-        for (const e of this.visibleEntries()) {
+        for (const e of this.entries) {
             const h = hourStartOf(e.at);
             const list = byHour.get(h) ?? [];
             list.push(e);
             byHour.set(h, list);
         }
-        const summaryByHour = new Map(this.visibleSummaries().map((s) => [s.hourStart, s.text]));
+        const summaryByHour = new Map(this.summaries.map((s) => [s.hourStart, s.text]));
         return [...byHour.entries()]
             .map(([hourStart, entries]) => {
             entries.sort((a, b) => a.at - b.at);
@@ -269,7 +263,7 @@ export class MemoryStore {
     async search(q) {
         await this.ensureLoaded();
         const limit = q.limit && q.limit > 0 ? Math.min(q.limit, QUERY_LIMIT_CAP) : QUERY_LIMIT_DEFAULT;
-        return searchMemoryEntries(this.visibleEntries(), {
+        return searchMemoryEntries(this.entries, {
             sinceMs: q.sinceMs,
             untilMs: q.untilMs,
             contains: q.contains,
@@ -279,7 +273,7 @@ export class MemoryStore {
     }
     async summaryList() {
         await this.ensureLoaded();
-        return this.visibleSummaries().sort((a, b) => b.hourStart - a.hourStart);
+        return [...this.summaries].sort((a, b) => b.hourStart - a.hourStart);
     }
     /** Most recent COMPLETED hour with lines but no summary, or null. */
     async pendingSummaryHour(nowMs = Date.now()) {
@@ -287,7 +281,7 @@ export class MemoryStore {
         const currentHour = hourStartOf(nowMs);
         const summarized = new Set(this.summaries.map((s) => s.hourStart));
         const hours = new Set();
-        for (const e of this.visibleEntries()) {
+        for (const e of this.entries) {
             if (e.kind !== "line")
                 continue;
             const h = hourStartOf(e.at);
@@ -428,29 +422,9 @@ export class MemoryStore {
             console.warn("MemoryStore: Assist migration failed:", err instanceof Error ? err.message : err);
         }
     }
-    retention() {
-        return this.hooks.getRetention?.() ?? STANDARD_RETENTION;
-    }
-    /** Entries inside the active tier's visibility window, oldest first. */
-    visibleEntries() {
-        const cutoff = Date.now() - this.retention().maxAgeMs;
-        return this.entries.filter((e) => e.at >= cutoff);
-    }
-    visibleSummaries() {
-        const cutoff = Date.now() - this.retention().maxAgeMs;
-        return this.summaries.filter((s) => s.hourStart >= cutoff);
-    }
-    /**
-     * Physical bounds, ALWAYS the extended policy regardless of tier. A free or
-     * lapsed user's older timeline stays on disk (reads just can't see past
-     * their window) so upgrading — or re-upgrading — restores it rather than
-     * finding it deleted. Deleting remains the user's call: clear()/removeScope
-     * operate on the physical store.
-     */
+    /** Keep the newest MEMORY_BOUNDS.maxEntries; nothing goes for age — deleting is the user's call. */
     prune() {
-        const { maxAgeMs, maxEntries } = EXTENDED_RETENTION;
-        const cutoff = Date.now() - maxAgeMs;
-        this.entries = this.entries.filter((e) => e.at >= cutoff);
+        const { maxEntries } = MEMORY_BOUNDS;
         if (this.entries.length > maxEntries)
             this.entries = this.entries.slice(-maxEntries);
     }
@@ -472,7 +446,7 @@ export class MemoryStore {
         this.logDirty = true;
         if (this.logFlushTimer)
             return;
-        this.logFlushTimer = setTimeout(() => {
+        this.logFlushTimer = BgTimer.setTimeout(() => {
             this.logFlushTimer = null;
             void this.persistLog().catch((err) => console.warn("MemoryStore: debounced log write failed:", err instanceof Error ? err.message : err));
         }, delay);
@@ -481,7 +455,7 @@ export class MemoryStore {
         // Any write of the full array satisfies whatever the debounce was holding.
         this.logDirty = false;
         if (this.logFlushTimer) {
-            clearTimeout(this.logFlushTimer);
+            BgTimer.clearTimeout(this.logFlushTimer);
             this.logFlushTimer = null;
         }
         if (this.loadedUserId == null)