@realtimex/sdk 1.1.4 → 1.2.1

package/dist/index.d.mts

@@ -79,6 +79,79 @@ interface Task {
     updated_at: string;
     runs: TaskRun[];
 }
+interface TTSOptions {
+    /** Voice ID (provider-specific) */
+    voice?: string;
+    /** Model ID (provider-specific) */
+    model?: string;
+    /** Speech speed (0.5-2.0) */
+    speed?: number;
+    /** TTS provider ID */
+    provider?: string;
+    /** Language code (e.g., 'en', 'es', 'fr') - for Supertonic */
+    language?: string;
+    /** Quality level (1-20) - for Supertonic num_inference_steps */
+    num_inference_steps?: number;
+}
+interface TTSProviderConfig {
+    /** Available voice/speaker IDs */
+    voices: string[];
+    /** Supported languages (for multilingual providers) */
+    languages?: string[];
+    /** Speed range */
+    speed?: {
+        min: number;
+        max: number;
+        default: number;
+    };
+    /** Quality range (for providers that support it) */
+    quality?: {
+        min: number;
+        max: number;
+        default: number;
+        description?: string;
+    };
+}
+interface TTSProvider {
+    /** Provider ID (e.g., 'elevenlabs', 'supertonic_local') */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Provider type: 'server' (remote API) or 'client' (local) */
+    type: 'server' | 'client';
+    /** Whether provider is configured and ready */
+    configured: boolean;
+    /** Whether streaming is supported */
+    supportsStreaming: boolean;
+    /** Optional note about provider requirements */
+    note?: string;
+    /** Configuration options */
+    config?: TTSProviderConfig;
+}
+interface TTSProvidersResponse {
+    success: boolean;
+    providers: TTSProvider[];
+    default: string;
+    error?: string;
+}
+interface TTSChunk {
+    /** Chunk index (0-based) */
+    index: number;
+    /** Total number of chunks */
+    total: number;
+    /** Decoded audio data (ArrayBuffer) - ready for playback */
+    audio: ArrayBuffer;
+    /** Audio MIME type */
+    mimeType: string;
+}
+interface TTSChunkEvent {
+    type: 'info' | 'chunk' | 'error' | 'done';
+    data: TTSChunk | {
+        totalChunks: number;
+    } | {
+        error: string;
+    };
+}
 
 /**
  * Activities Module - HTTP Proxy to RealtimeX Main App
@@ -636,6 +709,52 @@ declare class LLMModule {
     search(query: string, options?: VectorQueryOptions): Promise<VectorQueryResult[]>;
 }
 
+declare class TTSModule {
+    private baseUrl;
+    private appId;
+    private appName;
+    private apiKey?;
+    constructor(realtimexUrl: string, appId: string, appName?: string, apiKey?: string);
+    private get headers();
+    /**
+     * Request a single permission from Electron via internal API
+     */
+    private requestPermission;
+    /**
+     * Internal request wrapper that handles automatic permission prompts
+     */
+    private request;
+    /**
+     * Generate speech from text (returns full buffer)
+     *
+     * @example
+     * ```ts
+     * const buffer = await sdk.tts.speak("Hello world");
+     * // Play buffer...
+     * ```
+     */
+    speak(text: string, options?: TTSOptions): Promise<ArrayBuffer>;
+    /**
+     * Generate speech from text with streaming (yields decoded audio chunks)
+     * Uses SSE internally but returns decoded ArrayBuffer chunks for easy playback.
+     *
+     * @example
+     * ```ts
+     * for await (const chunk of sdk.tts.speakStream("Hello world")) {
+     *   // chunk.audio is ArrayBuffer (already decoded!)
+     *   const blob = new Blob([chunk.audio], { type: chunk.mimeType });
+     *   const audio = new Audio(URL.createObjectURL(blob));
+     *   await audio.play();
+     * }
+     * ```
+     */
+    speakStream(text: string, options?: TTSOptions): AsyncGenerator<TTSChunk>;
+    /**
+     * List available TTS providers with configuration options
+     */
+    listProviders(): Promise<TTSProvider[]>;
+}
+
 /**
  * RealtimeX Local App SDK
  *
@@ -650,6 +769,7 @@ declare class RealtimeXSDK {
     task: TaskModule;
     port: PortModule;
     llm: LLMModule;
+    tts: TTSModule;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;
@@ -683,4 +803,4 @@ declare class RealtimeXSDK {
     getAppDataDir(): Promise<string>;
 }
 
-export { ActivitiesModule, type Activity, type Agent, ApiModule, type ChatMessage, type ChatOptions, type ChatResponse, type EmbedOptions, type EmbedResponse, LLMModule, LLMPermissionError, LLMProviderError, PermissionDeniedError, PermissionRequiredError, PortModule, type Provider, type ProvidersResponse, RealtimeXSDK, type SDKConfig, type StreamChunk, type Task, TaskModule, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, type VectorDeleteOptions, type VectorDeleteResponse, type VectorQueryOptions, type VectorQueryResponse, type VectorQueryResult, type VectorRecord, VectorStore, type VectorUpsertOptions, type VectorUpsertResponse, WebhookModule, type Workspace };
+export { ActivitiesModule, type Activity, type Agent, ApiModule, type ChatMessage, type ChatOptions, type ChatResponse, type EmbedOptions, type EmbedResponse, LLMModule, LLMPermissionError, LLMProviderError, PermissionDeniedError, PermissionRequiredError, PortModule, type Provider, type ProvidersResponse, RealtimeXSDK, type SDKConfig, type StreamChunk, type TTSChunk, type TTSChunkEvent, TTSModule, type TTSOptions, type TTSProvider, type TTSProviderConfig, type TTSProvidersResponse, type Task, TaskModule, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, type VectorDeleteOptions, type VectorDeleteResponse, type VectorQueryOptions, type VectorQueryResponse, type VectorQueryResult, type VectorRecord, VectorStore, type VectorUpsertOptions, type VectorUpsertResponse, WebhookModule, type Workspace };

package/dist/index.d.ts

@@ -79,6 +79,79 @@ interface Task {
     updated_at: string;
     runs: TaskRun[];
 }
+interface TTSOptions {
+    /** Voice ID (provider-specific) */
+    voice?: string;
+    /** Model ID (provider-specific) */
+    model?: string;
+    /** Speech speed (0.5-2.0) */
+    speed?: number;
+    /** TTS provider ID */
+    provider?: string;
+    /** Language code (e.g., 'en', 'es', 'fr') - for Supertonic */
+    language?: string;
+    /** Quality level (1-20) - for Supertonic num_inference_steps */
+    num_inference_steps?: number;
+}
+interface TTSProviderConfig {
+    /** Available voice/speaker IDs */
+    voices: string[];
+    /** Supported languages (for multilingual providers) */
+    languages?: string[];
+    /** Speed range */
+    speed?: {
+        min: number;
+        max: number;
+        default: number;
+    };
+    /** Quality range (for providers that support it) */
+    quality?: {
+        min: number;
+        max: number;
+        default: number;
+        description?: string;
+    };
+}
+interface TTSProvider {
+    /** Provider ID (e.g., 'elevenlabs', 'supertonic_local') */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Provider type: 'server' (remote API) or 'client' (local) */
+    type: 'server' | 'client';
+    /** Whether provider is configured and ready */
+    configured: boolean;
+    /** Whether streaming is supported */
+    supportsStreaming: boolean;
+    /** Optional note about provider requirements */
+    note?: string;
+    /** Configuration options */
+    config?: TTSProviderConfig;
+}
+interface TTSProvidersResponse {
+    success: boolean;
+    providers: TTSProvider[];
+    default: string;
+    error?: string;
+}
+interface TTSChunk {
+    /** Chunk index (0-based) */
+    index: number;
+    /** Total number of chunks */
+    total: number;
+    /** Decoded audio data (ArrayBuffer) - ready for playback */
+    audio: ArrayBuffer;
+    /** Audio MIME type */
+    mimeType: string;
+}
+interface TTSChunkEvent {
+    type: 'info' | 'chunk' | 'error' | 'done';
+    data: TTSChunk | {
+        totalChunks: number;
+    } | {
+        error: string;
+    };
+}
 
 /**
  * Activities Module - HTTP Proxy to RealtimeX Main App
@@ -636,6 +709,52 @@ declare class LLMModule {
     search(query: string, options?: VectorQueryOptions): Promise<VectorQueryResult[]>;
 }
 
+declare class TTSModule {
+    private baseUrl;
+    private appId;
+    private appName;
+    private apiKey?;
+    constructor(realtimexUrl: string, appId: string, appName?: string, apiKey?: string);
+    private get headers();
+    /**
+     * Request a single permission from Electron via internal API
+     */
+    private requestPermission;
+    /**
+     * Internal request wrapper that handles automatic permission prompts
+     */
+    private request;
+    /**
+     * Generate speech from text (returns full buffer)
+     *
+     * @example
+     * ```ts
+     * const buffer = await sdk.tts.speak("Hello world");
+     * // Play buffer...
+     * ```
+     */
+    speak(text: string, options?: TTSOptions): Promise<ArrayBuffer>;
+    /**
+     * Generate speech from text with streaming (yields decoded audio chunks)
+     * Uses SSE internally but returns decoded ArrayBuffer chunks for easy playback.
+     *
+     * @example
+     * ```ts
+     * for await (const chunk of sdk.tts.speakStream("Hello world")) {
+     *   // chunk.audio is ArrayBuffer (already decoded!)
+     *   const blob = new Blob([chunk.audio], { type: chunk.mimeType });
+     *   const audio = new Audio(URL.createObjectURL(blob));
+     *   await audio.play();
+     * }
+     * ```
+     */
+    speakStream(text: string, options?: TTSOptions): AsyncGenerator<TTSChunk>;
+    /**
+     * List available TTS providers with configuration options
+     */
+    listProviders(): Promise<TTSProvider[]>;
+}
+
 /**
  * RealtimeX Local App SDK
  *
@@ -650,6 +769,7 @@ declare class RealtimeXSDK {
     task: TaskModule;
     port: PortModule;
     llm: LLMModule;
+    tts: TTSModule;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;
@@ -683,4 +803,4 @@ declare class RealtimeXSDK {
     getAppDataDir(): Promise<string>;
 }
 
-export { ActivitiesModule, type Activity, type Agent, ApiModule, type ChatMessage, type ChatOptions, type ChatResponse, type EmbedOptions, type EmbedResponse, LLMModule, LLMPermissionError, LLMProviderError, PermissionDeniedError, PermissionRequiredError, PortModule, type Provider, type ProvidersResponse, RealtimeXSDK, type SDKConfig, type StreamChunk, type Task, TaskModule, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, type VectorDeleteOptions, type VectorDeleteResponse, type VectorQueryOptions, type VectorQueryResponse, type VectorQueryResult, type VectorRecord, VectorStore, type VectorUpsertOptions, type VectorUpsertResponse, WebhookModule, type Workspace };
+export { ActivitiesModule, type Activity, type Agent, ApiModule, type ChatMessage, type ChatOptions, type ChatResponse, type EmbedOptions, type EmbedResponse, LLMModule, LLMPermissionError, LLMProviderError, PermissionDeniedError, PermissionRequiredError, PortModule, type Provider, type ProvidersResponse, RealtimeXSDK, type SDKConfig, type StreamChunk, type TTSChunk, type TTSChunkEvent, TTSModule, type TTSOptions, type TTSProvider, type TTSProviderConfig, type TTSProvidersResponse, type Task, TaskModule, type TaskRun, type Thread, type TriggerAgentPayload, type TriggerAgentResponse, type VectorDeleteOptions, type VectorDeleteResponse, type VectorQueryOptions, type VectorQueryResponse, type VectorQueryResult, type VectorRecord, VectorStore, type VectorUpsertOptions, type VectorUpsertResponse, WebhookModule, type Workspace };

package/dist/index.js

@@ -39,6 +39,7 @@ __export(index_exports, {
   PermissionRequiredError: () => PermissionRequiredError,
   PortModule: () => PortModule,
   RealtimeXSDK: () => RealtimeXSDK,
+  TTSModule: () => TTSModule,
   TaskModule: () => TaskModule,
   VectorStore: () => VectorStore,
   WebhookModule: () => WebhookModule
@@ -980,6 +981,188 @@ var LLMModule = class {
   }
 };
 
+// src/modules/tts.ts
+var TTSModule = class {
+  constructor(realtimexUrl, appId, appName, apiKey) {
+    this.baseUrl = realtimexUrl.replace(/\/$/, "");
+    this.appId = appId;
+    this.appName = appName || process.env.RTX_APP_NAME || "Local App";
+    this.apiKey = apiKey;
+  }
+  get headers() {
+    if (this.apiKey) {
+      return {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.apiKey}`
+      };
+    }
+    return {
+      "Content-Type": "application/json",
+      "x-app-id": this.appId
+    };
+  }
+  /**
+   * Request a single permission from Electron via internal API
+   */
+  async requestPermission(permission) {
+    try {
+      const response = await fetch(`${this.baseUrl}/api/local-apps/request-permission`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          app_id: this.appId,
+          app_name: this.appName,
+          permission
+        })
+      });
+      const data = await response.json();
+      return data.granted === true;
+    } catch (error) {
+      console.error("[SDK] Permission request failed:", error);
+      return false;
+    }
+  }
+  /**
+   * Internal request wrapper that handles automatic permission prompts
+   */
+  async request(method, endpoint, body, isStream = false) {
+    const response = await fetch(`${this.baseUrl}${endpoint}`, {
+      method,
+      headers: this.headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const data = await response.json();
+      if (data.code === "PERMISSION_REQUIRED") {
+        const permission = data.permission || "tts.speak";
+        const granted = await this.requestPermission(permission);
+        if (granted) {
+          return this.request(method, endpoint, body, isStream);
+        }
+        throw new PermissionDeniedError(permission);
+      }
+      throw new Error(data.error || `Request failed: ${response.status}`);
+    }
+    if (isStream) {
+      return response.body;
+    }
+    const contentType = response.headers.get("content-type");
+    if (contentType && contentType.includes("application/json")) {
+      return response.json();
+    }
+    return response.arrayBuffer();
+  }
+  /**
+   * Generate speech from text (returns full buffer)
+   * 
+   * @example
+   * ```ts
+   * const buffer = await sdk.tts.speak("Hello world");
+   * // Play buffer...
+   * ```
+   */
+  async speak(text, options = {}) {
+    return this.request("POST", "/sdk/tts", {
+      text,
+      ...options
+    });
+  }
+  /**
+   * Generate speech from text with streaming (yields decoded audio chunks)
+   * Uses SSE internally but returns decoded ArrayBuffer chunks for easy playback.
+   * 
+   * @example
+   * ```ts
+   * for await (const chunk of sdk.tts.speakStream("Hello world")) {
+   *   // chunk.audio is ArrayBuffer (already decoded!)
+   *   const blob = new Blob([chunk.audio], { type: chunk.mimeType });
+   *   const audio = new Audio(URL.createObjectURL(blob));
+   *   await audio.play();
+   * }
+   * ```
+   */
+  async *speakStream(text, options = {}) {
+    const response = await fetch(`${this.baseUrl}/sdk/tts/stream`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({ text, ...options })
+    });
+    if (!response.ok) {
+      const data = await response.json();
+      if (data.code === "PERMISSION_REQUIRED") {
+        const permission = data.permission || "tts.generate";
+        const granted = await this.requestPermission(permission);
+        if (granted) {
+          yield* this.speakStream(text, options);
+          return;
+        }
+        throw new PermissionDeniedError(permission);
+      }
+      throw new Error(data.error || `Streaming failed: ${response.status}`);
+    }
+    const reader = response.body?.getReader();
+    if (!reader) throw new Error("No response body");
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          const trimmedLine = line.trim();
+          if (!trimmedLine) continue;
+          if (trimmedLine.startsWith("event:")) {
+            eventType = trimmedLine.slice(6).trim();
+          } else if (trimmedLine.startsWith("data:")) {
+            const eventData = trimmedLine.slice(5).trim();
+            if (eventType === "chunk" && eventData) {
+              try {
+                const parsed = JSON.parse(eventData);
+                const binaryString = atob(parsed.audio);
+                const bytes = new Uint8Array(binaryString.length);
+                for (let i = 0; i < binaryString.length; i++) {
+                  bytes[i] = binaryString.charCodeAt(i);
+                }
+                yield {
+                  index: parsed.index,
+                  total: parsed.total,
+                  audio: bytes.buffer,
+                  mimeType: parsed.mimeType
+                };
+              } catch (e) {
+                console.warn("[TTS SDK] Failed to parse chunk:", e);
+              }
+            } else if (eventType === "error" && eventData) {
+              try {
+                const err = JSON.parse(eventData);
+                throw new Error(err.error || "TTS streaming error");
+              } catch (e) {
+                if (e instanceof Error && e.message !== "TTS streaming error") {
+                  throw e;
+                }
+              }
+            }
+            eventType = "";
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /**
+   * List available TTS providers with configuration options
+   */
+  async listProviders() {
+    const data = await this.request("GET", "/sdk/tts/providers");
+    return data.providers || [];
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -997,6 +1180,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.task = new TaskModule(this.realtimexUrl, this.appName, this.appId, this.apiKey);
     this.port = new PortModule(config.defaultPort);
     this.llm = new LLMModule(this.realtimexUrl, this.appId, this.appName, this.apiKey);
+    this.tts = new TTSModule(this.realtimexUrl, this.appId, this.appName, this.apiKey);
     if (this.permissions.length > 0 && this.appId && !this.apiKey) {
       this.register().catch((err) => {
         console.error("[RealtimeX SDK] Auto-registration failed:", err.message);
@@ -1105,6 +1289,7 @@ var RealtimeXSDK = _RealtimeXSDK;
   PermissionRequiredError,
   PortModule,
   RealtimeXSDK,
+  TTSModule,
   TaskModule,
   VectorStore,
   WebhookModule

package/dist/index.mjs

@@ -933,6 +933,188 @@ var LLMModule = class {
   }
 };
 
+// src/modules/tts.ts
+var TTSModule = class {
+  constructor(realtimexUrl, appId, appName, apiKey) {
+    this.baseUrl = realtimexUrl.replace(/\/$/, "");
+    this.appId = appId;
+    this.appName = appName || process.env.RTX_APP_NAME || "Local App";
+    this.apiKey = apiKey;
+  }
+  get headers() {
+    if (this.apiKey) {
+      return {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.apiKey}`
+      };
+    }
+    return {
+      "Content-Type": "application/json",
+      "x-app-id": this.appId
+    };
+  }
+  /**
+   * Request a single permission from Electron via internal API
+   */
+  async requestPermission(permission) {
+    try {
+      const response = await fetch(`${this.baseUrl}/api/local-apps/request-permission`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          app_id: this.appId,
+          app_name: this.appName,
+          permission
+        })
+      });
+      const data = await response.json();
+      return data.granted === true;
+    } catch (error) {
+      console.error("[SDK] Permission request failed:", error);
+      return false;
+    }
+  }
+  /**
+   * Internal request wrapper that handles automatic permission prompts
+   */
+  async request(method, endpoint, body, isStream = false) {
+    const response = await fetch(`${this.baseUrl}${endpoint}`, {
+      method,
+      headers: this.headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const data = await response.json();
+      if (data.code === "PERMISSION_REQUIRED") {
+        const permission = data.permission || "tts.speak";
+        const granted = await this.requestPermission(permission);
+        if (granted) {
+          return this.request(method, endpoint, body, isStream);
+        }
+        throw new PermissionDeniedError(permission);
+      }
+      throw new Error(data.error || `Request failed: ${response.status}`);
+    }
+    if (isStream) {
+      return response.body;
+    }
+    const contentType = response.headers.get("content-type");
+    if (contentType && contentType.includes("application/json")) {
+      return response.json();
+    }
+    return response.arrayBuffer();
+  }
+  /**
+   * Generate speech from text (returns full buffer)
+   * 
+   * @example
+   * ```ts
+   * const buffer = await sdk.tts.speak("Hello world");
+   * // Play buffer...
+   * ```
+   */
+  async speak(text, options = {}) {
+    return this.request("POST", "/sdk/tts", {
+      text,
+      ...options
+    });
+  }
+  /**
+   * Generate speech from text with streaming (yields decoded audio chunks)
+   * Uses SSE internally but returns decoded ArrayBuffer chunks for easy playback.
+   * 
+   * @example
+   * ```ts
+   * for await (const chunk of sdk.tts.speakStream("Hello world")) {
+   *   // chunk.audio is ArrayBuffer (already decoded!)
+   *   const blob = new Blob([chunk.audio], { type: chunk.mimeType });
+   *   const audio = new Audio(URL.createObjectURL(blob));
+   *   await audio.play();
+   * }
+   * ```
+   */
+  async *speakStream(text, options = {}) {
+    const response = await fetch(`${this.baseUrl}/sdk/tts/stream`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({ text, ...options })
+    });
+    if (!response.ok) {
+      const data = await response.json();
+      if (data.code === "PERMISSION_REQUIRED") {
+        const permission = data.permission || "tts.generate";
+        const granted = await this.requestPermission(permission);
+        if (granted) {
+          yield* this.speakStream(text, options);
+          return;
+        }
+        throw new PermissionDeniedError(permission);
+      }
+      throw new Error(data.error || `Streaming failed: ${response.status}`);
+    }
+    const reader = response.body?.getReader();
+    if (!reader) throw new Error("No response body");
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          const trimmedLine = line.trim();
+          if (!trimmedLine) continue;
+          if (trimmedLine.startsWith("event:")) {
+            eventType = trimmedLine.slice(6).trim();
+          } else if (trimmedLine.startsWith("data:")) {
+            const eventData = trimmedLine.slice(5).trim();
+            if (eventType === "chunk" && eventData) {
+              try {
+                const parsed = JSON.parse(eventData);
+                const binaryString = atob(parsed.audio);
+                const bytes = new Uint8Array(binaryString.length);
+                for (let i = 0; i < binaryString.length; i++) {
+                  bytes[i] = binaryString.charCodeAt(i);
+                }
+                yield {
+                  index: parsed.index,
+                  total: parsed.total,
+                  audio: bytes.buffer,
+                  mimeType: parsed.mimeType
+                };
+              } catch (e) {
+                console.warn("[TTS SDK] Failed to parse chunk:", e);
+              }
+            } else if (eventType === "error" && eventData) {
+              try {
+                const err = JSON.parse(eventData);
+                throw new Error(err.error || "TTS streaming error");
+              } catch (e) {
+                if (e instanceof Error && e.message !== "TTS streaming error") {
+                  throw e;
+                }
+              }
+            }
+            eventType = "";
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /**
+   * List available TTS providers with configuration options
+   */
+  async listProviders() {
+    const data = await this.request("GET", "/sdk/tts/providers");
+    return data.providers || [];
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -950,6 +1132,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.task = new TaskModule(this.realtimexUrl, this.appName, this.appId, this.apiKey);
     this.port = new PortModule(config.defaultPort);
     this.llm = new LLMModule(this.realtimexUrl, this.appId, this.appName, this.apiKey);
+    this.tts = new TTSModule(this.realtimexUrl, this.appId, this.appName, this.apiKey);
     if (this.permissions.length > 0 && this.appId && !this.apiKey) {
       this.register().catch((err) => {
         console.error("[RealtimeX SDK] Auto-registration failed:", err.message);
@@ -1057,6 +1240,7 @@ export {
   PermissionRequiredError,
   PortModule,
   RealtimeXSDK,
+  TTSModule,
   TaskModule,
   VectorStore,
   WebhookModule

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.1.4",
+    "version": "1.2.1",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -40,4 +40,4 @@
     "engines": {
         "node": ">=18.0.0"
     }
-}
+}