@sudocode-ai/local-server 0.1.17 → 0.1.18-dev.0

package/dist/services/stt-service.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Speech-to-Text Service
+ *
+ * Provides a pluggable STT abstraction with multiple provider support.
+ * Handles provider selection, fallback, and availability checking.
+ */
+import type { STTProvider as STTProviderType, STTOptions, TranscriptionResult, VoiceSettingsConfig } from "@sudocode-ai/types/voice";
+/**
+ * Interface for STT providers
+ */
+export interface STTProvider {
+    /** Provider name */
+    readonly name: STTProviderType;
+    /**
+     * Transcribe audio buffer to text
+     *
+     * @param audio - Audio buffer to transcribe
+     * @param options - Optional transcription options
+     * @returns Promise resolving to transcription result
+     */
+    transcribe(audio: Buffer, options?: STTOptions): Promise<TranscriptionResult>;
+    /**
+     * Check if this provider is currently available
+     * (e.g., service is running, API key is configured)
+     *
+     * @returns Promise resolving to true if provider is available
+     */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Configuration for the STT service
+ */
+export interface STTServiceConfig {
+    /** Default provider to use when none specified */
+    defaultProvider: STTProviderType;
+    /** Whisper server URL for local provider */
+    whisperUrl: string;
+    /** Whisper model to use */
+    whisperModel: string;
+}
+/**
+ * Get STT configuration from project config.
+ *
+ * All settings come from .sudocode/config.json voice.stt.* with defaults:
+ * - provider: "whisper-local"
+ * - whisperUrl: "http://localhost:2022/v1"
+ * - whisperModel: "base"
+ *
+ * @param projectVoiceConfig - Optional project voice settings from config.json
+ */
+export declare function getSTTConfig(projectVoiceConfig?: VoiceSettingsConfig): STTServiceConfig;
+/**
+ * Error thrown when no STT providers are available
+ */
+export declare class NoSTTProviderError extends Error {
+    constructor();
+}
+/**
+ * Error thrown when a specific provider is not found
+ */
+export declare class STTProviderNotFoundError extends Error {
+    constructor(providerName: string);
+}
+/**
+ * Error thrown when transcription fails
+ */
+export declare class TranscriptionError extends Error {
+    readonly provider: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, provider: string, cause?: Error | undefined);
+}
+/**
+ * Speech-to-Text Service
+ *
+ * Manages multiple STT providers with automatic fallback support.
+ */
+export declare class STTService {
+    private providers;
+    private config;
+    private availabilityCache;
+    private availabilityCacheTime;
+    private readonly CACHE_TTL_MS;
+    constructor(config?: Partial<STTServiceConfig>);
+    /**
+     * Register an STT provider
+     *
+     * @param provider - The provider to register
+     */
+    registerProvider(provider: STTProvider): void;
+    /**
+     * Unregister an STT provider
+     *
+     * @param providerName - Name of the provider to unregister
+     */
+    unregisterProvider(providerName: STTProviderType): void;
+    /**
+     * Get a provider by name
+     *
+     * @param providerName - Name of the provider
+     * @returns The provider if found
+     */
+    getProvider(providerName: STTProviderType): STTProvider | undefined;
+    /**
+     * Check if a provider's availability is cached and still valid
+     */
+    private isCacheValid;
+    /**
+     * Check if a provider is available (with caching)
+     *
+     * @param providerName - Name of the provider to check
+     * @returns Promise resolving to true if available
+     */
+    isProviderAvailable(providerName: STTProviderType): Promise<boolean>;
+    /**
+     * Get all available providers (those that are registered and currently available)
+     *
+     * @returns Promise resolving to array of available provider names
+     */
+    getAvailableProviders(): Promise<STTProviderType[]>;
+    /**
+     * Get the default provider name from configuration
+     *
+     * @returns The default provider name
+     */
+    getDefaultProvider(): STTProviderType;
+    /**
+     * Get the configuration
+     *
+     * @returns The current configuration
+     */
+    getConfig(): STTServiceConfig;
+    /**
+     * Clear the availability cache
+     */
+    clearAvailabilityCache(): void;
+    /**
+     * Transcribe audio using the specified or default provider
+     *
+     * Falls back to other available providers if the preferred one fails.
+     *
+     * @param audio - Audio buffer to transcribe
+     * @param options - Optional transcription options (can include preferred provider)
+     * @returns Promise resolving to transcription result
+     * @throws {NoSTTProviderError} If no providers are available
+     * @throws {TranscriptionError} If transcription fails on all providers
+     */
+    transcribe(audio: Buffer, options?: STTOptions): Promise<TranscriptionResult>;
+}
+/**
+ * Get or create the global STT service instance
+ *
+ * @param config - Optional configuration override
+ * @returns The STT service instance
+ */
+export declare function getSTTService(config?: Partial<STTServiceConfig>): STTService;
+/**
+ * Reset the global STT service instance (for testing)
+ */
+export declare function resetSTTService(): void;
+//# sourceMappingURL=stt-service.d.ts.map

package/dist/services/stt-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-service.d.ts","sourceRoot":"","sources":["../../src/services/stt-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,IAAI,eAAe,EAC9B,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,eAAe,EAAE,eAAe,CAAC;IACjC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,kBAAkB,CAAC,EAAE,mBAAmB,GACvC,gBAAgB,CAQlB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,YAAY,EAAE,MAAM;CAIjC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,QAAQ,EAAE,MAAM;aAChB,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,qBAAqB,CAA2C;IACxE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAO7C;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI;IAMvD;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS;IAInE;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;;;OAKG;IACG,mBAAmB,CAAC,YAAY,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB1E;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAYzD;;;;OAIG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;;;OAIG;IACH,SAAS,IAAI,gBAAgB;IAI7B;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAK9B;;;;;;;;;;OAUG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,mBAAmB,CAAC;CA+ChC;AAQD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAK5E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/services/stt-service.js

@@ -0,0 +1,246 @@
+/**
+ * Speech-to-Text Service
+ *
+ * Provides a pluggable STT abstraction with multiple provider support.
+ * Handles provider selection, fallback, and availability checking.
+ */
+/**
+ * Get STT configuration from project config.
+ *
+ * All settings come from .sudocode/config.json voice.stt.* with defaults:
+ * - provider: "whisper-local"
+ * - whisperUrl: "http://localhost:2022/v1"
+ * - whisperModel: "base"
+ *
+ * @param projectVoiceConfig - Optional project voice settings from config.json
+ */
+export function getSTTConfig(projectVoiceConfig) {
+    const sttSettings = projectVoiceConfig?.stt;
+    return {
+        defaultProvider: sttSettings?.provider || "whisper-local",
+        whisperUrl: sttSettings?.whisperUrl || "http://localhost:2022/v1",
+        whisperModel: sttSettings?.whisperModel || "base",
+    };
+}
+/**
+ * Error thrown when no STT providers are available
+ */
+export class NoSTTProviderError extends Error {
+    constructor() {
+        super("No STT providers are available");
+        this.name = "NoSTTProviderError";
+    }
+}
+/**
+ * Error thrown when a specific provider is not found
+ */
+export class STTProviderNotFoundError extends Error {
+    constructor(providerName) {
+        super(`STT provider '${providerName}' not found`);
+        this.name = "STTProviderNotFoundError";
+    }
+}
+/**
+ * Error thrown when transcription fails
+ */
+export class TranscriptionError extends Error {
+    provider;
+    cause;
+    constructor(message, provider, cause) {
+        super(message);
+        this.provider = provider;
+        this.cause = cause;
+        this.name = "TranscriptionError";
+    }
+}
+/**
+ * Speech-to-Text Service
+ *
+ * Manages multiple STT providers with automatic fallback support.
+ */
+export class STTService {
+    providers = new Map();
+    config;
+    availabilityCache = new Map();
+    availabilityCacheTime = new Map();
+    CACHE_TTL_MS = 30000; // 30 seconds
+    constructor(config) {
+        this.config = { ...getSTTConfig(), ...config };
+    }
+    /**
+     * Register an STT provider
+     *
+     * @param provider - The provider to register
+     */
+    registerProvider(provider) {
+        this.providers.set(provider.name, provider);
+        // Invalidate availability cache when a new provider is registered
+        this.availabilityCache.delete(provider.name);
+        this.availabilityCacheTime.delete(provider.name);
+    }
+    /**
+     * Unregister an STT provider
+     *
+     * @param providerName - Name of the provider to unregister
+     */
+    unregisterProvider(providerName) {
+        this.providers.delete(providerName);
+        this.availabilityCache.delete(providerName);
+        this.availabilityCacheTime.delete(providerName);
+    }
+    /**
+     * Get a provider by name
+     *
+     * @param providerName - Name of the provider
+     * @returns The provider if found
+     */
+    getProvider(providerName) {
+        return this.providers.get(providerName);
+    }
+    /**
+     * Check if a provider's availability is cached and still valid
+     */
+    isCacheValid(providerName) {
+        const cacheTime = this.availabilityCacheTime.get(providerName);
+        if (!cacheTime)
+            return false;
+        return Date.now() - cacheTime < this.CACHE_TTL_MS;
+    }
+    /**
+     * Check if a provider is available (with caching)
+     *
+     * @param providerName - Name of the provider to check
+     * @returns Promise resolving to true if available
+     */
+    async isProviderAvailable(providerName) {
+        const provider = this.providers.get(providerName);
+        if (!provider)
+            return false;
+        // Check cache first
+        if (this.isCacheValid(providerName)) {
+            return this.availabilityCache.get(providerName) ?? false;
+        }
+        // Check actual availability
+        try {
+            const available = await provider.isAvailable();
+            this.availabilityCache.set(providerName, available);
+            this.availabilityCacheTime.set(providerName, Date.now());
+            return available;
+        }
+        catch {
+            this.availabilityCache.set(providerName, false);
+            this.availabilityCacheTime.set(providerName, Date.now());
+            return false;
+        }
+    }
+    /**
+     * Get all available providers (those that are registered and currently available)
+     *
+     * @returns Promise resolving to array of available provider names
+     */
+    async getAvailableProviders() {
+        const availableProviders = [];
+        for (const providerName of this.providers.keys()) {
+            if (await this.isProviderAvailable(providerName)) {
+                availableProviders.push(providerName);
+            }
+        }
+        return availableProviders;
+    }
+    /**
+     * Get the default provider name from configuration
+     *
+     * @returns The default provider name
+     */
+    getDefaultProvider() {
+        return this.config.defaultProvider;
+    }
+    /**
+     * Get the configuration
+     *
+     * @returns The current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Clear the availability cache
+     */
+    clearAvailabilityCache() {
+        this.availabilityCache.clear();
+        this.availabilityCacheTime.clear();
+    }
+    /**
+     * Transcribe audio using the specified or default provider
+     *
+     * Falls back to other available providers if the preferred one fails.
+     *
+     * @param audio - Audio buffer to transcribe
+     * @param options - Optional transcription options (can include preferred provider)
+     * @returns Promise resolving to transcription result
+     * @throws {NoSTTProviderError} If no providers are available
+     * @throws {TranscriptionError} If transcription fails on all providers
+     */
+    async transcribe(audio, options) {
+        const preferredProvider = options?.provider || this.config.defaultProvider;
+        // Build provider order: preferred first, then others
+        const providerOrder = [preferredProvider];
+        for (const providerName of this.providers.keys()) {
+            if (providerName !== preferredProvider) {
+                providerOrder.push(providerName);
+            }
+        }
+        const errors = [];
+        for (const providerName of providerOrder) {
+            const provider = this.providers.get(providerName);
+            if (!provider)
+                continue;
+            // Check availability
+            if (!(await this.isProviderAvailable(providerName))) {
+                continue;
+            }
+            try {
+                const result = await provider.transcribe(audio, options);
+                return result;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                errors.push({ provider: providerName, error: err });
+                // Invalidate cache for this provider since it failed
+                this.availabilityCache.delete(providerName);
+                this.availabilityCacheTime.delete(providerName);
+                // Continue to next provider
+            }
+        }
+        // If we get here, all providers failed
+        if (errors.length === 0) {
+            throw new NoSTTProviderError();
+        }
+        const lastError = errors[errors.length - 1];
+        throw new TranscriptionError(`Transcription failed on all providers. Last error: ${lastError.error.message}`, lastError.provider, lastError.error);
+    }
+}
+/**
+ * Global STT service instance
+ * Lazy-initialized on first use
+ */
+let sttServiceInstance = null;
+/**
+ * Get or create the global STT service instance
+ *
+ * @param config - Optional configuration override
+ * @returns The STT service instance
+ */
+export function getSTTService(config) {
+    if (!sttServiceInstance) {
+        sttServiceInstance = new STTService(config);
+    }
+    return sttServiceInstance;
+}
+/**
+ * Reset the global STT service instance (for testing)
+ */
+export function resetSTTService() {
+    sttServiceInstance = null;
+}
+//# sourceMappingURL=stt-service.js.map

package/dist/services/stt-service.js.map

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

package/dist/services/tts-providers/browser-tts.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Browser TTS Provider
+ *
+ * A placeholder provider for browser-based TTS using the Web Speech API.
+ * This provider doesn't actually synthesize audio server-side - instead it
+ * returns the text for the client to synthesize using the Web Speech API.
+ *
+ * This approach has several advantages:
+ * - Zero server-side cost
+ * - Instant response (no audio to generate/stream)
+ * - Works offline (no network latency)
+ * - Uses system voices already installed on user's device
+ */
+import type { TTSProvider as TTSProviderType, TTSProviderOptions, TTSProviderResult, TTSVoice } from "@sudocode-ai/types/voice";
+import { type TTSProvider } from "../tts-service.js";
+/**
+ * Configuration for the Browser TTS provider
+ */
+export interface BrowserTTSConfig {
+    /** Default language code for voice listing */
+    defaultLanguage: string;
+}
+/**
+ * Browser TTS Provider
+ *
+ * Returns text for client-side Web Speech API synthesis.
+ * The actual speech synthesis happens in the browser.
+ */
+export declare class BrowserTTSProvider implements TTSProvider {
+    readonly id: TTSProviderType;
+    readonly name: string;
+    private config;
+    constructor(config?: Partial<BrowserTTSConfig>);
+    /**
+     * Browser TTS is always available on the server side
+     * (actual availability depends on client browser support)
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Return text for client-side synthesis
+     *
+     * @param text - Text to synthesize
+     * @param _options - Synthesis options (used client-side)
+     * @returns Result with text for client synthesis
+     */
+    synthesize(text: string, _options?: TTSProviderOptions): Promise<TTSProviderResult>;
+    /**
+     * Get available voices
+     *
+     * Since voices are determined by the client's browser, we return
+     * a generic placeholder. The frontend should query actual voices
+     * from window.speechSynthesis.getVoices() directly.
+     */
+    getVoices(): Promise<TTSVoice[]>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): BrowserTTSConfig;
+}
+/**
+ * Create a new Browser TTS provider instance
+ */
+export declare function createBrowserTTSProvider(config?: Partial<BrowserTTSConfig>): BrowserTTSProvider;
+//# sourceMappingURL=browser-tts.d.ts.map

package/dist/services/tts-providers/browser-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tts.d.ts","sourceRoot":"","sources":["../../../src/services/tts-providers/browser-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,WAAW,IAAI,eAAe,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAa;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAA8B;IACnD,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAM9C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAOrC;;;;;;OAMG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IAW7B;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IActC;;OAEG;IACH,SAAS,IAAI,gBAAgB;CAG9B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACjC,kBAAkB,CAEpB"}

package/dist/services/tts-providers/browser-tts.js

@@ -0,0 +1,89 @@
+/**
+ * Browser TTS Provider
+ *
+ * A placeholder provider for browser-based TTS using the Web Speech API.
+ * This provider doesn't actually synthesize audio server-side - instead it
+ * returns the text for the client to synthesize using the Web Speech API.
+ *
+ * This approach has several advantages:
+ * - Zero server-side cost
+ * - Instant response (no audio to generate/stream)
+ * - Works offline (no network latency)
+ * - Uses system voices already installed on user's device
+ */
+/**
+ * Browser TTS Provider
+ *
+ * Returns text for client-side Web Speech API synthesis.
+ * The actual speech synthesis happens in the browser.
+ */
+export class BrowserTTSProvider {
+    id = "browser";
+    name = "Browser (Web Speech API)";
+    config;
+    constructor(config) {
+        this.config = {
+            defaultLanguage: config?.defaultLanguage ?? "en-US",
+        };
+    }
+    /**
+     * Browser TTS is always available on the server side
+     * (actual availability depends on client browser support)
+     */
+    async isAvailable() {
+        // Browser TTS is always "available" server-side since we just
+        // return text for the client to handle. The client determines
+        // actual availability based on Web Speech API support.
+        return true;
+    }
+    /**
+     * Return text for client-side synthesis
+     *
+     * @param text - Text to synthesize
+     * @param _options - Synthesis options (used client-side)
+     * @returns Result with text for client synthesis
+     */
+    async synthesize(text, _options) {
+        // For browser TTS, we simply return the text.
+        // The client will use the Web Speech API to synthesize it.
+        // Options (voice, speed, pitch) are handled client-side.
+        return {
+            text,
+            // No audio buffer - client synthesizes
+            // No SSML - Web Speech API has limited SSML support
+        };
+    }
+    /**
+     * Get available voices
+     *
+     * Since voices are determined by the client's browser, we return
+     * a generic placeholder. The frontend should query actual voices
+     * from window.speechSynthesis.getVoices() directly.
+     */
+    async getVoices() {
+        // Return a placeholder voice indicating client-side determination
+        // The actual voice list is populated by the frontend from the
+        // browser's speechSynthesis.getVoices() API
+        return [
+            {
+                id: "default",
+                name: "System Default",
+                language: this.config.defaultLanguage,
+                provider: "browser",
+            },
+        ];
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+/**
+ * Create a new Browser TTS provider instance
+ */
+export function createBrowserTTSProvider(config) {
+    return new BrowserTTSProvider(config);
+}
+//# sourceMappingURL=browser-tts.js.map

package/dist/services/tts-providers/browser-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tts.js","sourceRoot":"","sources":["../../../src/services/tts-providers/browser-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACpB,EAAE,GAAoB,SAAS,CAAC;IAChC,IAAI,GAAW,0BAA0B,CAAC;IAC3C,MAAM,CAAmB;IAEjC,YAAY,MAAkC;QAC5C,IAAI,CAAC,MAAM,GAAG;YACZ,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,OAAO;SACpD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,8DAA8D;QAC9D,8DAA8D;QAC9D,uDAAuD;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,IAAY,EACZ,QAA6B;QAE7B,8CAA8C;QAC9C,2DAA2D;QAC3D,yDAAyD;QACzD,OAAO;YACL,IAAI;YACJ,uCAAuC;YACvC,oDAAoD;SACrD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS;QACb,kEAAkE;QAClE,8DAA8D;QAC9D,4CAA4C;QAC5C,OAAO;YACL;gBACE,EAAE,EAAE,SAAS;gBACb,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;gBACrC,QAAQ,EAAE,SAAS;aACpB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAkC;IAElC,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/services/tts-providers/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TTS Providers Index
+ *
+ * Exports all TTS provider implementations and factory functions.
+ */
+export { BrowserTTSProvider, createBrowserTTSProvider, type BrowserTTSConfig, } from "./browser-tts.js";
+import { TTSService } from "../tts-service.js";
+/**
+ * Initialize the TTS service with all available providers
+ *
+ * @param service - The TTS service to initialize
+ */
+export declare function initializeTTSProviders(service: TTSService): void;
+/**
+ * Create a fully initialized TTS service with all providers registered
+ *
+ * @returns Initialized TTS service
+ */
+export declare function createInitializedTTSService(): TTSService;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/tts-providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/tts-providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,UAAU,CAIxD"}

package/dist/services/tts-providers/index.js

@@ -0,0 +1,31 @@
+/**
+ * TTS Providers Index
+ *
+ * Exports all TTS provider implementations and factory functions.
+ */
+export { BrowserTTSProvider, createBrowserTTSProvider, } from "./browser-tts.js";
+import { BrowserTTSProvider } from "./browser-tts.js";
+import { TTSService } from "../tts-service.js";
+/**
+ * Initialize the TTS service with all available providers
+ *
+ * @param service - The TTS service to initialize
+ */
+export function initializeTTSProviders(service) {
+    // Register Browser TTS provider (default, always available)
+    service.registerProvider(new BrowserTTSProvider());
+    // Future providers will be registered here:
+    // - KokoroTTSProvider (local high-quality TTS)
+    // - OpenAITTSProvider (cloud TTS)
+}
+/**
+ * Create a fully initialized TTS service with all providers registered
+ *
+ * @returns Initialized TTS service
+ */
+export function createInitializedTTSService() {
+    const service = new TTSService();
+    initializeTTSProviders(service);
+    return service;
+}
+//# sourceMappingURL=index.js.map

package/dist/services/tts-providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/tts-providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAmB;IACxD,4DAA4D;IAC5D,OAAO,CAAC,gBAAgB,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAEnD,4CAA4C;IAC5C,+CAA+C;IAC/C,kCAAkC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;IACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC"}