fix(pydantic-ai): Restore tool description in execute_tool spans

The previous commit removed tool_definition from execute_tool_span, which
inadvertently dropped gen_ai.tool.description from spans. Restore description
support by extracting the description string from tool.tool_def in patches/tools.py
and passing it as Optional[str] to execute_tool_span, avoiding the ToolDefinition
type coupling while preserving the behavior.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: dingsdax

sentry_sdk/integrations/pydantic_ai/patches/tools.py

@@ -56,6 +56,9 @@ async def wrapped_execute_tool_call(
         if tool and HAS_MCP and isinstance(tool.toolset, MCPServer):
             tool_type = "mcp"
 
+        tool_def = getattr(tool, "tool_def", None)
+        tool_description = getattr(tool_def, "description", None)
+
         # Get agent from contextvar
         agent = get_current_agent()
 
@@ -73,6 +76,7 @@ async def wrapped_execute_tool_call(
                     args_dict,
                     agent,
                     tool_type=tool_type,
+                    tool_description=tool_description,
                 ) as span:
                     try:
                         result = await original_execute_tool_call(
@@ -133,6 +137,9 @@ async def wrapped_call_tool(
         if tool and HAS_MCP and isinstance(tool.toolset, MCPServer):
             tool_type = "mcp"
 
+        tool_def = getattr(tool, "tool_def", None)
+        tool_description = getattr(tool_def, "description", None)
+
         # Get agent from contextvar
         agent = get_current_agent()
 
@@ -150,6 +157,7 @@ async def wrapped_call_tool(
                     args_dict,
                     agent,
                     tool_type=tool_type,
+                    tool_description=tool_description,
                 ) as span:
                     try:
                         result = await original_call_tool(

sentry_sdk/integrations/pydantic_ai/spans/execute_tool.py

@@ -12,7 +12,11 @@
 
 
 def execute_tool_span(
-    tool_name: str, tool_args: "Any", agent: "Any", tool_type: str = "function"
+    tool_name: str,
+    tool_args: "Any",
+    agent: "Any",
+    tool_type: str = "function",
+    tool_description: "Optional[str]" = None,
 ) -> "sentry_sdk.tracing.Span":
     """Create a span for tool execution.
 
@@ -21,6 +25,7 @@ def execute_tool_span(
         tool_args: The arguments passed to the tool
         agent: The agent executing the tool
         tool_type: The type of tool ("function" for regular tools, "mcp" for MCP services)
+        tool_description: Optional description of the tool
     """
     span = sentry_sdk.start_span(
         op=OP.GEN_AI_EXECUTE_TOOL,
@@ -32,6 +37,9 @@ def execute_tool_span(
     span.set_data(SPANDATA.GEN_AI_TOOL_TYPE, tool_type)
     span.set_data(SPANDATA.GEN_AI_TOOL_NAME, tool_name)
 
+    if tool_description is not None:
+        span.set_data(SPANDATA.GEN_AI_TOOL_DESCRIPTION, tool_description)
+
     _set_agent_data(span, agent)
 
     if _should_send_prompts() and tool_args is not None: