@elizaos/capacitor-swabble 1.0.0 → 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# @elizaos/capacitor-swabble
+
+Capacitor plugin for wake-word detection and live speech transcription. Integrates with Eliza agent UIs to give users a hands-free voice interface across iOS, Android, browser, and desktop (Electrobun + Whisper.cpp).
+
+## What it does
+
+- Listens for configurable trigger phrases ("eliza", "hey assistant", etc.) and emits a `wakeWord` event carrying the detected command text.
+- Streams interim and final speech transcripts via a `transcript` event.
+- Exposes microphone state changes, audio level data (for VU-meter visualizations), and errors as typed events.
+- Manages microphone permissions across platforms.
+
+## Platforms
+
+| Platform | STT backend | Timing data |
+|----------|-------------|-------------|
+| iOS / macOS | Apple Speech framework | Yes |
+| Android | SpeechRecognizer API | Partial |
+| Browser | Web Speech API | No (postGap = -1) |
+| Desktop (Electrobun) | Whisper.cpp via IPC bridge | Yes |
+
+## Installation
+
+```bash
+npm install @elizaos/capacitor-swabble @capacitor/core
+npx cap sync
+```
+
+iOS requires the `Speech` and `AVFoundation` frameworks (linked automatically via the podspec). Android requires `RECORD_AUDIO` permission in your manifest.
+
+## Usage
+
+```typescript
+import { Swabble } from "@elizaos/capacitor-swabble";
+
+// Request microphone permission
+await Swabble.requestPermissions();
+
+// Listen for wake word + command
+const handle = await Swabble.addListener("wakeWord", (event) => {
+  console.log("Wake word:", event.wakeWord);
+  console.log("Command:", event.command);
+});
+
+// Start detection
+await Swabble.start({
+  config: {
+    triggers: ["eliza"],
+    minCommandLength: 3,
+    locale: "en-US",
+    modelSize: "small", // Whisper model for desktop
+  },
+});
+
+// Stop later
+await Swabble.stop();
+handle.remove();
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `triggers` | `string[]` | required | Wake phrases to detect |
+| `minPostTriggerGap` | `number` | — | Silence (seconds) required after trigger before command (native only) |
+| `minCommandLength` | `number` | `1` | Minimum command length in characters |
+| `locale` | `string` | `"en-US"` | Speech recognition locale |
+| `sampleRate` | `number` | `16000` | Audio sample rate (Hz) |
+| `modelSize` | `"tiny"\|"base"\|"small"\|"medium"\|"large"` | — | Whisper.cpp model size (desktop only) |
+
+## Events
+
+| Event | Description |
+|-------|-------------|
+| `wakeWord` | Trigger phrase detected; carries `wakeWord`, `command`, `transcript`, `postGap`, `confidence` |
+| `transcript` | Speech transcript update (interim and final); carries segments with timing |
+| `stateChange` | Microphone state: `idle`, `listening`, `processing`, `error` |
+| `audioLevel` | RMS level + peak (~10 Hz); useful for microphone visualizations |
+| `error` | Error with `code`, `message`, and `recoverable` flag |
+
+## Known limitations
+
+- **Web Speech API:** `postGap`, `start`, and `duration` in transcript segments are `-1` (timing unavailable). `setAudioDevice` throws on web.
+- **Device selection:** Only supported on native platforms; ignored or rejected on browser.
+
+## Building
+
+```bash
+bun run build   # tsc then rollup — produces dist/esm/, dist/plugin.js, dist/plugin.cjs.js
+bun run watch   # tsc --watch (no rollup)
+```

package/android/build.gradle

@@ -7,6 +7,16 @@ ext {
 }
 
 apply plugin: 'com.android.library'
+// Explicitly apply the Kotlin Android plugin. The kotlin-gradle-plugin is on
+// the root buildscript classpath, but without applying it here AGP 8.13 falls
+// back to its "built-in Kotlin" compile path (build/intermediates/
+// built_in_kotlinc), which compiles the .kt sources but does NOT bundle the
+// resulting .class files into the *release* library jar. The app's
+// :app:assembleRelease then links a library AAR with zero plugin classes, so
+// the Capacitor plugin (and any manifest-declared component) is absent from
+// the release dex. Applying the standard Kotlin plugin wires Kotlin
+// compilation into both the debug and release jar-bundling tasks.
+apply plugin: 'org.jetbrains.kotlin.android'
 android {
     namespace = "ai.eliza.plugins.swabble"
     compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
@@ -25,8 +35,12 @@ android {
     }
 
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_17
-        targetCompatibility JavaVersion.VERSION_17
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+
+    kotlinOptions {
+        jvmTarget = "21"
     }
 
 }
@@ -34,7 +48,7 @@ android {
 repositories {
     google()
     maven {
-        url = uri(rootProject.ext.mavenCentralMirrorUrl)
+        url = uri(rootProject.ext.has('mavenCentralMirrorUrl') ? rootProject.ext.mavenCentralMirrorUrl : 'https://repo.maven.apache.org/maven2')
     }
     mavenCentral()
 }

package/dist/esm/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAEvB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AA6JvB,qBAAa,UAAW,SAAQ,SAAS;IACvC,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA+C;IAGpE,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,qBAAqB;YAQf,oBAAoB;IAQlC,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,qBAAqB;YAOf,uBAAuB;IA+CrC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;IAWxB,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmFtE,OAAO,CAAC,kBAAkB;YAqCZ,yBAAyB;IAyBvC,OAAO,CAAC,wBAAwB;IAY1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9C,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAC;IAItD,YAAY,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBX,gBAAgB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA4BpD,kBAAkB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAetD,eAAe,IAAI,OAAO,CAAC;QAC/B,OAAO,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;IAgBI,cAAc,CAAC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAOpE"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAEvB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AA6JvB,qBAAa,UAAW,SAAQ,SAAS;IACvC,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA+C;IAGpE,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,qBAAqB;YAQf,oBAAoB;IAQlC,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,qBAAqB;YAOf,uBAAuB;IA+CrC,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,sBAAsB;IAWxB,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkFtE,OAAO,CAAC,kBAAkB;YAyCZ,yBAAyB;IAyBvC,OAAO,CAAC,wBAAwB;IAY1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9C,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAC;IAItD,YAAY,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBX,gBAAgB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAkCpD,kBAAkB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAkBtD,eAAe,IAAI,OAAO,CAAC;QAC/B,OAAO,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;IAiBI,cAAc,CAAC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAOpE"}

package/dist/esm/web.js

@@ -30,6 +30,34 @@ function subscribeDesktopBridgeEvent(options) {
 const getSpeechRecognition = () => window.SpeechRecognition ||
     window.webkitSpeechRecognition ||
     null;
+function normalizeConfig(config) {
+    if (!config || !Array.isArray(config.triggers)) {
+        throw new Error("Swabble config requires a triggers array");
+    }
+    const triggers = config.triggers
+        .filter((trigger) => typeof trigger === "string")
+        .map((trigger) => trigger.trim())
+        .filter(Boolean);
+    if (triggers.length === 0) {
+        throw new Error("Swabble config requires at least one non-empty trigger");
+    }
+    const minCommandLength = typeof config.minCommandLength === "number" &&
+        Number.isFinite(config.minCommandLength) &&
+        config.minCommandLength > 0
+        ? Math.floor(config.minCommandLength)
+        : 1;
+    const sampleRate = typeof config.sampleRate === "number" &&
+        Number.isFinite(config.sampleRate) &&
+        config.sampleRate > 0
+        ? Math.floor(config.sampleRate)
+        : 16000;
+    return {
+        ...config,
+        triggers,
+        minCommandLength,
+        sampleRate,
+    };
+}
 /**
  * WakeWordGate detects trigger phrases in transcripts.
  *
@@ -40,15 +68,22 @@ const getSpeechRecognition = () => window.SpeechRecognition ||
  */
 class WakeWordGate {
     constructor(config) {
-        this.triggers = config.triggers.map((t) => t.toLowerCase().trim());
+        const normalized = normalizeConfig(config);
+        this.triggers = normalized.triggers.map((t) => t.toLowerCase());
         this.minCommandLength = config.minCommandLength ?? 1;
         // Note: minPostTriggerGap cannot be enforced - Web Speech API lacks timing data
     }
     updateConfig(config) {
-        if (config.triggers)
-            this.triggers = config.triggers.map((t) => t.toLowerCase().trim());
-        if (config.minCommandLength !== undefined)
-            this.minCommandLength = config.minCommandLength;
+        if (config.triggers) {
+            this.triggers = normalizeConfig({
+                triggers: config.triggers,
+            }).triggers.map((t) => t.toLowerCase());
+        }
+        if (typeof config.minCommandLength === "number" &&
+            Number.isFinite(config.minCommandLength) &&
+            config.minCommandLength > 0) {
+            this.minCommandLength = Math.floor(config.minCommandLength);
+        }
     }
     /**
      * Match wake word in transcript using text-only detection.
@@ -190,6 +225,8 @@ export class SwabbleWeb extends WebPlugin {
         sink.connect(this.captureContext.destination);
     }
     computeRms(samples) {
+        if (samples.length === 0)
+            return 0;
         let sum = 0;
         for (let i = 0; i < samples.length; i++) {
             sum += samples[i] * samples[i];
@@ -218,6 +255,7 @@ export class SwabbleWeb extends WebPlugin {
     async start(options) {
         if (this.isActive)
             return { started: true };
+        const config = normalizeConfig(options.config);
         // Delegate to the native desktop bridge when available.
         const rpc = this.getRendererRpc();
         if (rpc) {
@@ -225,14 +263,14 @@ export class SwabbleWeb extends WebPlugin {
                 const result = await this.invokeDesktopRequest({
                     rpcMethod: "swabbleStart",
                     ipcChannel: "swabble:start",
-                    params: options,
+                    params: { ...options, config },
                 });
                 if (result?.started) {
                     this.isActive = true;
                     this.usingNativeIpc = true;
-                    this.config = options.config;
+                    this.config = config;
                     this.setupNativeListeners();
-                    await this.startNativeAudioCapture(options.config.sampleRate ?? 16000);
+                    await this.startNativeAudioCapture(config.sampleRate ?? 16000);
                     return result;
                 }
             }
@@ -247,13 +285,13 @@ export class SwabbleWeb extends WebPlugin {
                 error: "Speech recognition not supported in this browser",
             };
         }
-        this.config = options.config;
-        this.wakeGate = new WakeWordGate(options.config);
+        this.config = config;
+        this.wakeGate = new WakeWordGate(config);
         this.segments = [];
         const recognition = new SpeechRecognitionAPI();
         recognition.continuous = true;
         recognition.interimResults = true;
-        recognition.lang = options.config.locale || "en-US";
+        recognition.lang = config.locale || "en-US";
         recognition.onstart = () => {
             this.isActive = true;
             this.notifyListeners("stateChange", { state: "listening" });
@@ -291,10 +329,16 @@ export class SwabbleWeb extends WebPlugin {
         let transcript = "";
         let isFinal = false;
         for (let i = 0; i < event.results.length; i++) {
-            transcript += event.results[i][0].transcript;
-            if (event.results[i].isFinal)
+            const result = event.results[i];
+            const first = result?.[0];
+            if (!first || typeof first.transcript !== "string")
+                continue;
+            transcript += first.transcript;
+            if (result.isFinal)
                 isFinal = true;
         }
+        if (!transcript.trim())
+            return;
         // Web Speech API does not provide word-level timing.
         // Segments are provided for API compatibility but timing values are approximations.
         const words = transcript.split(/\s+/).filter(Boolean);
@@ -401,10 +445,14 @@ export class SwabbleWeb extends WebPlugin {
     async checkPermissions() {
         let microphone = "prompt";
         try {
-            const result = await navigator.permissions.query({
+            const result = await navigator.permissions?.query?.({
                 name: "microphone",
             });
-            microphone = result.state;
+            if (result?.state === "granted" ||
+                result?.state === "denied" ||
+                result?.state === "prompt") {
+                microphone = result.state;
+            }
         }
         catch {
             /* permissions.query not supported for microphone in some browsers */
@@ -424,7 +472,11 @@ export class SwabbleWeb extends WebPlugin {
     }
     async requestPermissions() {
         try {
-            const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+            const stream = await navigator.mediaDevices?.getUserMedia?.({
+                audio: true,
+            });
+            if (!stream)
+                throw new Error("mediaDevices.getUserMedia unavailable");
             stream.getTracks().forEach((track) => {
                 track.stop();
             });
@@ -439,7 +491,9 @@ export class SwabbleWeb extends WebPlugin {
     }
     async getAudioDevices() {
         try {
-            const devices = await navigator.mediaDevices.enumerateDevices();
+            const devices = await navigator.mediaDevices?.enumerateDevices?.();
+            if (!devices)
+                return { devices: [] };
             const audioInputs = devices
                 .filter((d) => d.kind === "audioinput")
                 .map((d, i) => ({

package/dist/esm/web.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web.test.d.ts.map

package/dist/esm/web.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.d.ts","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":""}

package/dist/esm/web.test.js

@@ -0,0 +1,170 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { SwabbleWeb } from "./web";
+class FakeRecognition extends EventTarget {
+    constructor() {
+        super();
+        this.continuous = false;
+        this.interimResults = false;
+        this.lang = "";
+        this.onstart = null;
+        this.onend = null;
+        this.onerror = null;
+        this.onresult = null;
+        this.start = vi.fn(() => {
+            this.onstart?.();
+        });
+        this.stop = vi.fn(() => {
+            this.onend?.();
+        });
+        this.abort = vi.fn();
+        FakeRecognition.latest = this;
+    }
+}
+FakeRecognition.latest = null;
+function setWindow(overrides = {}) {
+    Object.defineProperty(globalThis, "window", {
+        configurable: true,
+        value: overrides,
+    });
+}
+function setNavigator(value) {
+    Object.defineProperty(globalThis, "navigator", {
+        configurable: true,
+        value,
+    });
+}
+function speechEvent(transcript, isFinal = true, confidence = 0.8) {
+    return {
+        results: [
+            {
+                isFinal,
+                0: { transcript, confidence },
+            },
+        ],
+        resultIndex: 0,
+    };
+}
+describe("SwabbleWeb fallback", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+        FakeRecognition.latest = null;
+    });
+    it("reports unsupported speech recognition without microphone APIs", async () => {
+        setWindow();
+        setNavigator({});
+        await expect(new SwabbleWeb().checkPermissions()).resolves.toEqual({
+            microphone: "prompt",
+            speechRecognition: "not_supported",
+        });
+        await expect(new SwabbleWeb().requestPermissions()).resolves.toEqual({
+            microphone: "denied",
+            speechRecognition: "denied",
+        });
+        await expect(new SwabbleWeb().getAudioDevices()).resolves.toEqual({
+            devices: [],
+        });
+    });
+    it.each([
+        { triggers: [] },
+        { triggers: ["", "   "] },
+        { triggers: [123] },
+    ])("rejects malformed start config %#", async (config) => {
+        setWindow({ SpeechRecognition: FakeRecognition });
+        setNavigator({});
+        await expect(new SwabbleWeb().start({ config })).rejects.toThrow("Swabble config requires");
+        expect(FakeRecognition.latest).toBeNull();
+    });
+    it("emits transcript and wake-word events from valid final speech results", async () => {
+        setWindow({ SpeechRecognition: FakeRecognition });
+        setNavigator({
+            mediaDevices: {
+                getUserMedia: vi.fn(async () => null),
+            },
+        });
+        const plugin = new SwabbleWeb();
+        const states = vi.fn();
+        const transcripts = vi.fn();
+        const wakeWords = vi.fn();
+        await plugin.addListener("stateChange", states);
+        await plugin.addListener("transcript", transcripts);
+        await plugin.addListener("wakeWord", wakeWords);
+        await expect(plugin.start({
+            config: {
+                triggers: [" Eliza "],
+                minCommandLength: Number.NaN,
+                locale: "en-US",
+            },
+        })).resolves.toEqual({ started: true });
+        FakeRecognition.latest?.onresult?.(speechEvent("Eliza open calendar"));
+        expect(states).toHaveBeenCalledWith({ state: "listening" });
+        expect(transcripts).toHaveBeenCalledWith(expect.objectContaining({
+            transcript: "Eliza open calendar",
+            isFinal: true,
+        }));
+        expect(wakeWords).toHaveBeenCalledWith(expect.objectContaining({
+            wakeWord: "eliza",
+            command: "open calendar",
+            postGap: -1,
+        }));
+    });
+    it("ignores malformed speech result payloads without emitting transcripts", async () => {
+        setWindow({ SpeechRecognition: FakeRecognition });
+        setNavigator({
+            mediaDevices: {
+                getUserMedia: vi.fn(async () => null),
+            },
+        });
+        const plugin = new SwabbleWeb();
+        const transcripts = vi.fn();
+        await plugin.addListener("transcript", transcripts);
+        await plugin.start({ config: { triggers: ["eliza"] } });
+        FakeRecognition.latest?.onresult?.({
+            results: [{ isFinal: true, 0: { transcript: 42 } }],
+            resultIndex: 0,
+        });
+        expect(transcripts).not.toHaveBeenCalled();
+    });
+    it("uses desktop bridge state changes and removes subscriptions on stop", async () => {
+        const listeners = new Map();
+        const swabbleStart = vi.fn(async () => ({ started: true }));
+        const swabbleStop = vi.fn(async () => undefined);
+        const onMessage = vi.fn((name, listener) => {
+            listeners.set(name, listener);
+        });
+        const offMessage = vi.fn((name) => {
+            listeners.delete(name);
+        });
+        setWindow({
+            __ELIZA_ELECTROBUN_RPC__: {
+                request: {
+                    swabbleStart,
+                    swabbleStop,
+                    swabbleAudioChunk: vi.fn(async () => undefined),
+                },
+                onMessage,
+                offMessage,
+            },
+        });
+        setNavigator({
+            mediaDevices: {
+                getUserMedia: vi.fn(async () => null),
+            },
+        });
+        const plugin = new SwabbleWeb();
+        const states = vi.fn();
+        await plugin.addListener("stateChange", states);
+        await plugin.start({
+            config: { triggers: ["eliza"], sampleRate: Infinity },
+        });
+        expect(swabbleStart).toHaveBeenCalledWith({
+            config: { triggers: ["eliza"], minCommandLength: 1, sampleRate: 16000 },
+        });
+        listeners.get("swabbleStateChanged")?.({ listening: true });
+        await expect(plugin.isListening()).resolves.toEqual({ listening: true });
+        await plugin.stop();
+        expect(swabbleStop).toHaveBeenCalled();
+        expect(offMessage).toHaveBeenCalled();
+        expect(states).toHaveBeenLastCalledWith({ state: "idle" });
+    });
+});