@hamsa-ai/voice-agents-sdk 0.5.1-beta.1 → 0.5.2

package/package.json

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

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

@@ -182,6 +182,8 @@ export declare class LiveKitAnalytics extends EventEmitter {
     private lastUserInputTime;
     /** Previous connection quality for jitter change detection (internal) */
     private previousConnectionQuality;
+    /** Debug logger instance for conditional logging */
+    private readonly logger;
     /**
      * Creates a new LiveKitAnalytics instance
      *
@@ -203,7 +205,7 @@ export declare class LiveKitAnalytics extends EventEmitter {
      * analytics.startAnalyticsCollection();
      * ```
      */
-    constructor();
+    constructor(debug?: boolean);
     /**
      * Sets the LiveKit room reference for analytics data collection
      *

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

@@ -154,7 +154,7 @@
  * - Manages DOM element lifecycle to prevent memory leaks
  */
 import { EventEmitter } from 'events';
-import { type RemoteParticipant, type RemoteTrack, type RemoteTrackPublication, type Room } from 'livekit-client';
+import { type LocalTrack, type LocalTrackPublication, type Participant, type RemoteParticipant, type RemoteTrack, type RemoteTrackPublication, type Room, Track, type TrackPublication } from 'livekit-client';
 import type { AudioCaptureOptions, TrackStatsData, TrackStatsResult } from './types';
 /**
  * LiveKitAudioManager class for comprehensive audio stream management
@@ -181,8 +181,14 @@ export declare class LiveKitAudioManager extends EventEmitter {
     private audioCaptureOptions;
     private readonly recorders;
     private readonly processors;
+    private readonly sourceNodes;
+    /** Map of track IDs to cloned MediaStreamTracks for capture */
+    private readonly clonedTracks;
     /** Map of track IDs to their capture state */
     private readonly trackCaptureMap;
+    /** Debug logger instance for conditional logging */
+    private readonly logger;
+    constructor(debug?: boolean);
     /**
      * Provides the LiveKit Room to the audio manager for microphone control.
      */
@@ -459,6 +465,13 @@ export declare class LiveKitAudioManager extends EventEmitter {
      * ```
      */
     handleTrackSubscribed(track: RemoteTrack, publication: RemoteTrackPublication, participant: RemoteParticipant): void;
+    /**
+     * Processes local audio track publications
+     * @param track - The local audio track
+     * @param publication - Local track publication metadata
+     * @param participant - The local participant who published the track
+     */
+    handleLocalTrackPublished(track: LocalTrack, publication: LocalTrackPublication, participant: Participant): void;
     /**
      * Processes audio track unsubscription and cleanup
      *
@@ -495,7 +508,14 @@ export declare class LiveKitAudioManager extends EventEmitter {
      * });
      * ```
      */
-    handleTrackUnsubscribed(track: RemoteTrack, publication: RemoteTrackPublication, participant: RemoteParticipant): void;
+    handleTrackUnsubscribed(track: Track, publication: TrackPublication, participant: Participant): void;
+    /**
+     * Processes local audio track unpublications
+     * @param track - The local audio track
+     * @param publication - Local track publication metadata
+     * @param participant - The local participant who unpublished the track
+     */
+    handleLocalTrackUnsubscribed(track: LocalTrack, publication: LocalTrackPublication, participant: Participant): void;
     /**
      * Pauses playback of all active audio streams
      *
@@ -780,6 +800,11 @@ export declare class LiveKitAudioManager extends EventEmitter {
      * ```
      */
     enableAudioCapture(options: AudioCaptureOptions): void;
+    /**
+     * Internal state for AudioWorklet registration to prevent race conditions
+     * @private
+     */
+    private workletReady;
     /**
      * Disables audio capture and cleans up all capture resources
      *

package/types/classes/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared types and interfaces for LiveKit modules
  */
-import type { ConnectionQuality, RemoteTrack, RemoteTrackPublication } from 'livekit-client';
+import type { ConnectionQuality, Track, TrackPublication } from 'livekit-client';
 /**
  * Agent state as defined by LiveKit
  * Represents the current state of the voice agent
@@ -62,7 +62,7 @@ export type TrackStatsData = {
     /** Unix timestamp when this track was subscribed to */
     subscriptionTime: number;
     /** LiveKit track publication object containing track details */
-    publication: RemoteTrackPublication;
+    publication: TrackPublication;
     /** Track source (microphone, screen_share, etc.) */
     source?: string;
     /** Whether the track is currently muted */
@@ -270,9 +270,9 @@ export type ConnectionQualityData = {
  */
 export type TrackSubscriptionData = {
     /** The LiveKit track object that was subscribed to */
-    track: RemoteTrack;
+    track: Track;
     /** The track publication containing metadata */
-    publication: RemoteTrackPublication;
+    publication: TrackPublication;
     /** Identity of the participant who owns this track */
     participant: string;
     /** Optional statistics about this track subscription */
@@ -284,9 +284,9 @@ export type TrackSubscriptionData = {
  */
 export type TrackUnsubscriptionData = {
     /** The LiveKit track object that was unsubscribed from */
-    track: RemoteTrack;
+    track: Track;
     /** The track publication that was removed */
-    publication: RemoteTrackPublication;
+    publication: TrackPublication;
     /** Identity of the participant who owned this track */
     participant: string;
 };
@@ -336,6 +336,8 @@ export type AudioCaptureMetadata = {
     timestamp: number;
     /** Track ID associated with this audio */
     trackId: string;
+    /** Source of this specific track (e.g. 'microphone', 'screen_share') */
+    trackSource?: string;
     /** Audio format of this chunk */
     format: AudioCaptureFormat;
     /** Sample rate in Hz (for PCM formats) */
@@ -353,6 +355,9 @@ export type AudioCaptureCallback = (audioData: ArrayBuffer | Float32Array | Int1
 export type AudioCaptureOptions = {
     /** Source of audio to capture (default: 'agent') */
     source?: AudioCaptureSource;
+    /** Specific track source to capture (default: 'microphone').
+     * Set to 'all' to capture everything including screen share audio. */
+    trackSourceFilter?: 'microphone' | 'screen_share' | 'all';
     /** Audio format to deliver (default: 'opus-webm') */
     format?: AudioCaptureFormat;
     /** Chunk size in milliseconds for encoded formats (default: 100ms) */