@realtimex/sdk 1.1.3 → 1.2.0

package/dist/index.d.mts

@@ -79,6 +79,24 @@ interface Task {
     updated_at: string;
     runs: TaskRun[];
 }
+interface TTSOptions {
+    voice?: string;
+    model?: string;
+    speed?: number;
+    provider?: string;
+}
+interface TTSProvider {
+    id: string;
+    name: string;
+    type: 'remote' | 'local';
+    voices: string[];
+}
+interface TTSProvidersResponse {
+    success: boolean;
+    providers: TTSProvider[];
+    default: string;
+    error?: string;
+}
 
 /**
  * Activities Module - HTTP Proxy to RealtimeX Main App
@@ -396,6 +414,36 @@ interface VectorListWorkspacesResponse {
     workspaces?: string[];
     error?: string;
     code?: string;
+    error_message?: string;
+}
+interface VectorRegisterResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+    code?: string;
+}
+interface VectorConfigResponse {
+    success: boolean;
+    provider?: string;
+    config?: Record<string, any>;
+    error?: string;
+    code?: string;
+}
+interface VectorProviderField {
+    name: string;
+    label: string;
+    type: 'string' | 'password';
+    placeholder?: string;
+}
+interface VectorProviderMetadata {
+    name: string;
+    label: string;
+    description?: string;
+    fields: VectorProviderField[];
+}
+interface VectorProvidersResponse {
+    success: boolean;
+    providers: VectorProviderMetadata[];
 }
 /**
  * @deprecated Use PermissionRequiredError from api module instead
@@ -468,6 +516,29 @@ declare class VectorStore {
      * ```
      */
     listWorkspaces(): Promise<VectorListWorkspacesResponse>;
+    /**
+     * Register a custom vector database configuration for this app
+     *
+     * @example
+     * ```ts
+     * await sdk.llm.vectors.registerConfig('lancedb', { });
+     * ```
+     */
+    registerConfig(provider: string, config: Record<string, any>): Promise<VectorRegisterResponse>;
+    /**
+     * List all supported vector database providers and their configuration requirements
+     */
+    listProviders(): Promise<VectorProvidersResponse>;
+    /**
+     * Get the current vector database configuration for this app
+     *
+     * @example
+     * ```ts
+     * const { provider, config } = await sdk.llm.vectors.getConfig();
+     * console.log(`App is using ${provider}`);
+     * ```
+     */
+    getConfig(): Promise<VectorConfigResponse>;
 }
 declare class LLMModule {
     private baseUrl;
@@ -583,6 +654,49 @@ 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 (returns stream)
+     *
+     * @example
+     * ```ts
+     * const stream = await sdk.tts.speakStream("Hello world");
+     * for await (const chunk of stream) {
+     *   // Play chunk...
+     * }
+     * ```
+     */
+    speakStream(text: string, options?: TTSOptions): AsyncGenerator<Uint8Array>;
+    /**
+     * List available TTS providers
+     */
+    listProviders(): Promise<TTSProvider[]>;
+}
+
 /**
  * RealtimeX Local App SDK
  *
@@ -597,6 +711,7 @@ declare class RealtimeXSDK {
     task: TaskModule;
     port: PortModule;
     llm: LLMModule;
+    tts: TTSModule;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;
@@ -623,6 +738,11 @@ declare class RealtimeXSDK {
         appId?: string;
         timestamp: string;
     }>;
+    /**
+     * Get the absolute path to the data directory for this app.
+     * Path: ~/.realtimex.ai/Resources/local-apps/{appId}
+     */
+    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, TTSModule, type TTSOptions, type TTSProvider, 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,24 @@ interface Task {
     updated_at: string;
     runs: TaskRun[];
 }
+interface TTSOptions {
+    voice?: string;
+    model?: string;
+    speed?: number;
+    provider?: string;
+}
+interface TTSProvider {
+    id: string;
+    name: string;
+    type: 'remote' | 'local';
+    voices: string[];
+}
+interface TTSProvidersResponse {
+    success: boolean;
+    providers: TTSProvider[];
+    default: string;
+    error?: string;
+}
 
 /**
  * Activities Module - HTTP Proxy to RealtimeX Main App
@@ -396,6 +414,36 @@ interface VectorListWorkspacesResponse {
     workspaces?: string[];
     error?: string;
     code?: string;
+    error_message?: string;
+}
+interface VectorRegisterResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+    code?: string;
+}
+interface VectorConfigResponse {
+    success: boolean;
+    provider?: string;
+    config?: Record<string, any>;
+    error?: string;
+    code?: string;
+}
+interface VectorProviderField {
+    name: string;
+    label: string;
+    type: 'string' | 'password';
+    placeholder?: string;
+}
+interface VectorProviderMetadata {
+    name: string;
+    label: string;
+    description?: string;
+    fields: VectorProviderField[];
+}
+interface VectorProvidersResponse {
+    success: boolean;
+    providers: VectorProviderMetadata[];
 }
 /**
  * @deprecated Use PermissionRequiredError from api module instead
@@ -468,6 +516,29 @@ declare class VectorStore {
      * ```
      */
     listWorkspaces(): Promise<VectorListWorkspacesResponse>;
+    /**
+     * Register a custom vector database configuration for this app
+     *
+     * @example
+     * ```ts
+     * await sdk.llm.vectors.registerConfig('lancedb', { });
+     * ```
+     */
+    registerConfig(provider: string, config: Record<string, any>): Promise<VectorRegisterResponse>;
+    /**
+     * List all supported vector database providers and their configuration requirements
+     */
+    listProviders(): Promise<VectorProvidersResponse>;
+    /**
+     * Get the current vector database configuration for this app
+     *
+     * @example
+     * ```ts
+     * const { provider, config } = await sdk.llm.vectors.getConfig();
+     * console.log(`App is using ${provider}`);
+     * ```
+     */
+    getConfig(): Promise<VectorConfigResponse>;
 }
 declare class LLMModule {
     private baseUrl;
@@ -583,6 +654,49 @@ 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 (returns stream)
+     *
+     * @example
+     * ```ts
+     * const stream = await sdk.tts.speakStream("Hello world");
+     * for await (const chunk of stream) {
+     *   // Play chunk...
+     * }
+     * ```
+     */
+    speakStream(text: string, options?: TTSOptions): AsyncGenerator<Uint8Array>;
+    /**
+     * List available TTS providers
+     */
+    listProviders(): Promise<TTSProvider[]>;
+}
+
 /**
  * RealtimeX Local App SDK
  *
@@ -597,6 +711,7 @@ declare class RealtimeXSDK {
     task: TaskModule;
     port: PortModule;
     llm: LLMModule;
+    tts: TTSModule;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;
@@ -623,6 +738,11 @@ declare class RealtimeXSDK {
         appId?: string;
         timestamp: string;
     }>;
+    /**
+     * Get the absolute path to the data directory for this app.
+     * Path: ~/.realtimex.ai/Resources/local-apps/{appId}
+     */
+    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, TTSModule, type TTSOptions, type TTSProvider, 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
@@ -643,6 +644,38 @@ var VectorStore = class {
   async listWorkspaces() {
     return this.request("GET", "/sdk/llm/vectors/workspaces");
   }
+  /**
+   * Register a custom vector database configuration for this app
+   * 
+   * @example
+   * ```ts
+   * await sdk.llm.vectors.registerConfig('lancedb', { });
+   * ```
+   */
+  async registerConfig(provider, config) {
+    return this.request("POST", "/sdk/llm/vectors/register", {
+      provider,
+      config
+    });
+  }
+  /**
+   * List all supported vector database providers and their configuration requirements
+   */
+  async listProviders() {
+    return this.request("GET", "/sdk/llm/vectors/providers");
+  }
+  /**
+   * Get the current vector database configuration for this app
+   * 
+   * @example
+   * ```ts
+   * const { provider, config } = await sdk.llm.vectors.getConfig();
+   * console.log(`App is using ${provider}`);
+   * ```
+   */
+  async getConfig() {
+    return this.request("GET", "/sdk/llm/vectors/config");
+  }
 };
 var LLMModule = class {
   constructor(baseUrl, appId, appName = "Local App", apiKey) {
@@ -948,6 +981,129 @@ 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 (returns stream)
+   * 
+   * @example
+   * ```ts
+   * const stream = await sdk.tts.speakStream("Hello world");
+   * for await (const chunk of stream) {
+   *   // Play chunk...
+   * }
+   * ```
+   */
+  async *speakStream(text, options = {}) {
+    const body = await this.request("POST", "/sdk/tts/stream", {
+      text,
+      ...options
+    }, true);
+    if (!body) throw new Error("No response body");
+    const reader = body.getReader();
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        yield value;
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /**
+   * List available TTS providers
+   */
+  async listProviders() {
+    const data = await this.request("GET", "/sdk/tts/providers");
+    return data.providers || [];
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -965,6 +1121,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);
@@ -1034,6 +1191,31 @@ var _RealtimeXSDK = class _RealtimeXSDK {
       throw new Error(`Connection failed: ${error.message}`);
     }
   }
+  /**
+   * Get the absolute path to the data directory for this app.
+   * Path: ~/.realtimex.ai/Resources/local-apps/{appId}
+   */
+  async getAppDataDir() {
+    try {
+      const headers = { "Content-Type": "application/json" };
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      } else if (this.appId) {
+        headers["x-app-id"] = this.appId;
+      }
+      const response = await fetch(`${this.realtimexUrl.replace(/\/$/, "")}/sdk/local-apps/data-dir`, {
+        method: "GET",
+        headers
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        throw new Error(data.error || "Failed to get data directory");
+      }
+      return data.dataDir;
+    } catch (error) {
+      throw new Error(`Failed to get app data directory: ${error.message}`);
+    }
+  }
 };
 _RealtimeXSDK.DEFAULT_REALTIMEX_URL = "http://localhost:3001";
 var RealtimeXSDK = _RealtimeXSDK;
@@ -1048,6 +1230,7 @@ var RealtimeXSDK = _RealtimeXSDK;
   PermissionRequiredError,
   PortModule,
   RealtimeXSDK,
+  TTSModule,
   TaskModule,
   VectorStore,
   WebhookModule

package/dist/index.mjs

@@ -596,6 +596,38 @@ var VectorStore = class {
   async listWorkspaces() {
     return this.request("GET", "/sdk/llm/vectors/workspaces");
   }
+  /**
+   * Register a custom vector database configuration for this app
+   * 
+   * @example
+   * ```ts
+   * await sdk.llm.vectors.registerConfig('lancedb', { });
+   * ```
+   */
+  async registerConfig(provider, config) {
+    return this.request("POST", "/sdk/llm/vectors/register", {
+      provider,
+      config
+    });
+  }
+  /**
+   * List all supported vector database providers and their configuration requirements
+   */
+  async listProviders() {
+    return this.request("GET", "/sdk/llm/vectors/providers");
+  }
+  /**
+   * Get the current vector database configuration for this app
+   * 
+   * @example
+   * ```ts
+   * const { provider, config } = await sdk.llm.vectors.getConfig();
+   * console.log(`App is using ${provider}`);
+   * ```
+   */
+  async getConfig() {
+    return this.request("GET", "/sdk/llm/vectors/config");
+  }
 };
 var LLMModule = class {
   constructor(baseUrl, appId, appName = "Local App", apiKey) {
@@ -901,6 +933,129 @@ 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 (returns stream)
+   * 
+   * @example
+   * ```ts
+   * const stream = await sdk.tts.speakStream("Hello world");
+   * for await (const chunk of stream) {
+   *   // Play chunk...
+   * }
+   * ```
+   */
+  async *speakStream(text, options = {}) {
+    const body = await this.request("POST", "/sdk/tts/stream", {
+      text,
+      ...options
+    }, true);
+    if (!body) throw new Error("No response body");
+    const reader = body.getReader();
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        yield value;
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  /**
+   * List available TTS providers
+   */
+  async listProviders() {
+    const data = await this.request("GET", "/sdk/tts/providers");
+    return data.providers || [];
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -918,6 +1073,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);
@@ -987,6 +1143,31 @@ var _RealtimeXSDK = class _RealtimeXSDK {
       throw new Error(`Connection failed: ${error.message}`);
     }
   }
+  /**
+   * Get the absolute path to the data directory for this app.
+   * Path: ~/.realtimex.ai/Resources/local-apps/{appId}
+   */
+  async getAppDataDir() {
+    try {
+      const headers = { "Content-Type": "application/json" };
+      if (this.apiKey) {
+        headers["Authorization"] = `Bearer ${this.apiKey}`;
+      } else if (this.appId) {
+        headers["x-app-id"] = this.appId;
+      }
+      const response = await fetch(`${this.realtimexUrl.replace(/\/$/, "")}/sdk/local-apps/data-dir`, {
+        method: "GET",
+        headers
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        throw new Error(data.error || "Failed to get data directory");
+      }
+      return data.dataDir;
+    } catch (error) {
+      throw new Error(`Failed to get app data directory: ${error.message}`);
+    }
+  }
 };
 _RealtimeXSDK.DEFAULT_REALTIMEX_URL = "http://localhost:3001";
 var RealtimeXSDK = _RealtimeXSDK;
@@ -1000,6 +1181,7 @@ export {
   PermissionRequiredError,
   PortModule,
   RealtimeXSDK,
+  TTSModule,
   TaskModule,
   VectorStore,
   WebhookModule

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.1.3",
+    "version": "1.2.0",
     "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"
     }
-}
+}