@happyvertical/smrt-svelte 0.30.0 → 0.31.0

package/dist/hooks/useSTT.svelte.js

@@ -33,6 +33,10 @@ import { getAppStateContext } from '../state/context.js';
  */
 export function useSTT(options = {}) {
     const app = getAppStateContext();
+    // The STT manager is a Provider-level singleton shared by every useSTT()
+    // consumer. Track whether *this* hook started the current listening session
+    // so unmounting one <VoiceInput> doesn't abort another's recording (R4).
+    let startedByThisHook = false;
     // Auto-initialize if requested
     if (options.autoInit) {
         app.initializeSTT().catch(() => {
@@ -40,22 +44,32 @@ export function useSTT(options = {}) {
         });
     }
     const start = async (sttOptions) => {
-        await app.startListening({
-            ...options.defaultOptions,
-            ...sttOptions,
-        });
+        startedByThisHook = true;
+        try {
+            await app.startListening({
+                ...options.defaultOptions,
+                ...sttOptions,
+            });
+        }
+        catch (err) {
+            startedByThisHook = false;
+            throw err;
+        }
     };
     const stop = async () => {
+        startedByThisHook = false;
         await app.stopListening();
     };
     const initialize = async (initOptions) => {
         await app.initializeSTT(initOptions);
     };
-    // Cleanup on destroy
+    // Cleanup on destroy: only stop the shared singleton if this hook owns the
+    // in-progress session (R4) — never stop a recording another hook started.
     onDestroy(() => {
-        if (app.state.ai.stt.isListening) {
+        if (startedByThisHook && app.state.ai.stt.isListening) {
             app.stopListening().catch(() => { });
         }
+        startedByThisHook = false;
     });
     return {
         start,

package/dist/hooks/useTTS.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTTS.svelte.d.ts","sourceRoot":"","sources":["../../src/hooks/useTTS.svelte.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,oBAAoB;IACpB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,qBAAqB;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gEAAgE;IAChE,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,QAAQ,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAsEhE"}
+{"version":3,"file":"useTTS.svelte.d.ts","sourceRoot":"","sources":["../../src/hooks/useTTS.svelte.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,oBAAoB;IACpB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,qBAAqB;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gEAAgE;IAChE,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,QAAQ,EAAE,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAoFhE"}

package/dist/hooks/useTTS.svelte.js

@@ -31,6 +31,10 @@ import { getAppStateContext } from '../state/context.js';
  */
 export function useTTS(options = {}) {
     const app = getAppStateContext();
+    // The TTS manager is a Provider-level singleton shared by every useTTS()
+    // consumer. Track whether *this* hook started the current speech so
+    // unmounting one component doesn't cut off another's playback (R4).
+    let startedByThisHook = false;
     // Auto-initialize if requested
     if (options.autoInit) {
         app.initializeTTS().catch(() => {
@@ -38,12 +42,20 @@ export function useTTS(options = {}) {
         });
     }
     const speak = async (text, ttsOptions) => {
-        await app.speak(text, {
-            ...options.defaultOptions,
-            ...ttsOptions,
-        });
+        startedByThisHook = true;
+        try {
+            await app.speak(text, {
+                ...options.defaultOptions,
+                ...ttsOptions,
+            });
+        }
+        finally {
+            // Speech has finished (or errored) — this hook no longer owns playback.
+            startedByThisHook = false;
+        }
     };
     const stop = () => {
+        startedByThisHook = false;
         app.stopSpeaking();
     };
     const pause = () => {
@@ -58,11 +70,13 @@ export function useTTS(options = {}) {
     const getVoices = () => {
         return app.getTTSVoices();
     };
-    // Cleanup on destroy
+    // Cleanup on destroy: only stop the shared singleton if this hook owns the
+    // in-progress speech (R4) — never cut off speech another hook started.
     onDestroy(() => {
-        if (app.state.ai.tts.isSpeaking) {
+        if (startedByThisHook && app.state.ai.tts.isSpeaking) {
             app.stopSpeaking();
         }
+        startedByThisHook = false;
     });
     return {
         speak,

package/dist/i18n/server.d.ts

@@ -9,11 +9,11 @@
  * A consumer's load function calls `buildI18nSnapshot` for the request locale
  * and passes the result to `<Provider i18n={snapshot}>`.
  *
- * Requires `@happyvertical/smrt-languages` to be installed. It is an *optional*
- * peer of smrt-svelte by design — the client i18n layer (`/i18n`) is
- * languages-free, so apps that never use this server bridge are not forced to
- * pull the languages server dependency tree (smrt-core/sql/ai/jobs). Importing
- * this subpath without languages installed is a clear module-not-found error.
+ * `@happyvertical/smrt-languages` is a hard `dependency` of smrt-svelte (see
+ * `package.json`), so it is always installed. The client i18n layer (`/i18n`)
+ * stays languages-free regardless: it never imports the languages root, so the
+ * server tree (smrt-core/sql/ai/jobs) is tree-shaken out of the browser bundle
+ * — only this Node-only `/i18n/server` subpath pulls it in.
  */
 import { type ResolveLanguageStringOptions } from '@happyvertical/smrt-languages';
 import { type I18nSnapshot } from '@happyvertical/smrt-ui/i18n';

package/dist/i18n/server.js

@@ -9,11 +9,11 @@
  * A consumer's load function calls `buildI18nSnapshot` for the request locale
  * and passes the result to `<Provider i18n={snapshot}>`.
  *
- * Requires `@happyvertical/smrt-languages` to be installed. It is an *optional*
- * peer of smrt-svelte by design — the client i18n layer (`/i18n`) is
- * languages-free, so apps that never use this server bridge are not forced to
- * pull the languages server dependency tree (smrt-core/sql/ai/jobs). Importing
- * this subpath without languages installed is a clear module-not-found error.
+ * `@happyvertical/smrt-languages` is a hard `dependency` of smrt-svelte (see
+ * `package.json`), so it is always installed. The client i18n layer (`/i18n`)
+ * stays languages-free regardless: it never imports the languages root, so the
+ * server tree (smrt-core/sql/ai/jobs) is tree-shaken out of the browser bundle
+ * — only this Node-only `/i18n/server` subpath pulls it in.
  */
 import { defineLanguageString, LanguageRegistry, resolveLanguageString, } from '@happyvertical/smrt-languages';
 import { getRegisteredDefaults, } from '@happyvertical/smrt-ui/i18n';

package/dist/internal/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared package logger for `@happyvertical/smrt-svelte`.
+ *
+ * Browser-safe: the `@happyvertical/logger` console adapter pulls no Node
+ * built-ins and its `@sentry/node` integration is an optional peer that is
+ * never imported here. Centralising the instance keeps voice/AI error reporting
+ * consistent across the form components (mic permission denials, STT init
+ * failures) instead of swallowing them in empty `catch` blocks or scattering
+ * raw `console.*` calls.
+ */
+import { type Logger } from '@happyvertical/logger';
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/internal/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/internal/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAElE,eAAO,MAAM,MAAM,EAAE,MAAwC,CAAC"}

package/dist/internal/logger.js

@@ -0,0 +1,12 @@
+/**
+ * Shared package logger for `@happyvertical/smrt-svelte`.
+ *
+ * Browser-safe: the `@happyvertical/logger` console adapter pulls no Node
+ * built-ins and its `@sentry/node` integration is an optional peer that is
+ * never imported here. Centralising the instance keeps voice/AI error reporting
+ * consistent across the form components (mic permission denials, STT init
+ * failures) instead of swallowing them in empty `catch` blocks or scattering
+ * raw `console.*` calls.
+ */
+import { createLogger } from '@happyvertical/logger';
+export const logger = createLogger({ level: 'warn' });

package/dist/state/__tests__/app-state-ai-lifecycle.test.js

@@ -0,0 +1,240 @@
+/**
+ * Regression tests for the browser-AI warm-cache lifecycle (T2 #1403):
+ *
+ * - R1 (listener leak): warm-cached adapters survive Provider remounts. Each
+ *   manager that subscribes must capture + later remove its listeners on
+ *   dispose(), and a shared adapter must never accumulate more than one live
+ *   listener set across managers.
+ * - R2 (state lies): dispose() must not leave a disposed adapter cached as
+ *   'ready'; unloadLLM() must downgrade the warm-cache entry so the next init
+ *   re-runs (reports progress) instead of cache-hitting a model-less adapter.
+ * - R3 (scheduler thrash): setAIConfig() must no-op on a deep-equal config
+ *   (inline `ai={{…}}` literal => new identity every render), and concurrent
+ *   executePreload() passes must be guarded.
+ * - R7 (nit): the empty-config early-return must reset loaded/failed too.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// --- Fakes -----------------------------------------------------------------
+/**
+ * A fake STT/TTS adapter whose event-subscription methods return real
+ * unsubscribe handles backed by Sets — so a test can read the live listener
+ * count and prove subscriptions are torn down (R1).
+ */
+function makeFakeSTT(type = 'whisper-cpp') {
+    const sets = {
+        result: new Set(),
+        start: new Set(),
+        end: new Set(),
+        error: new Set(),
+    };
+    const sub = (set, cb) => {
+        set.add(cb);
+        return () => {
+            set.delete(cb);
+        };
+    };
+    return {
+        type,
+        dispose: vi.fn(async () => { }),
+        ensureInitialized: vi.fn(async () => { }),
+        start: vi.fn(async () => { }),
+        stop: vi.fn(async () => { }),
+        abort: vi.fn(),
+        isListening: () => false,
+        onResult: (cb) => sub(sets.result, cb),
+        onStart: (cb) => sub(sets.start, cb),
+        onEnd: (cb) => sub(sets.end, cb),
+        onError: (cb) => sub(sets.error, cb),
+        /** total live listeners across all event sets */
+        listenerCount: () => sets.result.size + sets.start.size + sets.end.size + sets.error.size,
+    };
+}
+function makeFakeTTS(type = 'browser-synthesis') {
+    const sets = {
+        start: new Set(),
+        end: new Set(),
+        error: new Set(),
+    };
+    const sub = (set, cb) => {
+        set.add(cb);
+        return () => {
+            set.delete(cb);
+        };
+    };
+    return {
+        type,
+        dispose: vi.fn(async () => { }),
+        ensureInitialized: vi.fn(async () => { }),
+        speak: vi.fn(async () => { }),
+        stop: vi.fn(),
+        pause: vi.fn(),
+        resume: vi.fn(),
+        getVoices: () => [],
+        onStart: (cb) => sub(sets.start, cb),
+        onEnd: (cb) => sub(sets.end, cb),
+        onError: (cb) => sub(sets.error, cb),
+        listenerCount: () => sets.start.size + sets.end.size + sets.error.size,
+    };
+}
+function makeFakeLLM(type = 'webllm', model = 'tiny-model') {
+    return {
+        type,
+        currentModel: model,
+        dispose: vi.fn(async () => { }),
+        ensureInitialized: vi.fn(async () => { }),
+        unloadModel: vi.fn(async () => { }),
+        message: vi.fn(async () => 'ok'),
+    };
+}
+// --- Module mocks ----------------------------------------------------------
+// The manager imports the AI factories + capability helpers from the browser-ai
+// barrel. Mock only those; keep everything else (types) real via importOriginal.
+const fakeSTT = makeFakeSTT();
+const fakeTTS = makeFakeTTS();
+const fakeLLM = makeFakeLLM();
+vi.mock('../../browser-ai/index.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        detectCapabilities: () => ({}),
+        canEnableSmrtMode: () => false,
+        getSTT: vi.fn(async () => fakeSTT),
+        getTTS: vi.fn(async () => fakeTTS),
+        getLLM: vi.fn(async () => fakeLLM),
+    };
+});
+import { createAppState, } from '../app-state.svelte.js';
+import { clearAllCaches, getCachedLLM, getCachedSTT } from '../warm-clients.js';
+beforeEach(async () => {
+    await clearAllCaches();
+});
+afterEach(async () => {
+    await clearAllCaches();
+    vi.clearAllMocks();
+});
+describe('R1: warm-adapter listener lifecycle', () => {
+    it("removes a manager's listeners on dispose()", async () => {
+        const m = createAppState();
+        await m.initializeSTT({ type: 'whisper-cpp' });
+        expect(fakeSTT.listenerCount()).toBeGreaterThan(0);
+        await m.dispose();
+        expect(fakeSTT.listenerCount()).toBe(0);
+    });
+    it('does not accumulate listeners across remounts of the same cached adapter', async () => {
+        // Manager 1 subscribes then disposes.
+        const m1 = createAppState();
+        await m1.initializeSTT({ type: 'whisper-cpp' });
+        const afterFirst = fakeSTT.listenerCount();
+        await m1.dispose();
+        // Manager 2 cache-hits the SAME warm adapter, subscribes, disposes.
+        const m2 = createAppState();
+        await m2.initializeSTT({ type: 'whisper-cpp' });
+        // Exactly one manager's worth of listeners while live — not doubled.
+        expect(fakeSTT.listenerCount()).toBe(afterFirst);
+        await m2.dispose();
+        expect(fakeSTT.listenerCount()).toBe(0);
+    });
+    it('keeps at most one live listener set when two managers coexist', async () => {
+        const m1 = createAppState();
+        await m1.initializeSTT({ type: 'whisper-cpp' });
+        const single = fakeSTT.listenerCount();
+        // A second live manager taking over the shared adapter must evict the
+        // first's listeners rather than stack a second set.
+        const m2 = createAppState();
+        await m2.initializeSTT({ type: 'whisper-cpp' });
+        expect(fakeSTT.listenerCount()).toBe(single);
+        await m1.dispose();
+        await m2.dispose();
+        expect(fakeSTT.listenerCount()).toBe(0);
+    });
+    it('removes TTS listeners on dispose()', async () => {
+        const m = createAppState();
+        await m.initializeTTS({ type: 'browser-synthesis' });
+        expect(fakeTTS.listenerCount()).toBeGreaterThan(0);
+        await m.dispose();
+        expect(fakeTTS.listenerCount()).toBe(0);
+    });
+    it('subscribing the same adapter twice on one manager is idempotent', async () => {
+        const m = createAppState();
+        await m.initializeSTT({ type: 'whisper-cpp' });
+        const once = fakeSTT.listenerCount();
+        // Second init cache-hits and re-enters subscribeToSTTEvents.
+        await m.initializeSTT({ type: 'whisper-cpp' });
+        expect(fakeSTT.listenerCount()).toBe(once);
+        await m.dispose();
+    });
+});
+describe('R2: dispose()/unloadLLM() do not leave the cache lying', () => {
+    it('dispose() leaves the warm STT adapter intact (not disposed) and cached ready', async () => {
+        const m = createAppState();
+        await m.initializeSTT({ type: 'whisper-cpp' });
+        await m.dispose();
+        // Cached adapter survives navigation and was NOT disposed — so a later
+        // init won't restore a dead engine reported as 'ready'.
+        const cached = getCachedSTT('whisper-cpp');
+        expect(cached?.initState).toBe('ready');
+        expect(cached?.adapter).toBe(fakeSTT);
+        expect(fakeSTT.dispose).not.toHaveBeenCalled();
+    });
+    it('unloadLLM() downgrades the warm-cache entry to uninitialized', async () => {
+        const m = createAppState();
+        await m.initializeLLM('tiny-model', { type: 'webllm' });
+        expect(getCachedLLM('webllm', 'tiny-model')?.initState).toBe('ready');
+        await m.unloadLLM();
+        // Next initializeLLM must re-run (report progress) rather than cache-hit a
+        // model-less adapter reported as 'ready'.
+        expect(getCachedLLM('webllm', 'tiny-model')?.initState).toBe('uninitialized');
+        await m.dispose();
+    });
+});
+describe('R3: setAIConfig scheduler thrash + preload re-entrancy', () => {
+    it('no-ops on a deep-equal config of a different identity', async () => {
+        const m = createAppState();
+        const spy = vi.spyOn(m, 'schedulePreload');
+        m.setAIConfig({ preload: 'none', stt: { type: 'whisper-cpp' } });
+        const callsAfterFirst = spy.mock.calls.length;
+        expect(callsAfterFirst).toBeGreaterThan(0);
+        // Same shape, brand-new object literal (what an inline `ai={{…}}` produces).
+        m.setAIConfig({ preload: 'none', stt: { type: 'whisper-cpp' } });
+        expect(spy.mock.calls.length).toBe(callsAfterFirst); // no re-schedule
+    });
+    it('re-schedules when the config actually changes', async () => {
+        const m = createAppState();
+        const spy = vi.spyOn(m, 'schedulePreload');
+        m.setAIConfig({ preload: 'none', stt: { type: 'whisper-cpp' } });
+        const before = spy.mock.calls.length;
+        m.setAIConfig({ preload: 'none', stt: { type: 'whisper-wasm' } });
+        expect(spy.mock.calls.length).toBe(before + 1);
+    });
+    it('guards executePreload against concurrent passes', async () => {
+        const m = createAppState();
+        m.setAIConfig({
+            preload: 'none',
+            stt: { type: 'whisper-cpp' },
+        });
+        const exec = m.executePreload.bind(m);
+        // Two overlapping passes: the second must early-return (guarded), so the
+        // STT factory is invoked once, not twice.
+        const { getSTT } = (await import('../../browser-ai/index.js'));
+        getSTT.mockClear();
+        await Promise.all([exec(), exec()]);
+        expect(getSTT).toHaveBeenCalledTimes(1);
+        await m.dispose();
+    });
+});
+describe('R7: empty-config preload early-return resets loaded/failed', () => {
+    it('clears stale loaded/failed entries', async () => {
+        const m = createAppState();
+        // Seed stale entries through a normal pass, then re-run with empty config.
+        m.setAIConfig({ preload: 'none', stt: { type: 'whisper-cpp' } });
+        await m.executePreload();
+        expect(m.aiLoading.loaded.length).toBeGreaterThan(0);
+        // Now an empty config — the early-return path must reset loaded/failed.
+        m.setAIConfig({ preload: 'none' });
+        await m.executePreload();
+        expect(m.aiLoading.phase).toBe('idle');
+        expect(m.aiLoading.loaded).toEqual([]);
+        expect(m.aiLoading.failed).toEqual([]);
+        await m.dispose();
+    });
+});

package/dist/state/app-state.svelte.d.ts

@@ -15,11 +15,12 @@ export declare class SmrtAppStateManager {
     private _aiConfig;
     private _preloadScheduled;
     private _idleCallbackId;
+    private _preloadInFlight;
     private _socket;
     private _socketConfig;
     private _reconnectTimeout;
-    private _subscribedSTTAdapters;
-    private _subscribedTTSAdapters;
+    private _sttSubscriptions;
+    private _ttsSubscriptions;
     constructor(options?: CreateAppStateOptions);
     /**
      * Get the current socket configuration (for reconnection)
@@ -44,7 +45,15 @@ export declare class SmrtAppStateManager {
      */
     initialize(): Promise<void>;
     /**
-     * Set or update AI configuration
+     * Set or update AI configuration.
+     *
+     * No-ops when the incoming config is deep-equal to the current one. The
+     * Provider's `ai` $effect depends on the prop's identity, and the documented
+     * usage passes an inline `ai={{…}}` object literal — a fresh identity on every
+     * parent render. Without this guard each render would cancel the idle
+     * callback, reset `_preloadScheduled`, and re-schedule (and, for `eager`,
+     * re-launch a full preload), thrashing the scheduler and double-downloading
+     * models (R3).
      */
     setAIConfig(config: AIConfig): void;
     /**
@@ -56,9 +65,18 @@ export declare class SmrtAppStateManager {
      */
     triggerPreload(): void;
     /**
-     * Execute the preloading of configured adapters
+     * Execute the preloading of configured adapters.
+     *
+     * Re-entrancy guarded: an `idle`/`eager` strategy can be re-scheduled while a
+     * pass is still awaiting model downloads. Without the guard the overlapping
+     * passes interleave their aiLoading writes and double-download models (R3).
      */
     private executePreload;
+    /**
+     * The actual preload pass. Always invoked behind the `_preloadInFlight` guard
+     * in {@link executePreload}.
+     */
+    private runPreload;
     /**
      * Update the AI loading state
      */
@@ -118,8 +136,13 @@ export declare class SmrtAppStateManager {
      */
     initializeSTT(options?: GetSTTOptions): Promise<STTAdapter>;
     /**
-     * Subscribe to STT adapter events
-     * Only subscribes once per adapter instance to prevent duplicate listeners
+     * Subscribe to STT adapter events.
+     *
+     * Captures every unsubscribe handle the adapter returns and stores a single
+     * teardown both per-manager (called on dispose()) and at module scope keyed
+     * by adapter identity. Because warm adapters are shared singletons, any
+     * previous owner's listeners are torn down first — guaranteeing exactly one
+     * live listener set per adapter, with the latest manager owning it (R1).
      */
     private subscribeToSTTEvents;
     /**
@@ -136,8 +159,11 @@ export declare class SmrtAppStateManager {
      */
     initializeTTS(options?: GetTTSOptions): Promise<TTSAdapter>;
     /**
-     * Subscribe to TTS adapter events
-     * Only subscribes once per adapter instance to prevent duplicate listeners
+     * Subscribe to TTS adapter events.
+     *
+     * Mirrors {@link subscribeToSTTEvents}: captures unsubscribe handles, dedups
+     * per-manager, and evicts any prior owner so a shared warm adapter never
+     * pins more than one manager's `_state` proxy (R1).
      */
     private subscribeToTTSEvents;
     /**
@@ -176,6 +202,12 @@ export declare class SmrtAppStateManager {
      * Unload LLM model to free memory
      */
     unloadLLM(): Promise<void>;
+    /**
+     * Unsubscribe every adapter-event listener this manager owns (R1). Called on
+     * dispose() so a destroyed Provider stops being pinned by the shared warm
+     * adapters' module-surviving listener `Set`s.
+     */
+    private unsubscribeAllAdapterEvents;
     /**
      * Dispose of all resources
      */

package/dist/state/app-state.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-state.svelte.d.ts","sourceRoot":"","sources":["../../src/state/app-state.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-state.svelte.d.ts","sourceRoot":"","sources":["../../src/state/app-state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAIlB,KAAK,UAAU,EAEf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAE1B,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AA6CxB;;GAEG;AACH,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,MAAM,CAA8C;IAG5D,OAAO,CAAC,OAAO,CAAwB;IAGvC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAuB;IAM9C,OAAO,CAAC,gBAAgB,CAAS;IAGjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,iBAAiB,CAA8C;IAOvE,OAAO,CAAC,iBAAiB,CAAqC;IAC9D,OAAO,CAAC,iBAAiB,CAAqC;gBAElD,OAAO,GAAE,qBAA0B;IAK/C;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAEtC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,CAElC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAE9B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC,CAExC;IAED;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CjC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAuBnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,cAAc,IAAI,IAAI;IAQtB;;;;;;OAMG;YACW,cAAc;IAW5B;;;OAGG;YACW,UAAU;IAyGxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,UAAsB,GAAG,IAAI;IAmB5D;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAOlD;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAI3C;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO;IAMjD;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO;IAMhD;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,IAAI;IAQ5D;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IA+CzC;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAexB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAQhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAoEjE;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAmD5B;;OAEG;IACG,cAAc,CAClB,OAAO,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAuDjE;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAsC5B;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;OAEG;IACH,YAAY;IAMZ;;;OAGG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,UAAU,CAAC;IAoEtB;;OAEG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACrE,OAAO,CAAC,MAAM,CAAC;IAgBlB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BhC;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD9B;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAKvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAMzB;CACF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,mBAAmB,CAErB"}