@hamsa-ai/voice-agents-sdk 0.4.1-beta.6 → 0.4.1-beta.8

package/package.json

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

package/types/main.d.ts

@@ -19,6 +19,8 @@ declare class HamsaApiError extends Error {
 type HamsaVoiceAgentConfig = {
     /** Base URL for the Hamsa API. Defaults to 'https://api.tryhamsa.com' */
     API_URL?: string;
+    /** LiveKit RTC WebSocket URL. Defaults to 'wss://rtc.eu.tryhamsa.com' */
+    LIVEKIT_URL?: string;
 };
 /**
  * Configuration options for starting a voice agent conversation
@@ -306,6 +308,8 @@ declare class HamsaVoiceAgent extends EventEmitter {
     apiKey: string;
     /** Base URL for Hamsa API endpoints */
     API_URL: string;
+    /** LiveKit RTC WebSocket URL */
+    LIVEKIT_URL: string;
     /** Job ID for tracking conversation completion status */
     jobId: string | null;
     /** Screen wake lock manager to prevent device sleep during calls */
@@ -318,21 +322,23 @@ declare class HamsaVoiceAgent extends EventEmitter {
      * @param apiKey - Your Hamsa API key (get from https://dashboard.tryhamsa.com)
      * @param config - Optional configuration settings
      * @param config.API_URL - Custom API endpoint URL (defaults to https://api.tryhamsa.com)
+     * @param config.LIVEKIT_URL - Custom LiveKit RTC URL (defaults to wss://rtc.eu.tryhamsa.com)
      *
      * @example
      * ```typescript
-     * // Using default API endpoint
+     * // Using default endpoints
      * const agent = new HamsaVoiceAgent('hamsa_api_key_here');
      *
-     * // Using custom API endpoint
+     * // Using custom endpoints
      * const agent = new HamsaVoiceAgent('hamsa_api_key_here', {
-     *   API_URL: 'https://custom-api.example.com'
+     *   API_URL: 'https://custom-api.example.com',
+     *   LIVEKIT_URL: 'wss://custom-rtc.example.com'
      * });
      * ```
      *
      * @throws {Error} If apiKey is not provided or invalid
      */
-    constructor(apiKey: string, { API_URL }?: HamsaVoiceAgentConfig);
+    constructor(apiKey: string, { API_URL, LIVEKIT_URL, }?: HamsaVoiceAgentConfig);
     /**
      * Adjusts the volume level for voice agent audio playback
      *
@@ -876,6 +882,37 @@ declare class HamsaVoiceAgent extends EventEmitter {
      * ```
      */
     getRoom(): Room | null;
+    /**
+     * Gets the remote audio track from the voice agent for visualization
+     *
+     * Provides access to the agent's audio track for use with LiveKit React
+     * visualization components like BarVisualizer. Returns undefined if not
+     * connected or no remote audio track is available.
+     *
+     * @returns RemoteTrack | undefined - The agent's audio track or undefined if not available
+     *
+     * @example With LiveKit BarVisualizer
+     * ```typescript
+     * import { BarVisualizer } from '@livekit/components-react';
+     *
+     * function AgentVisualizer({ agent }) {
+     *   const [audioTrack, setAudioTrack] = useState();
+     *
+     *   useEffect(() => {
+     *     agent.on('trackSubscribed', ({ track }) => {
+     *       if (track.kind === 'audio') {
+     *         setAudioTrack(track);
+     *       }
+     *     });
+     *   }, [agent]);
+     *
+     *   if (!audioTrack) return null;
+     *
+     *   return <BarVisualizer trackRef={{ track: audioTrack, source: 'microphone' }} />;
+     * }
+     * ```
+     */
+    getRemoteAudioTrack(): RemoteTrack | undefined;
 }
 /**
  * Declaration merging: Add type-safe event methods to HamsaVoiceAgent
@@ -919,5 +956,6 @@ interface HamsaVoiceAgent {
 }
 export { HamsaVoiceAgent, HamsaApiError };
 export default HamsaVoiceAgent;
+export type { LocalTrack, RemoteParticipant, RemoteTrack, RemoteTrackPublication, Room, } from 'livekit-client';
 export type { AudioLevelsResult, CallAnalyticsResult, ConnectionStatsResult, ParticipantData, PerformanceMetricsResult, TrackStatsResult, } from './classes/livekit-manager';
 export type { HamsaVoiceAgentEvents, StartOptions, Tool, JobDetails };