feat: catalog-driven audio.cpp server.json creation

1 files changed, 44 insertions, 5 deletions

diff --git a/tests/test_tts.py b/tests/test_tts.py
index a0828de..33834d2 100644
--- a/tests/test_tts.py
+++ b/tests/test_tts.py
@@ -508,10 +508,11 @@ class AudioCppTTSClientHealthTests(unittest.TestCase):
             raise AssertionError(f"unexpected URL: {url}")
         return _dispatch
 
-    def _client(self, voice=None, language=None, **kwargs):
+    def _client(self, voice=None, language=None, model_id=None, **kwargs):
         with patch("converter.tts.urllib.request.urlopen",
                    side_effect=self._get_responses(**kwargs)):
-            return AudioCppTTSClient(voice=voice, language=language)
+            return AudioCppTTSClient(voice=voice, language=language,
+                                     model_id=model_id)
 
     def test_unreachable_server_raises_with_readme_pointer(self):
         import urllib.error
@@ -600,6 +601,35 @@ class AudioCppTTSClientHealthTests(unittest.TestCase):
         self.assertEqual(client.model_id, "qwen3-tts")
         self.assertTrue(any("qwen3-tts-clone" in line for line in logs.output))
 
+    def test_empty_model_id_auto_picks_single_server_entry(self):
+        # A multi-model server used without editing config.py: an empty
+        # --model resolves to the only hosted entry automatically.
+        client = self._client(
+            voice="narrator", model_id="",
+            models={"data": [{"id": "higgs", "family": "higgs_audio_tts"}]},
+            voices={"voices": ["narrator"]})
+        self.assertEqual(client.model_id, "higgs")
+
+    def test_empty_model_id_with_multiple_entries_requires_explicit_choice(self):
+        with self.assertRaises(RuntimeError) as ctx:
+            self._client(
+                voice="narrator", model_id="",
+                models={"data": [{"id": "higgs"}, {"id": "voxcpm2"}]},
+                voices={"voices": ["narrator"]})
+        message = str(ctx.exception)
+        self.assertIn("--model", message)
+        self.assertIn("higgs", message)
+        self.assertIn("voxcpm2", message)
+
+    def test_model_id_override_reaches_request(self):
+        # --model overrides AUDIOCPP_MODEL_ID for the run.
+        with patch.object(config, "AUDIOCPP_MODEL_ID", "qwen"):
+            client = self._client(
+                voice="narrator", model_id="higgs",
+                models={"data": [{"id": "higgs", "family": "higgs_audio_tts"}]},
+                voices={"voices": ["narrator"]})
+        self.assertEqual(client.model_id, "higgs")
+
     def test_clone_model_id_ignored_for_speaker_mode(self):
         with patch.object(config, "AUDIOCPP_MODEL_ID", "qwen3-tts"), \
                 patch.object(config, "AUDIOCPP_CLONE_MODEL_ID", "qwen3-tts-clone"):
@@ -1101,7 +1131,7 @@ class BackendWiringTests(unittest.TestCase):
                                backend=tts.BACKEND_AUDIOCPP, voice="narrator",
                                language="ja")
         mock_audiocpp.assert_called_once_with(voice="narrator", language="Japanese",
-                                              chunk_text=False)
+                                              chunk_text=False, model_id=None)
         mock_faster.assert_not_called()
         mock_qwen.assert_not_called()
 
@@ -1110,7 +1140,7 @@ class BackendWiringTests(unittest.TestCase):
             AudiobookConverter(voice_mode=tts.VOICE_MODE_CUSTOM,
                                backend=tts.BACKEND_AUDIOCPP)
         mock_audiocpp.assert_called_once_with(voice=None, language=config.LANGUAGE,
-                                              chunk_text=False)
+                                              chunk_text=False, model_id=None)
 
     def test_audiocpp_backend_chunk_flag_forces_client_chunking(self):
         with patch("converter.converter.AudioCppTTSClient") as mock_audiocpp:
@@ -1119,9 +1149,18 @@ class BackendWiringTests(unittest.TestCase):
                                            voice="narrator", chunk=True)
         mock_audiocpp.assert_called_once_with(voice="narrator",
                                               language=config.LANGUAGE,
-                                              chunk_text=True)
+                                              chunk_text=True, model_id=None)
         self.assertTrue(converter.client_chunks)
 
+    def test_audiocpp_backend_model_id_is_wired_through(self):
+        with patch("converter.converter.AudioCppTTSClient") as mock_audiocpp:
+            AudiobookConverter(voice_mode=tts.VOICE_MODE_CLONE,
+                               backend=tts.BACKEND_AUDIOCPP, voice="narrator",
+                               model_id="higgs")
+        mock_audiocpp.assert_called_once_with(
+            voice="narrator", language=config.LANGUAGE,
+            chunk_text=False, model_id="higgs")
+
     def test_gradio_backend_uses_qwen_client(self):
         with patch("converter.converter.FasterTTSClient") as mock_faster, \
                 patch("converter.converter.QwenTTSClient") as mock_qwen, \