Make clearer the distinction between "storage-mode" and "delta-mode" usage of *Settings objects

- Storage mode: for use in `self._settings`. All fields should be specified, i.e. should not be `NOT_GIVEN`.
- Delta mode: for use in `*UpdateSettingsFrame`.

In service of this, this commit:
- Adds a runtime check that all fields are specified in storage mode
- Updates all services to specify all fields in stored settings
- Updates all services to no longer check for `is_given` in stored settings (not necessary anymore)
- Updates relevant docstrings
- Renames `update` to `delta` in `*UpdateSettingsFrame`
- Updates community integrations guide

COMMUNITY_INTEGRATIONS.md

@@ -260,9 +260,11 @@ class MySTTService(STTService):
 
     _settings: MySTTSettings
 
-    def __init__(self, *, model: str, region: str, **kwargs):
+    def __init__(self, *, model: str, language: str, region: str, **kwargs):
         super().__init__(**kwargs)
-        self._settings = MySTTSettings(model=model, region=region)
+        # Initial value must be provided for every field in self._settings
+        # before service is started
+        self._settings = MySTTSettings(model=model, language=language, region=region)
         self._sync_model_name_to_metrics()
 ```
 
@@ -298,7 +300,7 @@ async def _update_settings(self, update: STTSettings) -> dict[str, Any]:
     if "language" in changed:
         await self._update_language()
     else:
-        # TODO: handle changes to other settings soon!
+        # TODO: this should be temporary - handle changes to other settings soon!
         self._warn_unhandled_updated_settings(changed.keys() - {"language"})
 
     return changed

changelog/3714.added.md

@@ -12,7 +12,7 @@
 
   ```python
   await task.queue_frame(
-      STTUpdateSettingsFrame(update=DeepgramSTTSettings(language=Language.ES))
+      STTUpdateSettingsFrame(delta=DeepgramSTTSettings(language=Language.ES))
   )
   ```
 

changelog/3714.deprecated.2.md

@@ -1 +1 @@
-- Dict-based `*UpdateSettingsFrame(settings={...})` is deprecated in favor of passing typed settings delta objects with `*UpdateSettingsFrame(update={...})`.
+- Dict-based `*UpdateSettingsFrame(settings={...})` is deprecated in favor of passing typed settings delta objects with `*UpdateSettingsFrame(delta={...})`.

examples/foundational/55a-update-settings-deepgram-flux-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Deepgram Flux STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=DeepgramFluxSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=DeepgramFluxSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55a-update-settings-deepgram-sagemaker-stt.py

@@ -109,7 +109,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Deepgram SageMaker STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=DeepgramSageMakerSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=DeepgramSageMakerSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55a-update-settings-deepgram-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Deepgram STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=DeepgramSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=DeepgramSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55b-update-settings-azure-stt.py

@@ -105,9 +105,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Azure STT settings: language=es")
-        await task.queue_frame(
+        await task.queue_frame(STTUpdateSettingsFrame(delta=AzureSTTSettings(language=Language.ES)))
-            STTUpdateSettingsFrame(update=AzureSTTSettings(language=Language.ES))
-        )
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55c-update-settings-google-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Google STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=GoogleSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=GoogleSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55d-update-settings-assemblyai-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating AssemblyAI STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=AssemblyAISTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=AssemblyAISTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55e-update-settings-gladia-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Gladia STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=GladiaSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=GladiaSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55f-update-settings-elevenlabs-realtime-stt.py

@@ -106,7 +106,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating ElevenLabs Realtime STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=ElevenLabsRealtimeSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=ElevenLabsRealtimeSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55g-update-settings-elevenlabs-stt.py

@@ -108,7 +108,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info("Updating ElevenLabs STT settings: language=es")
             await task.queue_frame(
-                STTUpdateSettingsFrame(update=ElevenLabsSTTSettings(language=Language.ES))
+                STTUpdateSettingsFrame(delta=ElevenLabsSTTSettings(language=Language.ES))
             )
 
         @transport.event_handler("on_client_disconnected")

examples/foundational/55h-update-settings-speechmatics-stt.py

@@ -110,13 +110,13 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Speechmatics STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=SpeechmaticsSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=SpeechmaticsSTTSettings(language=Language.ES))
         )
 
         await asyncio.sleep(10)
         logger.info("Updating Speechmatics STT settings: focus_speakers=['S1']")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=SpeechmaticsSTTSettings(focus_speakers=["S1"]))
+            STTUpdateSettingsFrame(delta=SpeechmaticsSTTSettings(focus_speakers=["S1"]))
         )
 
         await asyncio.sleep(10)
@@ -125,7 +125,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         )
         await task.queue_frame(
             STTUpdateSettingsFrame(
-                update=SpeechmaticsSTTSettings(
+                delta=SpeechmaticsSTTSettings(
                     speaker_active_format="<SPEAKER_{speaker_id}>{text}</SPEAKER_{speaker_id}>"
                 )
             )

examples/foundational/55i-update-settings-whisper-api-stt.py

@@ -108,7 +108,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info('Updating OpenAI STT settings: language="es"')
-        await task.queue_frame(STTUpdateSettingsFrame(update=BaseWhisperSTTSettings(language="es")))
+        await task.queue_frame(STTUpdateSettingsFrame(delta=BaseWhisperSTTSettings(language="es")))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55j-update-settings-sarvam-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Sarvam STT settings: language=en-IN")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=SarvamSTTSettings(language=Language.EN_IN))
+            STTUpdateSettingsFrame(delta=SarvamSTTSettings(language=Language.EN_IN))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55k-update-settings-soniox-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Soniox STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=SonioxSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=SonioxSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55l-update-settings-aws-transcribe-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating AWS Transcribe STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=AWSTranscribeSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=AWSTranscribeSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55m-update-settings-cartesia-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Cartesia STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=CartesiaSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=CartesiaSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55n-update-settings-cartesia-http-tts.py

@@ -107,7 +107,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating Cartesia HTTP TTS settings: speed increased to 1.5")
         await task.queue_frame(
             TTSUpdateSettingsFrame(
-                update=CartesiaTTSSettings(generation_config=GenerationConfig(speed=1.5))
+                delta=CartesiaTTSSettings(generation_config=GenerationConfig(speed=1.5))
             )
         )
 

examples/foundational/55n-update-settings-cartesia-tts.py

@@ -106,7 +106,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating Cartesia TTS settings: speed increased to 1.5")
         await task.queue_frame(
             TTSUpdateSettingsFrame(
-                update=CartesiaTTSSettings(generation_config=GenerationConfig(speed=1.5))
+                delta=CartesiaTTSSettings(generation_config=GenerationConfig(speed=1.5))
             )
         )
 

examples/foundational/55o-update-settings-elevenlabs-http-tts.py

@@ -107,7 +107,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info("Updating ElevenLabs TTS settings: speed=0.7")
             await task.queue_frame(
-                TTSUpdateSettingsFrame(update=ElevenLabsHttpTTSSettings(speed=0.7))
+                TTSUpdateSettingsFrame(delta=ElevenLabsHttpTTSSettings(speed=0.7))
             )
 
         @transport.event_handler("on_client_disconnected")

examples/foundational/55o-update-settings-elevenlabs-tts.py

@@ -102,13 +102,13 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating ElevenLabs TTS settings: speed=0.7")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=ElevenLabsTTSSettings(speed=0.7)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=ElevenLabsTTSSettings(speed=0.7)))
 
         await asyncio.sleep(10)
         logger.info("Updating ElevenLabs TTS settings: switching to a different voice")
         await task.queue_frame(
             TTSUpdateSettingsFrame(
-                update=ElevenLabsTTSSettings(voice=os.getenv("ELEVENLABS_VOICE_ID_ALT"))
+                delta=ElevenLabsTTSSettings(voice=os.getenv("ELEVENLABS_VOICE_ID_ALT"))
             )
         )
 

examples/foundational/55p-update-settings-openai-tts.py

@@ -99,7 +99,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating OpenAI TTS settings: speed=2.0")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=OpenAITTSSettings(speed=2.0)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=OpenAITTSSettings(speed=2.0)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55q-update-settings-deepgram-http-tts.py

@@ -106,13 +106,13 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info('Updating Deepgram TTS settings: voice="aura-2-aries-en"')
             await task.queue_frame(
-                TTSUpdateSettingsFrame(update=DeepgramTTSSettings(voice="aura-2-aries-en"))
+                TTSUpdateSettingsFrame(delta=DeepgramTTSSettings(voice="aura-2-aries-en"))
             )
 
             await asyncio.sleep(10)
             logger.info('Updating Deepgram TTS settings: voice="aura-2-luna-en"')
             await task.queue_frame(
-                TTSUpdateSettingsFrame(update=DeepgramTTSSettings(voice="aura-2-luna-en"))
+                TTSUpdateSettingsFrame(delta=DeepgramTTSSettings(voice="aura-2-luna-en"))
             )
 
         @transport.event_handler("on_client_disconnected")

examples/foundational/55q-update-settings-deepgram-sagemaker-tts.py

@@ -106,13 +106,13 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating Deepgram SageMaker TTS settings: voice="aura-2-aries-en"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=DeepgramSageMakerTTSSettings(voice="aura-2-aries-en"))
+            TTSUpdateSettingsFrame(delta=DeepgramSageMakerTTSSettings(voice="aura-2-aries-en"))
         )
 
         await asyncio.sleep(10)
         logger.info('Updating Deepgram SageMaker TTS settings: voice="aura-2-luna-en"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=DeepgramSageMakerTTSSettings(voice="aura-2-luna-en"))
+            TTSUpdateSettingsFrame(delta=DeepgramSageMakerTTSSettings(voice="aura-2-luna-en"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55q-update-settings-deepgram-tts.py

@@ -99,13 +99,13 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating Deepgram TTS settings: voice="aura-2-aries-en"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=DeepgramTTSSettings(voice="aura-2-aries-en"))
+            TTSUpdateSettingsFrame(delta=DeepgramTTSSettings(voice="aura-2-aries-en"))
         )
 
         await asyncio.sleep(10)
         logger.info('Updating Deepgram TTS settings: voice="aura-2-luna-en"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=DeepgramTTSSettings(voice="aura-2-luna-en"))
+            TTSUpdateSettingsFrame(delta=DeepgramTTSSettings(voice="aura-2-luna-en"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55r-update-settings-azure-http-tts.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating Azure TTS settings: rate="0.7", style="sad"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=AzureTTSSettings(rate="0.7", style="sad"))
+            TTSUpdateSettingsFrame(delta=AzureTTSSettings(rate="0.7", style="sad"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55r-update-settings-azure-tts.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating Azure TTS settings: rate="0.7", style="sad"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=AzureTTSSettings(rate="0.7", style="sad"))
+            TTSUpdateSettingsFrame(delta=AzureTTSSettings(rate="0.7", style="sad"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55s-update-settings-google-http-tts.py

@@ -99,7 +99,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Google HTTP TTS settings: speaking_rate=1.4")
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=GoogleHttpTTSSettings(speaking_rate=1.4))
+            TTSUpdateSettingsFrame(delta=GoogleHttpTTSSettings(speaking_rate=1.4))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55s-update-settings-google-stream-tts.py

@@ -99,7 +99,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Google Stream TTS settings: speaking_rate=1.4")
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=GoogleStreamTTSSettings(speaking_rate=1.4))
+            TTSUpdateSettingsFrame(delta=GoogleStreamTTSSettings(speaking_rate=1.4))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55t-update-settings-playht-tts.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating PlayHT TTS settings: speed=1.3")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=PlayHTTTSSettings(speed=1.3)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=PlayHTTTSSettings(speed=1.3)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55u-update-settings-rime-http-tts.py

@@ -104,7 +104,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
             await asyncio.sleep(10)
             logger.info("Updating Rime TTS settings: voice=rex")
-            await task.queue_frame(TTSUpdateSettingsFrame(update=RimeTTSSettings(voice="rex")))
+            await task.queue_frame(TTSUpdateSettingsFrame(delta=RimeTTSSettings(voice="rex")))
 
         @transport.event_handler("on_client_disconnected")
         async def on_client_disconnected(transport, client):

examples/foundational/55u-update-settings-rime-tts.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Rime TTS settings: voice=bond")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=RimeTTSSettings(voice="bond")))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=RimeTTSSettings(voice="bond")))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55v-update-settings-lmnt-tts.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info('Updating LMNT TTS settings: voice="tyler"')
-        await task.queue_frame(TTSUpdateSettingsFrame(update=LmntTTSSettings(voice="tyler")))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=LmntTTSSettings(voice="tyler")))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55w-update-settings-fish-tts.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Fish Audio TTS settings: prosody_speed=1.5")
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=FishAudioTTSSettings(prosody_speed=1.5))
+            TTSUpdateSettingsFrame(delta=FishAudioTTSSettings(prosody_speed=1.5))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55x-update-settings-minimax-tts.py

@@ -105,7 +105,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info('Updating MiniMax TTS settings: speed=1.5, emotion="happy"')
             await task.queue_frame(
-                TTSUpdateSettingsFrame(update=MiniMaxTTSSettings(speed=1.5, emotion="happy"))
+                TTSUpdateSettingsFrame(delta=MiniMaxTTSSettings(speed=1.5, emotion="happy"))
             )
 
         @transport.event_handler("on_client_disconnected")

examples/foundational/55y-update-settings-groq-tts.py

@@ -98,7 +98,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Groq TTS settings: speed=1.5")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=GroqTTSSettings(speed=1.5)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=GroqTTSSettings(speed=1.5)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55z-update-settings-hume-tts.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info('Updating Hume TTS settings: speed=2.0, description="Speak with excitement"')
         await task.queue_frame(
             TTSUpdateSettingsFrame(
-                update=HumeTTSSettings(speed=2.0, description="Speak with excitement")
+                delta=HumeTTSSettings(speed=2.0, description="Speak with excitement")
             )
         )
 

examples/foundational/55za-update-settings-neuphonic-http-tts.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
             await asyncio.sleep(10)
             logger.info("Updating Neuphonic HTTP TTS settings: speed=1.4")
-            await task.queue_frame(TTSUpdateSettingsFrame(update=NeuphonicTTSSettings(speed=1.4)))
+            await task.queue_frame(TTSUpdateSettingsFrame(delta=NeuphonicTTSSettings(speed=1.4)))
 
         @transport.event_handler("on_client_disconnected")
         async def on_client_disconnected(transport, client):

examples/foundational/55za-update-settings-neuphonic-tts.py

@@ -98,7 +98,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Neuphonic TTS settings: speed=1.4")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=NeuphonicTTSSettings(speed=1.4)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=NeuphonicTTSSettings(speed=1.4)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zb-update-settings-inworld-http-tts.py

@@ -103,9 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info("Updating Inworld TTS settings: speaking_rate=1.5, temperature=0.8")
             await task.queue_frame(
-                TTSUpdateSettingsFrame(
+                TTSUpdateSettingsFrame(delta=InworldTTSSettings(speaking_rate=1.5, temperature=0.8))
-                    update=InworldTTSSettings(speaking_rate=1.5, temperature=0.8)
-                )
             )
 
         @transport.event_handler("on_client_disconnected")

examples/foundational/55zb-update-settings-inworld-tts.py

@@ -99,7 +99,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Inworld TTS settings: speaking_rate=1.5, temperature=0.8")
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=InworldTTSSettings(speaking_rate=1.5, temperature=0.8))
+            TTSUpdateSettingsFrame(delta=InworldTTSSettings(speaking_rate=1.5, temperature=0.8))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zc-update-settings-gemini-tts.py

@@ -108,7 +108,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating Gemini TTS settings: prompt="Speak slowly and dramatically"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=GeminiTTSSettings(prompt="Speak slowly and dramatically"))
+            TTSUpdateSettingsFrame(delta=GeminiTTSSettings(prompt="Speak slowly and dramatically"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zd-update-settings-aws-polly-tts.py

@@ -98,7 +98,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info('Updating AWS Polly TTS settings: rate="fast"')
-        await task.queue_frame(TTSUpdateSettingsFrame(update=AWSPollyTTSSettings(rate="fast")))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=AWSPollyTTSSettings(rate="fast")))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55ze-update-settings-sarvam-http-tts.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
             await asyncio.sleep(10)
             logger.info("Updating Sarvam TTS settings: pace=1.5")
-            await task.queue_frame(TTSUpdateSettingsFrame(update=SarvamHttpTTSSettings(pace=1.5)))
+            await task.queue_frame(TTSUpdateSettingsFrame(delta=SarvamHttpTTSSettings(pace=1.5)))
 
         @transport.event_handler("on_client_disconnected")
         async def on_client_disconnected(transport, client):

examples/foundational/55ze-update-settings-sarvam-tts.py

@@ -98,7 +98,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Sarvam TTS settings: pace=1.5")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=SarvamTTSSettings(pace=1.5)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=SarvamTTSSettings(pace=1.5)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zf-update-settings-camb-tts.py

@@ -99,7 +99,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Camb TTS settings: language -> Spanish")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=CambTTSSettings(language=Language.ES)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=CambTTSSettings(language=Language.ES)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zg-update-settings-hathora-tts.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Hathora TTS settings: speed=1.3")
-        await task.queue_frame(TTSUpdateSettingsFrame(update=HathoraTTSSettings(speed=1.3)))
+        await task.queue_frame(TTSUpdateSettingsFrame(delta=HathoraTTSSettings(speed=1.3)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zh-update-settings-resembleai-tts.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating ResembleAI TTS settings: voice (changed)")
         await task.queue_frame(
             TTSUpdateSettingsFrame(
-                update=ResembleAITTSSettings(voice=os.getenv("RESEMBLE_VOICE_UUID_ALT"))
+                delta=ResembleAITTSSettings(voice=os.getenv("RESEMBLE_VOICE_UUID_ALT"))
             )
         )
 

examples/foundational/55zi-update-settings-azure-llm.py

@@ -106,7 +106,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Azure LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zi-update-settings-openai-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating OpenAI LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zj-update-settings-anthropic-llm.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Anthropic LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=AnthropicLLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=AnthropicLLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zk-update-settings-google-llm.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Google LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=GoogleLLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=GoogleLLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zk-update-settings-google-vertex-llm.py

@@ -106,7 +106,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Google Vertex LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=GoogleLLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=GoogleLLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zl-update-settings-azure-realtime.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating Azure Realtime LLM settings: output_modalities=['text']")
         await task.queue_frame(
             LLMUpdateSettingsFrame(
-                update=OpenAIRealtimeLLMSettings(
+                delta=OpenAIRealtimeLLMSettings(
                     session_properties=events.SessionProperties(output_modalities=["text"])
                 )
             )
@@ -112,7 +112,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating Azure Realtime LLM settings: output_modalities=['audio']")
         await task.queue_frame(
             LLMUpdateSettingsFrame(
-                update=OpenAIRealtimeLLMSettings(
+                delta=OpenAIRealtimeLLMSettings(
                     session_properties=events.SessionProperties(output_modalities=["audio"])
                 )
             )

examples/foundational/55zl-update-settings-openai-realtime.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating OpenAI Realtime LLM settings: output_modalities=['text']")
         await task.queue_frame(
             LLMUpdateSettingsFrame(
-                update=OpenAIRealtimeLLMSettings(
+                delta=OpenAIRealtimeLLMSettings(
                     session_properties=events.SessionProperties(output_modalities=["text"])
                 )
             )
@@ -111,7 +111,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating OpenAI Realtime LLM settings: output_modalities=['audio']")
         await task.queue_frame(
             LLMUpdateSettingsFrame(
-                update=OpenAIRealtimeLLMSettings(
+                delta=OpenAIRealtimeLLMSettings(
                     session_properties=events.SessionProperties(output_modalities=["audio"])
                 )
             )

examples/foundational/55zm-update-settings-gemini-live-vertex.py

@@ -91,9 +91,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Gemini Live Vertex LLM settings: temperature=0.1")
-        await task.queue_frame(
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=GeminiLiveLLMSettings(temperature=0.1)))
-            LLMUpdateSettingsFrame(update=GeminiLiveLLMSettings(temperature=0.1))
-        )
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zm-update-settings-gemini-live.py

@@ -89,9 +89,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Gemini Live LLM settings: temperature=0.1")
-        await task.queue_frame(
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=GeminiLiveLLMSettings(temperature=0.1)))
-            LLMUpdateSettingsFrame(update=GeminiLiveLLMSettings(temperature=0.1))
-        )
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zn-update-settings-ultravox-realtime.py

@@ -112,13 +112,13 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Ultravox Realtime LLM settings: output_medium=text")
         await task.queue_frame(
-            LLMUpdateSettingsFrame(update=UltravoxRealtimeLLMSettings(output_medium="text"))
+            LLMUpdateSettingsFrame(delta=UltravoxRealtimeLLMSettings(output_medium="text"))
         )
 
         await asyncio.sleep(10)
         logger.info("Updating Ultravox Realtime LLM settings: output_medium=voice")
         await task.queue_frame(
-            LLMUpdateSettingsFrame(update=UltravoxRealtimeLLMSettings(output_medium="voice"))
+            LLMUpdateSettingsFrame(delta=UltravoxRealtimeLLMSettings(output_medium="voice"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zo-update-settings-grok-realtime.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         logger.info("Updating Grok Realtime LLM settings: voice='Rex'")
         await task.queue_frame(
             LLMUpdateSettingsFrame(
-                update=GrokRealtimeLLMSettings(
+                delta=GrokRealtimeLLMSettings(
                     session_properties=events.SessionProperties(voice="Rex")
                 )
             )

examples/foundational/55zp-update-settings-aws-bedrock-llm.py

@@ -105,9 +105,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating AWS Bedrock LLM settings: temperature=0.1")
-        await task.queue_frame(
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=AWSBedrockLLMSettings(temperature=0.1)))
-            LLMUpdateSettingsFrame(update=AWSBedrockLLMSettings(temperature=0.1))
-        )
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zq-update-settings-fal-stt.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info('Updating Fal STT settings: task="translate"')
-        await task.queue_frame(STTUpdateSettingsFrame(update=FalSTTSettings(task="translate")))
+        await task.queue_frame(STTUpdateSettingsFrame(delta=FalSTTSettings(task="translate")))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zr-update-settings-gradium-stt.py

@@ -104,7 +104,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Gradium STT settings: delay_in_frames=5")
-        await task.queue_frame(STTUpdateSettingsFrame(update=GradiumSTTSettings(delay_in_frames=5)))
+        await task.queue_frame(STTUpdateSettingsFrame(delta=GradiumSTTSettings(delay_in_frames=5)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zs-update-settings-hathora-stt.py

@@ -104,7 +104,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating Hathora STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=HathoraSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=HathoraSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zt-update-settings-nvidia-segmented-stt.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating NVIDIA Segmented STT settings: profanity_filter=True")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=NvidiaSegmentedSTTSettings(profanity_filter=True))
+            STTUpdateSettingsFrame(delta=NvidiaSegmentedSTTSettings(profanity_filter=True))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zt-update-settings-nvidia-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating NVIDIA STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=NvidiaSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=NvidiaSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zu-update-settings-openai-realtime-stt.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating OpenAI Realtime STT settings: language=es")
         await task.queue_frame(
-            STTUpdateSettingsFrame(update=OpenAIRealtimeSTTSettings(language=Language.ES))
+            STTUpdateSettingsFrame(delta=OpenAIRealtimeSTTSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zv-update-settings-asyncai-http-tts.py

@@ -108,7 +108,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info("Updating AsyncAI HTTP TTS settings: language=es")
             await task.queue_frame(
-                TTSUpdateSettingsFrame(update=AsyncAITTSSettings(language=Language.ES))
+                TTSUpdateSettingsFrame(delta=AsyncAITTSSettings(language=Language.ES))
             )
 
         @transport.event_handler("on_client_disconnected")

examples/foundational/55zv-update-settings-asyncai-tts.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating AsyncAI TTS settings: language=es")
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=AsyncAITTSSettings(language=Language.ES))
+            TTSUpdateSettingsFrame(delta=AsyncAITTSSettings(language=Language.ES))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zw-update-settings-gradium-tts.py

@@ -103,7 +103,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating Gradium TTS settings: voice="LFZvm12tW_z0xfGo"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=GradiumTTSSettings(voice="LFZvm12tW_z0xfGo"))
+            TTSUpdateSettingsFrame(delta=GradiumTTSSettings(voice="LFZvm12tW_z0xfGo"))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zx-update-settings-cerebras-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Cerebras LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zy-update-settings-deepseek-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating DeepSeek LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zz-update-settings-fireworks-llm.py

@@ -105,7 +105,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Fireworks LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zza-update-settings-grok-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Grok LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzb-update-settings-groq-llm.py

@@ -104,7 +104,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Groq LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzc-update-settings-mistral-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Mistral LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzd-update-settings-nvidia-llm.py

@@ -104,7 +104,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating NVIDIA LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zze-update-settings-ollama-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating OLLama LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzf-update-settings-openrouter-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating OpenRouter LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzg-update-settings-perplexity-llm.py

@@ -101,7 +101,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Perplexity LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzh-update-settings-qwen-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Qwen LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzi-update-settings-sambanova-llm.py

@@ -102,7 +102,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating SambaNova LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzj-update-settings-together-llm.py

@@ -105,7 +105,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
 
         await asyncio.sleep(10)
         logger.info("Updating Together LLM settings: temperature=0.1")
-        await task.queue_frame(LLMUpdateSettingsFrame(update=OpenAILLMSettings(temperature=0.1)))
+        await task.queue_frame(LLMUpdateSettingsFrame(delta=OpenAILLMSettings(temperature=0.1)))
 
     @transport.event_handler("on_client_disconnected")
     async def on_client_disconnected(transport, client):

examples/foundational/55zzk-update-settings-aws-nova-sonic-llm.py

@@ -99,7 +99,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info("Updating AWS Nova Sonic LLM settings: temperature=0.1")
         await task.queue_frame(
-            LLMUpdateSettingsFrame(update=AWSNovaSonicLLMSettings(temperature=0.1))
+            LLMUpdateSettingsFrame(delta=AWSNovaSonicLLMSettings(temperature=0.1))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zzl-update-settings-nvidia-tts.py

@@ -100,7 +100,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
         await asyncio.sleep(10)
         logger.info('Updating NVIDIA TTS settings: language="ES_US"')
         await task.queue_frame(
-            TTSUpdateSettingsFrame(update=NvidiaTTSSettings(language=Language.ES_US))
+            TTSUpdateSettingsFrame(delta=NvidiaTTSSettings(language=Language.ES_US))
         )
 
     @transport.event_handler("on_client_disconnected")

examples/foundational/55zzm-update-settings-speechmatics-tts.py

@@ -104,7 +104,7 @@ async def run_bot(transport: BaseTransport, runner_args: RunnerArguments):
             await asyncio.sleep(10)
             logger.info('Updating Speechmatics TTS settings: voice="theo"')
             await task.queue_frame(
-                TTSUpdateSettingsFrame(update=SpeechmaticsTTSSettings(voice="theo"))
+                TTSUpdateSettingsFrame(delta=SpeechmaticsTTSSettings(voice="theo"))
             )
 
         @transport.event_handler("on_client_disconnected")

src/pipecat/frames/frames.py

@@ -2121,21 +2121,21 @@ class TTSStoppedFrame(ControlFrame):
 class ServiceUpdateSettingsFrame(ControlFrame):
     """Base frame for updating service settings.
 
-    Supports both a ``settings`` dict (for backward compatibility) and an
+    Supports both a ``settings`` dict (for backward compatibility) and a
-    ``update`` object.  When both are provided, ``update`` takes precedence.
+    ``delta`` object.  When both are provided, ``delta`` takes precedence.
 
     Parameters:
         settings: Dictionary of setting name to value mappings.
 
             .. deprecated:: 0.0.103
-                Use ``update`` with a typed settings object instead.
+                Use ``delta`` with a typed settings object instead.
 
-        update: :class:`~pipecat.services.settings.ServiceSettings` object
+        delta: :class:`~pipecat.services.settings.ServiceSettings` delta-mode
-            describing the delta to apply.
+            object describing the fields to change.
     """
 
     settings: Mapping[str, Any] = field(default_factory=dict)
-    update: Optional["ServiceSettings"] = None
+    delta: Optional["ServiceSettings"] = None
 
 
 @dataclass

src/pipecat/services/ai_service.py

@@ -42,7 +42,7 @@ class AIService(FrameProcessor):
             **kwargs: Additional arguments passed to the parent FrameProcessor.
         """
         super().__init__(**kwargs)
-        self._settings: ServiceSettings = ServiceSettings(model="")
+        self._settings: ServiceSettings = ServiceSettings()  # Here in case subclass doesn't implement more specific settings (hopefully shouldn't happen)
         self._session_properties: Dict[str, Any] = {}
         self._tracing_enabled: bool = False
         self._tracing_context = None
@@ -73,6 +73,7 @@ class AIService(FrameProcessor):
         Args:
             frame: The start frame containing initialization parameters.
         """
+        self._settings.validate_complete()
         self._tracing_enabled = frame.enable_tracing
         self._tracing_context = frame.tracing_context
 
@@ -98,10 +99,10 @@ class AIService(FrameProcessor):
         """
         pass
 
-    async def _update_settings(self, update: ServiceSettings) -> Dict[str, Any]:
+    async def _update_settings(self, delta: ServiceSettings) -> Dict[str, Any]:
-        """Apply a settings update and return the changed fields.
+        """Apply a settings delta and return the changed fields.
 
-        The update is applied to ``_settings`` and a dict mapping each changed
+        The delta is applied to ``_settings`` and a dict mapping each changed
         field name to its **pre-update** value is returned.  The ``model``
         field is handled specially: when it changes, ``set_model_name`` is
         called.
@@ -110,12 +111,12 @@ class AIService(FrameProcessor):
         to react to specific changed fields (e.g. reconnect on voice change).
 
         Args:
-            update: A settings delta.
+            delta: A delta-mode settings object.
 
         Returns:
             Dict mapping changed field names to their previous values.
         """
-        changed = self._settings.apply_update(update)
+        changed = self._settings.apply_update(delta)
 
         if "model" in changed:
             self._sync_model_name_to_metrics()

src/pipecat/services/anthropic/llm.py

@@ -254,6 +254,11 @@ class AnthropicLLMService(LLMService):
             temperature=params.temperature,
             top_k=params.top_k,
             top_p=params.top_p,
+            frequency_penalty=None,
+            presence_penalty=None,
+            seed=None,
+            filter_incomplete_user_turns=False,
+            user_turn_completion_config=None,
             thinking=params.thinking,
             extra=params.extra if isinstance(params.extra, dict) else {},
         )

src/pipecat/services/assemblyai/stt.py

@@ -116,6 +116,7 @@ class AssemblyAISTTService(WebsocketSTTService):
 
         self._api_key = api_key
         self._settings = AssemblyAISTTSettings(
+            model=None,
             language=language,
             connection_params=connection_params,
         )
@@ -186,18 +187,18 @@ class AssemblyAISTTService(WebsocketSTTService):
         """
         return True
 
-    async def _update_settings(self, update: STTSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: STTSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Settings are stored but not applied to the active connection.
 
         Args:
-            update: A :class:`STTSettings` (or ``AssemblyAISTTSettings``) delta.
+            delta: A :class:`STTSettings` (or ``AssemblyAISTTSettings``) delta.
 
         Returns:
             Dict mapping changed field names to their previous values.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         if not changed:
             return changed

src/pipecat/services/asyncai/tts.py

@@ -176,12 +176,12 @@ class AsyncAITTSService(AudioContextTTSService):
         self._receive_task = None
         self._keepalive_task = None
 
-    async def _update_settings(self, update: TTSSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: TTSSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Settings are stored but not applied to the active connection.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         if not changed:
             return changed

src/pipecat/services/aws/llm.py

@@ -827,6 +827,12 @@ class AWSBedrockLLMService(LLMService):
             max_tokens=params.max_tokens,
             temperature=params.temperature,
             top_p=params.top_p,
+            top_k=None,
+            frequency_penalty=None,
+            presence_penalty=None,
+            seed=None,
+            filter_incomplete_user_turns=False,
+            user_turn_completion_config=None,
             latency=params.latency,
             additional_model_request_fields=params.additional_model_request_fields
             if isinstance(params.additional_model_request_fields, dict)

src/pipecat/services/aws/nova_sonic/llm.py

@@ -267,6 +267,12 @@ class AWSNovaSonicLLMService(LLMService):
             temperature=params.temperature,
             max_tokens=params.max_tokens,
             top_p=params.top_p,
+            top_k=None,
+            frequency_penalty=None,
+            presence_penalty=None,
+            seed=None,
+            filter_incomplete_user_turns=False,
+            user_turn_completion_config=None,
             endpointing_sensitivity=params.endpointing_sensitivity,
         )
         self._sync_model_name_to_metrics()
@@ -338,12 +344,12 @@ class AWSNovaSonicLLMService(LLMService):
     # settings
     #
 
-    async def _update_settings(self, update: AWSNovaSonicLLMSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: AWSNovaSonicLLMSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Settings are stored but not applied to the active connection.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         if not changed:
             return changed

src/pipecat/services/aws/stt.py

@@ -148,12 +148,12 @@ class AWSTranscribeSTTService(WebsocketSTTService):
         }
         return encoding_map.get(encoding, encoding)
 
-    async def _update_settings(self, update: STTSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: STTSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Settings are stored but not applied to the active connection.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         if not changed:
             return changed

src/pipecat/services/aws/tts.py

@@ -209,6 +209,7 @@ class AWSPollyTTSService(TTSService):
 
         self._aws_session = aioboto3.Session()
         self._settings = AWSPollyTTSSettings(
+            model=None,
             voice=voice_id,
             engine=params.engine,
             language=self.language_to_service_language(params.language)

src/pipecat/services/azure/stt.py

@@ -110,6 +110,7 @@ class AzureSTTService(STTService):
         self._audio_stream = None
         self._speech_recognizer = None
         self._settings = AzureSTTSettings(
+            model=None,
             region=region,
             language=language_to_azure_language(language),
             sample_rate=sample_rate,
@@ -134,12 +135,12 @@ class AzureSTTService(STTService):
         """
         return language_to_azure_language(language)
 
-    async def _update_settings(self, update: STTSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: STTSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Settings are stored but not applied to the active recognizer.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         # TODO: someday we could reconnect here to apply updated settings.
         # Code might look something like the below:

src/pipecat/services/azure/tts.py

@@ -156,6 +156,7 @@ class AzureBaseTTSService:
         params = params or AzureBaseTTSService.InputParams()
 
         self._settings = AzureTTSSettings(
+            model=None,
             emphasis=params.emphasis,
             language=self.language_to_service_language(params.language)
             if params.language

src/pipecat/services/cartesia/stt.py

@@ -294,16 +294,16 @@ class CartesiaSTTService(WebsocketSTTService):
 
         await self._disconnect_websocket()
 
-    async def _update_settings(self, update: STTSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: STTSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Args:
-            update: A :class:`STTSettings` (or ``CartesiaSTTSettings``) delta.
+            delta: A :class:`STTSettings` (or ``CartesiaSTTSettings``) delta.
 
         Returns:
             Dict mapping changed field names to their previous values.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         # TODO: someday we could reconnect here to apply updated settings.
         # Code might look something like the below:

src/pipecat/services/cartesia/tts.py

@@ -28,7 +28,7 @@ from pipecat.frames.frames import (
     TTSStoppedFrame,
 )
 from pipecat.processors.frame_processor import FrameDirection
-from pipecat.services.settings import NOT_GIVEN, TTSSettings, _NotGiven, is_given
+from pipecat.services.settings import NOT_GIVEN, TTSSettings, _NotGiven
 from pipecat.services.tts_service import AudioContextTTSService, TTSService
 from pipecat.transcriptions.language import Language, resolve_language
 from pipecat.utils.text.base_text_aggregator import BaseTextAggregator
@@ -443,7 +443,7 @@ class CartesiaTTSService(AudioContextTTSService):
         voice_config["mode"] = "id"
         voice_config["id"] = self._settings.voice
 
-        if is_given(self._settings.emotion) and self._settings.emotion:
+        if self._settings.emotion:
             with warnings.catch_warnings():
                 warnings.simplefilter("always")
                 warnings.warn(
@@ -469,18 +469,18 @@ class CartesiaTTSService(AudioContextTTSService):
             "use_original_timestamps": False if self._settings.model == "sonic" else True,
         }
 
-        if is_given(self._settings.language) and self._settings.language:
+        if self._settings.language:
             msg["language"] = self._settings.language
 
-        if is_given(self._settings.speed) and self._settings.speed:
+        if self._settings.speed:
             msg["speed"] = self._settings.speed
 
-        if is_given(self._settings.generation_config) and self._settings.generation_config:
+        if self._settings.generation_config:
             msg["generation_config"] = self._settings.generation_config.model_dump(
                 exclude_none=True
             )
 
-        if is_given(self._settings.pronunciation_dict_id) and self._settings.pronunciation_dict_id:
+        if self._settings.pronunciation_dict_id:
             msg["pronunciation_dict_id"] = self._settings.pronunciation_dict_id
 
         return json.dumps(msg)
@@ -811,7 +811,7 @@ class CartesiaHttpTTSService(TTSService):
         try:
             voice_config = {"mode": "id", "id": self._settings.voice}
 
-            if is_given(self._settings.emotion) and self._settings.emotion:
+            if self._settings.emotion:
                 with warnings.catch_warnings():
                     warnings.simplefilter("always")
                     warnings.warn(
@@ -836,21 +836,18 @@ class CartesiaHttpTTSService(TTSService):
                 "output_format": output_format,
             }
 
-            if is_given(self._settings.language) and self._settings.language:
+            if self._settings.language:
                 payload["language"] = self._settings.language
 
-            if is_given(self._settings.speed) and self._settings.speed:
+            if self._settings.speed:
                 payload["speed"] = self._settings.speed
 
-            if is_given(self._settings.generation_config) and self._settings.generation_config:
+            if self._settings.generation_config:
                 payload["generation_config"] = self._settings.generation_config.model_dump(
                     exclude_none=True
                 )
 
-            if (
+            if self._settings.pronunciation_dict_id:
-                is_given(self._settings.pronunciation_dict_id)
-                and self._settings.pronunciation_dict_id
-            ):
                 payload["pronunciation_dict_id"] = self._settings.pronunciation_dict_id
 
             yield TTSStartedFrame(context_id=context_id)

src/pipecat/services/deepgram/flux/stt.py

@@ -384,12 +384,12 @@ class DeepgramFluxSTTService(WebsocketSTTService):
         """
         return True
 
-    async def _update_settings(self, update: DeepgramFluxSTTSettings) -> dict[str, Any]:
+    async def _update_settings(self, delta: DeepgramFluxSTTSettings) -> dict[str, Any]:
-        """Apply a settings update.
+        """Apply a settings delta.
 
         Settings are stored but not applied to the active connection.
         """
-        changed = await super()._update_settings(update)
+        changed = await super()._update_settings(delta)
 
         if not changed:
             return changed