feat: Allow passing extra kwargs to create_session of VertexAiSessionService

This can be used to set ttl and other configs.

PiperOrigin-RevId: 821782343

Author: DeanChensj

src/google/adk/sessions/vertex_ai_session_service.py

@@ -73,7 +73,23 @@ async def create_session(
       user_id: str,
       state: Optional[dict[str, Any]] = None,
       session_id: Optional[str] = None,
+      **kwargs: Any,
   ) -> Session:
+    """Creates a new session.
+
+    Args:
+      app_name: The name of the application.
+      user_id: The ID of the user.
+      state: The initial state of the session.
+      session_id: The ID of the session.
+      **kwargs: Additional arguments to pass to the session creation. E.g. set
+        expire_time='2025-10-01T00:00:00Z' to set the session expiration time.
+        See https://cloud.google.com/vertex-ai/generative-ai/docs/reference/rest/v1beta1/projects.locations.reasoningEngines.sessions
+        for more details.
+    Returns:
+      The created session.
+    """
+
     if session_id:
       raise ValueError(
           'User-provided Session id is not supported for'
@@ -84,6 +100,7 @@ async def create_session(
     api_client = self._get_api_client()
 
     config = {'session_state': state} if state else {}
+    config.update(kwargs)
 
     if _is_vertex_express_mode(self._project, self._location):
       config['wait_for_completion'] = False

tests/unittests/sessions/test_vertex_ai_session_service.py

@@ -242,6 +242,7 @@ def __init__(self) -> None:
     self.agent_engines.sessions.create.side_effect = self._create_session
     self.agent_engines.sessions.events.list.side_effect = self._list_events
     self.agent_engines.sessions.events.append.side_effect = self._append_event
+    self.last_create_session_config: dict[str, Any] = {}
 
   def _get_session(self, name: str):
     session_id = name.split('/')[-1]
@@ -275,6 +276,7 @@ def _delete_session(self, name: str):
     self.session_dict.pop(session_id)
 
   def _create_session(self, name: str, user_id: str, config: dict[str, Any]):
+    self.last_create_session_config = config
     new_session_id = '4'
     self.session_dict[new_session_id] = {
         'name': (
@@ -360,7 +362,8 @@ def mock_vertex_ai_session_service(agent_engine_id: Optional[str] = None):
 
 
 @pytest.fixture
-def mock_get_api_client():
+def mock_api_client_instance():
+  """Creates a mock API client instance for testing."""
   api_client = MockApiClient()
   api_client.session_dict = {
       '1': MOCK_SESSION_JSON_1,
@@ -373,9 +376,15 @@ def mock_get_api_client():
       '1': (copy.deepcopy(MOCK_EVENT_JSON), None),
       '2': (copy.deepcopy(MOCK_EVENT_JSON_2), 'my_token'),
   }
+  return api_client
+
+
+@pytest.fixture
+def mock_get_api_client(mock_api_client_instance):
+  """Mocks the _get_api_client method to return a mock API client."""
   with mock.patch(
       'google.adk.sessions.vertex_ai_session_service.VertexAiSessionService._get_api_client',
-      return_value=api_client,
+      return_value=mock_api_client_instance,
   ):
     yield
 
@@ -521,6 +530,21 @@ async def test_create_session_with_custom_session_id():
   )
 
 
+@pytest.mark.asyncio
+@pytest.mark.usefixtures('mock_get_api_client')
+async def test_create_session_with_custom_config(mock_api_client_instance):
+  session_service = mock_vertex_ai_session_service()
+
+  expire_time = '2025-12-12T12:12:12.123456Z'
+  await session_service.create_session(
+      app_name='123', user_id='user', expire_time=expire_time
+  )
+  assert (
+      mock_api_client_instance.last_create_session_config['expire_time']
+      == expire_time
+  )
+
+
 @pytest.mark.asyncio
 @pytest.mark.usefixtures('mock_get_api_client')
 async def test_append_event():