Merge branch 'fern-bot/2026-06-04_20-31-12_964': add new vendors and fields, fix fern-replay artifacts

  - Add InteractionLanguage field to Deepgram, Speechmatics, and Sarvam STT options
  - Add XaiGrok MLLM vendor, GenericAvatar, AnamAvatar vendors
  - Add with_audio_scenario() builder method to Agent
  - Fix VertexAI MLLM: move project_id, location, adc_credentials_string into params (not top-level)
  - Fix agent_session LLM merge to use key-existence checks (Issue 9 parity with agent.py)
  - Remove duplicate imports, method declarations, and dead XaiRealtime test reference
  - Remove unused StartAgentsRequestPropertiesLlmGreetingConfigs import (type never generated)
  - Update tests for new OpenAISTT required-field validation, correct vendor-wins precedence behavior

Author: digitallysavvy

.fern/replay.lock

@@ -336,6 +336,7 @@ Use `turn_detection.language` for Agora interaction language; it defaults to `en
 | `api_key` | `str` | BYOK only | `None` | Deepgram API key. Optional only for Agora-managed `nova-2` and `nova-3`. |
 | `model` | `str` | No | `None` | Model (e.g., `nova-2`) |
 | `language` | `str` | No | `None` | Language code (e.g., `en-US`) |
+| `interaction_language` | `str` | No | `None` | Agora `asr.language` override |
 | `smart_format` | `bool` | No | `None` | Enable smart formatting |
 | `punctuation` | `bool` | No | `None` | Enable punctuation |
 | `additional_params` | `Dict[str, Any]` | No | `None` | Additional parameters |

docs/reference/vendors.md

@@ -24,6 +24,7 @@
     is_generic_avatar,
     is_heygen_avatar,
     is_live_avatar_avatar,
+    is_rtc_avatar,
     validate_avatar_config,
     validate_tts_sample_rate,
 )
@@ -333,15 +334,15 @@ def _build_start_properties(
             properties["tts"] = self._dump_model(self._agent.tts)
         if self._agent.llm is not None:
             llm = dict(self._agent.llm)
-            if self._agent.instructions is not None:
+            if self._agent.instructions is not None and "system_messages" not in llm:
                 llm["system_messages"] = [{"role": "system", "content": self._agent.instructions}]
-            if self._agent.greeting is not None:
+            if self._agent.greeting is not None and "greeting_message" not in llm:
                 llm["greeting_message"] = self._agent.greeting
-            if self._agent.greeting_configs is not None:
+            if self._agent.greeting_configs is not None and "greeting_configs" not in llm:
                 llm["greeting_configs"] = self._dump_model(self._agent.greeting_configs)
-            if self._agent.failure_message is not None:
+            if self._agent.failure_message is not None and "failure_message" not in llm:
                 llm["failure_message"] = self._agent.failure_message
-            if self._agent.max_history is not None:
+            if self._agent.max_history is not None and "max_history" not in llm:
                 llm["max_history"] = self._agent.max_history
             properties["llm"] = llm
         if self._agent.stt is not None:

src/agora_agent/agentkit/agent_session.py

@@ -206,3 +206,4 @@ def to_config(self) -> Dict[str, Any]:
 
         enable = self.options.enable if self.options.enable is not None else True
         return {"enable": enable, "vendor": "anam", "params": params}
+

src/agora_agent/agentkit/vendors/avatar.py

@@ -1,4 +1,4 @@
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, Union
 
 from pydantic import BaseModel, ConfigDict, Field, model_validator
 

src/agora_agent/agentkit/vendors/llm.py

@@ -1,3 +1,4 @@
+import warnings
 from typing import Any, Dict, List, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
@@ -178,11 +179,12 @@ def to_config(self) -> Dict[str, Any]:
         if self.options.http_options is not None:
             params["http_options"] = self.options.http_options
 
+        params["project_id"] = self.options.project_id
+        params["location"] = self.options.location
+        params["adc_credentials_string"] = self.options.adc_credentials_string
+
         config: Dict[str, Any] = {
             "vendor": "vertexai",
-            "project_id": self.options.project_id,
-            "location": self.options.location,
-            "adc_credentials_string": self.options.adc_credentials_string,
             "params": params,
         }
 

src/agora_agent/agentkit/vendors/mllm.py

@@ -4,6 +4,9 @@
 
 from .base import BaseSTT
 
+# BCP-47 language tag for asr.language (the Agora interaction language).
+InteractionLanguage = str
+
 _DEEPGRAM_MANAGED_MODELS = {"nova-2", "nova-3"}
 
 
@@ -12,6 +15,7 @@ class SpeechmaticsSTTOptions(BaseModel):
 
     api_key: str = Field(..., description="Speechmatics API key")
     language: str = Field(..., description="Language code (e.g., en, es, fr)")
+    interaction_language: Optional[InteractionLanguage] = Field(default=None, description="Agora interaction language for asr.language")
     model: Optional[str] = Field(default=None, description="Model name")
     uri: Optional[str] = Field(default=None, description="Speechmatics streaming WebSocket URL")
     additional_params: Optional[Dict[str, Any]] = Field(default=None)
@@ -45,6 +49,7 @@ class DeepgramSTTOptions(BaseModel):
     model: Optional[str] = Field(default=None, description="Model (e.g., nova-2, enhanced, base)")
     language: Optional[str] = Field(default=None, description="Language code (e.g., en-US)")
     keyterm: Optional[str] = Field(default=None, description="Boost specialized terms and brands for Deepgram")
+    interaction_language: Optional[InteractionLanguage] = Field(default=None, description="Agora interaction language for asr.language")
     smart_format: Optional[bool] = Field(default=None, description="Enable smart formatting")
     punctuation: Optional[bool] = Field(default=None, description="Enable punctuation")
     additional_params: Optional[Dict[str, Any]] = Field(default=None)
@@ -262,6 +267,7 @@ class SarvamSTTOptions(BaseModel):
 
     api_key: str = Field(..., description="Sarvam API key")
     language: str = Field(..., description="Language code (e.g., en, hi, ta)")
+    interaction_language: Optional[InteractionLanguage] = Field(default=None, description="Agora interaction language for asr.language")
     model: Optional[str] = Field(default=None, description="Model name")
     additional_params: Optional[Dict[str, Any]] = Field(default=None)
 

src/agora_agent/agentkit/vendors/stt.py

@@ -26,10 +26,10 @@ def __init__(
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "agora-agents/v2.1.1",
+            "User-Agent": "agora-agents/v2.1.2",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "agora-agents",
-            "X-Fern-SDK-Version": "v2.1.1",
+            "X-Fern-SDK-Version": "v2.1.2",
             **(self.get_custom_headers() or {}),
         }
         headers["Authorization"] = httpx.BasicAuth(self._get_username(), self._get_password())._auth_header

src/agora_agent/core/client_wrapper.py

@@ -54,7 +54,6 @@ class Asr_Deepgram(UncheckedBaseModel):
     vendor: typing.Literal["deepgram"] = "deepgram"
     language: typing.Optional[AsrLanguage] = None
     params: DeepgramAsrParams
-    keyterm: typing.Optional[str] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/agora_agent/types/asr.py

@@ -16,10 +16,6 @@ class DeepgramAsr(UncheckedBaseModel):
 
     language: typing.Optional[AsrLanguage] = None
     params: DeepgramAsrParams
-    keyterm: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    Boost specialized terms and brands for preset-backed Deepgram usage.
-    """
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2