langtrace-python-sdk 3.8.8__tar.gz → 3.8.10__tar.gz

{langtrace_python_sdk-3.8.8 → langtrace_python_sdk-3.8.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langtrace-python-sdk
-Version: 3.8.8
+Version: 3.8.10
 Summary: Python SDK for LangTrace
 Project-URL: Homepage, https://github.com/Scale3-Labs/langtrace-python-sdk
 Author-email: Scale3 Labs <engineering@scale3labs.com>
@@ -23,7 +23,7 @@ Requires-Dist: sentry-sdk>=2.14.0
 Requires-Dist: setuptools
 Requires-Dist: sqlalchemy
 Requires-Dist: tiktoken>=0.1.1
-Requires-Dist: trace-attributes==7.2.0
+Requires-Dist: trace-attributes==7.2.1
 Requires-Dist: transformers>=4.11.3
 Requires-Dist: ujson>=5.10.0
 Provides-Extra: dev

{langtrace_python_sdk-3.8.8 → langtrace_python_sdk-3.8.10}/pyproject.toml

@@ -18,7 +18,7 @@ classifiers = [
   "Operating System :: OS Independent",
 ]
 dependencies = [
-  'trace-attributes==7.2.0',
+  'trace-attributes==7.2.1',
   'opentelemetry-api>=1.25.0',
   'opentelemetry-sdk>=1.25.0',
   'opentelemetry-instrumentation>=0.47b0',

langtrace_python_sdk-3.8.10/src/examples/neo4j_example/__init__.py

@@ -0,0 +1,8 @@
+from .basic import execute_query
+from langtrace_python_sdk import with_langtrace_root_span
+
+
+class Neo4jRunner:
+    @with_langtrace_root_span("Neo4jRunner")
+    def run(self):
+        execute_query()

langtrace_python_sdk-3.8.10/src/examples/neo4j_example/basic.py

@@ -0,0 +1,26 @@
+import os
+from langtrace_python_sdk import langtrace
+from neo4j import GraphDatabase
+
+langtrace.init()
+
+def execute_query():
+    driver = GraphDatabase.driver(
+        os.getenv("NEO4J_URI"), 
+        auth=(os.getenv("NEO4J_USERNAME"), os.getenv("NEO4J_PASSWORD"))
+    )
+
+    records, summary, keys = driver.execute_query(
+        "MATCH (p:Person {age: $age}) RETURN p.name AS name",
+        age=42,
+        database_=os.getenv("NEO4J_DATABASE"),
+    )
+
+    # Loop through results and do something with them
+    for person in records:
+        print(person)
+    # Summary information
+    print("The query `{query}` returned {records_count} records in {time} ms.".format(
+        query=summary.query, records_count=len(records),
+        time=summary.result_available_after,
+    ))

langtrace_python_sdk-3.8.10/src/examples/neo4j_graphrag_example/__init__.py

@@ -0,0 +1,9 @@
+import asyncio
+from .basic import search
+from langtrace_python_sdk import with_langtrace_root_span
+
+
+class Neo4jGraphRagRunner:
+    @with_langtrace_root_span("Neo4jGraphRagRunner")
+    def run(self):
+        asyncio.run(search())

langtrace_python_sdk-3.8.10/src/examples/neo4j_graphrag_example/basic.py

@@ -0,0 +1,52 @@
+import os
+from langtrace_python_sdk import langtrace
+from langtrace_python_sdk.utils.with_root_span import with_langtrace_root_span
+from neo4j import GraphDatabase
+from neo4j_graphrag.generation import GraphRAG
+from neo4j_graphrag.indexes import create_vector_index
+from neo4j_graphrag.llm import OpenAILLM as LLM
+from neo4j_graphrag.embeddings import OpenAIEmbeddings as Embeddings
+from neo4j_graphrag.retrievers import VectorRetriever
+from neo4j_graphrag.experimental.pipeline.kg_builder import SimpleKGPipeline
+
+langtrace.init()
+
+neo4j_driver = GraphDatabase.driver(os.getenv("NEO4J_URI"), auth=(os.getenv("NEO4J_USERNAME"), os.getenv("NEO4J_PASSWORD")))
+
+ex_llm=LLM(
+   model_name="gpt-4o-mini",
+   model_params={
+       "response_format": {"type": "json_object"},
+       "temperature": 0
+   })
+
+embedder = Embeddings()
+
+@with_langtrace_root_span("run_neo_rag")
+async def search():
+    # 1. Build KG and Store in Neo4j Database
+    kg_builder_pdf = SimpleKGPipeline(
+        llm=ex_llm,
+        driver=neo4j_driver,
+        embedder=embedder,
+        from_pdf=True
+    )
+    await kg_builder_pdf.run_async(file_path='src/examples/neo4j_graphrag_example/data/abramov.pdf')
+    
+    create_vector_index(neo4j_driver, name="text_embeddings", label="Chunk",
+                    embedding_property="embedding", dimensions=1536, similarity_fn="cosine")
+
+    # 2. KG Retriever
+    vector_retriever = VectorRetriever(
+        neo4j_driver,
+        index_name="text_embeddings",
+        embedder=embedder
+    )
+
+    # 3. GraphRAG Class
+    llm = LLM(model_name="gpt-4o")
+    rag = GraphRAG(llm=llm, retriever=vector_retriever)
+
+    # 4. Run
+    response = rag.search("What did the author do in college?")
+    print(response.answer)

langtrace_python_sdk-3.8.10/src/langtrace_python_sdk/constants/instrumentation/neo4j.py

@@ -0,0 +1,36 @@
+from langtrace.trace_attributes import Neo4jMethods
+
+APIS = {
+    "RUN": {
+        "METHOD": Neo4jMethods.RUN.value,
+        "OPERATION": "run",
+    },
+    "BEGIN_TRANSACTION": {
+        "METHOD": Neo4jMethods.BEGIN_TRANSACTION.value,
+        "OPERATION": "begin_transaction",
+    },
+    "READ_TRANSACTION": {
+        "METHOD": Neo4jMethods.READ_TRANSACTION.value,
+        "OPERATION": "read_transaction",
+    },
+    "WRITE_TRANSACTION": {
+        "METHOD": Neo4jMethods.WRITE_TRANSACTION.value,
+        "OPERATION": "write_transaction",
+    },
+    "EXECUTE_READ": {
+        "METHOD": Neo4jMethods.EXECUTE_READ.value,
+        "OPERATION": "execute_read",
+    },
+    "EXECUTE_WRITE": {
+        "METHOD": Neo4jMethods.EXECUTE_WRITE.value,
+        "OPERATION": "execute_write",
+    },
+    "EXECUTE_QUERY": {
+        "METHOD": Neo4jMethods.EXECUTE_QUERY.value,
+        "OPERATION": "execute_query",
+    },
+    "TX_RUN": {
+        "METHOD": Neo4jMethods.TX_RUN.value,
+        "OPERATION": "tx_run",
+    },
+}

{langtrace_python_sdk-3.8.8 → langtrace_python_sdk-3.8.10}/src/langtrace_python_sdk/instrumentation/__init__.py

@@ -22,6 +22,7 @@ from .litellm import LiteLLMInstrumentation
 from .llamaindex import LlamaindexInstrumentation
 from .milvus import MilvusInstrumentation
 from .mistral import MistralInstrumentation
+from .neo4j import Neo4jInstrumentation
 from .neo4j_graphrag import Neo4jGraphRAGInstrumentation
 from .ollama import OllamaInstrumentor
 from .openai import OpenAIInstrumentation

{langtrace_python_sdk-3.8.8 → langtrace_python_sdk-3.8.10}/src/langtrace_python_sdk/instrumentation/agno/instrumentation.py

@@ -21,7 +21,7 @@ from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
 from opentelemetry.trace import get_tracer
 from wrapt import wrap_function_wrapper as _W
 
-from .patch import patch_agent, patch_memory
+from .patch import patch_agent, patch_memory, patch_team
 
 
 class AgnoInstrumentation(BaseInstrumentor):
@@ -76,6 +76,27 @@ class AgnoInstrumentation(BaseInstrumentor):
                 patch_memory("AgentMemory.aupdate_summary", version, tracer),
             )
 
+            _W(
+                "agno.team.team",
+                "Team.run",
+                patch_team("Team.run", version, tracer),
+            )
+            _W(
+                "agno.team.team",
+                "Team.arun",
+                patch_team("Team.arun", version, tracer),
+            )
+            _W(
+                "agno.team.team",
+                "Team._run",
+                patch_team("Team._run", version, tracer),
+            )
+            _W(
+                "agno.team.team",
+                "Team._arun",
+                patch_team("Team._arun", version, tracer),
+            )
+
         except Exception:
             pass
 

{langtrace_python_sdk-3.8.8 → langtrace_python_sdk-3.8.10}/src/langtrace_python_sdk/instrumentation/agno/patch.py

@@ -26,9 +26,7 @@ from opentelemetry.trace.status import Status, StatusCode
 
 from langtrace_python_sdk.constants import LANGTRACE_SDK_NAME
 from langtrace_python_sdk.constants.instrumentation.common import (
-    LANGTRACE_ADDITIONAL_SPAN_ATTRIBUTES_KEY,
-    SERVICE_PROVIDERS,
-)
+    LANGTRACE_ADDITIONAL_SPAN_ATTRIBUTES_KEY, SERVICE_PROVIDERS)
 from langtrace_python_sdk.utils import set_span_attribute
 from langtrace_python_sdk.utils.llm import get_span_name, set_span_attributes
 from langtrace_python_sdk.utils.misc import serialize_args, serialize_kwargs
@@ -62,9 +60,9 @@ def patch_agent(operation_name, version, tracer: Tracer):
             try:
                 set_span_attributes(span, attributes)
                 AgnoSpanAttributes(span=span, instance=instance)
-                
+
                 result = wrapped(*args, **kwargs)
-                
+
                 span.set_status(Status(StatusCode.OK))
 
                 if operation_name in ["Agent._run", "Agent._arun", "Agent.run", "Agent.arun", "Agent.print_response"]:
@@ -72,14 +70,14 @@ def patch_agent(operation_name, version, tracer: Tracer):
                         if hasattr(instance, "run_response") and instance.run_response:
                             if hasattr(instance.run_response, "run_id") and instance.run_response.run_id:
                                 set_span_attribute(span, "agno.agent.run_id", instance.run_response.run_id)
-                            
+
                             if hasattr(instance.run_response, "created_at") and instance.run_response.created_at:
                                 set_span_attribute(span, "agno.agent.timestamp", instance.run_response.created_at)
 
                             if hasattr(instance.run_response, "content") and instance.run_response.content:
                                 content = str(instance.run_response.content)
                                 set_span_attribute(span, "agno.agent.response_content", content)
-                            
+
                             # Capture any tools that were used
                             if hasattr(instance.run_response, "tools") and instance.run_response.tools:
                                 tools = instance.run_response.tools
@@ -122,7 +120,7 @@ def patch_agent(operation_name, version, tracer: Tracer):
                                     else:
                                         set_span_attribute(span, "agno.agent.token_usage.input", 
                                                            metrics['input_tokens'])
-                                
+
                                 if 'output_tokens' in metrics:
                                     if isinstance(metrics['output_tokens'], list) and metrics['output_tokens']:
                                         set_span_attribute(span, "agno.agent.token_usage.output", 
@@ -130,7 +128,7 @@ def patch_agent(operation_name, version, tracer: Tracer):
                                     else:
                                         set_span_attribute(span, "agno.agent.token_usage.output", 
                                                            metrics['output_tokens'])
-                                
+
                                 if 'total_tokens' in metrics:
                                     if isinstance(metrics['total_tokens'], list) and metrics['total_tokens']:
                                         set_span_attribute(span, "agno.agent.token_usage.total", 
@@ -140,21 +138,21 @@ def patch_agent(operation_name, version, tracer: Tracer):
                                                            metrics['total_tokens'])
                     except Exception as err:
                         set_span_attribute(span, "agno.agent.run_response_error", str(err))
-                
+
                 return result
-            
+
             except Exception as err:
                 span.record_exception(err)
                 span.set_status(Status(StatusCode.ERROR, str(err)))
                 raise
-    
+
     return traced_method
 
 
 def patch_memory(operation_name, version, tracer: Tracer):
     """
     Apply instrumentation patches to AgentMemory class methods.
-    
+
     Args:
         operation_name: The name of the operation
         version: The version of Agno
@@ -163,7 +161,7 @@ def patch_memory(operation_name, version, tracer: Tracer):
     def traced_method(wrapped, instance, args, kwargs):
         service_provider = SERVICE_PROVIDERS.get("AGNO", "agno")
         extra_attributes = baggage.get_baggage(LANGTRACE_ADDITIONAL_SPAN_ATTRIBUTES_KEY)
-        
+
         # Collect basic span attributes
         span_attributes = {
             "langtrace.sdk.name": "langtrace-python-sdk",
@@ -180,7 +178,7 @@ def patch_memory(operation_name, version, tracer: Tracer):
             inputs["args"] = serialize_args(*args)
         if len(kwargs) > 0:
             inputs["kwargs"] = serialize_kwargs(**kwargs)
-        
+
         span_attributes["agno.memory.inputs"] = json.dumps(inputs)
 
         if hasattr(instance, "messages"):
@@ -199,10 +197,10 @@ def patch_memory(operation_name, version, tracer: Tracer):
             try:
                 # Set attributes
                 set_span_attributes(span, attributes)
-                
+
                 # Execute the wrapped method
                 result = wrapped(*args, **kwargs)
-                
+
                 # Add memory stats after operation
                 if hasattr(instance, "messages"):
                     set_span_attribute(span, "agno.memory.messages_count_after", len(instance.messages))
@@ -210,37 +208,153 @@ def patch_memory(operation_name, version, tracer: Tracer):
                     set_span_attribute(span, "agno.memory.runs_count_after", len(instance.runs))
                 if hasattr(instance, "memories") and instance.memories:
                     set_span_attribute(span, "agno.memory.memories_count_after", len(instance.memories))
-                
+
                 # Record execution time
                 set_span_attribute(span, "agno.memory.execution_time_ms", int((time.time() - start_time) * 1000))
-                
+
                 # Record success status
                 span.set_status(Status(StatusCode.OK))
-                
+
                 # Add result if relevant
                 if result is not None:
                     set_span_attribute(span, "agno.memory.result", str(result))
-                
+
                 return result
-            
+
             except Exception as err:
                 # Record the exception
                 span.record_exception(err)
                 span.set_status(Status(StatusCode.ERROR, str(err)))
                 raise
-    
+
     return traced_method
 
 
+def patch_team(operation_name, version, tracer: Tracer):
+    def traced_method(wrapped, instance, args, kwargs):
+        service_provider = SERVICE_PROVIDERS.get("AGNO", "agno")
+        extra_attributes = baggage.get_baggage(LANGTRACE_ADDITIONAL_SPAN_ATTRIBUTES_KEY)
+
+        span_attributes = {
+            "langtrace.sdk.name": "langtrace-python-sdk",
+            "langtrace.service.name": service_provider,
+            "langtrace.service.type": "framework",
+            "langtrace.service.version": version,
+            "langtrace.version": v(LANGTRACE_SDK_NAME),
+            **(extra_attributes if extra_attributes is not None else {}),
+        }
+
+        inputs = {}
+        if len(args) > 0:
+            inputs["args"] = serialize_args(*args)
+        if len(kwargs) > 0:
+            inputs["kwargs"] = serialize_kwargs(**kwargs)
+        span_attributes["agno.team.inputs"] = json.dumps(inputs)
+        attributes = FrameworkSpanAttributes(**span_attributes)
+
+        with tracer.start_as_current_span(
+            get_span_name(operation_name), kind=SpanKind.CLIENT
+        ) as span:
+            try:
+                set_span_attributes(span, attributes)
+                AgnoSpanAttributes(span=span, instance=instance)
+
+                result = wrapped(*args, **kwargs)
+
+                span.set_status(Status(StatusCode.OK))
+
+                if operation_name in ["Team.run", "Team.arun", "Team._run", "Team._arun"]:
+                    try:
+                        if hasattr(instance, "run_response") and instance.run_response:
+                            if hasattr(instance.run_response, "run_id") and instance.run_response.run_id:
+                                set_span_attribute(span, "agno.team.run_id", instance.run_response.run_id)
+
+                            if hasattr(instance.run_response, "created_at") and instance.run_response.created_at:
+                                set_span_attribute(span, "agno.team.timestamp", instance.run_response.created_at)
+
+                            if hasattr(instance.run_response, "content") and instance.run_response.content:
+                                content = str(instance.run_response.content)
+                                set_span_attribute(span, "agno.team.response_content", content)
+
+                            # Capture any tools that were used
+                            if hasattr(instance.run_response, "tools") and instance.run_response.tools:
+                                tools = instance.run_response.tools
+                                tool_summary = []
+                                for tool in tools:
+                                    if 'tool_name' in tool:
+                                        tool_summary.append(tool['tool_name'])
+                                    elif 'function' in tool and 'name' in tool['function']:
+                                        tool_summary.append(tool['function']['name'])
+                                set_span_attribute(span, "agno.team.tools_used", json.dumps(tool_summary))
+
+                            if hasattr(instance.run_response, "metrics") and instance.run_response.metrics:
+                                metrics = instance.run_response.metrics
+                                for metric_name, metric_values in metrics.items():
+                                    if isinstance(metric_values, list):
+
+                                        if all(isinstance(v, (int, float)) for v in metric_values):
+                                            set_span_attribute(
+                                                span,
+                                                f"agno.team.metrics.{metric_name}",
+                                                sum(metric_values) / len(metric_values) if metric_values else 0
+                                            )
+                                        elif len(metric_values) > 0:
+                                            set_span_attribute(
+                                                span,
+                                                f"agno.team.metrics.{metric_name}",
+                                                str(metric_values[-1])
+                                            )
+                                    else:
+                                        set_span_attribute(
+                                            span,
+                                            f"agno.team.metrics.{metric_name}",
+                                            str(metric_values)
+                                        )
+
+                                if 'input_tokens' in metrics:
+                                    if isinstance(metrics['input_tokens'], list) and metrics['input_tokens']:
+                                        set_span_attribute(span, "agno.team.token_usage.input", 
+                                                           sum(metrics['input_tokens']))
+                                    else:
+                                        set_span_attribute(span, "agno.team.token_usage.input", 
+                                                           metrics['input_tokens'])
+
+                                if 'output_tokens' in metrics:
+                                    if isinstance(metrics['output_tokens'], list) and metrics['output_tokens']:
+                                        set_span_attribute(span, "agno.team.token_usage.output", 
+                                                           sum(metrics['output_tokens']))
+                                    else:
+                                        set_span_attribute(span, "agno.team.token_usage.output", 
+                                                           metrics['output_tokens'])
+
+                                if 'total_tokens' in metrics:
+                                    if isinstance(metrics['total_tokens'], list) and metrics['total_tokens']:
+                                        set_span_attribute(span, "agno.team.token_usage.total", 
+                                                           sum(metrics['total_tokens']))
+                                    else:
+                                        set_span_attribute(span, "agno.team.token_usage.total", 
+                                                           metrics['total_tokens'])
+                    except Exception as err:
+                        set_span_attribute(span, "agno.team.run_response_error", str(err))
+
+                return result
+
+            except Exception as err:
+                span.record_exception(err)
+                span.set_status(Status(StatusCode.ERROR, str(err)))
+                raise
+
+    return traced_method
+
 class AgnoSpanAttributes:
     """
     Helper class to extract and set Agno Agent attributes on spans.
     """
-    
+
     def __init__(self, span: Span, instance: Any) -> None:
         """
         Initialize with a span and Agno instance.
-        
+
         Args:
             span: OpenTelemetry span to update
             instance: Agno Agent instance
@@ -248,14 +362,14 @@ class AgnoSpanAttributes:
         self.span = span
         self.instance = instance
         self.agent_data = {}
-        
+
         self.run()
-    
+
     def run(self) -> None:
         """Process the instance attributes and add them to the span."""
         # Collect basic agent attributes
         self.collect_agent_attributes()
-        
+
         # Add attributes to span
         for key, value in self.agent_data.items():
             if value is not None:
@@ -264,68 +378,68 @@ class AgnoSpanAttributes:
                     f"agno.agent.{key}", 
                     str(value) if not isinstance(value, (int, float, bool)) else value
                 )
-    
+
     def collect_agent_attributes(self) -> None:
         """Collect important attributes from the Agent instance."""
         # Extract basic agent information
         if hasattr(self.instance, "agent_id"):
             self.agent_data["id"] = self.instance.agent_id
-        
+
         if hasattr(self.instance, "name"):
             self.agent_data["name"] = self.instance.name
-        
+
         if hasattr(self.instance, "session_id"):
             self.agent_data["session_id"] = self.instance.session_id
-        
+
         if hasattr(self.instance, "user_id"):
             self.agent_data["user_id"] = self.instance.user_id
-        
+
         if hasattr(self.instance, "run_id"):
             self.agent_data["run_id"] = self.instance.run_id
-        
-                        # Extract model information
+
+        # Extract model information
         if hasattr(self.instance, "model") and self.instance.model:
             model = self.instance.model
             model_info = {}
-            
+
             if hasattr(model, "id"):
                 model_info["id"] = model.id
-            
+
             if hasattr(model, "name"):
                 model_info["name"] = model.name
-                
+
             if hasattr(model, "provider"):
                 model_info["provider"] = model.provider
-                
+
             # Add temperature if available
             if hasattr(model, "temperature") and model.temperature is not None:
                 model_info["temperature"] = model.temperature
-                
+ 
             # Add max_tokens if available
             if hasattr(model, "max_tokens") and model.max_tokens is not None:
                 model_info["max_tokens"] = model.max_tokens
-            
+
             self.agent_data["model"] = json.dumps(model_info)
-        
+
         # Extract tool information
         if hasattr(self.instance, "tools") and self.instance.tools:
             tool_info = []
             for tool in self.instance.tools:
                 tool_data = {}
-                
+
                 # Handle different types of tools
                 if hasattr(tool, "name"):
                     tool_data["name"] = tool.name
-                    
+
                     # Handle DuckDuckGoTools and similar toolkits
                     if hasattr(tool, "functions") and isinstance(tool.functions, dict):
                         tool_data["functions"] = list(tool.functions.keys())
-                        
+
                 elif hasattr(tool, "__name__"):
                     tool_data["name"] = tool.__name__
                 else:
                     tool_data["name"] = str(tool)
-                
+
                 # Add functions if available
                 if not "functions" in tool_data and hasattr(tool, "functions"):
                     if callable(getattr(tool, "functions")):
@@ -336,28 +450,28 @@ class AgnoSpanAttributes:
                                                          for f in tool_functions]
                         except:
                             pass
-                
+
                 tool_info.append(tool_data)
-            
+
             self.agent_data["tools"] = json.dumps(tool_info)
-        
+
         # Extract reasoning settings
         if hasattr(self.instance, "reasoning") and self.instance.reasoning:
             self.agent_data["reasoning_enabled"] = True
-            
+
             if hasattr(self.instance, "reasoning_model") and self.instance.reasoning_model:
                 self.agent_data["reasoning_model"] = str(self.instance.reasoning_model.id)
-            
+
             if hasattr(self.instance, "reasoning_min_steps"):
                 self.agent_data["reasoning_min_steps"] = self.instance.reasoning_min_steps
-                
+
             if hasattr(self.instance, "reasoning_max_steps"):
                 self.agent_data["reasoning_max_steps"] = self.instance.reasoning_max_steps
-        
+
         # Extract knowledge settings
         if hasattr(self.instance, "knowledge") and self.instance.knowledge:
             self.agent_data["knowledge_enabled"] = True
-        
+
         # Extract streaming settings
         if hasattr(self.instance, "stream"):
-            self.agent_data["stream"] = self.instance.stream
+            self.agent_data["stream"] = self.instance.stream

{langtrace_python_sdk-3.8.8 → langtrace_python_sdk-3.8.10}/src/langtrace_python_sdk/instrumentation/google_genai/instrumentation.py

@@ -8,7 +8,7 @@ from .patch import patch_google_genai, patch_google_genai_streaming
 
 class GoogleGenaiInstrumentation(BaseInstrumentor):
     def instrumentation_dependencies(self) -> Collection[str]:
-        return ["google-genai >= 0.1.0", "google-generativeai < 1.0.0"]
+        return ["google-genai >= 0.1.0"]
 
     def _instrument(self, **kwargs):
         trace_provider = kwargs.get("tracer_provider")

langtrace_python_sdk-3.8.10/src/langtrace_python_sdk/instrumentation/neo4j/__init__.py

@@ -0,0 +1,3 @@
+from .instrumentation import Neo4jInstrumentation
+
+__all__ = ["Neo4jInstrumentation"]