chore: Improve error message for missing invocation_id and new_message in run_async

GWeale · copybara-github · commit de841a4a0982 · 2025-12-05T12:34:18.000-08:00
Help with issue in #3801 Co-authored-by: George Weale <gweale@google.com> PiperOrigin-RevId: 840833736
diff --git a/src/google/adk/runners.py b/src/google/adk/runners.py
@@ -412,7 +412,11 @@ async def _run_with_trace(
           message = self._format_session_not_found_message(session_id)
           raise ValueError(message)
         if not invocation_id and not new_message:
-          raise ValueError('Both invocation_id and new_message are None.')
+          raise ValueError(
+              'Running an agent requires either a new_message or an '
+              'invocation_id to resume a previous invocation. '
+              f'Session: {session_id}, User: {user_id}'
+          )
 
         if invocation_id:
           if (
