from unittest.mock import AsyncMock, patch import pytest from agents.realtime._default_tracker import ModelAudioTracker from agents.realtime.model import RealtimePlaybackTracker from agents.realtime.model_inputs import RealtimeModelSendInterrupt from agents.realtime.openai_realtime import OpenAIRealtimeWebSocketModel class TestPlaybackTracker: """Test playback tracker functionality for interrupt timing.""" @pytest.fixture def model(self): """Create a fresh model instance for each test.""" return OpenAIRealtimeWebSocketModel() @pytest.mark.asyncio async def test_interrupt_timing_with_custom_playback_tracker(self, model): """Test interrupt uses custom playback tracker elapsed time instead of default timing.""" # Create custom tracker and set elapsed time custom_tracker = RealtimePlaybackTracker() custom_tracker.set_audio_format("pcm16") custom_tracker.on_play_ms("item_1", 1, 500.0) # content_index 1, 500ms played # Set up model with custom tracker directly model._playback_tracker = custom_tracker # Mock send_raw_message to capture interrupt model._send_raw_message = AsyncMock() # Send interrupt await model._send_interrupt(RealtimeModelSendInterrupt()) # Should use custom tracker's 500ms elapsed time truncate_events = [ call.args[0] for call in model._send_raw_message.await_args_list if getattr(call.args[0], "type", None) == "conversation.item.truncate" ] assert truncate_events assert truncate_events[0].audio_end_ms == 500 @pytest.mark.asyncio async def test_interrupt_skipped_when_no_audio_playing(self, model): """Test interrupt returns early when no audio is currently playing.""" model._send_raw_message = AsyncMock() # No audio playing (default state) await model._send_interrupt(RealtimeModelSendInterrupt()) # Should not send any interrupt message model._send_raw_message.assert_not_called() @pytest.mark.asyncio async def test_interrupt_skips_when_elapsed_exceeds_audio_length(self, model): """Test interrupt skips truncation when playback appears complete.""" model._send_raw_message = AsyncMock() model._audio_state_tracker.set_audio_format("pcm16") # 48_000 bytes of PCM16 at 24kHz equals ~1000ms of audio. model._audio_state_tracker.on_audio_delta("item_1", 0, b"a" * 48_000) model._playback_tracker = RealtimePlaybackTracker() model._playback_tracker.on_play_ms("item_1", 0, 2000.0) await model._send_interrupt(RealtimeModelSendInterrupt()) truncate_events = [ call.args[0] for call in model._send_raw_message.await_args_list if getattr(call.args[0], "type", None) == "conversation.item.truncate" ] assert truncate_events == [] @pytest.mark.asyncio async def test_interrupt_sends_truncate_when_ongoing_response(self, model): """Test interrupt still truncates while response is ongoing.""" model._ongoing_response = True model._send_raw_message = AsyncMock() model._audio_state_tracker.set_audio_format("pcm16") # 48_000 bytes of PCM16 at 24kHz equals ~1000ms of audio. model._audio_state_tracker.on_audio_delta("item_1", 0, b"a" * 48_000) model._playback_tracker = RealtimePlaybackTracker() model._playback_tracker.on_play_ms("item_1", 0, 2000.0) await model._send_interrupt(RealtimeModelSendInterrupt()) truncate_events = [ call.args[0] for call in model._send_raw_message.await_args_list if getattr(call.args[0], "type", None) == "conversation.item.truncate" ] assert truncate_events assert truncate_events[0].audio_end_ms == 2000 def test_audio_delta_before_set_audio_format_does_not_raise(self): """ModelAudioTracker must tolerate audio deltas before a format is negotiated. For transcription-only sessions or session payloads that omit an audio format, ``set_audio_format`` is never called. Previously, the first ``on_audio_delta`` call raised ``AttributeError`` because ``self._format`` was unset. The length calculator already accepts ``None`` as the unknown-format fallback, so the tracker should pass that through. """ tracker = ModelAudioTracker() # Intentionally do NOT call set_audio_format here. tracker.on_audio_delta("item_1", 0, b"test") state = tracker.get_state("item_1", 0) assert state is not None # With no format, calculate_audio_length_ms falls back to PCM math. expected_length = (4 / (24_000 * 2)) * 1000 assert state.audio_length_ms == pytest.approx(expected_length, rel=0, abs=1e-6) assert tracker.get_last_audio_item() == ("item_1", 0) def test_audio_state_accumulation_across_deltas(self): """Test ModelAudioTracker accumulates audio length across multiple deltas.""" tracker = ModelAudioTracker() tracker.set_audio_format("pcm16") # Send multiple deltas for same item tracker.on_audio_delta("item_1", 0, b"test") # 4 bytes tracker.on_audio_delta("item_1", 0, b"more") # 4 bytes state = tracker.get_state("item_1", 0) assert state is not None # Should accumulate: 8 bytes -> 4 samples -> (4 / 24000) * 1000 ≈ 0.167ms expected_length = (8 / (24_000 * 2)) * 1000 assert state.audio_length_ms == pytest.approx(expected_length, rel=0, abs=1e-6) def test_default_playback_timing_uses_monotonic_clock(self, model): model._audio_state_tracker.set_audio_format("pcm16") with patch("agents.realtime._default_tracker.time.monotonic", return_value=42.0): model._audio_state_tracker.on_audio_delta("item_1", 0, b"test") with patch("agents.realtime.openai_realtime.time.monotonic", return_value=42.25): state = model._get_playback_state() assert state["current_item_id"] == "item_1" assert state["current_item_content_index"] == 0 assert state["elapsed_ms"] == pytest.approx(250.0) def test_state_cleanup_on_interruption(self): """Test both trackers properly reset state on interruption.""" # Test ModelAudioTracker cleanup model_tracker = ModelAudioTracker() model_tracker.set_audio_format("pcm16") model_tracker.on_audio_delta("item_1", 0, b"test") assert model_tracker.get_last_audio_item() == ("item_1", 0) model_tracker.on_interrupted() assert model_tracker.get_last_audio_item() is None # Test RealtimePlaybackTracker cleanup playback_tracker = RealtimePlaybackTracker() playback_tracker.on_play_ms("item_1", 0, 100.0) state = playback_tracker.get_state() assert state["current_item_id"] == "item_1" assert state["elapsed_ms"] == 100.0 playback_tracker.on_interrupted() state = playback_tracker.get_state() assert state["current_item_id"] is None assert state["elapsed_ms"] is None def test_audio_length_calculation_with_different_formats(self): """Test calculate_audio_length_ms handles g711 and PCM formats correctly.""" from agents.realtime._util import calculate_audio_length_ms # Test g711 format (8kHz) g711_bytes = b"12345678" # 8 bytes g711_length = calculate_audio_length_ms("g711_ulaw", g711_bytes) assert g711_length == 1 # (8 / 8000) * 1000 # Test PCM format (24kHz, default) pcm_bytes = b"test" # 4 bytes pcm_length = calculate_audio_length_ms("pcm16", pcm_bytes) expected_pcm = (len(pcm_bytes) / (24_000 * 2)) * 1000 assert pcm_length == pytest.approx(expected_pcm, rel=0, abs=1e-6) # Test None format (defaults to PCM) none_length = calculate_audio_length_ms(None, pcm_bytes) assert none_length == pytest.approx(expected_pcm, rel=0, abs=1e-6)