@hamsa-ai/voice-agents-sdk 0.4.2 → 0.4.3-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamsa-ai/voice-agents-sdk",
-  "version": "0.4.2",
+  "version": "0.4.3-beta.2",
   "description": "Hamsa AI - Voice Agents JavaScript SDK",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/types/classes/livekit-connection.d.ts

@@ -188,6 +188,8 @@ export declare class LiveKitConnection extends EventEmitter {
     private reconnectionAttempts;
     /** Whether we've already emitted a 'connected' event for the current session */
     private hasEmittedConnected;
+    /** Enable debug logging for troubleshooting */
+    private readonly debug;
     /**
      * Creates a new LiveKitConnection instance
      *
@@ -197,19 +199,21 @@ export declare class LiveKitConnection extends EventEmitter {
      *
      * @param lkUrl - LiveKit WebSocket URL (e.g., 'wss://livekit.example.com')
      * @param accessToken - JWT token for room authentication and authorization
+     * @param debug - Enable debug logging (defaults to false)
      *
      * @example
      * ```typescript
      * const connection = new LiveKitConnection(
      *   'wss://rtc.eu.tryhamsa.com',
-     *   'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+     *   'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+     *   false
      * );
      *
      * // Connection is ready for use
      * await connection.connect();
      * ```
      */
-    constructor(lkUrl: string, accessToken: string);
+    constructor(lkUrl: string, accessToken: string, debug?: boolean);
     /**
      * Provides access to the underlying LiveKit room instance
      *

package/types/classes/livekit-manager.d.ts

@@ -83,7 +83,7 @@ export default class LiveKitManager extends EventEmitter {
      * );
      * ```
      */
-    constructor(lkUrl: string, accessToken: string, tools?: Tool[]);
+    constructor(lkUrl: string, accessToken: string, tools?: Tool[], debug?: boolean);
     /**
      * Establishes connection to the LiveKit room and initializes voice agent communication
      *

package/types/main.d.ts

@@ -21,6 +21,8 @@ type HamsaVoiceAgentConfig = {
     API_URL?: string;
     /** LiveKit RTC WebSocket URL. Defaults to 'wss://rtc.eu.tryhamsa.com' */
     LIVEKIT_URL?: string;
+    /** Enable debug logging for troubleshooting. Defaults to false */
+    debug?: boolean;
 };
 /**
  * Configuration options for starting a voice agent conversation
@@ -302,8 +304,6 @@ declare class HamsaVoiceAgent extends EventEmitter {
     private static readonly DEFAULT_OUTPUT_VOLUME;
     /** Default fallback input volume when not connected */
     private static readonly DEFAULT_INPUT_VOLUME;
-    /** Delay in milliseconds before auto-disconnect when agent leaves (allows LiveKit cleanup) */
-    private static readonly AGENT_DISCONNECT_DELAY_MS;
     /** Internal LiveKit manager instance for WebRTC communication */
     liveKitManager: LiveKitManager | null;
     /** Hamsa API key for authentication */
@@ -312,6 +312,8 @@ declare class HamsaVoiceAgent extends EventEmitter {
     API_URL: string;
     /** LiveKit RTC WebSocket URL */
     LIVEKIT_URL: string;
+    /** Enable debug logging for troubleshooting */
+    debug: boolean;
     /** Job ID for tracking conversation completion status */
     jobId: string | null;
     /** Screen wake lock manager to prevent device sleep during calls */
@@ -340,7 +342,7 @@ declare class HamsaVoiceAgent extends EventEmitter {
      *
      * @throws {Error} If apiKey is not provided or invalid
      */
-    constructor(apiKey: string, { API_URL, LIVEKIT_URL, }?: HamsaVoiceAgentConfig);
+    constructor(apiKey: string, { API_URL, LIVEKIT_URL, debug, }?: HamsaVoiceAgentConfig);
     /**
      * Adjusts the volume level for voice agent audio playback
      *