monocle-apptrace 0.4.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

monocle_apptrace/instrumentation/metamodel/langchain/_helper.py

@@ -4,14 +4,18 @@ and assistant messages from various input formats.
 """
 
 import logging
+from opentelemetry.context import get_value
+from monocle_apptrace.instrumentation.common.constants import AGENT_PREFIX_KEY, INFERENCE_AGENT_DELEGATION, INFERENCE_COMMUNICATION, INFERENCE_TOOL_CALL
 from monocle_apptrace.instrumentation.common.utils import (
     Option,
+    get_json_dumps,
     get_keys_as_tuple,
     get_nested_value,
     try_option,
     get_exception_message,
     get_status_code,
 )
+from monocle_apptrace.instrumentation.metamodel.finish_types import map_langchain_finish_reason_to_finish_type
 
 
 logger = logging.getLogger(__name__)
@@ -32,45 +36,80 @@ def extract_messages(args):
                 for msg in args[0].messages:
                     if hasattr(msg, 'content') and hasattr(msg, 'type'):
                         messages.append({msg.type: msg.content})
-        return [str(d) for d in messages]
+            else:
+                for msg in args[0]:
+                    if hasattr(msg, 'content') and hasattr(msg, 'type') and msg.content:
+                        messages.append({msg.type: msg.content})
+                    elif hasattr(msg, 'tool_calls') and msg.tool_calls:
+                        messages.append({msg.type: get_json_dumps(msg.tool_calls)})
+        return [get_json_dumps(d) for d in messages]
     except Exception as e:
         logger.warning("Warning: Error occurred in extract_messages: %s", str(e))
         return []
+def agent_inference_type(arguments):
+    """Extract agent inference type from arguments."""
+    try:
+        if get_value(AGENT_PREFIX_KEY):
+            agent_prefix = get_value(AGENT_PREFIX_KEY)
+            if hasattr(arguments['result'], "tool_calls") and arguments['result'].tool_calls:
+                tool_call = arguments['result'].tool_calls[0] if arguments['result'].tool_calls else None
+                if tool_call and 'name' in tool_call and tool_call["name"].startswith(agent_prefix):
+                    return INFERENCE_AGENT_DELEGATION
+                else:
+                    return INFERENCE_TOOL_CALL
+        return INFERENCE_COMMUNICATION
+            
+    except Exception as e:
+        logger.warning("Warning: Error occurred in agent_inference_type: %s", str(e))
+        return None
 
 def extract_assistant_message(arguments):
     status = get_status_code(arguments)
-    response: str = ""
+    messages = []
+    role = "assistant"
     if status == 'success':
         if isinstance(arguments['result'], str):
-            response = arguments['result']
-        if hasattr(arguments['result'], "content"):
-            response = arguments['result'].content
-        if hasattr(arguments['result'], "message") and hasattr(arguments['result'].message, "content"):
-            response =  arguments['result'].message.content
+            messages.append({role: arguments['result']})
+        elif hasattr(arguments['result'], "content") and arguments['result'].content != "":
+            role = arguments['result'].type if hasattr(arguments['result'], 'type') else role
+            messages.append({role: arguments['result'].content})
+        elif hasattr(arguments['result'], "message") and hasattr(arguments['result'].message, "content") and arguments['result'].message.content != "":
+            role = arguments['result'].type if hasattr(arguments['result'], 'type') else role
+            messages.append({role: arguments['result'].message.content})
+        elif hasattr(arguments['result'], "tool_calls"):
+            role = arguments['result'].type if hasattr(arguments['result'], 'type') else role
+            messages.append({role: arguments['result'].tool_calls[0]})
     else:
         if arguments["exception"] is not None:
-            response = get_exception_message(arguments)
+            messages.append({role: get_exception_message(arguments)})
         elif hasattr(arguments["result"], "error"):
-            response = arguments["result"].error
-
-    return response
-
+            return arguments["result"].error
+    return get_json_dumps(messages[0]) if messages else ""
 
 def extract_provider_name(instance):
-    provider_url: Option[str] = None
-    if hasattr(instance,'client'):
+    provider_url: Option[str] = Option(None)
+    if hasattr(instance, 'client'):
+        provider_url: Option[str] = try_option(getattr, instance.client, 'universe_domain')
+    if hasattr(instance,'client') and hasattr(instance.client, '_client') and hasattr(instance.client._client, 'base_url'):
+        # If the client has a base_url, extract the host from it
         provider_url: Option[str] = try_option(getattr, instance.client._client.base_url, 'host')
-    if hasattr(instance, '_client'):
+    if hasattr(instance, '_client') and hasattr(instance._client, 'base_url'):
         provider_url = try_option(getattr, instance._client.base_url, 'host')
     return provider_url.unwrap_or(None)
 
 
 def extract_inference_endpoint(instance):
     inference_endpoint: Option[str] = None
-    if hasattr(instance,'client'):
+    # instance.client.meta.endpoint_url
+    if hasattr(instance, 'client') and hasattr(instance.client, 'transport'):
+        inference_endpoint: Option[str] = try_option(getattr, instance.client.transport, 'host')
+
+    if hasattr(instance, 'client') and hasattr(instance.client, 'meta') and hasattr(instance.client.meta, 'endpoint_url'):
+        inference_endpoint: Option[str] = try_option(getattr, instance.client.meta, 'endpoint_url').map(str)
+
+    if hasattr(instance,'client') and hasattr(instance.client, '_client'):
         inference_endpoint: Option[str] = try_option(getattr, instance.client._client, 'base_url').map(str)
-        if inference_endpoint.is_none() and "meta" in instance.client.__dict__:
-            inference_endpoint = try_option(getattr, instance.client.meta, 'endpoint_url').map(str)
+
     if hasattr(instance,'_client'):
         inference_endpoint = try_option(getattr, instance._client, 'base_url').map(str)
 
@@ -138,4 +177,91 @@ def update_span_from_llm_response(response, instance):
                 {"completion_tokens": token_usage.get("completion_tokens") or token_usage.get("output_tokens")})
             meta_dict.update({"prompt_tokens": token_usage.get("prompt_tokens") or token_usage.get("input_tokens")})
             meta_dict.update({"total_tokens": token_usage.get("total_tokens")})
-    return meta_dict
+    return meta_dict
+
+def extract_finish_reason(arguments):
+    """Extract finish_reason from LangChain response."""
+    try:
+        # Handle exception cases first
+        if arguments.get("exception") is not None:
+            # If there's an exception, it's typically an error finish type
+            return "error"
+        
+        response = arguments.get("result")
+        if response is None:
+            return None
+            
+        # Check various possible locations for finish_reason in LangChain responses
+        
+        # Direct finish_reason attribute
+        if hasattr(response, "finish_reason") and response.finish_reason:
+            return response.finish_reason
+            
+        # Response metadata (common in LangChain)
+        if hasattr(response, "response_metadata") and response.response_metadata:
+            metadata = response.response_metadata
+            if isinstance(metadata, dict):
+                # Check for finish_reason in metadata
+                if "finish_reason" in metadata:
+                    return metadata["finish_reason"]
+                # Check for stop_reason (Anthropic style through LangChain)
+                if "stop_reason" in metadata:
+                    return metadata["stop_reason"]
+                # Check for other common finish reason keys
+                for key in ["completion_reason", "end_reason", "status"]:
+                    if key in metadata:
+                        return metadata[key]
+        
+        # Check if response has generation_info (some LangChain models)
+        if hasattr(response, "generation_info") and response.generation_info:
+            gen_info = response.generation_info
+            if isinstance(gen_info, dict):
+                for key in ["finish_reason", "stop_reason", "completion_reason"]:
+                    if key in gen_info:
+                        return gen_info[key]
+        
+        # Check if response has llm_output (batch responses)
+        if hasattr(response, "llm_output") and response.llm_output:
+            llm_output = response.llm_output
+            if isinstance(llm_output, dict):
+                for key in ["finish_reason", "stop_reason"]:
+                    if key in llm_output:
+                        return llm_output[key]
+        
+        # For AIMessage responses, check additional_kwargs
+        if hasattr(response, "additional_kwargs") and response.additional_kwargs:
+            kwargs = response.additional_kwargs
+            if isinstance(kwargs, dict):
+                for key in ["finish_reason", "stop_reason"]:
+                    if key in kwargs:
+                        return kwargs[key]
+        
+        # For generation responses with choices (similar to OpenAI structure)
+        if hasattr(response, "generations") and response.generations:
+            generations = response.generations
+            if isinstance(generations, list) and len(generations) > 0:
+                for generation in generations:
+                    if hasattr(generation, "generation_info") and generation.generation_info:
+                        gen_info = generation.generation_info
+                        if isinstance(gen_info, dict):
+                            for key in ["finish_reason", "stop_reason"]:
+                                if key in gen_info:
+                                    return gen_info[key]
+        
+        # If no specific finish reason found, infer from status
+        status_code = get_status_code(arguments)
+        if status_code == 'success':
+            return "stop"  # Default success finish reason
+        elif status_code == 'error':
+            return "error"
+            
+    except Exception as e:
+        logger.warning("Warning: Error occurred in extract_finish_reason: %s", str(e))
+        return None
+    
+    return None
+
+
+def map_finish_reason_to_finish_type(finish_reason):
+    """Map LangChain finish_reason to finish_type."""
+    return map_langchain_finish_reason_to_finish_type(finish_reason)

monocle_apptrace/instrumentation/metamodel/langchain/entities/inference.py

@@ -1,7 +1,7 @@
 from monocle_apptrace.instrumentation.metamodel.langchain import (
     _helper,
 )
-from monocle_apptrace.instrumentation.common.utils import resolve_from_alias, get_llm_type, get_status, get_status_code
+from monocle_apptrace.instrumentation.common.utils import get_error_message, resolve_from_alias, get_llm_type, get_status, get_status_code
 
 INFERENCE = {
     "type": "inference.framework",
@@ -30,11 +30,11 @@ INFERENCE = {
             {
                 "_comment": "LLM Model",
                 "attribute": "name",
-                "accessor": lambda arguments: resolve_from_alias(arguments['instance'].__dict__, ['model', 'model_name', 'endpoint_name', 'deployment_name'])
+                "accessor": lambda arguments: resolve_from_alias(arguments['instance'].__dict__, ['model', 'model_name', 'endpoint_name', 'deployment_name', 'model_id'])
             },
             {
                 "attribute": "type",
-                "accessor": lambda arguments: 'model.llm.' + resolve_from_alias(arguments['instance'].__dict__, ['model', 'model_name', 'endpoint_name', 'deployment_name'])
+                "accessor": lambda arguments: 'model.llm.' + resolve_from_alias(arguments['instance'].__dict__, ['model', 'model_name', 'endpoint_name', 'deployment_name', 'model_id'])
             }
         ]
     ],
@@ -53,13 +53,8 @@ INFERENCE = {
             "name": "data.output",
             "attributes": [
                 {
-                    "_comment": "this is result from LLM",
-                    "attribute": "status",
-                    "accessor": lambda arguments: get_status(arguments)
-                },
-                {
-                    "attribute": "status_code",
-                    "accessor": lambda arguments: get_status_code(arguments)
+                    "attribute": "error_code",
+                    "accessor": lambda arguments: get_error_message(arguments)
                 },
                 {
                     "attribute": "response",
@@ -73,6 +68,20 @@ INFERENCE = {
                 {
                     "_comment": "this is metadata usage from LLM",
                     "accessor": lambda arguments: _helper.update_span_from_llm_response(arguments['result'], arguments['instance'])
+                },
+                {
+                    "attribute": "finish_reason",
+                    "accessor": lambda arguments: _helper.extract_finish_reason(arguments)
+                },
+                {
+                    "attribute": "finish_type",
+                    "accessor": lambda arguments: _helper.map_finish_reason_to_finish_type(
+                        _helper.extract_finish_reason(arguments)
+                    )
+                },
+                {
+                    "attribute": "inference_sub_type",
+                    "accessor": lambda arguments: _helper.agent_inference_type(arguments)
                 }
             ]
         }

monocle_apptrace/instrumentation/metamodel/langgraph/_helper.py

@@ -1,15 +1,20 @@
+from opentelemetry.context import get_value
 from monocle_apptrace.instrumentation.common.utils import resolve_from_alias
 import logging
 logger = logging.getLogger(__name__)
 
-def handle_openai_response(response):
+DELEGATION_NAME_PREFIX = 'transfer_to_'
+ROOT_AGENT_NAME = 'LangGraph'
+LANGGRAPTH_AGENT_NAME_KEY = "agent.langgraph"
+
+def extract_agent_response(response):
     try:
-        if 'messages' in response:
+        if response is not None and 'messages' in response:
             output = response["messages"][-1]
             return str(output.content)
     except Exception as e:
-        logger.warning("Warning: Error occurred in handle_openai_response: %s", str(e))
-        return ""
+        logger.warning("Warning: Error occurred in handle_response: %s", str(e))
+    return ""
 
 def agent_instructions(arguments):
     if callable(arguments['kwargs']['agent'].instructions):
@@ -17,11 +22,13 @@ def agent_instructions(arguments):
     else:
         return arguments['kwargs']['agent'].instructions
 
-def extract_input(arguments):
-    history = arguments['result']['messages']
-    for message in history:
-        if hasattr(message, 'content') and hasattr(message, 'type') and message.type == "human":  # Check if the message is a HumanMessage
-            return message.content
+def extract_agent_input(arguments):
+    if arguments['result'] is not None and 'messages' in arguments['result']:
+        history = arguments['result']['messages']
+        for message in history:
+            if hasattr(message, 'content') and hasattr(message, 'type') and message.type == "human":  # Check if the message is a HumanMessage
+                return message.content
+    return None
 
 def get_inference_endpoint(arguments):
     inference_endpoint = resolve_from_alias(arguments['instance'].client.__dict__, ['azure_endpoint', 'api_base', '_base_url'])
@@ -33,7 +40,6 @@ def tools(instance):
         if hasattr(tools,'bound') and hasattr(tools.bound,'tools_by_name'):
             return list(tools.bound.tools_by_name.keys())
 
-
 def update_span_from_llm_response(response):
     meta_dict = {}
     token_usage = None
@@ -46,3 +52,54 @@ def update_span_from_llm_response(response):
             meta_dict.update({"prompt_tokens": token_usage.get('prompt_tokens')})
             meta_dict.update({"total_tokens": token_usage.get('total_tokens')})
     return meta_dict
+
+def extract_tool_response(result):
+    if result is not None and hasattr(result, 'content'):
+        return result.content
+    return None
+
+def get_status(result):
+    if result is not None and hasattr(result, 'status'):
+        return result.status
+    return None
+
+def extract_tool_input(arguments):
+    tool_input = arguments['args'][0]
+    if isinstance(tool_input, str):
+        return [tool_input]
+    else:
+        return list(tool_input.values())
+
+def get_name(instance):
+    return instance.name if hasattr(instance, 'name') else ""
+
+def get_agent_name(instance) -> str:
+    return get_name(instance)
+
+def get_tool_name(instance) -> str:
+    return get_name(instance)
+
+def is_delegation_tool(instance) -> bool:
+    return get_name(instance).startswith(DELEGATION_NAME_PREFIX)
+
+def get_target_agent(instance) -> str:
+    return get_name(instance).replace(DELEGATION_NAME_PREFIX, '', 1)
+
+def is_root_agent_name(instance) -> bool:
+    return get_name(instance) == ROOT_AGENT_NAME
+
+def get_source_agent() -> str:
+    """Get the name of the agent that initiated the request."""
+    from_agent = get_value(LANGGRAPTH_AGENT_NAME_KEY)
+    return from_agent if from_agent is not None else ""
+
+def get_description(instance) -> str:
+    return instance.description if hasattr(instance, 'description') else ""
+
+def get_agent_description(instance) -> str:
+    """Get the description of the agent."""
+    return get_description(instance)
+
+def get_tool_description(instance) -> str:
+    """Get the description of the tool."""
+    return get_description(instance)

monocle_apptrace/instrumentation/metamodel/langgraph/entities/inference.py

@@ -1,24 +1,25 @@
 from monocle_apptrace.instrumentation.metamodel.langgraph import (
     _helper
 )
-INFERENCE = {
-      "type": "agent",
+
+AGENT = {
+      "type": "agentic.invocation",
       "attributes": [
         [
               {
                 "_comment": "agent type",
                 "attribute": "type",
-                "accessor": lambda arguments:'agent.oai'
+                "accessor": lambda arguments:'agent.langgraph'
               },
               {
                 "_comment": "name of the agent",
                 "attribute": "name",
-                "accessor": lambda arguments:arguments['instance'].name
+                "accessor": lambda arguments: _helper.get_agent_name(arguments['instance'])
               },
               {
-                "_comment": "agent tools",
-                "attribute": "tools",
-                "accessor": lambda arguments: _helper.tools(arguments['instance'])
+                "_comment": "agent description",
+                "attribute": "description",
+                "accessor": lambda arguments: _helper.get_agent_description(arguments['instance'])
               }
         ]
       ],
@@ -27,9 +28,9 @@ INFERENCE = {
           "name":"data.input",
           "attributes": [
             {
-                "_comment": "this is LLM input",
+                "_comment": "this is Agent input",
                 "attribute": "query",
-                "accessor": lambda arguments: _helper.extract_input(arguments)
+                "accessor": lambda arguments: _helper.extract_agent_input(arguments)
             }
           ]
         },
@@ -39,18 +40,124 @@ INFERENCE = {
             {
                 "_comment": "this is response from LLM",
                 "attribute": "response",
-                "accessor": lambda arguments: _helper.handle_openai_response(arguments['result'])
+                "accessor": lambda arguments: _helper.extract_agent_response(arguments['result'])
             }
           ]
-       },
-       {
-            "name": "metadata",
-            "attributes": [
-                {
-                    "_comment": "this is metadata usage from LLM",
-                    "accessor": lambda arguments: _helper.update_span_from_llm_response(arguments['result'])
-                }
-            ]
         }
       ]
-    }
+    }
+
+AGENT_REQUEST = {
+      "type": "agentic.request",
+      "attributes": [
+        [
+              {
+                "_comment": "agent type",
+                "attribute": "type",
+                "accessor": lambda arguments:'agent.langgraph'
+              }
+        ],
+      ],
+      "events": [
+        {
+          "name":"data.input",
+          "attributes": [
+            {
+                "_comment": "this is Agent input",
+                "attribute": "input",
+                "accessor": lambda arguments: _helper.extract_agent_input(arguments)
+            }
+          ]
+        },
+        {
+          "name":"data.output",
+          "attributes": [
+            {
+                "_comment": "this is response from LLM",
+                "attribute": "response",
+                "accessor": lambda arguments: _helper.extract_agent_response(arguments['result'])
+            }
+          ]
+        }
+      ]
+}
+
+TOOLS = {
+      "type": "agentic.tool.invocation",
+      "attributes": [
+        [
+              {
+                "_comment": "tool type",
+                "attribute": "type",
+                "accessor": lambda arguments:'tool.langgraph'
+              },
+              {
+                "_comment": "name of the tool",
+                "attribute": "name",
+                "accessor": lambda arguments: _helper.get_tool_name(arguments['instance'])
+              },
+              {
+                  "_comment": "tool description",
+                  "attribute": "description",
+                  "accessor": lambda arguments: _helper.get_tool_description(arguments['instance'])
+              }
+        ],
+        [             
+              {
+                "_comment": "name of the agent",
+                "attribute": "name",
+                "accessor": lambda arguments: _helper.get_source_agent()
+              },          
+              {
+                "_comment": "agent type",
+                "attribute": "type",
+                "accessor": lambda arguments:'agent.langgraph'
+              }
+        ]
+      ],
+      "events": [
+        {
+          "name":"data.input",
+          "attributes": [
+            {
+                "_comment": "this is Tool input",
+                "attribute": "Inputs",
+                "accessor": lambda arguments: _helper.extract_tool_input(arguments) 
+            },
+          ]
+        },
+        {
+          "name":"data.output",
+          "attributes": [
+            {
+                "_comment": "this is response from Tool",
+                "attribute": "response",
+                "accessor": lambda arguments: _helper.extract_tool_response(arguments['result'])
+            }
+          ]
+        }
+      ]
+}
+
+AGENT_DELEGATION = {
+      "type": "agentic.delegation",
+      "attributes": [
+        [
+              {
+                "_comment": "agent type",
+                "attribute": "type",
+                "accessor": lambda arguments:'agent.langgraph'
+              },
+              {
+                "_comment": "name of the agent",
+                "attribute": "from_agent",
+                "accessor": lambda arguments: _helper.get_source_agent()
+              },
+              {
+                "_comment": "name of the agent called",
+                "attribute": "to_agent",
+                "accessor": lambda arguments: _helper.get_target_agent(arguments['instance'])
+              }
+        ]
+      ]
+}

monocle_apptrace/instrumentation/metamodel/langgraph/langgraph_processor.py

@@ -0,0 +1,46 @@
+from opentelemetry.context import set_value, attach, detach
+from monocle_apptrace.instrumentation.common.constants import AGENT_PREFIX_KEY
+from monocle_apptrace.instrumentation.common.span_handler import SpanHandler
+from monocle_apptrace.instrumentation.metamodel.langgraph._helper import (
+   DELEGATION_NAME_PREFIX, get_name, is_root_agent_name, is_delegation_tool, LANGGRAPTH_AGENT_NAME_KEY
+
+)
+from monocle_apptrace.instrumentation.metamodel.langgraph.entities.inference import (
+    AGENT_DELEGATION, AGENT_REQUEST
+)
+
+class LanggraphAgentHandler(SpanHandler):
+    def pre_tracing(self, to_wrap, wrapped, instance, args, kwargs):
+        context = set_value(LANGGRAPTH_AGENT_NAME_KEY, get_name(instance))
+        context = set_value(AGENT_PREFIX_KEY, DELEGATION_NAME_PREFIX, context)
+        return attach(context)
+
+    def post_tracing(self, to_wrap, wrapped, instance, args, kwargs, result, token):
+        if token is not None:
+            detach(token)
+
+    # In multi agent scenarios, the root agent is the one that orchestrates the other agents. LangGraph generates an extra root level invoke()
+    # call on top of the supervisor agent invoke().
+    # This span handler resets the parent invoke call as generic type to avoid duplicate attributes/events in supervisor span and this root span.
+    def hydrate_span(self, to_wrap, wrapped, instance, args, kwargs, result, span, parent_span = None, ex:Exception = None) -> bool:
+        if is_root_agent_name(instance) and "parent.agent.span" in span.attributes:
+            agent_request_wrapper = to_wrap.copy()
+            agent_request_wrapper["output_processor"] = AGENT_REQUEST
+        else:
+            agent_request_wrapper = to_wrap
+            if hasattr(instance, 'name') and parent_span is not None and not SpanHandler.is_root_span(parent_span):
+                parent_span.set_attribute("parent.agent.span", True)
+        return super().hydrate_span(agent_request_wrapper, wrapped, instance, args, kwargs, result, span, parent_span, ex)
+
+class LanggraphToolHandler(SpanHandler):
+    # LangGraph uses an internal tool to initate delegation to other agents. The method is tool invoke() with tool name as `transfer_to_<agent_name>`.
+    # Hence we usea different output processor for tool invoke() to format the span as agentic.delegation.
+    def hydrate_span(self, to_wrap, wrapped, instance, args, kwargs, result, span, parent_span = None, ex:Exception = None) -> bool:
+        if is_delegation_tool(instance):
+            agent_request_wrapper = to_wrap.copy()
+            agent_request_wrapper["output_processor"] = AGENT_DELEGATION
+        else:
+            agent_request_wrapper = to_wrap
+
+        return super().hydrate_span(agent_request_wrapper, wrapped, instance, args, kwargs, result, span, parent_span, ex)
+    

monocle_apptrace/instrumentation/metamodel/langgraph/methods.py

@@ -1,14 +1,40 @@
-from monocle_apptrace.instrumentation.common.wrapper import task_wrapper
+from monocle_apptrace.instrumentation.common.wrapper import task_wrapper, atask_wrapper
 from monocle_apptrace.instrumentation.metamodel.langgraph.entities.inference import (
-    INFERENCE,
+    AGENT,
+    TOOLS,
 )
+
 LANGGRAPH_METHODS = [
     {
         "package": "langgraph.graph.state",
-         "object": "CompiledStateGraph",
-         "method": "invoke",
-         "span_name": "langgraph.graph.invoke",
-         "wrapper_method": task_wrapper,
-         "output_processor": INFERENCE
-    }
-]
+        "object": "CompiledStateGraph",
+        "method": "invoke",
+        "wrapper_method": task_wrapper,
+        "span_handler": "langgraph_agent_handler",
+        "output_processor": AGENT,
+    },
+    {
+        "package": "langgraph.graph.state",
+        "object": "CompiledStateGraph",
+        "method": "ainvoke",
+        "wrapper_method": atask_wrapper,
+        "span_handler": "langgraph_agent_handler",
+        "output_processor": AGENT,
+    },
+    {
+        "package": "langchain_core.tools.base",
+        "object": "BaseTool",
+        "method": "run",
+        "wrapper_method": task_wrapper,
+        "span_handler": "langgraph_tool_handler",
+        "output_processor": TOOLS,
+    },
+    {
+        "package": "langchain_core.tools.base",
+        "object": "BaseTool",
+        "method": "arun",
+        "wrapper_method": atask_wrapper,
+        "span_handler": "langgraph_tool_handler",
+        "output_processor": TOOLS,
+    },
+]