ug-js-sdk 3.0.51 → 3.0.57

package/README.md

@@ -29,13 +29,13 @@ const conversation = new ConversationManager({
   },
 })
 
-// Start the conversation
-await conversation.start()
+// Initialize the connection
+await conversation.initialize()
 
 // Send text input
 await conversation.sendText('Hello!')
 
-// Or enable voice input
+// Or enable voice input (after initialize)
 await conversation.startListening()
 ```
 

package/dist/ug-core/__tests__/__mocks__/ErrorRetryHandler.d.ts

@@ -0,0 +1,7 @@
+export declare class ErrorRetryHandler {
+    private config;
+    constructor(config: any);
+    attemptRecovery(errorType: string): Promise<boolean>;
+    resetRetryCount(): void;
+    getCurrentRetryCount(): number;
+}

package/dist/ug-core/__tests__/__mocks__/ErrorRetryHandler.js

@@ -0,0 +1,16 @@
+// Manual mock for ErrorRetryHandler
+export class ErrorRetryHandler {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async attemptRecovery(errorType) {
+        // Default to not recovering so errors propagate to hooks
+        return false;
+    }
+    resetRetryCount() { }
+    getCurrentRetryCount() {
+        return 0;
+    }
+}
+//# sourceMappingURL=ErrorRetryHandler.js.map

package/dist/ug-core/__tests__/__mocks__/ErrorRetryHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorRetryHandler.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/__mocks__/ErrorRetryHandler.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,MAAW;QAAX,WAAM,GAAN,MAAM,CAAK;IAAG,CAAC;IAEnC,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,yDAAyD;QACzD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,eAAe,KAAU,CAAC;IAE1B,oBAAoB;QAClB,OAAO,CAAC,CAAA;IACV,CAAC;CACF"}

package/dist/ug-core/__tests__/__mocks__/mpg123-decoder.d.ts

@@ -0,0 +1,10 @@
+export declare class MPEGDecoder {
+    constructor();
+    ready(): Promise<void>;
+    decode(data: Uint8Array): {
+        channelData: Float32Array[];
+        sampleRate: number;
+    };
+    reset(): void;
+    free(): void;
+}

package/dist/ug-core/__tests__/__mocks__/mpg123-decoder.js

@@ -0,0 +1,16 @@
+// Mock implementation of mpg123-decoder
+export class MPEGDecoder {
+    constructor() { }
+    async ready() {
+        return Promise.resolve();
+    }
+    decode(data) {
+        return {
+            channelData: [new Float32Array(0)],
+            sampleRate: 44100,
+        };
+    }
+    reset() { }
+    free() { }
+}
+//# sourceMappingURL=mpg123-decoder.js.map

package/dist/ug-core/__tests__/__mocks__/mpg123-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpg123-decoder.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/__mocks__/mpg123-decoder.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,OAAO,WAAW;IACtB,gBAAe,CAAC;IAEhB,KAAK,CAAC,KAAK;QACT,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED,MAAM,CAAC,IAAgB;QACrB,OAAO;YACL,WAAW,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;YAClC,UAAU,EAAE,KAAK;SAClB,CAAA;IACH,CAAC;IAED,KAAK,KAAU,CAAC;IAEhB,IAAI,KAAU,CAAC;CAChB"}

package/dist/ug-core/__tests__/__mocks__/uuid.d.ts

@@ -0,0 +1,2 @@
+export declare const v4: () => string;
+export declare const __resetMockUuid: () => void;

package/dist/ug-core/__tests__/__mocks__/uuid.js

@@ -0,0 +1,11 @@
+// Mock implementation of uuid
+let counter = 0;
+export const v4 = () => {
+    counter++;
+    return `mock-uuid-${counter}`;
+};
+// Reset counter for test isolation
+export const __resetMockUuid = () => {
+    counter = 0;
+};
+//# sourceMappingURL=uuid.js.map

package/dist/ug-core/__tests__/__mocks__/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/__mocks__/uuid.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,IAAI,OAAO,GAAG,CAAC,CAAA;AAEf,MAAM,CAAC,MAAM,EAAE,GAAG,GAAW,EAAE;IAC7B,OAAO,EAAE,CAAA;IACT,OAAO,aAAa,OAAO,EAAE,CAAA;AAC/B,CAAC,CAAA;AAED,mCAAmC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,OAAO,GAAG,CAAC,CAAA;AACb,CAAC,CAAA"}

package/dist/ug-core/__tests__/__mocks__/vad-web.d.ts

@@ -0,0 +1,11 @@
+export declare class MicVAD {
+    private options;
+    static new(options: any): Promise<MicVAD>;
+    constructor(options: any);
+    start(): void;
+    pause(): void;
+    destroy(): void;
+}
+export declare const utils: {
+    minFramesForTargetMS: (targetMS: number, frameSamples: number, sampleRate: number) => number;
+};

package/dist/ug-core/__tests__/__mocks__/vad-web.js

@@ -0,0 +1,19 @@
+// Mock implementation of @ricky0123/vad-web
+export class MicVAD {
+    options;
+    static async new(options) {
+        return new MicVAD(options);
+    }
+    constructor(options) {
+        this.options = options;
+    }
+    start() { }
+    pause() { }
+    destroy() { }
+}
+export const utils = {
+    minFramesForTargetMS: (targetMS, frameSamples, sampleRate) => {
+        return Math.ceil((targetMS * sampleRate) / (1000 * frameSamples));
+    },
+};
+//# sourceMappingURL=vad-web.js.map

package/dist/ug-core/__tests__/__mocks__/vad-web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vad-web.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/__mocks__/vad-web.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,OAAO,MAAM;IAKG;IAJpB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAY;QAC3B,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,YAAoB,OAAY;QAAZ,YAAO,GAAP,OAAO,CAAK;IAAG,CAAC;IAEpC,KAAK,KAAU,CAAC;IAEhB,KAAK,KAAU,CAAC;IAEhB,OAAO,KAAU,CAAC;CACnB;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,oBAAoB,EAAE,CAAC,QAAgB,EAAE,YAAoB,EAAE,UAAkB,EAAU,EAAE;QAC3F,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,CAAA;IACnE,CAAC;CACF,CAAA"}

package/dist/ug-core/__tests__/conversation-manager/ConversationCommands.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ug-core/__tests__/conversation-manager/ConversationCommands.test.js

@@ -0,0 +1,67 @@
+import { ConversationCommands } from '@/ug-core/conversation-manager/ConversationCommands';
+describe('ConversationCommands', () => {
+    let commands;
+    beforeEach(() => {
+        commands = new ConversationCommands();
+    });
+    describe('default values', () => {
+        it('should have correct static default constants', () => {
+            expect(ConversationCommands.DEFAULT_START_COMMAND).toBe('[start conversation]');
+            expect(ConversationCommands.DEFAULT_PAUSE_RESUME_COMMAND).toBe('[resume after short pause]');
+            expect(ConversationCommands.DEFAULT_LONG_PAUSE_RESUME_COMMAND).toBe('[resume after long break]');
+            expect(ConversationCommands.DEFAULT_ERROR_RESUME_COMMAND).toBe('[resume after error]');
+        });
+        it('should initialize with default values', () => {
+            expect(commands.startCommand).toBe(ConversationCommands.DEFAULT_START_COMMAND);
+            expect(commands.pauseResumeCommand).toBe(ConversationCommands.DEFAULT_PAUSE_RESUME_COMMAND);
+            expect(commands.longPauseResumeCommand).toBe(ConversationCommands.DEFAULT_LONG_PAUSE_RESUME_COMMAND);
+            expect(commands.errorResumeCommand).toBe(ConversationCommands.DEFAULT_ERROR_RESUME_COMMAND);
+        });
+    });
+    describe('set()', () => {
+        it('should set all command values', () => {
+            commands.set('start', 'pause', 'longPause', 'error');
+            expect(commands.startCommand).toBe('start');
+            expect(commands.pauseResumeCommand).toBe('pause');
+            expect(commands.longPauseResumeCommand).toBe('longPause');
+            expect(commands.errorResumeCommand).toBe('error');
+        });
+        it('should use defaults when parameters are undefined', () => {
+            commands.set(undefined, undefined, undefined, undefined);
+            expect(commands.startCommand).toBe(ConversationCommands.DEFAULT_START_COMMAND);
+            expect(commands.pauseResumeCommand).toBe(ConversationCommands.DEFAULT_PAUSE_RESUME_COMMAND);
+            expect(commands.longPauseResumeCommand).toBe(ConversationCommands.DEFAULT_LONG_PAUSE_RESUME_COMMAND);
+            expect(commands.errorResumeCommand).toBe(ConversationCommands.DEFAULT_ERROR_RESUME_COMMAND);
+        });
+        it('should allow partial setting with defaults for others', () => {
+            commands.set('custom start', undefined, 'custom long pause', undefined);
+            expect(commands.startCommand).toBe('custom start');
+            expect(commands.pauseResumeCommand).toBe(ConversationCommands.DEFAULT_PAUSE_RESUME_COMMAND);
+            expect(commands.longPauseResumeCommand).toBe('custom long pause');
+            expect(commands.errorResumeCommand).toBe(ConversationCommands.DEFAULT_ERROR_RESUME_COMMAND);
+        });
+        it('should handle empty strings as valid values', () => {
+            commands.set('', '', '', '');
+            expect(commands.startCommand).toBe('');
+            expect(commands.pauseResumeCommand).toBe('');
+            expect(commands.longPauseResumeCommand).toBe('');
+            expect(commands.errorResumeCommand).toBe('');
+        });
+    });
+    describe('setDefault()', () => {
+        it('should reset all commands to defaults', () => {
+            commands.set('custom1', 'custom2', 'custom3', 'custom4');
+            commands.setDefault();
+            expect(commands.startCommand).toBe(ConversationCommands.DEFAULT_START_COMMAND);
+            expect(commands.pauseResumeCommand).toBe(ConversationCommands.DEFAULT_PAUSE_RESUME_COMMAND);
+            expect(commands.longPauseResumeCommand).toBe(ConversationCommands.DEFAULT_LONG_PAUSE_RESUME_COMMAND);
+            expect(commands.errorResumeCommand).toBe(ConversationCommands.DEFAULT_ERROR_RESUME_COMMAND);
+        });
+        it('should be idempotent when called multiple times', () => {
+            commands.setDefault();
+            commands.setDefault();
+            expect(commands.startCommand).toBe(ConversationCommands.DEFAULT_START_COMMAND);
+        });
+    });
+});
+//# sourceMappingURL=ConversationCommands.test.js.map

package/dist/ug-core/__tests__/conversation-manager/ConversationCommands.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationCommands.test.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/conversation-manager/ConversationCommands.test.ts"],"names":[],"mappings":"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"}

package/dist/ug-core/__tests__/conversation-manager/ConversationManager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ug-core/__tests__/conversation-manager/ConversationManager.test.js

@@ -0,0 +1,185 @@
+import { ConversationManager } from '@/ug-core/conversation-manager/ConversationManager';
+// Mock all dependencies using path aliases
+jest.mock('@/ug-core/network/ConversationNetwork');
+jest.mock('@/ug-core/user-input-manager/VADManager');
+jest.mock('@/ug-core/user-input-manager/UserInputManager');
+jest.mock('@/ug-core/playback-manager/PlaybackManager');
+// ErrorRetryHandler is mocked via moduleNameMapper in jest.config.js
+// Import mocked classes to access mock implementations
+import { ConversationNetwork } from '@/ug-core/network/ConversationNetwork';
+import { VADManager } from '@/ug-core/user-input-manager/VADManager';
+import { UserInputManager } from '@/ug-core/user-input-manager/UserInputManager';
+import { PlaybackManager } from '@/ug-core/playback-manager/PlaybackManager';
+const MockedConversationNetwork = ConversationNetwork;
+const MockedVADManager = VADManager;
+const MockedUserInputManager = UserInputManager;
+const MockedPlaybackManager = PlaybackManager;
+describe('ConversationManager', () => {
+    let config;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        config = {
+            apiUrl: 'https://test.api.com',
+            apiKey: 'test-api-key',
+            federatedId: 'test-user-123',
+            prompt: 'You are a helpful assistant.',
+            hooks: {},
+        };
+        // Setup default mock implementations
+        MockedConversationNetwork.prototype.initialize = jest.fn().mockResolvedValue(undefined);
+        MockedConversationNetwork.prototype.connect = jest.fn().mockResolvedValue(undefined);
+        MockedConversationNetwork.prototype.disconnect = jest.fn().mockResolvedValue(undefined);
+        MockedConversationNetwork.prototype.isReady = jest.fn().mockReturnValue(false);
+        MockedConversationNetwork.prototype.updateConfig = jest.fn();
+        MockedConversationNetwork.prototype.on = jest.fn();
+        MockedConversationNetwork.prototype.removeAllListeners = jest.fn();
+        MockedVADManager.prototype.on = jest.fn();
+        MockedVADManager.prototype.removeAllListeners = jest.fn();
+        MockedUserInputManager.prototype.initialize = jest.fn().mockResolvedValue(undefined);
+        MockedUserInputManager.prototype.start = jest.fn().mockResolvedValue(undefined);
+        MockedUserInputManager.prototype.stop = jest.fn().mockResolvedValue(false);
+        MockedUserInputManager.prototype.on = jest.fn();
+        MockedUserInputManager.prototype.removeAllListeners = jest.fn();
+        MockedPlaybackManager.prototype.initialize = jest.fn().mockResolvedValue(undefined);
+        MockedPlaybackManager.prototype.wireVADToAvatar = jest.fn();
+        MockedPlaybackManager.prototype.wireConversationStateToAvatar = jest.fn();
+        MockedPlaybackManager.prototype.dispose = jest.fn();
+        MockedPlaybackManager.prototype.on = jest.fn();
+        MockedPlaybackManager.prototype.removeAllListeners = jest.fn();
+    });
+    describe('constructor', () => {
+        it('should create instance with valid config', () => {
+            const manager = new ConversationManager(config);
+            expect(manager).toBeInstanceOf(ConversationManager);
+        });
+        it('should initialize with default capabilities when not provided', () => {
+            const minimalConfig = {
+                apiUrl: 'https://stg.uglabs.app',
+                apiKey: 'test-key',
+                federatedId: 'test-user',
+                hooks: {},
+            };
+            const manager = new ConversationManager(minimalConfig);
+            expect(manager).toBeInstanceOf(ConversationManager);
+        });
+        it('should create network, VAD manager, user input manager, and playback manager', () => {
+            new ConversationManager(config);
+            expect(MockedConversationNetwork).toHaveBeenCalledTimes(1);
+            expect(MockedVADManager).toHaveBeenCalledTimes(1);
+            expect(MockedUserInputManager).toHaveBeenCalledTimes(1);
+            expect(MockedPlaybackManager).toHaveBeenCalledTimes(1);
+        });
+        it('should wire playback manager to avatar', () => {
+            const manager = new ConversationManager(config);
+            expect(MockedPlaybackManager.prototype.wireVADToAvatar).toHaveBeenCalledWith(manager);
+            expect(MockedPlaybackManager.prototype.wireConversationStateToAvatar).toHaveBeenCalledWith(manager);
+        });
+        it('should setup event listeners on child components', () => {
+            new ConversationManager(config);
+            // Network events
+            expect(MockedConversationNetwork.prototype.on).toHaveBeenCalled();
+            // User input events
+            expect(MockedUserInputManager.prototype.on).toHaveBeenCalled();
+            // Playback events
+            expect(MockedPlaybackManager.prototype.on).toHaveBeenCalled();
+        });
+    });
+    describe('initialize()', () => {
+        it('should initialize all components in correct order', async () => {
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true }, // Disable audio to skip getUserMedia
+            });
+            await manager.initialize();
+            // Verify initialization order
+            expect(MockedConversationNetwork.prototype.initialize).toHaveBeenCalledTimes(1);
+            expect(MockedPlaybackManager.prototype.initialize).toHaveBeenCalledTimes(1);
+            expect(MockedUserInputManager.prototype.initialize).toHaveBeenCalledTimes(1);
+            expect(MockedConversationNetwork.prototype.connect).toHaveBeenCalledTimes(1);
+        });
+        it('should call onStateChange hook during initialization', async () => {
+            const onStateChange = jest.fn();
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true },
+                hooks: { onStateChange },
+            });
+            await manager.initialize();
+            // Should transition through: uninitialized -> initializing -> waiting
+            expect(onStateChange).toHaveBeenCalledWith('initializing');
+            expect(onStateChange).toHaveBeenCalledWith('waiting');
+        });
+        it('should transition to error state when initialization fails', async () => {
+            const onStateChange = jest.fn();
+            MockedConversationNetwork.prototype.initialize = jest
+                .fn()
+                .mockRejectedValue(new Error('Network error'));
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true },
+                hooks: { onStateChange },
+            });
+            await manager.initialize();
+            // Should transition to error state when initialization fails
+            expect(onStateChange).toHaveBeenCalledWith('error');
+        });
+    });
+    describe('dispose()', () => {
+        it('should dispose all resources', async () => {
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true },
+            });
+            await manager.dispose();
+            // Verify all cleanup calls
+            expect(MockedUserInputManager.prototype.removeAllListeners).toHaveBeenCalled();
+            expect(MockedPlaybackManager.prototype.removeAllListeners).toHaveBeenCalled();
+            expect(MockedConversationNetwork.prototype.removeAllListeners).toHaveBeenCalled();
+            expect(MockedPlaybackManager.prototype.dispose).toHaveBeenCalled();
+            expect(MockedConversationNetwork.prototype.disconnect).toHaveBeenCalled();
+        });
+        it('should only dispose once when called multiple times', async () => {
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true },
+            });
+            await manager.dispose();
+            await manager.dispose();
+            // Should only be called once despite multiple dispose() calls
+            expect(MockedPlaybackManager.prototype.dispose).toHaveBeenCalledTimes(1);
+            expect(MockedConversationNetwork.prototype.disconnect).toHaveBeenCalledTimes(1);
+        });
+        it('should be safe to dispose without initializing first', async () => {
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true },
+            });
+            // Should not throw even though we never called initialize()
+            await expect(manager.dispose()).resolves.toBeUndefined();
+        });
+        it('should handle errors during disposal gracefully', async () => {
+            MockedConversationNetwork.prototype.disconnect = jest
+                .fn()
+                .mockRejectedValue(new Error('Disconnect failed'));
+            const manager = new ConversationManager({
+                ...config,
+                inputCapabilities: { audio: false, text: true },
+            });
+            // Should not throw, just log warning
+            await expect(manager.dispose()).resolves.toBeUndefined();
+        });
+    });
+    describe('isConnected()', () => {
+        it('should return false when network is not ready', () => {
+            MockedConversationNetwork.prototype.isReady = jest.fn().mockReturnValue(false);
+            const manager = new ConversationManager(config);
+            expect(manager.isConnected()).toBe(false);
+        });
+        it('should return true when network is ready', () => {
+            MockedConversationNetwork.prototype.isReady = jest.fn().mockReturnValue(true);
+            const manager = new ConversationManager(config);
+            expect(manager.isConnected()).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=ConversationManager.test.js.map

package/dist/ug-core/__tests__/conversation-manager/ConversationManager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationManager.test.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/conversation-manager/ConversationManager.test.ts"],"names":[],"mappings":"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"}

package/dist/ug-core/__tests__/conversation-manager/ErrorRetryHandler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ug-core/__tests__/conversation-manager/ErrorRetryHandler.test.js

@@ -0,0 +1,168 @@
+import { ErrorRetryHandler, } from '@/ug-core/conversation-manager/ErrorRetryHandler';
+import { ConversationCommands } from '@/ug-core/conversation-manager/ConversationCommands';
+describe('ErrorRetryHandler', () => {
+    let handler;
+    let mockDeps;
+    let mockLogger;
+    let mockCommands;
+    let mockSendText;
+    let mockIsConnected;
+    beforeEach(() => {
+        mockLogger = {
+            trace: jest.fn(),
+            debug: jest.fn(),
+            info: jest.fn(),
+            warn: jest.fn(),
+            error: jest.fn(),
+        };
+        mockCommands = new ConversationCommands();
+        mockSendText = jest.fn().mockResolvedValue(undefined);
+        mockIsConnected = jest.fn().mockReturnValue(true);
+        mockDeps = {
+            logger: mockLogger,
+            conversationCommands: mockCommands,
+            sendText: mockSendText,
+            clearAudio: jest.fn().mockResolvedValue(undefined),
+            isConnected: mockIsConnected,
+            maxRetryCount: 3,
+        };
+        handler = new ErrorRetryHandler(mockDeps);
+    });
+    describe('constructor', () => {
+        it('should use default max retry count when not provided', () => {
+            const depsWithoutMax = { ...mockDeps };
+            delete depsWithoutMax.maxRetryCount;
+            const handlerWithDefaults = new ErrorRetryHandler(depsWithoutMax);
+            expect(handlerWithDefaults.getCurrentRetryCount()).toBe(0);
+        });
+        it('should use provided max retry count', () => {
+            const customDeps = { ...mockDeps, maxRetryCount: 5 };
+            const customHandler = new ErrorRetryHandler(customDeps);
+            // Verify by attempting recovery up to the custom limit
+            expect(customHandler.getCurrentRetryCount()).toBe(0);
+        });
+    });
+    describe('attemptRecovery()', () => {
+        describe('retryable errors', () => {
+            it.each(['network_timeout', 'network_error', 'server_error'])('should attempt recovery for %s error', async (errorType) => {
+                const result = await handler.attemptRecovery(errorType);
+                expect(result).toBe(true);
+                expect(mockDeps.clearAudio).toHaveBeenCalled();
+                expect(mockSendText).toHaveBeenCalledWith(mockCommands.errorResumeCommand);
+                expect(handler.getCurrentRetryCount()).toBe(1);
+            });
+        });
+        describe('non-retryable errors', () => {
+            it.each(['mic_denied', 'decode_error'])('should not attempt recovery for %s error', async (errorType) => {
+                const result = await handler.attemptRecovery(errorType);
+                expect(result).toBe(false);
+                expect(mockSendText).not.toHaveBeenCalled();
+                expect(handler.getCurrentRetryCount()).toBe(0);
+            });
+        });
+        describe('network connectivity', () => {
+            it('should not retry when network is disconnected', async () => {
+                mockIsConnected.mockReturnValue(false);
+                const result = await handler.attemptRecovery('network_error');
+                expect(result).toBe(false);
+                expect(mockSendText).not.toHaveBeenCalled();
+            });
+        });
+        describe('max retry count', () => {
+            it('should respect max retry count', async () => {
+                // Exhaust retries
+                await handler.attemptRecovery('network_error');
+                await handler.attemptRecovery('network_error');
+                await handler.attemptRecovery('network_error');
+                expect(handler.getCurrentRetryCount()).toBe(3);
+                // Fourth attempt should fail
+                const result = await handler.attemptRecovery('network_error');
+                expect(result).toBe(false);
+                expect(mockSendText).toHaveBeenCalledTimes(3); // Not called on 4th attempt
+            });
+        });
+        describe('retry failure handling', () => {
+            it('should retry recursively when sendText fails', async () => {
+                mockSendText
+                    .mockRejectedValueOnce(new Error('First failure'))
+                    .mockRejectedValueOnce(new Error('Second failure'))
+                    .mockResolvedValueOnce(undefined);
+                const result = await handler.attemptRecovery('network_error');
+                expect(result).toBe(true);
+                expect(mockSendText).toHaveBeenCalledTimes(3);
+                expect(handler.getCurrentRetryCount()).toBe(3);
+            });
+            it('should return false when all retries are exhausted', async () => {
+                mockSendText.mockRejectedValue(new Error('Always fails'));
+                const result = await handler.attemptRecovery('network_error');
+                expect(result).toBe(false);
+                expect(mockSendText).toHaveBeenCalledTimes(3);
+                expect(handler.getCurrentRetryCount()).toBe(3);
+            });
+        });
+        describe('concurrent retry prevention', () => {
+            it('should prevent recursive retry attempts', async () => {
+                // Create a promise that we can control
+                let resolveSendText;
+                mockSendText.mockImplementation(() => new Promise((resolve) => {
+                    resolveSendText = resolve;
+                }));
+                // Start first recovery
+                const firstRecovery = handler.attemptRecovery('network_error');
+                // Try second recovery while first is in progress
+                const secondRecovery = handler.attemptRecovery('network_error');
+                const secondResult = await secondRecovery;
+                expect(secondResult).toBe(false);
+                // Complete first recovery
+                resolveSendText();
+                const firstResult = await firstRecovery;
+                expect(firstResult).toBe(true);
+                expect(mockSendText).toHaveBeenCalledTimes(1);
+            });
+        });
+    });
+    describe('resetRetryCount()', () => {
+        it('should reset the retry count to zero', async () => {
+            await handler.attemptRecovery('network_error');
+            await handler.attemptRecovery('network_error');
+            expect(handler.getCurrentRetryCount()).toBe(2);
+            handler.resetRetryCount();
+            expect(handler.getCurrentRetryCount()).toBe(0);
+        });
+        it('should allow new retries after reset', async () => {
+            // Exhaust retries
+            await handler.attemptRecovery('network_error');
+            await handler.attemptRecovery('network_error');
+            await handler.attemptRecovery('network_error');
+            // Reset
+            handler.resetRetryCount();
+            // Should be able to retry again
+            const result = await handler.attemptRecovery('network_error');
+            expect(result).toBe(true);
+            expect(handler.getCurrentRetryCount()).toBe(1);
+        });
+    });
+    describe('getCurrentRetryCount()', () => {
+        it('should return 0 initially', () => {
+            expect(handler.getCurrentRetryCount()).toBe(0);
+        });
+        it('should increment with each retry attempt', async () => {
+            await handler.attemptRecovery('network_error');
+            expect(handler.getCurrentRetryCount()).toBe(1);
+            await handler.attemptRecovery('network_error');
+            expect(handler.getCurrentRetryCount()).toBe(2);
+        });
+    });
+    describe('logging', () => {
+        it('should log info when attempting recovery', async () => {
+            await handler.attemptRecovery('network_error');
+            expect(mockLogger.info).toHaveBeenCalledWith(expect.stringContaining('Attempting silent recovery'));
+        });
+        it('should log info when network is not connected', async () => {
+            mockIsConnected.mockReturnValue(false);
+            await handler.attemptRecovery('network_error');
+            expect(mockLogger.info).toHaveBeenCalledWith(expect.stringContaining('Network is not connected'));
+        });
+    });
+});
+//# sourceMappingURL=ErrorRetryHandler.test.js.map

package/dist/ug-core/__tests__/conversation-manager/ErrorRetryHandler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorRetryHandler.test.js","sourceRoot":"","sources":["../../../../src/ug-core/__tests__/conversation-manager/ErrorRetryHandler.test.ts"],"names":[],"mappings":"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"}

package/dist/ug-core/__tests__/core/EventEmitter.test.d.ts

@@ -0,0 +1 @@
+export {};