@elizaos/capacitor-talkmode 1.0.0

package/dist/esm/definitions.d.ts

@@ -0,0 +1,277 @@
+import type { PluginListenerHandle } from "@capacitor/core";
+/**
+ * TTS voice directive from assistant response
+ */
+export interface TTSDirective {
+    /** Voice ID to use (ElevenLabs voice ID or alias) */
+    voiceId?: string;
+    /** Model ID for ElevenLabs */
+    modelId?: string;
+    /** Output format (e.g., "pcm_24000", "mp3_44100") */
+    outputFormat?: string;
+    /** Speech rate multiplier (0.5-2.0) */
+    speed?: number;
+    /** Words per minute rate */
+    rateWpm?: number;
+    /** Voice stability (0-1) */
+    stability?: number;
+    /** Voice similarity boost (0-1) */
+    similarity?: number;
+    /** Style exaggeration (0-1) */
+    style?: number;
+    /** Enable speaker boost */
+    speakerBoost?: boolean;
+    /** Seed for reproducible output */
+    seed?: number;
+    /** Normalize audio levels */
+    normalize?: boolean;
+    /** Language code (e.g., "en", "es") */
+    language?: string;
+    /** Latency optimization tier (1-4) */
+    latencyTier?: number;
+    /** Apply only to this utterance */
+    once?: boolean;
+}
+/**
+ * TTS configuration
+ */
+export interface TTSConfig {
+    /** Default ElevenLabs voice ID */
+    voiceId?: string;
+    /** Default ElevenLabs model ID */
+    modelId?: string;
+    /** Default output format */
+    outputFormat?: string;
+    /** ElevenLabs API key */
+    apiKey?: string;
+    /** Voice aliases mapping (name -> voiceId) */
+    voiceAliases?: Record<string, string>;
+    /** Whether to interrupt playback when user speaks */
+    interruptOnSpeech?: boolean;
+}
+/**
+ * Options for speaking text
+ */
+export interface SpeakOptions {
+    /** Text to speak */
+    text: string;
+    /** Optional directive overrides */
+    directive?: TTSDirective;
+    /** Force use of system TTS */
+    useSystemTts?: boolean;
+}
+/**
+ * Result of speak operation
+ */
+export interface SpeakResult {
+    /** Whether speech completed successfully */
+    completed: boolean;
+    /** Whether playback was interrupted */
+    interrupted: boolean;
+    /** Time at which playback was interrupted (seconds from start) */
+    interruptedAt?: number;
+    /** Whether system TTS was used as fallback */
+    usedSystemTts: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Talk mode configuration
+ */
+export interface TalkModeConfig {
+    /** Session key for chat */
+    sessionKey?: string;
+    /** TTS configuration */
+    tts?: TTSConfig;
+    /** STT configuration (desktop whisper/web) */
+    stt?: {
+        /** STT engine preference */
+        engine?: "whisper" | "web";
+        /** Whisper model size */
+        modelSize?: "tiny" | "base" | "small" | "medium" | "large";
+        /** Language code (e.g., "en", "es") */
+        language?: string;
+        /** Audio sample rate in Hz (default: 16000) */
+        sampleRate?: number;
+    };
+    /** Silence window before finalizing transcript (ms) */
+    silenceWindowMs?: number;
+    /** Whether to use interrupt-on-speech */
+    interruptOnSpeech?: boolean;
+}
+/**
+ * Talk mode state
+ */
+export type TalkModeState = "idle" | "listening" | "processing" | "speaking" | "error";
+/**
+ * Talk mode state event
+ */
+export interface TalkModeStateEvent {
+    /** Current state */
+    state: TalkModeState;
+    /** Previous state */
+    previousState: TalkModeState;
+    /** Status message */
+    statusText: string;
+    /** Whether system TTS is being used */
+    usingSystemTts?: boolean;
+}
+/**
+ * Transcript event during talk mode
+ */
+export interface TalkModeTranscriptEvent {
+    /** Transcript text */
+    transcript: string;
+    /** Whether this is final */
+    isFinal: boolean;
+}
+/**
+ * TTS start event
+ */
+export interface TTSSpeakingEvent {
+    /** Text being spoken */
+    text: string;
+    /** Whether using system TTS */
+    isSystemTts: boolean;
+}
+/**
+ * TTS completion event
+ */
+export interface TTSCompleteEvent {
+    /** Whether completed without interruption */
+    completed: boolean;
+    /** Interrupted at time (seconds) if interrupted */
+    interruptedAt?: number;
+}
+/**
+ * Talk mode error event
+ */
+export interface TalkModeErrorEvent {
+    /** Error code */
+    code: string;
+    /** Error message */
+    message: string;
+    /** Whether recoverable */
+    recoverable: boolean;
+}
+/**
+ * Permission status for talk mode
+ */
+export interface TalkModePermissionStatus {
+    /** Microphone permission */
+    microphone: "granted" | "denied" | "prompt";
+    /** Speech recognition permission */
+    speechRecognition: "granted" | "denied" | "prompt" | "not_supported";
+}
+/**
+ * TalkMode Plugin Interface
+ *
+ * Provides full conversation mode with STT → chat → TTS flow.
+ * Uses ElevenLabs for high-quality TTS with system TTS fallback.
+ */
+export interface TalkModePlugin {
+    /**
+     * Start talk mode
+     *
+     * @param options - Configuration options
+     * @returns Promise resolving when started
+     */
+    start(options?: {
+        config?: TalkModeConfig;
+    }): Promise<{
+        started: boolean;
+        error?: string;
+    }>;
+    /**
+     * Stop talk mode
+     *
+     * @returns Promise that resolves when stopped
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if talk mode is enabled
+     *
+     * @returns Promise resolving to enabled status
+     */
+    isEnabled(): Promise<{
+        enabled: boolean;
+    }>;
+    /**
+     * Get current state
+     *
+     * @returns Promise resolving to current state
+     */
+    getState(): Promise<{
+        state: TalkModeState;
+        statusText: string;
+    }>;
+    /**
+     * Update configuration
+     *
+     * @param options - New configuration
+     * @returns Promise that resolves when updated
+     */
+    updateConfig(options: {
+        config: Partial<TalkModeConfig>;
+    }): Promise<void>;
+    /**
+     * Speak text using TTS
+     *
+     * @param options - Text and options
+     * @returns Promise resolving to speak result
+     */
+    speak(options: SpeakOptions): Promise<SpeakResult>;
+    /**
+     * Stop current TTS playback
+     *
+     * @returns Promise that resolves when stopped
+     */
+    stopSpeaking(): Promise<{
+        interruptedAt?: number;
+    }>;
+    /**
+     * Check if currently speaking
+     *
+     * @returns Promise resolving to speaking status
+     */
+    isSpeaking(): Promise<{
+        speaking: boolean;
+    }>;
+    /**
+     * Check permissions
+     *
+     * @returns Promise resolving to permission status
+     */
+    checkPermissions(): Promise<TalkModePermissionStatus>;
+    /**
+     * Request permissions
+     *
+     * @returns Promise resolving to permission status after request
+     */
+    requestPermissions(): Promise<TalkModePermissionStatus>;
+    /**
+     * Add listener for state changes
+     */
+    addListener(eventName: "stateChange", listenerFunc: (event: TalkModeStateEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Add listener for transcript updates during listening
+     */
+    addListener(eventName: "transcript", listenerFunc: (event: TalkModeTranscriptEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Add listener for TTS start
+     */
+    addListener(eventName: "speaking", listenerFunc: (event: TTSSpeakingEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Add listener for TTS completion
+     */
+    addListener(eventName: "speakComplete", listenerFunc: (event: TTSCompleteEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Add listener for errors
+     */
+    addListener(eventName: "error", listenerFunc: (event: TalkModeErrorEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners
+     */
+    removeAllListeners(): Promise<void>;
+}
+//# sourceMappingURL=definitions.d.ts.map

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

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

package/dist/esm/definitions.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { TalkModePlugin } from "./definitions";
+export * from "./definitions";
+export declare const TalkMode: TalkModePlugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,cAAc,eAAe,CAAC;AAI9B,eAAO,MAAM,QAAQ,gBAEnB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+import { registerPlugin } from "@capacitor/core";
+export * from "./definitions";
+const loadWeb = () => import("./web").then((m) => new m.TalkModeWeb());
+export const TalkMode = registerPlugin("TalkMode", {
+    web: loadWeb,
+});

package/dist/esm/web.d.ts

@@ -0,0 +1,46 @@
+import { WebPlugin } from "@capacitor/core";
+import type { SpeakOptions, SpeakResult, TalkModeConfig, TalkModePermissionStatus, TalkModeState } from "./definitions";
+/**
+ * Web implementation of TalkMode plugin
+ *
+ * Uses Web Speech API for TTS with limited functionality compared to native.
+ * ElevenLabs streaming is not supported on web due to CORS limitations.
+ */
+export declare class TalkModeWeb extends WebPlugin {
+    private config;
+    private state;
+    private statusText;
+    private synthesis;
+    private currentUtterance;
+    private recognition;
+    private enabled;
+    constructor();
+    start(options?: {
+        config?: TalkModeConfig;
+    }): Promise<{
+        started: boolean;
+        error?: string;
+    }>;
+    stop(): Promise<void>;
+    isEnabled(): Promise<{
+        enabled: boolean;
+    }>;
+    getState(): Promise<{
+        state: TalkModeState;
+        statusText: string;
+    }>;
+    updateConfig(options: {
+        config: Partial<TalkModeConfig>;
+    }): Promise<void>;
+    speak(options: SpeakOptions): Promise<SpeakResult>;
+    stopSpeaking(): Promise<{
+        interruptedAt?: number;
+    }>;
+    isSpeaking(): Promise<{
+        speaking: boolean;
+    }>;
+    checkPermissions(): Promise<TalkModePermissionStatus>;
+    requestPermissions(): Promise<TalkModePermissionStatus>;
+    private setState;
+}
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,aAAa,EACd,MAAM,eAAe,CAAC;AA8CvB;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,OAAO,CAAS;;IASlB,KAAK,CAAC,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,cAAc,CAAC;KACzB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA8E3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAI1C,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjE,YAAY,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAwDlD,YAAY,IAAI,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IASnD,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAI5C,gBAAgB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IA2BrD,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAc7D,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/esm/web.js

@@ -0,0 +1,201 @@
+import { WebPlugin } from "@capacitor/core";
+/**
+ * Web implementation of TalkMode plugin
+ *
+ * Uses Web Speech API for TTS with limited functionality compared to native.
+ * ElevenLabs streaming is not supported on web due to CORS limitations.
+ */
+export class TalkModeWeb extends WebPlugin {
+    constructor() {
+        super();
+        this.config = {};
+        this.state = "idle";
+        this.statusText = "Off";
+        this.synthesis = null;
+        this.currentUtterance = null;
+        this.recognition = null;
+        this.enabled = false;
+        if (typeof window !== "undefined" && window.speechSynthesis) {
+            this.synthesis = window.speechSynthesis;
+        }
+    }
+    async start(options) {
+        if (options?.config) {
+            this.config = { ...this.config, ...options.config };
+        }
+        // Check for Web Speech API support
+        const SpeechRecognitionAPI = window.SpeechRecognition ||
+            window.webkitSpeechRecognition;
+        if (!SpeechRecognitionAPI) {
+            return {
+                started: false,
+                error: "Speech recognition not supported on this browser",
+            };
+        }
+        if (!this.synthesis) {
+            console.warn("[TalkMode] Speech synthesis not available on web");
+        }
+        this.enabled = true;
+        this.setState("listening", "Listening");
+        // Initialize speech recognition
+        this.recognition = new SpeechRecognitionAPI();
+        this.recognition.continuous = true;
+        this.recognition.interimResults = true;
+        this.recognition.onresult = (event) => {
+            const result = event.results[event.results.length - 1];
+            const transcript = result[0].transcript;
+            const isFinal = result.isFinal;
+            this.notifyListeners("transcript", { transcript, isFinal });
+            if (isFinal && transcript.trim()) {
+                // Note: Full talk mode flow would need Gateway plugin integration
+                // For web, we just emit the transcript
+            }
+        };
+        this.recognition.onerror = (event) => {
+            this.notifyListeners("error", {
+                code: event.error,
+                message: event.message || event.error,
+                recoverable: event.error !== "not-allowed",
+            });
+        };
+        this.recognition.onend = () => {
+            if (this.enabled && this.state === "listening") {
+                // Restart recognition if still enabled
+                try {
+                    this.recognition?.start();
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    if (!msg.includes("already started")) {
+                        console.warn("[TalkMode] Failed to restart recognition:", msg);
+                    }
+                }
+            }
+        };
+        try {
+            this.recognition.start();
+            return { started: true };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Failed to start";
+            return { started: false, error: message };
+        }
+    }
+    async stop() {
+        this.enabled = false;
+        this.recognition?.stop();
+        this.recognition = null;
+        this.synthesis?.cancel();
+        this.currentUtterance = null;
+        this.setState("idle", "Off");
+    }
+    async isEnabled() {
+        return { enabled: this.enabled };
+    }
+    async getState() {
+        return { state: this.state, statusText: this.statusText };
+    }
+    async updateConfig(options) {
+        this.config = { ...this.config, ...options.config };
+    }
+    async speak(options) {
+        if (!this.synthesis) {
+            return {
+                completed: false,
+                interrupted: false,
+                usedSystemTts: false,
+                error: "Speech synthesis not available",
+            };
+        }
+        // Web can only use system TTS (no ElevenLabs due to CORS)
+        const text = options.text.trim();
+        if (!text) {
+            return { completed: true, interrupted: false, usedSystemTts: true };
+        }
+        this.setState("speaking", "Speaking");
+        this.notifyListeners("speaking", { text, isSystemTts: true });
+        return new Promise((resolve) => {
+            const utterance = new SpeechSynthesisUtterance(text);
+            this.currentUtterance = utterance;
+            // Always set language — fallback to en-US if directive doesn't specify.
+            // Without this, the browser uses the system locale, which may read
+            // numbers in the wrong language (e.g., Chinese on a Chinese-locale system).
+            utterance.lang = options.directive?.language || "en-US";
+            // Apply directive settings if available
+            if (options.directive?.speed) {
+                utterance.rate = options.directive.speed;
+            }
+            utterance.onend = () => {
+                this.currentUtterance = null;
+                this.notifyListeners("speakComplete", { completed: true });
+                this.setState("listening", "Listening");
+                resolve({ completed: true, interrupted: false, usedSystemTts: true });
+            };
+            utterance.onerror = (event) => {
+                this.currentUtterance = null;
+                this.notifyListeners("speakComplete", { completed: false });
+                this.setState("idle", "Speech error");
+                resolve({
+                    completed: false,
+                    interrupted: event.error === "interrupted",
+                    usedSystemTts: true,
+                    error: event.error,
+                });
+            };
+            this.synthesis?.speak(utterance);
+        });
+    }
+    async stopSpeaking() {
+        if (this.synthesis && this.currentUtterance) {
+            this.synthesis.cancel();
+            this.currentUtterance = null;
+            return { interruptedAt: undefined };
+        }
+        return {};
+    }
+    async isSpeaking() {
+        return { speaking: this.synthesis?.speaking ?? false };
+    }
+    async checkPermissions() {
+        // Check microphone permission
+        let microphone = "prompt";
+        try {
+            const result = await navigator.permissions.query({
+                name: "microphone",
+            });
+            microphone = result.state;
+        }
+        catch {
+            // Permissions API may not support microphone query
+        }
+        // Check if speech recognition is supported
+        const SpeechRecognitionAPI = window.SpeechRecognition ||
+            window.webkitSpeechRecognition;
+        const speechRecognition = SpeechRecognitionAPI ? "prompt" : "not_supported";
+        return { microphone, speechRecognition };
+    }
+    async requestPermissions() {
+        // Request microphone permission by attempting to get user media
+        try {
+            const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+            stream.getTracks().forEach((track) => {
+                track.stop();
+            });
+        }
+        catch {
+            // Permission denied or error
+        }
+        return this.checkPermissions();
+    }
+    setState(state, statusText) {
+        const previousState = this.state;
+        this.state = state;
+        this.statusText = statusText;
+        this.notifyListeners("stateChange", {
+            state,
+            previousState,
+            statusText,
+            usingSystemTts: true,
+        });
+    }
+}