feat: add live history_config with initial_history_in_client_content

PiperOrigin-RevId: 882741677

Author: google-genai-bot

google/genai/_live_converters.py

@@ -584,6 +584,9 @@ def _LiveClientSetup_to_mldev(
   if getv(from_object, ['proactivity']) is not None:
     setv(to_object, ['proactivity'], getv(from_object, ['proactivity']))
 
+  if getv(from_object, ['history_config']) is not None:
+    setv(to_object, ['historyConfig'], getv(from_object, ['history_config']))
+
   if getv(from_object, ['explicit_vad_signal']) is not None:
     raise ValueError(
         'explicit_vad_signal parameter is not supported in Gemini API.'
@@ -658,6 +661,9 @@ def _LiveClientSetup_to_vertex(
   if getv(from_object, ['proactivity']) is not None:
     setv(to_object, ['proactivity'], getv(from_object, ['proactivity']))
 
+  if getv(from_object, ['history_config']) is not None:
+    raise ValueError('history_config parameter is not supported in Vertex AI.')
+
   if getv(from_object, ['explicit_vad_signal']) is not None:
     setv(
         to_object,
@@ -819,6 +825,13 @@ def _LiveConnectConfig_to_mldev(
         getv(from_object, ['proactivity']),
     )
 
+  if getv(from_object, ['history_config']) is not None:
+    setv(
+        parent_object,
+        ['setup', 'historyConfig'],
+        getv(from_object, ['history_config']),
+    )
+
   if getv(from_object, ['explicit_vad_signal']) is not None:
     raise ValueError(
         'explicit_vad_signal parameter is not supported in Gemini API.'
@@ -972,6 +985,9 @@ def _LiveConnectConfig_to_vertex(
         getv(from_object, ['proactivity']),
     )
 
+  if getv(from_object, ['history_config']) is not None:
+    raise ValueError('history_config parameter is not supported in Vertex AI.')
+
   if getv(from_object, ['explicit_vad_signal']) is not None:
     setv(
         parent_object,

google/genai/_tokens_converters.py

@@ -411,6 +411,13 @@ def _LiveConnectConfig_to_mldev(
         getv(from_object, ['proactivity']),
     )
 
+  if getv(from_object, ['history_config']) is not None:
+    setv(
+        parent_object,
+        ['setup', 'historyConfig'],
+        getv(from_object, ['history_config']),
+    )
+
   if getv(from_object, ['explicit_vad_signal']) is not None:
     raise ValueError(
         'explicit_vad_signal parameter is not supported in Gemini API.'

google/genai/tests/live/test_live.py

@@ -873,6 +873,19 @@ async def test_explicit_vad_config(vertexai):
   assert result['setup']['explicitVadSignal'] == True
 
 
+@pytest.mark.asyncio
+async def test_history_config():
+  config_dict = {
+      'history_config': {'initial_history_in_client_content': True},
+  }
+  result = await get_connect_message(
+      mock_api_client(vertexai=False), model='test_model', config=config_dict
+  )
+  assert result['setup']['historyConfig'] == {
+      'initial_history_in_client_content': True,
+  }
+
+
 @pytest.mark.parametrize('vertexai', [True, False])
 @pytest.mark.asyncio
 async def test_bidi_setup_to_api_with_system_instruction_as_content_type(

google/genai/types.py

@@ -18037,6 +18037,33 @@ class ProactivityConfigDict(TypedDict, total=False):
 ProactivityConfigOrDict = Union[ProactivityConfig, ProactivityConfigDict]
 
 
+class HistoryConfig(_common.BaseModel):
+  """Configuration for history exchange between client and server."""
+
+  initial_history_in_client_content: Optional[bool] = Field(
+      default=None,
+      description="""If true, after sending `setup_complete`, the server will wait
+      and at first process `client_content` messages until `turn_complete` is
+      `true`. This initial history will not trigger a model call and
+      may end with model content. After `turn_complete` is `true`, the client
+      can start the realtime conversation via `realtime_input`.""",
+  )
+
+
+class HistoryConfigDict(TypedDict, total=False):
+  """Configuration for history exchange between client and server."""
+
+  initial_history_in_client_content: Optional[bool]
+  """If true, after sending `setup_complete`, the server will wait
+      and at first process `client_content` messages until `turn_complete` is
+      `true`. This initial history will not trigger a model call and
+      may end with model content. After `turn_complete` is `true`, the client
+      can start the realtime conversation via `realtime_input`."""
+
+
+HistoryConfigOrDict = Union[HistoryConfig, HistoryConfigDict]
+
+
 class AutomaticActivityDetection(_common.BaseModel):
   """Configures automatic detection of activity."""
 
@@ -18184,6 +18211,10 @@ class LiveClientSetup(_common.BaseModel):
       description="""Configures the proactivity of the model. This allows the model to respond proactively to
     the input and to ignore irrelevant input.""",
   )
+  history_config: Optional[HistoryConfig] = Field(
+      default=None,
+      description="""Configures the exchange of history between the client and the server.""",
+  )
   explicit_vad_signal: Optional[bool] = Field(
       default=None,
       description="""Configures the explicit VAD signal. If enabled, the client will send
@@ -18241,6 +18272,9 @@ class LiveClientSetupDict(TypedDict, total=False):
   """Configures the proactivity of the model. This allows the model to respond proactively to
     the input and to ignore irrelevant input."""
 
+  history_config: Optional[HistoryConfigDict]
+  """Configures the exchange of history between the client and the server."""
+
   explicit_vad_signal: Optional[bool]
   """Configures the explicit VAD signal. If enabled, the client will send
       vad_signal to indicate the start and end of speech. This allows the server
@@ -18730,6 +18764,10 @@ class LiveConnectConfig(_common.BaseModel):
       description="""Configures the proactivity of the model. This allows the model to respond proactively to
     the input and to ignore irrelevant input.""",
   )
+  history_config: Optional[HistoryConfig] = Field(
+      default=None,
+      description="""Configures the exchange of history between the client and the server.""",
+  )
   explicit_vad_signal: Optional[bool] = Field(
       default=None,
       description="""Configures the explicit VAD signal. If enabled, the client will send
@@ -18838,6 +18876,9 @@ class LiveConnectConfigDict(TypedDict, total=False):
   """Configures the proactivity of the model. This allows the model to respond proactively to
     the input and to ignore irrelevant input."""
 
+  history_config: Optional[HistoryConfigDict]
+  """Configures the exchange of history between the client and the server."""
+
   explicit_vad_signal: Optional[bool]
   """Configures the explicit VAD signal. If enabled, the client will send
       vad_signal to indicate the start and end of speech. This allows the server