refactor: replace dict-based config with type-safe vendor classes

src/agoraio/__init__.py

@@ -12,21 +12,15 @@
     from .version import __version__
     from .wrapper import (
         Agent,
-        AgentOptions,
         AgentSession,
         AgentSessionOptions,
         generate_rtc_token,
         GenerateTokenOptions,
-        is_heygen_avatar,
-        is_akool_avatar,
-        validate_avatar_config,
-        validate_tts_sample_rate,
     )
     from .wrapper.agent_session import AsyncAgentSession
 _dynamic_imports: typing.Dict[str, str] = {
     "Agora": ".pool_client",
     "Agent": ".wrapper",
-    "AgentOptions": ".wrapper",
     "AgentSession": ".wrapper",
     "AgentSessionOptions": ".wrapper",
     "Area": ".core.domain",
@@ -39,12 +33,8 @@
     "core": ".core",
     "create_pool": ".core.domain",
     "generate_rtc_token": ".wrapper",
-    "is_akool_avatar": ".wrapper",
-    "is_heygen_avatar": ".wrapper",
     "phone_numbers": ".phone_numbers",
     "telephony": ".telephony",
-    "validate_avatar_config": ".wrapper",
-    "validate_tts_sample_rate": ".wrapper",
     "wrapper": ".wrapper",
 }
 
@@ -73,7 +63,6 @@ def __dir__():
 __all__ = [
     "Agora",
     "Agent",
-    "AgentOptions",
     "AgentSession",
     "AgentSessionOptions",
     "Area",
@@ -86,11 +75,7 @@ def __dir__():
     "core",
     "create_pool",
     "generate_rtc_token",
-    "is_akool_avatar",
-    "is_heygen_avatar",
     "phone_numbers",
     "telephony",
-    "validate_avatar_config",
-    "validate_tts_sample_rate",
     "wrapper",
 ]

src/agoraio/wrapper/__init__.py

@@ -1,22 +1,93 @@
-from .agent import Agent, AgentOptions
+from .agent import Agent
 from .agent_session import AgentSession, AgentSessionOptions
-from .avatar_types import (
-    is_akool_avatar,
-    is_heygen_avatar,
-    validate_avatar_config,
-    validate_tts_sample_rate,
-)
 from .token import GenerateTokenOptions, generate_rtc_token
+from .vendors import (
+    AkoolAvatar,
+    AmazonSTT,
+    AmazonTTS,
+    Anthropic,
+    AresSTT,
+    AssemblyAISTT,
+    AzureOpenAI,
+    BaseAvatar,
+    BaseLLM,
+    BaseMLLM,
+    BaseSTT,
+    BaseTTS,
+    CartesiaSampleRate,
+    CartesiaTTS,
+    DeepgramSTT,
+    ElevenLabsSampleRate,
+    ElevenLabsTTS,
+    FishAudioTTS,
+    Gemini,
+    GoogleSTT,
+    GoogleTTS,
+    GroqTTS,
+    HeyGenAvatar,
+    HumeAITTS,
+    MicrosoftSampleRate,
+    MicrosoftSTT,
+    MicrosoftTTS,
+    MiniMaxTTS,
+    OpenAI,
+    OpenAIRealtime,
+    OpenAISampleRate,
+    OpenAISTT,
+    OpenAITTS,
+    RimeTTS,
+    SampleRate,
+    SarvamSTT,
+    SarvamTTS,
+    SonioxSTT,
+    SpeechmaticsSTT,
+    VertexAI,
+)
 
 __all__ = [
     "Agent",
-    "AgentOptions",
     "AgentSession",
     "AgentSessionOptions",
     "generate_rtc_token",
     "GenerateTokenOptions",
-    "is_heygen_avatar",
-    "is_akool_avatar",
-    "validate_avatar_config",
-    "validate_tts_sample_rate",
+    "BaseLLM",
+    "BaseTTS",
+    "BaseSTT",
+    "BaseMLLM",
+    "BaseAvatar",
+    "SampleRate",
+    "ElevenLabsSampleRate",
+    "MicrosoftSampleRate",
+    "OpenAISampleRate",
+    "CartesiaSampleRate",
+    "OpenAI",
+    "AzureOpenAI",
+    "Anthropic",
+    "Gemini",
+    "ElevenLabsTTS",
+    "MicrosoftTTS",
+    "OpenAITTS",
+    "CartesiaTTS",
+    "GoogleTTS",
+    "AmazonTTS",
+    "HumeAITTS",
+    "RimeTTS",
+    "FishAudioTTS",
+    "GroqTTS",
+    "MiniMaxTTS",
+    "SarvamTTS",
+    "SpeechmaticsSTT",
+    "DeepgramSTT",
+    "MicrosoftSTT",
+    "OpenAISTT",
+    "GoogleSTT",
+    "AmazonSTT",
+    "AssemblyAISTT",
+    "AresSTT",
+    "SonioxSTT",
+    "SarvamSTT",
+    "OpenAIRealtime",
+    "VertexAI",
+    "HeyGenAvatar",
+    "AkoolAvatar",
 ]