Files
2026-07-13 12:39:17 +08:00

375 lines
12 KiB
Python

from __future__ import annotations
import asyncio
import numpy as np
import numpy.typing as npt
import pytest
from tests.testing_processor import fetch_events
try:
from agents.voice import (
AudioInput,
StreamedAudioResult,
TTSModelSettings,
VoicePipeline,
VoicePipelineConfig,
VoiceStreamEvent,
VoiceStreamEventAudio,
VoiceStreamEventLifecycle,
)
from .fake_models import FakeStreamedAudioInput, FakeSTT, FakeTTS, FakeWorkflow
from .helpers import extract_events
except ImportError:
pass
def test_streamed_audio_result_odd_length_buffer_int16() -> None:
result = StreamedAudioResult(
FakeTTS(),
TTSModelSettings(dtype=np.int16),
VoicePipelineConfig(),
)
transformed = result._transform_audio_buffer([b"\x01"], np.int16)
assert transformed.dtype == np.int16
assert transformed.tolist() == [1]
def test_streamed_audio_result_odd_length_buffer_float32() -> None:
result = StreamedAudioResult(
FakeTTS(),
TTSModelSettings(dtype=np.float32),
VoicePipelineConfig(),
)
transformed = result._transform_audio_buffer([b"\x01"], np.float32)
assert transformed.dtype == np.float32
assert transformed.shape == (1, 1)
assert transformed[0, 0] == pytest.approx(1 / 32767.0)
@pytest.mark.asyncio
async def test_streamed_audio_result_preserves_cross_chunk_sample_boundaries() -> None:
class SplitSampleTTS(FakeTTS):
async def run(self, text: str, settings: TTSModelSettings):
del text, settings
yield b"\x01"
yield b"\x00"
result = StreamedAudioResult(
SplitSampleTTS(),
TTSModelSettings(buffer_size=1, dtype=np.int16),
VoicePipelineConfig(),
)
local_queue: asyncio.Queue[VoiceStreamEvent | None] = asyncio.Queue()
await result._stream_audio("hello", local_queue, finish_turn=True)
audio_chunks: list[bytes] = []
while True:
event = await local_queue.get()
assert event is not None
if isinstance(event, VoiceStreamEventAudio) and event.data is not None:
audio_chunks.append(event.data.tobytes())
if isinstance(event, VoiceStreamEventLifecycle) and event.event == "turn_ended":
break
assert audio_chunks == [np.array([1], dtype=np.int16).tobytes()]
@pytest.mark.asyncio
async def test_streamed_audio_result_synthesizes_short_custom_splitter_chunk() -> None:
texts: list[str] = []
class RecordingTTS(FakeTTS):
async def run(self, text: str, settings: TTSModelSettings):
texts.append(text)
yield np.zeros(2, dtype=np.int16).tobytes()
def split_immediately(text: str) -> tuple[str, str]:
return text, ""
result = StreamedAudioResult(
RecordingTTS(),
TTSModelSettings(buffer_size=1, text_splitter=split_immediately),
VoicePipelineConfig(),
)
await result._add_text("ok")
await result._turn_done()
await result._done()
events, audio_chunks = await extract_events(result)
assert texts == ["ok"]
assert events == ["turn_started", "audio", "turn_ended", "session_ended"]
assert audio_chunks == [np.zeros(2, dtype=np.int16).tobytes()]
@pytest.mark.asyncio
async def test_streamed_audio_result_ignores_empty_custom_splitter_chunk() -> None:
texts: list[str] = []
class RecordingTTS(FakeTTS):
async def run(self, text: str, settings: TTSModelSettings):
texts.append(text)
yield np.zeros(2, dtype=np.int16).tobytes()
def discard_text(_text: str) -> tuple[str, str]:
return "", ""
result = StreamedAudioResult(
RecordingTTS(),
TTSModelSettings(buffer_size=1, text_splitter=discard_text),
VoicePipelineConfig(),
)
await result._add_text("ok")
await result._turn_done()
await result._done()
events, audio_chunks = await extract_events(result)
assert texts == []
assert events == ["turn_started", "turn_ended", "session_ended"]
assert audio_chunks == []
@pytest.mark.asyncio
async def test_voicepipeline_run_single_turn() -> None:
# Single turn. Should produce a single audio output, which is the TTS output for "out_1".
fake_stt = FakeSTT(["first"])
workflow = FakeWorkflow([["out_1"]])
fake_tts = FakeTTS()
config = VoicePipelineConfig(tts_settings=TTSModelSettings(buffer_size=1))
pipeline = VoicePipeline(
workflow=workflow, stt_model=fake_stt, tts_model=fake_tts, config=config
)
audio_input = AudioInput(buffer=np.zeros(2, dtype=np.int16))
result = await pipeline.run(audio_input)
events, audio_chunks = await extract_events(result)
assert events == [
"turn_started",
"audio",
"turn_ended",
"session_ended",
]
await fake_tts.verify_audio("out_1", audio_chunks[0])
@pytest.mark.asyncio
async def test_voicepipeline_streamed_audio_input() -> None:
# Multi turn. Should produce 2 audio outputs, which are the TTS outputs of "out_1" and "out_2"
fake_stt = FakeSTT(["first", "second"])
workflow = FakeWorkflow([["out_1"], ["out_2"]])
fake_tts = FakeTTS()
pipeline = VoicePipeline(workflow=workflow, stt_model=fake_stt, tts_model=fake_tts)
streamed_audio_input = await FakeStreamedAudioInput.get(count=2)
result = await pipeline.run(streamed_audio_input)
events, audio_chunks = await extract_events(result)
assert events == [
"turn_started",
"audio", # out_1
"turn_ended",
"turn_started",
"audio", # out_2
"turn_ended",
"session_ended",
]
assert len(audio_chunks) == 2
await fake_tts.verify_audio("out_1", audio_chunks[0])
await fake_tts.verify_audio("out_2", audio_chunks[1])
@pytest.mark.asyncio
async def test_voicepipeline_run_single_turn_split_words() -> None:
# Single turn. Should produce multiple audio outputs, which are the TTS outputs of "foo bar baz"
# split into words and then "foo2 bar2 baz2" split into words.
fake_stt = FakeSTT(["first"])
workflow = FakeWorkflow([["foo bar baz"]])
fake_tts = FakeTTS(strategy="split_words")
config = VoicePipelineConfig(tts_settings=TTSModelSettings(buffer_size=1))
pipeline = VoicePipeline(
workflow=workflow, stt_model=fake_stt, tts_model=fake_tts, config=config
)
audio_input = AudioInput(buffer=np.zeros(2, dtype=np.int16))
result = await pipeline.run(audio_input)
events, audio_chunks = await extract_events(result)
assert events == [
"turn_started",
"audio", # foo
"audio", # bar
"audio", # baz
"turn_ended",
"session_ended",
]
await fake_tts.verify_audio_chunks("foo bar baz", audio_chunks)
@pytest.mark.asyncio
async def test_voicepipeline_run_multi_turn_split_words() -> None:
# Multi turn. Should produce multiple audio outputs, which are the TTS outputs of "foo bar baz"
# split into words.
fake_stt = FakeSTT(["first", "second"])
workflow = FakeWorkflow([["foo bar baz"], ["foo2 bar2 baz2"]])
fake_tts = FakeTTS(strategy="split_words")
config = VoicePipelineConfig(tts_settings=TTSModelSettings(buffer_size=1))
pipeline = VoicePipeline(
workflow=workflow, stt_model=fake_stt, tts_model=fake_tts, config=config
)
streamed_audio_input = await FakeStreamedAudioInput.get(count=6)
result = await pipeline.run(streamed_audio_input)
events, audio_chunks = await extract_events(result)
assert events == [
"turn_started",
"audio", # foo
"audio", # bar
"audio", # baz
"turn_ended",
"turn_started",
"audio", # foo2
"audio", # bar2
"audio", # baz2
"turn_ended",
"session_ended",
]
assert len(audio_chunks) == 6
await fake_tts.verify_audio_chunks("foo bar baz", audio_chunks[:3])
await fake_tts.verify_audio_chunks("foo2 bar2 baz2", audio_chunks[3:])
@pytest.mark.asyncio
async def test_voicepipeline_float32() -> None:
# Single turn. Should produce a single audio output, which is the TTS output for "out_1".
fake_stt = FakeSTT(["first"])
workflow = FakeWorkflow([["out_1"]])
fake_tts = FakeTTS()
config = VoicePipelineConfig(tts_settings=TTSModelSettings(buffer_size=1, dtype=np.float32))
pipeline = VoicePipeline(
workflow=workflow, stt_model=fake_stt, tts_model=fake_tts, config=config
)
audio_input = AudioInput(buffer=np.zeros(2, dtype=np.int16))
result = await pipeline.run(audio_input)
events, audio_chunks = await extract_events(result)
assert events == [
"turn_started",
"audio",
"turn_ended",
"session_ended",
]
await fake_tts.verify_audio("out_1", audio_chunks[0], dtype=np.float32)
@pytest.mark.asyncio
async def test_voicepipeline_transform_data() -> None:
# Single turn. Should produce a single audio output, which is the TTS output for "out_1".
def _transform_data(
data_chunk: npt.NDArray[np.int16 | np.float32],
) -> npt.NDArray[np.int16]:
return data_chunk.astype(np.int16)
fake_stt = FakeSTT(["first"])
workflow = FakeWorkflow([["out_1"]])
fake_tts = FakeTTS()
config = VoicePipelineConfig(
tts_settings=TTSModelSettings(
buffer_size=1,
dtype=np.float32,
transform_data=_transform_data,
)
)
pipeline = VoicePipeline(
workflow=workflow, stt_model=fake_stt, tts_model=fake_tts, config=config
)
audio_input = AudioInput(buffer=np.zeros(2, dtype=np.int16))
result = await pipeline.run(audio_input)
events, audio_chunks = await extract_events(result)
assert events == [
"turn_started",
"audio",
"turn_ended",
"session_ended",
]
await fake_tts.verify_audio("out_1", audio_chunks[0], dtype=np.int16)
class _BlockingWorkflow(FakeWorkflow):
def __init__(self, gate: asyncio.Event):
super().__init__()
self._gate = gate
async def run(self, _: str):
await self._gate.wait()
yield "out_1"
class _OnStartYieldThenFailWorkflow(FakeWorkflow):
async def on_start(self):
yield "intro"
raise RuntimeError("boom")
@pytest.mark.asyncio
async def test_voicepipeline_trace_not_finished_before_single_turn_completes() -> None:
fake_stt = FakeSTT(["first"])
fake_tts = FakeTTS()
gate = asyncio.Event()
workflow = _BlockingWorkflow(gate)
config = VoicePipelineConfig(tts_settings=TTSModelSettings(buffer_size=1))
pipeline = VoicePipeline(
workflow=workflow, stt_model=fake_stt, tts_model=fake_tts, config=config
)
audio_input = AudioInput(buffer=np.zeros(2, dtype=np.int16))
result = await pipeline.run(audio_input)
await asyncio.sleep(0)
events_before_unblock = fetch_events()
assert "trace_start" in events_before_unblock
assert "trace_end" not in events_before_unblock
gate.set()
await extract_events(result)
assert fetch_events()[-1] == "trace_end"
@pytest.mark.asyncio
async def test_voicepipeline_trace_finishes_after_multi_turn_processing() -> None:
fake_stt = FakeSTT(["first", "second"])
workflow = FakeWorkflow([["out_1"], ["out_2"]])
fake_tts = FakeTTS()
pipeline = VoicePipeline(workflow=workflow, stt_model=fake_stt, tts_model=fake_tts)
streamed_audio_input = await FakeStreamedAudioInput.get(count=2)
result = await pipeline.run(streamed_audio_input)
await extract_events(result)
assert fetch_events()[-1] == "trace_end"
@pytest.mark.asyncio
async def test_voicepipeline_multi_turn_on_start_exception_does_not_abort() -> None:
fake_stt = FakeSTT(["first"])
workflow = _OnStartYieldThenFailWorkflow([["out_1"]])
fake_tts = FakeTTS()
pipeline = VoicePipeline(workflow=workflow, stt_model=fake_stt, tts_model=fake_tts)
streamed_audio_input = await FakeStreamedAudioInput.get(count=1)
result = await pipeline.run(streamed_audio_input)
events, _ = await extract_events(result)
assert events[-1] == "session_ended"
assert "error" not in events