from __future__ import annotations import json import tempfile import unittest from pathlib import Path from owner_voice_pet.config import AppConfig from owner_voice_pet.models import ( AudioFrame, AudioSegment, ErrorCode, Message, PipelineState, ProviderError, ) from owner_voice_pet.speech_models import ( DEFAULT_DENOISER_PATH, default_manifest, denoiser_model_path, stt_model_paths, ) class ModelsConfigTests(unittest.TestCase): def test_audio_frame_validates_core_fields(self) -> None: frame = AudioFrame( pcm=b"\x00\x00", sample_rate=16000, channels=1, timestamp_ms=10, frame_id=1, metadata={"wake": True}, ) self.assertEqual(frame.sample_rate, 16000) self.assertTrue(frame.metadata["wake"]) def test_audio_segment_duration(self) -> None: segment = AudioSegment( pcm=b"\x00\x00\x01\x00", sample_rate=16000, channels=1, start_time_ms=100, end_time_ms=450, ) self.assertEqual(segment.duration_ms, 350) def test_invalid_audio_frame_rejected(self) -> None: with self.assertRaises(ValueError): AudioFrame(b"", 0, 1, 0, 0) def test_provider_error_string_is_structured(self) -> None: error = ProviderError( ErrorCode.LLM_API_KEY_MISSING, "missing key", False, "openai-compatible", "llm", ) self.assertIn("LLM_API_KEY_MISSING", str(error)) self.assertIn("llm/openai-compatible", str(error)) def test_config_from_dotenv_uses_file_values(self) -> None: with tempfile.TemporaryDirectory() as tmp: path = f"{tmp}/.env" with open(path, "w", encoding="utf-8") as handle: handle.write( "\n".join( [ "OWNER_LLM_BASE_URL=https://token-plan-cn.xiaomimimo.com/v1/", "OWNER_LLM_API_KEY=secret-value", "OWNER_LLM_MODEL=test-model", ] ) ) config = AppConfig.from_dotenv(path) self.assertEqual(config.assistant_mode, "turn_based_voice_pet") self.assertEqual(config.llm_base_url, "https://token-plan-cn.xiaomimimo.com/v1") self.assertEqual(config.llm_api_key, "secret-value") self.assertEqual(config.llm_model, "test-model") self.assertTrue(config.realtime_transcript_enabled) self.assertEqual(config.realtime_transcript_idle_timeout_ms, 1500) self.assertEqual(config.wake_provider, "local_kws") self.assertEqual(config.wake_kws_threshold, 0.15) self.assertEqual(config.wake_kws_score, 1.0) self.assertEqual(config.wake_ack_text, "我在") self.assertEqual(config.post_playback_drain_ms, 0) self.assertEqual(config.pipeline_mode, "live_turn_based") self.assertEqual(config.endpoint_mode, "primary_speaker") self.assertTrue(config.noise_filter_enabled) self.assertEqual(config.noise_filter_provider, "sherpa_onnx_gtcrn") self.assertFalse(config.wake_denoise_enabled) self.assertEqual(config.speaker_profile_ms, 600) self.assertEqual(config.speaker_profile_min_ms, 120) self.assertEqual(config.speaker_absent_ms, 300) self.assertEqual(config.speaker_similarity_threshold, 0.70) self.assertEqual(config.speaker_min_rms, 0.012) self.assertEqual(config.vad_provider, "hybrid") self.assertEqual(config.vad_threshold, 0.5) self.assertEqual(config.vad_min_duration_ms, 250) self.assertEqual(config.vad_end_silence_ms, 350) self.assertEqual(config.vad_no_speech_timeout_ms, 5000) self.assertEqual(config.vad_max_recording_ms, 12000) self.assertEqual(config.speech_provider, "local") self.assertEqual(config.asr_model, "mimo-v2.5-asr") self.assertEqual(config.tts_model, "mimo-v2.5-tts") self.assertEqual(config.tts_voice, "mimo_default") self.assertEqual(str(config.speech_models_dir), "models") self.assertEqual(config.context_mode, "session_memory") self.assertTrue(config.continuous_dialog_enabled) self.assertEqual(config.continuation_decision_provider, "hybrid") self.assertEqual(config.continuation_confidence_threshold, 0.65) self.assertEqual(config.followup_listen_timeout_ms, 3000) self.assertTrue(config.barge_in_enabled) self.assertEqual(config.barge_in_min_speech_ms, 250) self.assertEqual(config.barge_in_echo_guard_ms, 500) self.assertTrue(config.barge_in_speaker_gate_enabled) self.assertEqual(config.barge_in_user_similarity_threshold, 0.62) self.assertEqual(config.barge_in_assistant_reject_threshold, 0.72) self.assertEqual(config.barge_in_listen_interval_ms, 20) self.assertEqual(config.barge_in_chunk_ms, 30) self.assertTrue(config.end_chime_enabled) self.assertEqual(str(config.end_chime_file), "assets/sounds/codex-notification.wav") self.assertEqual(config.end_chime_frequency_hz, 880) self.assertEqual(config.end_chime_duration_ms, 140) self.assertEqual(config.audio_apm_provider, "webrtc") self.assertTrue(config.audio_aec_enabled) self.assertTrue(config.audio_ns_enabled) self.assertTrue(config.audio_agc_enabled) self.assertTrue(config.audio_apm_required) self.assertEqual(config.audio_frame_ms, 20) self.assertEqual(config.audio_ring_buffer_ms, 3000) self.assertTrue(config.interrupt_enabled) self.assertEqual(config.interrupt_target_latency_ms, 200) self.assertEqual(config.streaming_stt_provider, "faster_whisper") self.assertEqual(config.streaming_stt_product_candidate, "sensevoice") self.assertEqual(config.streaming_tts_provider, "cosyvoice") self.assertFalse(config.memory_enabled) self.assertEqual(config.memory_provider, "faiss_sqlite") self.assertEqual(config.memory_top_k, 5) self.assertFalse(config.memory_auto_save_sensitive) self.assertFalse(config.tool_router_enabled) self.assertEqual(config.tool_max_calls_per_turn, 5) self.assertEqual(config.tool_timeout_ms, 30000) self.assertFalse(config.openinterpreter_enabled) self.assertEqual(config.openinterpreter_command, "openinterpreter") self.assertFalse(config.browser_playwright_enabled) self.assertFalse(config.computer_control_enabled) self.assertTrue(config.llm_stream) self.assertEqual(config.validate_basic(), []) def test_full_duplex_agent_config_values_are_read_from_dotenv(self) -> None: with tempfile.TemporaryDirectory() as tmp: path = f"{tmp}/.env" with open(path, "w", encoding="utf-8") as handle: handle.write( "\n".join( [ "OWNER_ASSISTANT_MODE=full_duplex_agent", "OWNER_AUDIO_APM_PROVIDER=fake", "OWNER_AUDIO_AEC_ENABLED=0", "OWNER_AUDIO_NS_ENABLED=0", "OWNER_AUDIO_AGC_ENABLED=0", "OWNER_AUDIO_APM_REQUIRED=0", "OWNER_AUDIO_FRAME_MS=10", "OWNER_AUDIO_RING_BUFFER_MS=1200", "OWNER_INTERRUPT_ENABLED=0", "OWNER_INTERRUPT_TARGET_LATENCY_MS=180", "OWNER_LLM_STREAMING_ENABLED=0", "OWNER_STREAMING_STT_PROVIDER=sherpa_onnx", "OWNER_STREAMING_STT_PRODUCT_CANDIDATE=faster_whisper", "OWNER_STREAMING_TTS_PROVIDER=macos_say", "OWNER_MEMORY_ENABLED=1", "OWNER_MEMORY_PROVIDER=faiss_sqlite", "OWNER_MEMORY_TOP_K=3", "OWNER_MEMORY_AUTO_SAVE_SENSITIVE=1", "OWNER_TOOL_ROUTER_ENABLED=1", "OWNER_TOOL_MAX_CALLS_PER_TURN=2", "OWNER_TOOL_TIMEOUT_MS=1000", "OWNER_OPENINTERPRETER_ENABLED=1", "OWNER_OPENINTERPRETER_COMMAND=/tmp/openinterpreter", "OWNER_BROWSER_PLAYWRIGHT_ENABLED=1", "OWNER_COMPUTER_CONTROL_ENABLED=1", ] ) ) config = AppConfig.from_dotenv(path) self.assertEqual(config.assistant_mode, "full_duplex_agent") self.assertEqual(config.audio_apm_provider, "fake") self.assertFalse(config.audio_aec_enabled) self.assertFalse(config.audio_ns_enabled) self.assertFalse(config.audio_agc_enabled) self.assertFalse(config.audio_apm_required) self.assertEqual(config.audio_frame_ms, 10) self.assertEqual(config.audio_ring_buffer_ms, 1200) self.assertFalse(config.interrupt_enabled) self.assertEqual(config.interrupt_target_latency_ms, 180) self.assertFalse(config.llm_stream) self.assertEqual(config.streaming_stt_provider, "sherpa_onnx") self.assertEqual(config.streaming_stt_product_candidate, "faster_whisper") self.assertEqual(config.streaming_tts_provider, "macos_say") self.assertTrue(config.memory_enabled) self.assertEqual(config.memory_provider, "faiss_sqlite") self.assertEqual(config.memory_top_k, 3) self.assertTrue(config.memory_auto_save_sensitive) self.assertTrue(config.tool_router_enabled) self.assertEqual(config.tool_max_calls_per_turn, 2) self.assertEqual(config.tool_timeout_ms, 1000) self.assertTrue(config.openinterpreter_enabled) self.assertEqual(config.openinterpreter_command, "/tmp/openinterpreter") self.assertTrue(config.browser_playwright_enabled) self.assertTrue(config.computer_control_enabled) self.assertEqual(config.validate_basic(), []) def test_llm_streaming_enabled_takes_precedence_over_legacy_llm_stream(self) -> None: with tempfile.TemporaryDirectory() as tmp: path = f"{tmp}/.env" with open(path, "w", encoding="utf-8") as handle: handle.write("OWNER_LLM_STREAM=0\nOWNER_LLM_STREAMING_ENABLED=1\n") config = AppConfig.from_dotenv(path) self.assertTrue(config.llm_stream) def test_legacy_llm_stream_still_disables_streaming(self) -> None: with tempfile.TemporaryDirectory() as tmp: path = f"{tmp}/.env" with open(path, "w", encoding="utf-8") as handle: handle.write("OWNER_LLM_STREAM=0\n") config = AppConfig.from_dotenv(path) self.assertFalse(config.llm_stream) def test_speech_provider_must_be_cloud_or_local(self) -> None: config = AppConfig(speech_provider="invalid") errors = config.validate_basic() self.assertTrue(any("OWNER_SPEECH_PROVIDER" in error.message for error in errors)) def test_full_duplex_agent_config_is_validated(self) -> None: config = AppConfig( assistant_mode="invalid", audio_apm_provider="invalid", audio_frame_ms=0, audio_ring_buffer_ms=0, interrupt_target_latency_ms=0, streaming_stt_provider="invalid", streaming_stt_product_candidate="invalid", streaming_tts_provider="invalid", memory_provider="invalid", memory_top_k=0, tool_max_calls_per_turn=0, tool_timeout_ms=0, openinterpreter_enabled=True, openinterpreter_command="", ) errors = config.validate_basic() self.assertTrue(any("OWNER_ASSISTANT_MODE" in error.message for error in errors)) self.assertTrue(any("OWNER_AUDIO_APM_PROVIDER" in error.message for error in errors)) self.assertTrue(any("OWNER_AUDIO_FRAME_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_AUDIO_RING_BUFFER_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_INTERRUPT_TARGET_LATENCY_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_STREAMING_STT_PROVIDER" in error.message for error in errors)) self.assertTrue(any("OWNER_STREAMING_STT_PRODUCT_CANDIDATE" in error.message for error in errors)) self.assertTrue(any("OWNER_STREAMING_TTS_PROVIDER" in error.message for error in errors)) self.assertTrue(any("OWNER_MEMORY_PROVIDER" in error.message for error in errors)) self.assertTrue(any("OWNER_MEMORY_TOP_K" in error.message for error in errors)) self.assertTrue(any("OWNER_TOOL_MAX_CALLS_PER_TURN" in error.message for error in errors)) self.assertTrue(any("OWNER_TOOL_TIMEOUT_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_OPENINTERPRETER_COMMAND" in error.message for error in errors)) def test_realtime_transcript_idle_timeout_must_be_non_negative(self) -> None: config = AppConfig(realtime_transcript_idle_timeout_ms=-1) errors = config.validate_basic() self.assertTrue(any("OWNER_REALTIME_TRANSCRIPT_IDLE_TIMEOUT_MS" in error.message for error in errors)) def test_wake_provider_must_be_local_kws(self) -> None: config = AppConfig(wake_provider="cloud_asr") errors = config.validate_basic() self.assertTrue(any("OWNER_WAKE_PROVIDER" in error.message for error in errors)) def test_vad_provider_must_be_hybrid_local_or_energy(self) -> None: config = AppConfig(vad_provider="invalid") errors = config.validate_basic() self.assertTrue(any("OWNER_VAD_PROVIDER" in error.message for error in errors)) def test_endpoint_provider_must_be_primary_speaker_or_vad(self) -> None: config = AppConfig(endpoint_mode="invalid") errors = config.validate_basic() self.assertTrue(any("OWNER_ENDPOINT_MODE" in error.message for error in errors)) def test_noise_filter_provider_must_be_gtcrn(self) -> None: config = AppConfig(noise_filter_provider="invalid") errors = config.validate_basic() self.assertTrue(any("OWNER_NOISE_FILTER_PROVIDER" in error.message for error in errors)) def test_continuation_config_is_validated(self) -> None: config = AppConfig( continuation_decision_provider="invalid", continuation_confidence_threshold=2.0, followup_listen_timeout_ms=-1, barge_in_min_speech_ms=-1, barge_in_echo_guard_ms=-1, barge_in_user_similarity_threshold=1.5, barge_in_assistant_reject_threshold=0.0, barge_in_listen_interval_ms=0, barge_in_chunk_ms=0, end_chime_frequency_hz=0, end_chime_duration_ms=0, ) errors = config.validate_basic() self.assertTrue(any("OWNER_CONTINUATION_DECISION_PROVIDER" in error.message for error in errors)) self.assertTrue(any("OWNER_CONTINUATION_CONFIDENCE_THRESHOLD" in error.message for error in errors)) self.assertTrue(any("OWNER_FOLLOWUP_LISTEN_TIMEOUT_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_BARGE_IN_MIN_SPEECH_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_BARGE_IN_ECHO_GUARD_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_BARGE_IN_USER_SIMILARITY_THRESHOLD" in error.message for error in errors)) self.assertTrue(any("OWNER_BARGE_IN_ASSISTANT_REJECT_THRESHOLD" in error.message for error in errors)) self.assertTrue(any("OWNER_BARGE_IN_LISTEN_INTERVAL_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_BARGE_IN_CHUNK_MS" in error.message for error in errors)) self.assertTrue(any("OWNER_END_CHIME_FREQUENCY_HZ" in error.message for error in errors)) self.assertTrue(any("OWNER_END_CHIME_DURATION_MS" in error.message for error in errors)) def test_speaker_similarity_threshold_range_is_validated(self) -> None: config = AppConfig(speaker_similarity_threshold=1.5) errors = config.validate_basic() self.assertTrue(any("OWNER_SPEAKER_SIMILARITY_THRESHOLD" in error.message for error in errors)) def test_missing_dotenv_uses_non_secret_defaults(self) -> None: config = AppConfig.from_dotenv("/tmp/owner-voice-pet-missing.env") self.assertEqual(config.llm_base_url, "https://token-plan-cn.xiaomimimo.com/v1") self.assertIsNone(config.llm_api_key) def test_api_url_accepts_base_with_or_without_v1(self) -> None: with_v1 = AppConfig(llm_base_url="https://token-plan-cn.xiaomimimo.com/v1") without_v1 = AppConfig(llm_base_url="https://newapi.mkbk.shop") self.assertEqual( with_v1.api_url("/v1/chat/completions"), "https://token-plan-cn.xiaomimimo.com/v1/chat/completions", ) self.assertEqual( without_v1.api_url("/v1/chat/completions"), "https://newapi.mkbk.shop/v1/chat/completions", ) def test_missing_llm_key_has_structured_error(self) -> None: config = AppConfig(llm_api_key=None) with self.assertRaises(ProviderError) as raised: config.require_llm_credentials() self.assertEqual(raised.exception.code, ErrorCode.LLM_API_KEY_MISSING) def test_pipeline_states_include_required_names(self) -> None: self.assertEqual(PipelineState.LISTENING.value, "listening") self.assertEqual(PipelineState.WAKE_LISTENING.value, "wake_listening") self.assertEqual(PipelineState.TOOL_RUNNING.value, "tool_running") self.assertEqual(PipelineState.RECOVERING.value, "recovering") self.assertEqual(PipelineState.ERROR_RECOVERING.value, "error_recovering") def test_message_model_accepts_roles(self) -> None: message = Message(role="user", content="你好", created_at=1.0) self.assertEqual(message.role, "user") def test_default_manifest_uses_ctc_stt_and_denoiser(self) -> None: manifest = default_manifest() stt = manifest["providers"]["stt"] denoiser = manifest["providers"]["denoiser"] self.assertEqual(stt["type"], "sherpa-onnx-streaming-zipformer2-ctc") self.assertTrue(stt["model"].endswith("model.int8.onnx")) self.assertEqual(denoiser["path"], DEFAULT_DENOISER_PATH) self.assertIn(DEFAULT_DENOISER_PATH, manifest["required_files"]) def test_model_path_helpers_support_ctc_manifest_and_denoiser(self) -> None: with tempfile.TemporaryDirectory() as tmp: root = Path(tmp) manifest_path = root / "manifest.json" manifest_path.write_text( json.dumps(default_manifest(), ensure_ascii=False), encoding="utf-8", ) paths = stt_model_paths(root) self.assertEqual(paths["type"], "sherpa-onnx-streaming-zipformer2-ctc") self.assertTrue(str(paths["model"]).endswith("model.int8.onnx")) self.assertTrue(str(denoiser_model_path(root)).endswith(DEFAULT_DENOISER_PATH)) if __name__ == "__main__": unittest.main()