From 3cea5923f3f209b063261568ba3dd94481c01c15 Mon Sep 17 00:00:00 2001
From: ruskaruma <ishaan.sinha10@gmail.com>
Date: Mon, 3 Nov 2025 01:07:53 +0530
Subject: [PATCH 1/2] fix(realtime): include tool arguments in
 RealtimeToolStart events

Fixes #1663
---
 src/agents/realtime/events.py  | 4 ++++
 src/agents/realtime/session.py | 1 +
 tests/realtime/test_session.py | 9 ++++++++-
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/agents/realtime/events.py b/src/agents/realtime/events.py
index 3c523c33b..3c02793cb 100644
--- a/src/agents/realtime/events.py
+++ b/src/agents/realtime/events.py
@@ -69,6 +69,10 @@ class RealtimeToolStart:
     """The agent that updated."""
 
     tool: Tool
+    """The tool being called."""
+
+    arguments: str
+    """The arguments passed to the tool as a JSON string."""
 
     info: RealtimeEventInfo
     """Common info for all events, such as the context."""
diff --git a/src/agents/realtime/session.py b/src/agents/realtime/session.py
index 6378382e1..e2c90cb74 100644
--- a/src/agents/realtime/session.py
+++ b/src/agents/realtime/session.py
@@ -411,6 +411,7 @@ async def _handle_tool_call(
                     info=self._event_info,
                     tool=function_map[event.name],
                     agent=agent,
+                    arguments=event.arguments,
                 )
             )
 
diff --git a/tests/realtime/test_session.py b/tests/realtime/test_session.py
index 8280de61c..59e1498fd 100644
--- a/tests/realtime/test_session.py
+++ b/tests/realtime/test_session.py
@@ -986,6 +986,7 @@ async def test_function_tool_execution_success(
         assert isinstance(tool_start_event, RealtimeToolStart)
         assert tool_start_event.tool == mock_function_tool
         assert tool_start_event.agent == mock_agent
+        assert tool_start_event.arguments == '{"param": "value"}'
 
         # Check tool end event
         tool_end_event = await session._event_queue.get()
@@ -1111,6 +1112,7 @@ async def test_function_tool_exception_handling(
         assert session._event_queue.qsize() == 1
         tool_start_event = await session._event_queue.get()
         assert isinstance(tool_start_event, RealtimeToolStart)
+        assert tool_start_event.arguments == "{}"
 
         # But no tool output should have been sent and no end event queued
         assert len(mock_model.sent_tool_outputs) == 0
@@ -1133,10 +1135,15 @@ async def test_tool_call_with_complex_arguments(
 
         await session._handle_tool_call(tool_call_event)
 
-        # Verify arguments were passed correctly
+        # Verify arguments were passed correctly to tool
         call_args = mock_function_tool.on_invoke_tool.call_args
         assert call_args[0][1] == complex_args
 
+        # Verify tool_start event includes arguments
+        tool_start_event = await session._event_queue.get()
+        assert isinstance(tool_start_event, RealtimeToolStart)
+        assert tool_start_event.arguments == complex_args
+
     @pytest.mark.asyncio
     async def test_tool_call_with_custom_call_id(self, mock_model, mock_agent, mock_function_tool):
         """Test that tool context receives correct call_id"""

From 918ee6ff98d6508b99e997061c53b9113231afb0 Mon Sep 17 00:00:00 2001
From: ruskaruma <ishaan.sinha10@gmail.com>
Date: Wed, 5 Nov 2025 09:33:29 +0530
Subject: [PATCH 2/2] feat(realtime): include tool arguments in RealtimeToolEnd
 events, fixes consistency request from PR #2028

---
 src/agents/realtime/events.py  | 3 +++
 src/agents/realtime/session.py | 1 +
 tests/realtime/test_session.py | 6 ++++++
 3 files changed, 10 insertions(+)

diff --git a/src/agents/realtime/events.py b/src/agents/realtime/events.py
index 3c02793cb..d0cbb64ef 100644
--- a/src/agents/realtime/events.py
+++ b/src/agents/realtime/events.py
@@ -90,6 +90,9 @@ class RealtimeToolEnd:
     tool: Tool
     """The tool that was called."""
 
+    arguments: str
+    """The arguments passed to the tool as a JSON string."""
+
     output: Any
     """The output of the tool call."""
 
diff --git a/src/agents/realtime/session.py b/src/agents/realtime/session.py
index e2c90cb74..a3cd1d3ea 100644
--- a/src/agents/realtime/session.py
+++ b/src/agents/realtime/session.py
@@ -437,6 +437,7 @@ async def _handle_tool_call(
                     tool=func_tool,
                     output=result,
                     agent=agent,
+                    arguments=event.arguments,
                 )
             )
         elif event.name in handoff_map:
diff --git a/tests/realtime/test_session.py b/tests/realtime/test_session.py
index 59e1498fd..775e5418f 100644
--- a/tests/realtime/test_session.py
+++ b/tests/realtime/test_session.py
@@ -994,6 +994,7 @@ async def test_function_tool_execution_success(
         assert tool_end_event.tool == mock_function_tool
         assert tool_end_event.output == "function_result"
         assert tool_end_event.agent == mock_agent
+        assert tool_end_event.arguments == '{"param": "value"}'
 
     @pytest.mark.asyncio
     async def test_function_tool_with_multiple_tools_available(self, mock_model, mock_agent):
@@ -1144,6 +1145,11 @@ async def test_tool_call_with_complex_arguments(
         assert isinstance(tool_start_event, RealtimeToolStart)
         assert tool_start_event.arguments == complex_args
 
+        # Verify tool_end event includes arguments
+        tool_end_event = await session._event_queue.get()
+        assert isinstance(tool_end_event, RealtimeToolEnd)
+        assert tool_end_event.arguments == complex_args
+
     @pytest.mark.asyncio
     async def test_tool_call_with_custom_call_id(self, mock_model, mock_agent, mock_function_tool):
         """Test that tool context receives correct call_id"""