From d02337515a0e5f245872b134b44ee5cd15e54105 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 9 Jun 2026 19:12:18 +0000
Subject: [PATCH] docs: update for pipecat PR #4665 - TTS turn event
 improvements

- Add append_to_context parameter to TTSStartedFrame documentation
- Clarify that assistant turn events work for TTSSpeakFrame utterances
- Document that on_assistant_turn_started fires when TTS begins for TTSSpeakFrame
---
 api-reference/server/frames/control-frames.mdx | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/api-reference/server/frames/control-frames.mdx b/api-reference/server/frames/control-frames.mdx
index 8b6df299..3ba86a1c 100644
--- a/api-reference/server/frames/control-frames.mdx
+++ b/api-reference/server/frames/control-frames.mdx
@@ -231,6 +231,13 @@ Signals the beginning of a TTS audio response.
   Identifier linking this TTS output to its originating context.
 </ParamField>
 
+<ParamField path="append_to_context" type="bool" default="True">
+  Whether the spoken text for this response will be appended to the LLM
+  context. When `True`, the assistant aggregator will track this output as an
+  assistant turn, firing `on_assistant_turn_started` and
+  `on_assistant_turn_stopped` events.
+</ParamField>
+
 ### TTSStoppedFrame
 
 Signals the end of a TTS audio response.