quraite 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

quraite/adapters/__init__.py

@@ -8,9 +8,9 @@ if TYPE_CHECKING:
     from quraite.adapters.bedrock_agents_adapter import BedrockAgentsAdapter
     from quraite.adapters.flowise_adapter import FlowiseAdapter
     from quraite.adapters.google_adk_adapter import GoogleADKAdapter
+    from quraite.adapters.langchain_adapter import LangchainAdapter
+    from quraite.adapters.langchain_server_adapter import LangchainServerAdapter
     from quraite.adapters.langflow_adapter import LangflowAdapter
-    from quraite.adapters.langgraph_adapter import LanggraphAdapter
-    from quraite.adapters.langgraph_server_adapter import LanggraphServerAdapter
     from quraite.adapters.n8n_adapter import N8nAdapter
     from quraite.adapters.openai_agents_adapter import OpenaiAgentsAdapter
     from quraite.adapters.pydantic_ai_adapter import PydanticAIAdapter
@@ -25,8 +25,8 @@ __all__ = [
     "FlowiseAdapter",
     "GoogleADKAdapter",
     "LangflowAdapter",
-    "LanggraphAdapter",
-    "LanggraphServerAdapter",
+    "LangchainAdapter",
+    "LangchainServerAdapter",
     "N8nAdapter",
     "OpenaiAgentsAdapter",
     "PydanticAIAdapter",
@@ -76,24 +76,24 @@ def __getattr__(name: str):
 
         return LangflowAdapter
 
-    elif name == "LanggraphAdapter":
+    elif name == "LangchainAdapter":
         try:
-            from quraite.adapters.langgraph_adapter import LanggraphAdapter
+            from quraite.adapters.langchain_adapter import LangchainAdapter
 
-            return LanggraphAdapter
+            return LangchainAdapter
         except ImportError as e:
             raise ImportError(
-                f"Failed to import {name}. Please install the 'langgraph' optional dependency: pip install 'quraite[langgraph]'"
+                f"Failed to import {name}. Please install the 'langchain' optional dependency: pip install 'quraite[langchain]'"
             ) from e
 
-    elif name == "LanggraphServerAdapter":
+    elif name == "LangchainServerAdapter":
         try:
-            from quraite.adapters.langgraph_server_adapter import LanggraphServerAdapter
+            from quraite.adapters.langchain_server_adapter import LangchainServerAdapter
 
-            return LanggraphServerAdapter
+            return LangchainServerAdapter
         except ImportError as e:
             raise ImportError(
-                f"Failed to import {name}. Please install the 'langgraph' optional dependency: pip install 'quraite[langgraph]'"
+                f"Failed to import {name}. Please install the 'langchain' optional dependency: pip install 'quraite[langchain]'"
             ) from e
 
     elif name == "N8nAdapter":

quraite/adapters/agno_adapter.py

@@ -1,4 +1,3 @@
-import uuid
 from typing import List, Union
 
 from agno.agent import Agent
@@ -9,7 +8,7 @@ from quraite.adapters.base import BaseAdapter
 from quraite.logger import get_logger
 from quraite.schema.message import AgentMessage
 from quraite.schema.response import AgentInvocationResponse
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX, Framework
+from quraite.tracing.constants import Framework
 from quraite.tracing.trace import AgentSpan, AgentTrace
 
 logger = get_logger(__name__)
@@ -122,27 +121,26 @@ class AgnoAdapter(BaseAdapter):
         session_id: str,
     ) -> AgentInvocationResponse:
         """Execute ainvoke with tracing enabled."""
-        adapter_trace_id = f"{QURAITE_ADAPTER_TRACE_PREFIX}-{uuid.uuid4()}"
-        logger.debug(
-            "Starting traced invocation (trace_id=%s, session_id=%s)",
-            adapter_trace_id,
-            session_id,
-        )
-
-        with self.tracer.start_as_current_span(name=adapter_trace_id):
+        with self.tracer.start_as_current_span("agno_invocation") as span:
+            trace_id = span.get_span_context().trace_id
+            logger.debug(
+                "Starting traced invocation (session_id=%s) with trace_id=%s",
+                session_id,
+                trace_id,
+            )
             # Run the agent/team
             await self.agent.arun(agent_input, session_id=session_id)
 
         # Get trace spans
-        trace_readable_spans = self.quraite_span_exporter.get_trace_by_testcase(
-            adapter_trace_id
+        trace_readable_spans = self.quraite_span_exporter.get_spans_by_trace_id(
+            trace_id
         )
 
         if trace_readable_spans:
             logger.info(
                 "Retrieved %d spans for trace_id=%s",
                 len(trace_readable_spans),
-                adapter_trace_id,
+                trace_id,
             )
             agent_trace = AgentTrace(
                 spans=[
@@ -151,7 +149,7 @@ class AgnoAdapter(BaseAdapter):
                 ],
             )
         else:
-            logger.warning("No spans found for trace_id=%s", adapter_trace_id)
+            logger.warning("No spans found for trace_id=%s", trace_id)
 
         return AgentInvocationResponse(
             agent_trace=agent_trace,

quraite/adapters/base.py

@@ -1,7 +1,7 @@
 from abc import ABC, abstractmethod
 from typing import Any, List, Optional, Union
 
-from opentelemetry.trace import TracerProvider
+from opentelemetry.trace import Tracer, TracerProvider
 
 from quraite.schema.message import AgentMessage, AssistantMessage, MessageContentText
 from quraite.schema.response import AgentInvocationResponse
@@ -22,7 +22,7 @@ class BaseAdapter(ABC):
     """
 
     tracer_provider: Optional[TracerProvider] = None
-    tracer: Optional[Any] = None
+    tracer: Optional[Tracer] = None
     quraite_span_exporter: Optional[QuraiteInMemorySpanExporter] = None
 
     def _init_tracing(

quraite/adapters/google_adk_adapter.py

@@ -13,7 +13,7 @@ from quraite.adapters.base import BaseAdapter
 from quraite.logger import get_logger
 from quraite.schema.message import AgentMessage
 from quraite.schema.response import AgentInvocationResponse
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX, Framework
+from quraite.tracing.constants import Framework
 from quraite.tracing.trace import AgentSpan, AgentTrace
 
 logger = get_logger(__name__)
@@ -141,14 +141,18 @@ class GoogleADKAdapter(BaseAdapter):
         session_id: str,
     ) -> AgentInvocationResponse:
         """Execute ainvoke with tracing enabled."""
-        adapter_trace_id = f"{QURAITE_ADAPTER_TRACE_PREFIX}-{uuid.uuid4()}"
         logger.debug(
-            "Starting Google ADK traced invocation (trace_id=%s, session_id=%s)",
-            adapter_trace_id,
+            "Starting Google ADK traced invocation (session_id=%s)",
             session_id,
         )
 
-        with self.tracer.start_as_current_span(name=adapter_trace_id):
+        with self.tracer.start_as_current_span("google_adk_invocation") as span:
+            trace_id = span.get_span_context().trace_id
+            logger.debug(
+                "Starting Google ADK traced invocation (trace_id=%s, session_id=%s)",
+                trace_id,
+                session_id,
+            )
             # Create session if it doesn't exist
             try:
                 await self.session_service.create_session(
@@ -180,8 +184,8 @@ class GoogleADKAdapter(BaseAdapter):
                 pass  # Just consume events, tracing handles capture
 
         # Get trace spans
-        trace_readable_spans = self.quraite_span_exporter.get_trace_by_testcase(
-            adapter_trace_id
+        trace_readable_spans = self.quraite_span_exporter.get_spans_by_trace_id(
+            trace_id
         )
 
         if trace_readable_spans:
@@ -194,12 +198,10 @@ class GoogleADKAdapter(BaseAdapter):
             logger.info(
                 "Google ADK trace collected %d spans for trace_id=%s",
                 len(trace_readable_spans),
-                adapter_trace_id,
+                trace_id,
             )
         else:
-            logger.warning(
-                "No spans exported for Google ADK trace_id=%s", adapter_trace_id
-            )
+            logger.warning("No spans exported for Google ADK trace_id=%s", trace_id)
 
         return AgentInvocationResponse(
             agent_trace=agent_trace,

quraite/adapters/http_adapter.py

@@ -239,10 +239,14 @@ if __name__ == "__main__":
 
         try:
             response = await adapter.ainvoke(
-                input=[UserMessage(content=[MessageContentText(text="What is 1 + 1")])],
+                input=[
+                    UserMessage(
+                        content=[MessageContentText(text="What is 34354 - 54?")]
+                    )
+                ],
                 session_id="test",
             )
-            print(response)
+            print(response.agent_trajectory)
         except httpx.HTTPStatusError as e:
             print(json.loads(e.response.text)["detail"])
         except Exception as e:

quraite/adapters/{langgraph_adapter.py → langchain_adapter.py}

@@ -1,5 +1,4 @@
 import json
-import uuid
 from typing import Optional
 
 from langchain_core.messages import AIMessage, HumanMessage, SystemMessage, ToolMessage
@@ -14,7 +13,7 @@ from quraite.schema.message import ToolCall
 from quraite.schema.message import ToolMessage as QuraiteToolMessage
 from quraite.schema.message import UserMessage
 from quraite.schema.response import AgentInvocationResponse
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX, Framework
+from quraite.tracing.constants import Framework
 from quraite.tracing.trace import AgentSpan, AgentTrace
 
 LangchainMessage = HumanMessage | SystemMessage | AIMessage | ToolMessage
@@ -22,12 +21,12 @@ LangchainMessage = HumanMessage | SystemMessage | AIMessage | ToolMessage
 logger = get_logger(__name__)
 
 
-class LanggraphAdapter(BaseAdapter):
+class LangchainAdapter(BaseAdapter):
     """
-    LangGraph adapter wrapper that converts any LangGraph agent
+    LangChain adapter wrapper that converts any LangChain agent
     to a standardized callable interface (invoke) and converts the output to List[AgentMessage].
 
-    This class wraps any LangGraph CompiledGraph and provides:
+    This class wraps any LangChain CompiledGraph and provides:
     - Synchronous invocation via invoke()
     - Asynchronous invocation via ainvoke()
     - Automatic conversion to List[AgentMessage] format
@@ -36,22 +35,22 @@ class LanggraphAdapter(BaseAdapter):
     def __init__(
         self,
         agent_graph: CompiledStateGraph,
-        agent_name: str = "LangGraph Agent",
+        agent_name: str = "LangChain Agent",
         tracer_provider: Optional[TracerProvider] = None,
     ):
         """
-        Initialize with a pre-configured LangGraph agent
+        Initialize with a pre-configured LangChain agent
 
         Args:
-            agent_graph: Any CompiledGraph from LangGraph (must have invoke/ainvoke methods)
+            agent_graph: Any CompiledGraph from LangChain (must have invoke/ainvoke methods)
             agent_name: Name of the agent for trajectory metadata
         """
-        logger.debug("Initializing LanggraphAdapter with agent_name=%s", agent_name)
+        logger.debug("Initializing LangchainAdapter with agent_name=%s", agent_name)
         self.agent_graph = agent_graph
         self.agent_name = agent_name
         self._init_tracing(tracer_provider, required=False)
         logger.info(
-            "LanggraphAdapter initialized successfully (tracing_enabled=%s)",
+            "LangchainAdapter initialized successfully (tracing_enabled=%s)",
             bool(tracer_provider),
         )
 
@@ -59,7 +58,7 @@ class LanggraphAdapter(BaseAdapter):
         self, input: list[AgentMessage]
     ) -> dict[str, list[HumanMessage]]:
         """
-        Prepare input for LangGraph agent from List[Message].
+        Prepare input for LangChain agent from List[Message].
 
         Args:
             input: List[AgentMessage] containing user_message
@@ -201,7 +200,7 @@ class LanggraphAdapter(BaseAdapter):
         session_id: str | None,
     ) -> AgentInvocationResponse:
         """
-        Asynchronous invocation method - invokes the LangGraph agent and converts the output to List[AgentMessage]
+        Asynchronous invocation method - invokes the LangChain agent and converts the output to List[AgentMessage]
 
         Args:
             input: List[AgentMessage] containing user_message
@@ -238,14 +237,16 @@ class LanggraphAdapter(BaseAdapter):
         config: dict,
     ) -> AgentInvocationResponse:
         """Execute ainvoke with tracing enabled."""
-        adapter_trace_id = f"{QURAITE_ADAPTER_TRACE_PREFIX}-{uuid.uuid4()}"
-        logger.debug("Starting traced invocation (trace_id=%s)", adapter_trace_id)
-
-        with self.tracer.start_as_current_span(name=adapter_trace_id):
-            result = await self.agent_graph.ainvoke(agent_input, config=config)
+        with self.tracer.start_as_current_span("langchain_invocation") as span:
+            trace_id = span.get_span_context().trace_id
+            logger.debug(
+                "Starting LangChain traced invocation (trace_id=%s)",
+                trace_id,
+            )
+            _ = await self.agent_graph.ainvoke(agent_input, config=config)
 
-        trace_readable_spans = self.quraite_span_exporter.get_trace_by_testcase(
-            adapter_trace_id
+        trace_readable_spans = self.quraite_span_exporter.get_spans_by_trace_id(
+            trace_id
         )
 
         if trace_readable_spans:
@@ -257,7 +258,7 @@ class LanggraphAdapter(BaseAdapter):
                 ]
             )
 
-            trajectory = agent_trace.to_agent_trajectory(framework=Framework.LANGGRAPH)
+            trajectory = agent_trace.to_agent_trajectory(framework=Framework.LANGCHAIN)
             logger.debug("Generated trajectory with %d messages", len(trajectory))
 
             return AgentInvocationResponse(
@@ -265,7 +266,7 @@ class LanggraphAdapter(BaseAdapter):
                 agent_trajectory=trajectory,
             )
 
-        logger.warning("No trace spans found for trace_id=%s", adapter_trace_id)
+        logger.warning("No trace spans found for trace_id=%s", trace_id)
         return AgentInvocationResponse()
 
     async def _ainvoke_without_tracing(

quraite/adapters/{langgraph_server_adapter.py → langchain_server_adapter.py}

@@ -22,11 +22,11 @@ LangchainMessage = Annotated[
 logger = get_logger(__name__)
 
 
-class LanggraphServerAdapter(BaseAdapter):
-    """Remote LangGraph server adapter based on langgraph-sdk.
+class LangchainServerAdapter(BaseAdapter):
+    """Remote LangChain server adapter based on langgraph-sdk.
 
     Args:
-        base_url: The base URL of the LangGraph server
+        base_url: The base URL of the LangChain server
         assistant_id: The ID of the assistant to invoke
         **kwargs: Additional keyword arguments passed directly to
                  langgraph_sdk.get_client() and get_sync_client().
@@ -49,7 +49,7 @@ class LanggraphServerAdapter(BaseAdapter):
         self.graph_name = graph_name
 
         logger.debug(
-            "Initializing LanggraphServerAdapter (base_url=%s, assistant_id=%s, graph_name=%s)",
+            "Initializing LangchainServerAdapter (base_url=%s, assistant_id=%s, graph_name=%s)",
             base_url,
             assistant_id,
             graph_name,
@@ -73,17 +73,17 @@ class LanggraphServerAdapter(BaseAdapter):
                 )
         except Exception as exc:
             raise RuntimeError(
-                f"Failed to initialize LangGraph RemoteGraph for {self.base_url}: {exc}"
+                f"Failed to initialize LangChain RemoteGraph for {self.base_url}: {exc}"
             )
         logger.info(
-            "LanggraphServerAdapter initialized (assistant_id=%s, graph_name=%s)",
+            "LangchainServerAdapter initialized (assistant_id=%s, graph_name=%s)",
             self.assistant_id,
             self.graph_name,
         )
 
     def _prepare_input(self, input: List[AgentMessage]) -> Any:
         """
-        Prepare input for LangGraph agent from List[AgentMessage].
+        Prepare input for LangChain agent from List[AgentMessage].
 
         Args:
             input: List[AgentMessage] containing user_message
@@ -91,15 +91,15 @@ class LanggraphServerAdapter(BaseAdapter):
         Returns:
             Dict with messages list containing user_message
         """
-        logger.debug("Preparing Langgraph server input from %d messages", len(input))
+        logger.debug("Preparing Langchain server input from %d messages", len(input))
         if not input or input[-1].role != "user":
-            logger.error("Langgraph server input missing user message")
+            logger.error("Langchain server input missing user message")
             raise ValueError("No user message found in the input")
 
         last_user_message = input[-1]
         # Check if content list is not empty and has text
         if not last_user_message.content:
-            logger.error("Langgraph server user message missing content")
+            logger.error("Langchain server user message missing content")
             raise ValueError("User message has no content")
 
         # Find the first text content item
@@ -110,11 +110,11 @@ class LanggraphServerAdapter(BaseAdapter):
                 break
 
         if not text_content:
-            logger.error("Langgraph server user message missing text content")
+            logger.error("Langchain server user message missing text content")
             raise ValueError("No text content found in user message")
 
         logger.debug(
-            "Prepared Langgraph server input (text_length=%d)", len(text_content)
+            "Prepared Langchain server input (text_length=%d)", len(text_content)
         )
         return {"messages": [HumanMessage(content=text_content).model_dump()]}
 
@@ -123,7 +123,7 @@ class LanggraphServerAdapter(BaseAdapter):
         messages: List[dict],
     ) -> List[AgentMessage]:
         logger.debug(
-            "Converting %d Langgraph server messages to quraite format", len(messages)
+            "Converting %d Langchain server messages to quraite format", len(messages)
         )
         converted_messages: List[AgentMessage] = []
 
@@ -201,7 +201,7 @@ class LanggraphServerAdapter(BaseAdapter):
                 continue
 
         logger.info(
-            "Langgraph server message conversion produced %d messages",
+            "Langchain server message conversion produced %d messages",
             len(converted_messages),
         )
         return converted_messages
@@ -209,7 +209,7 @@ class LanggraphServerAdapter(BaseAdapter):
     async def ainvoke(
         self,
         input: List[AgentMessage],
-        session_id: Annotated[Union[str, None], "Thread ID used by LangGraph API"],
+        session_id: Annotated[Union[str, None], "Thread ID used by LangChain API"],
     ) -> AgentInvocationResponse:
         agent_messages = []
         agent_input = self._prepare_input(input)
@@ -219,19 +219,19 @@ class LanggraphServerAdapter(BaseAdapter):
             config = {}
 
         try:
-            logger.info("Langgraph server ainvoke called (session_id=%s)", session_id)
+            logger.info("Langchain server ainvoke called (session_id=%s)", session_id)
             async for event in self.remote_graph.astream(agent_input, config=config):
                 for _, result in event.items():
                     if result.get("messages"):
                         logger.debug(
-                            "Langgraph server received %d messages from stream chunk",
+                            "Langchain server received %d messages from stream chunk",
                             len(result.get("messages")),
                         )
                         agent_messages += result.get("messages")
 
         except Exception as e:
-            logger.exception("Error invoking Langgraph remote graph")
-            raise RuntimeError(f"Error invoking LangGraph agent: {e}") from e
+            logger.exception("Error invoking Langchain remote graph")
+            raise RuntimeError(f"Error invoking LangChain agent: {e}") from e
 
         try:
             # Convert to List[AgentMessage]
@@ -239,7 +239,7 @@ class LanggraphServerAdapter(BaseAdapter):
                 agent_messages
             )
             logger.info(
-                "Langgraph server ainvoke produced %d trajectory messages",
+                "Langchain server ainvoke produced %d trajectory messages",
                 len(agent_trajectory),
             )
 
@@ -248,5 +248,5 @@ class LanggraphServerAdapter(BaseAdapter):
             )
 
         except ValueError:
-            logger.exception("Langgraph server conversion to AgentMessage failed")
+            logger.exception("Langchain server conversion to AgentMessage failed")
             return AgentInvocationResponse()

quraite/adapters/openai_agents_adapter.py

@@ -1,5 +1,4 @@
 import json
-import uuid
 from typing import Dict, List, Optional, Union
 
 from agents import (
@@ -27,7 +26,7 @@ from quraite.schema.message import (
     ToolMessage,
 )
 from quraite.schema.response import AgentInvocationResponse
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX, Framework
+from quraite.tracing.constants import Framework
 from quraite.tracing.trace import AgentSpan, AgentTrace
 
 logger = get_logger(__name__)
@@ -200,22 +199,21 @@ class OpenaiAgentsAdapter(BaseAdapter):
         session: Session,
     ) -> AgentInvocationResponse:
         """Execute ainvoke with tracing enabled."""
-        adapter_trace_id = f"{QURAITE_ADAPTER_TRACE_PREFIX}-{uuid.uuid4()}"
-        logger.debug(
-            "Starting OpenAI traced invocation (trace_id=%s, session_id=%s)",
-            adapter_trace_id,
-            session.session_id if session else None,
-        )
-
-        with self.tracer.start_as_current_span(name=adapter_trace_id):
+        with self.tracer.start_as_current_span("openai_invocation") as span:
+            trace_id = span.get_span_context().trace_id
+            logger.debug(
+                "Starting OpenAI traced invocation (trace_id=%s session_id=%s)",
+                trace_id,
+                session.session_id if session else None,
+            )
             await Runner.run(
                 self.agent,
                 input=agent_input,
                 session=session,
             )
 
-        trace_readable_spans = self.quraite_span_exporter.get_trace_by_testcase(
-            adapter_trace_id
+        trace_readable_spans = self.quraite_span_exporter.get_spans_by_trace_id(
+            trace_id
         )
 
         if trace_readable_spans:
@@ -228,12 +226,12 @@ class OpenaiAgentsAdapter(BaseAdapter):
             logger.info(
                 "OpenAI trace collected %d spans for trace_id=%s",
                 len(trace_readable_spans),
-                adapter_trace_id,
+                trace_id,
             )
         else:
             logger.warning(
                 "No spans exported for OpenAI trace_id=%s",
-                adapter_trace_id,
+                trace_id,
             )
 
         return AgentInvocationResponse(

quraite/adapters/pydantic_ai_adapter.py

@@ -21,7 +21,7 @@ from quraite.schema.message import (
     ToolMessage,
 )
 from quraite.schema.response import AgentInvocationResponse
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX, Framework
+from quraite.tracing.constants import Framework
 from quraite.tracing.trace import AgentSpan, AgentTrace
 
 logger = get_logger(__name__)
@@ -228,16 +228,13 @@ class PydanticAIAdapter(BaseAdapter):
         message_history: Any | None,
     ) -> AgentInvocationResponse:
         """Execute ainvoke with tracing enabled."""
-        from uuid import uuid4
-
-        adapter_trace_id = f"{QURAITE_ADAPTER_TRACE_PREFIX}-{uuid4()}"
-        logger.debug(
-            "Starting Pydantic AI traced invocation (trace_id=%s, session_id=%s)",
-            adapter_trace_id,
-            session_id,
-        )
-
-        with self.tracer.start_as_current_span(name=adapter_trace_id):
+        with self.tracer.start_as_current_span("pydantic_invocation") as span:
+            trace_id = span.get_span_context().trace_id
+            logger.debug(
+                "Starting Pydantic AI traced invocation (trace_id=%s session_id=%s)",
+                trace_id,
+                session_id,
+            )
             # Run the agent asynchronously with message history for context
             if message_history:
                 result = await self.agent.run(
@@ -250,8 +247,8 @@ class PydanticAIAdapter(BaseAdapter):
         # Store the complete updated message history for this session
         self._sessions[session_id] = result.all_messages()
 
-        trace_readable_spans = self.quraite_span_exporter.get_trace_by_testcase(
-            adapter_trace_id
+        trace_readable_spans = self.quraite_span_exporter.get_spans_by_trace_id(
+            trace_id
         )
 
         if trace_readable_spans:
@@ -264,12 +261,10 @@ class PydanticAIAdapter(BaseAdapter):
             logger.info(
                 "Pydantic AI trace collected %d spans for trace_id=%s",
                 len(trace_readable_spans),
-                adapter_trace_id,
+                trace_id,
             )
         else:
-            logger.warning(
-                "No spans exported for Pydantic AI trace_id=%s", adapter_trace_id
-            )
+            logger.warning("No spans exported for Pydantic AI trace_id=%s", trace_id)
 
         return AgentInvocationResponse(
             agent_trace=agent_trace,

quraite/adapters/smolagents_adapter.py

@@ -1,5 +1,4 @@
 import asyncio
-import uuid
 from typing import List, Optional
 
 from opentelemetry.trace import TracerProvider
@@ -9,7 +8,7 @@ from quraite.adapters.base import BaseAdapter
 from quraite.logger import get_logger
 from quraite.schema.message import AgentMessage
 from quraite.schema.response import AgentInvocationResponse
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX, Framework
+from quraite.tracing.constants import Framework
 from quraite.tracing.trace import AgentSpan, AgentTrace
 
 logger = get_logger(__name__)
@@ -114,24 +113,23 @@ class SmolagentsAdapter(BaseAdapter):
 
     async def _ainvoke_with_tracing(self, agent_input: str) -> AgentInvocationResponse:
         """Execute ainvoke with tracing enabled."""
-        adapter_trace_id = f"{QURAITE_ADAPTER_TRACE_PREFIX}-{uuid.uuid4()}"
-        logger.debug(
-            "Starting Smolagents traced invocation (trace_id=%s)", adapter_trace_id
-        )
-
-        with self.tracer.start_as_current_span(name=adapter_trace_id):
+        with self.tracer.start_as_current_span("smolagents_invocation") as span:
+            trace_id = span.get_span_context().trace_id
+            logger.debug(
+                "Starting Smolagents traced invocation (trace_id=%s)", trace_id
+            )
             # Run the agent synchronously inside a thread to avoid blocking
             await asyncio.to_thread(self.agent.run, agent_input)
 
-        trace_readable_spans = self.quraite_span_exporter.get_trace_by_testcase(
-            adapter_trace_id
+        trace_readable_spans = self.quraite_span_exporter.get_spans_by_trace_id(
+            trace_id
         )
 
         if trace_readable_spans:
             logger.info(
                 "Smolagents trace collected %d spans for trace_id=%s",
                 len(trace_readable_spans),
-                adapter_trace_id,
+                trace_id,
             )
             agent_trace = AgentTrace(
                 spans=[
@@ -140,9 +138,7 @@ class SmolagentsAdapter(BaseAdapter):
                 ],
             )
         else:
-            logger.warning(
-                "No spans captured for Smolagents trace_id=%s", adapter_trace_id
-            )
+            logger.warning("No spans captured for Smolagents trace_id=%s", trace_id)
 
         return AgentInvocationResponse(
             agent_trace=agent_trace,

quraite/serve/local_agent.py

@@ -48,9 +48,9 @@ class LocalAgentServer:
     Usage:
         ```python
         from quraite.serve.local_agent_server import LocalAgentServer
-        from quraite.adapters import LangGraphAdapter
+        from quraite.adapters import LangChainAdapter
 
-        sdk = LocalAgentServer(wrapped_agent=LangGraphAdapter(agent_graph=agent_graph))
+        sdk = LocalAgentServer(wrapped_agent=LangChainAdapter(agent_graph=agent_graph))
         sdk.start(host="0.0.0.0", port=8000, reload=False)
         ```
     """
@@ -227,15 +227,16 @@ class LocalAgentServer:
 
             logger.info("Local Agent Server started successfully")
             if self.public_url:
-                logger.info("Agent publicly available at %s", self.public_url)
+                path = "/v1/agents/completions"
+                logger.info(f"Agent publicly available at {self.public_url}{path}")
+
                 if not self.agent_id or not self._quraite_endpoint:
                     logger.info(
-                        "Add this URL to your agent in the Quraite platform: %s",
-                        self.agent_url,
+                        f"Add this URL to your agent in the Quraite platform: {self.public_url}{path}"
                     )
             else:
                 logger.info(
-                    "Agent running locally. Use a tunnel option to make it publicly available."
+                    f"Agent running locally and available at {self.agent_url}{path}. Use a tunnel option to make it publicly available."
                 )
             yield
 

quraite/tracing/__init__.py

@@ -12,6 +12,7 @@ __all__ = [
     "CostInfo",
     "TokenInfo",
     "Framework",
+    "Tool",
     "ToolCallInfo",
     "get_tool_extractor",
     "QuraiteInMemorySpanExporter",

quraite/tracing/constants.py

@@ -1,15 +1,14 @@
 from enum import Enum
 
-QURAITE_ADAPTER_TRACE_PREFIX = "quraite-adapter"
-
 QURAITE_TRACER_NAME = "quraite.instrumentation"
 
 
 class Framework(str, Enum):
     """Supported agent frameworks."""
 
-    PYDANTIC = "pydantic"
-    LANGGRAPH = "langgraph"
+    DEFAULT = "default"
+    PYDANTIC_AI = "pydantic_ai"
+    LANGCHAIN = "langchain"
     GOOGLE_ADK = "google_adk"
     OPENAI_AGENTS = "openai_agents"
     AGNO = "agno"

quraite/tracing/span_exporter.py

@@ -12,20 +12,9 @@ class QuraiteInMemorySpanExporter(SpanExporter):
     def __init__(self) -> None:
         # self.spans: typing.List[ReadableSpan] = []
         self.traces: typing.Dict[int, typing.List[ReadableSpan]] = defaultdict(list)
-        self.testcase_to_trace: typing.Dict[str, int] = {}
-
         self._stopped = False
         self._lock = threading.Lock()
 
-    def handle_testcase_trace(self, span: ReadableSpan) -> None:
-        """Handle a testcase trace."""
-        # print(f"🟢 testcase trace received: {span.name}")
-        # print(f"🟢 Span: {span.context}")
-        formatted_trace_id = format(span.context.trace_id, "032x")[:8]
-        # print(f"🟢 testcase formatted trace id: {formatted_trace_id}")
-        self.traces[formatted_trace_id] = []
-        self.testcase_to_trace[span.name] = formatted_trace_id
-
     def export(self, spans: typing.Sequence[ReadableSpan]) -> SpanExportResult:
         """Stores a list of spans in memory."""
         if self._stopped:
@@ -33,13 +22,16 @@ class QuraiteInMemorySpanExporter(SpanExporter):
 
         with self._lock:
             for span in spans:
-                formatted_trace_id = format(span.context.trace_id, "032x")[:8]
                 # print(f"🟢 span formatted context trace id: {formatted_trace_id}")
-                self.traces[formatted_trace_id].append(span)
+                self.traces[span.context.trace_id].append(span)
                 # self.spans.append(span)
 
         return SpanExportResult.SUCCESS
 
+    def get_spans_by_trace_id(self, trace_id: int) -> typing.List[ReadableSpan]:
+        """Get all spans for a specific trace ID"""
+        return self.traces.get(trace_id, [])
+
     def shutdown(self) -> None:
         """Shut downs the exporter.
 
@@ -55,11 +47,6 @@ class QuraiteInMemorySpanExporter(SpanExporter):
         """Get all spans grouped by trace ID"""
         return dict(self.traces)
 
-    def get_trace_by_testcase(self, testcase_name: str) -> typing.List[ReadableSpan]:
-        """Get all spans for a specific testcase"""
-        with self._lock:
-            return self.traces.get(self.testcase_to_trace.get(testcase_name, None), [])
-
     def get_trace(self, trace_id: int) -> typing.List[ReadableSpan]:
         """Get all spans for a specific trace"""
         return self.traces.get(trace_id, [])
@@ -75,7 +62,6 @@ class QuraiteInMemorySpanExporter(SpanExporter):
         for trace_id, spans in self.traces.items():
             print(f"Trace ID: {trace_id}...")
             print(f"Spans in trace: {len(spans)}")
-        print(f"Total Testcases: {self.testcase_to_trace}")
         print(f"TraceIDs: {self.traces.keys()}")
         print(f"{'='*60}\n")
 

quraite/tracing/span_processor.py

@@ -10,7 +10,6 @@ from opentelemetry.context import (
 from opentelemetry.sdk.trace.export import ReadableSpan, SpanExporter, SpanProcessor
 from opentelemetry.trace import Span, logger
 
-from quraite.tracing.constants import QURAITE_ADAPTER_TRACE_PREFIX
 from quraite.tracing.span_exporter import QuraiteInMemorySpanExporter
 
 
@@ -27,8 +26,7 @@ class QuraiteSimpleSpanProcessor(SpanProcessor):
     def on_start(
         self, span: Span, parent_context: typing.Optional[Context] = None
     ) -> None:
-        if QURAITE_ADAPTER_TRACE_PREFIX in span.name:
-            self.span_exporter.handle_testcase_trace(span)
+        pass
 
     def on_end(self, span: ReadableSpan) -> None:
         if not span.context.trace_flags.sampled:

quraite/tracing/tool_extractors.py

@@ -2,12 +2,14 @@
 Framework-specific tool extractors for converting span attributes to standardized tool call information.
 
 These extractors handle the varying attribute structures across different agent frameworks
-(pydantic, langgraph, adk, openai_agents, agno, smolagents, etc.)
+(pydantic, langchain, adk, openai_agents, agno, smolagents, etc.)
 """
 
 import json
 from typing import Any, Protocol
 
+from openinference.semconv.trace import SpanAttributes
+
 from quraite.tracing.constants import Framework
 
 
@@ -75,9 +77,9 @@ def extract_tool_pydantic(span: dict[str, Any]) -> ToolCallInfo | None:
     )
 
 
-def extract_tool_langgraph(span: dict[str, Any]) -> ToolCallInfo | None:
+def extract_tool_langchain(span: dict[str, Any]) -> ToolCallInfo | None:
     """
-    Extract tool info from LangGraph tool spans.
+    Extract tool info from LangChain tool spans.
 
     Attributes:
         - tool.name: "add"
@@ -94,7 +96,7 @@ def extract_tool_langgraph(span: dict[str, Any]) -> ToolCallInfo | None:
     arguments = attrs.get("input.value", "{}")
     output_value = attrs.get("output.value", "")
 
-    # Also check for response attribute (some LangGraph spans store response here)
+    # Also check for response attribute (some LangChain spans store response here)
     response_value = attrs.get("response", output_value)
 
     # Try to parse output to extract content
@@ -115,7 +117,7 @@ def extract_tool_langgraph(span: dict[str, Any]) -> ToolCallInfo | None:
                 # First check for direct content field
                 if "content" in parsed:
                     response = parsed.get("content", response_value)
-                # Check for update.messages structure (LangGraph graph updates)
+                # Check for update.messages structure (LangChain graph updates)
                 # this comes when you use supervisor agent with multiple agents
                 elif "update" in parsed:
                     update = parsed.get("update", {})
@@ -137,7 +139,7 @@ def extract_tool_langgraph(span: dict[str, Any]) -> ToolCallInfo | None:
 
     return ToolCallInfo(
         tool_name=tool_name,
-        tool_call_id=None,  # LangGraph doesn't always have call IDs in tool spans
+        tool_call_id=None,  # LangChain doesn't always have call IDs in tool spans
         arguments=arguments,
         response=response,
     )
@@ -270,14 +272,33 @@ def extract_tool_smolagents(span: dict[str, Any]) -> ToolCallInfo | None:
     )
 
 
+def extract_default(span: dict[str, Any]) -> ToolCallInfo | None:
+    """
+    Extract tool info following openinference semantic conventions.
+    """
+    attrs = span.get("attributes", {})
+
+    tool_name = attrs.get(SpanAttributes.TOOL_NAME, "")
+    arguments = attrs.get(SpanAttributes.TOOL_PARAMETERS, "{}")
+    response = attrs.get(SpanAttributes.OUTPUT_VALUE, "")
+
+    return ToolCallInfo(
+        tool_name=tool_name,
+        tool_call_id=None,
+        arguments=arguments,
+        response=response,
+    )
+
+
 # Registry of framework extractors
 TOOL_EXTRACTORS: dict[Framework, ToolExtractor] = {
-    Framework.PYDANTIC: extract_tool_pydantic,
-    Framework.LANGGRAPH: extract_tool_langgraph,
+    Framework.PYDANTIC_AI: extract_tool_pydantic,
+    Framework.LANGCHAIN: extract_tool_langchain,
     Framework.GOOGLE_ADK: extract_tool_adk,
     Framework.OPENAI_AGENTS: extract_tool_openai_agents,
     Framework.AGNO: extract_tool_agno,
     Framework.SMOLAGENTS: extract_tool_smolagents,
+    Framework.DEFAULT: extract_default,
 }
 
 
@@ -285,6 +306,4 @@ def get_tool_extractor(framework: Framework | str) -> ToolExtractor:
     """Get the appropriate tool extractor for the given framework."""
     if isinstance(framework, str):
         framework = Framework(framework.lower())
-    return TOOL_EXTRACTORS.get(
-        framework, extract_tool_langgraph
-    )  # Default to langgraph
+    return TOOL_EXTRACTORS.get(framework, extract_default)

quraite/tracing/trace.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 
 import json
 from functools import cached_property
-from typing import Any, List
+from typing import Any, List, Optional
 
 from openinference.semconv.trace import OpenInferenceSpanKindValues, SpanAttributes
 from opentelemetry.sdk.trace import ReadableSpan
@@ -185,7 +185,7 @@ class AgentSpan(BaseModel):
         return cleaned_messages
 
     def to_tool_message(
-        self, framework: Framework = Framework.LANGGRAPH
+        self, framework: Framework = Framework.LANGCHAIN
     ) -> dict[str, Any] | None:
         """
         Convert tool execution span to a tool message.
@@ -405,8 +405,8 @@ class AgentTrace(BaseModel):
 
     def to_agent_trajectory(
         self,
-        framework: Framework = Framework.LANGGRAPH,
-        only_leaf_llms: bool = True,
+        framework: Optional[Framework] = Framework.DEFAULT,
+        only_leaf_llms: Optional[bool] = True,
     ) -> List[AssistantMessage | ToolMessage]:
         """
         Convert trace spans to agent trajectory.
@@ -422,9 +422,9 @@ class AgentTrace(BaseModel):
         # - Some frameworks (pydantic_ai, agno) execute tools DURING the LLM span
         #   (tools are nested inside LLM), so we sort by end_time to get correct order
         #   This means the parent span does not end before the nested span ends.
-        # - Other frameworks (langgraph, openai_agents, etc.) execute tools AFTER the LLM span
+        # - Other frameworks (langchain, openai_agents, etc.) execute tools AFTER the LLM span
         #   ends, so start_time sort works fine
-        nested_tool_frameworks = (Framework.PYDANTIC, Framework.AGNO)
+        nested_tool_frameworks = (Framework.PYDANTIC_AI, Framework.AGNO)
 
         if framework in nested_tool_frameworks:
             # Sort by end_time: LLM output is ready at end_time, then tool results follow

{quraite-0.1.1.dist-info → quraite-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: quraite
-Version: 0.1.1
+Version: 0.1.3
 Summary: This project provides adaptors and methods to integrate with the Quraite platform
 Author: Shiv Mohith
 Author-email: Shiv Mohith <shivmohith8@gmail.com>
@@ -16,8 +16,8 @@ Requires-Dist: uvicorn>=0.38.0
 Requires-Dist: agno>=2.3.4 ; extra == 'agno'
 Requires-Dist: boto3>=1.40.70 ; extra == 'bedrock'
 Requires-Dist: google-adk>=1.18.0 ; extra == 'google-adk'
-Requires-Dist: langchain>=1.0.5 ; extra == 'langgraph'
-Requires-Dist: langgraph>=1.0.3 ; extra == 'langgraph'
+Requires-Dist: langchain>=1.0.5 ; extra == 'langchain'
+Requires-Dist: langgraph>=1.0.3 ; extra == 'langchain'
 Requires-Dist: openai-agents>=0.5.0 ; extra == 'openai-agents'
 Requires-Dist: pydantic-ai>=1.25.0 ; extra == 'pydantic-ai'
 Requires-Dist: pyngrok>=7.5.0 ; extra == 'pyngrok'
@@ -26,7 +26,7 @@ Requires-Python: >=3.10
 Provides-Extra: agno
 Provides-Extra: bedrock
 Provides-Extra: google-adk
-Provides-Extra: langgraph
+Provides-Extra: langchain
 Provides-Extra: openai-agents
 Provides-Extra: pydantic-ai
 Provides-Extra: pyngrok
@@ -37,16 +37,15 @@ Description-Content-Type: text/markdown
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-Compatible-blue)](https://opentelemetry.io/)
 
-The **Quraite Python SDK** provides adapters and methods to integrate AI agent frameworks with the [Quraite platform](https://quraite.ai). It offers a unified interface for different agent frameworks, automatic tracing and observability, and easy local server setup with tunneling capabilities.
+The **Quraite Python SDK** provides adapters and methods to integrate AI agent with the [Quraite platform](https://quraite.ai) for evaluation. It offers a unified interface for different agent frameworks, automatic tracing at every turn for agent trajectory evaluation, and easy local server setup with tunneling capabilities.
 
 ## Features
 
-- 🔌 **Framework Adapters**: Support for multiple AI agent frameworks (LangGraph, Pydantic AI, Agno, Google ADK, OpenAI Agents, Smolagents, AWS Bedrock, Flowise, Langflow, N8n, and more)
-- 📊 **Automatic Tracing**: Built-in OpenTelemetry-based tracing for agent execution, tool calls, and performance metrics
-- 🚀 **Local Server**: Easy-to-use local server with optional tunneling (Cloudflare/ngrok) for public access
-- 📦 **Standardized Schema**: Unified message and response formats across all frameworks
-- 🔍 **Observability**: Track token usage, costs, latency, and model information for each agent invocation
+- 🔌 **Framework Adapters**: Support for multiple AI agent frameworks (LangChain, Pydantic AI, Agno, Google ADK, OpenAI Agents, Smolagents, AWS Bedrock, Flowise, Langflow, N8n, and more)
+- 📊 **Automatic Tracing**: Built-in OpenInference-based (OpenTelemetry-based tracing support coming soon) tracing for agent trajectory evaluation. Track token usage, costs, latency, and model information for each agent invocation
+- 🚀 **Local Server**: Easy-to-use local server with optional tunneling (Cloudflare/ngrok) for public access and integration with Quraite platform
 
 ## Installation
 
@@ -61,8 +60,8 @@ pip install quraite
 Install with optional dependencies for specific frameworks:
 
 ```bash
-# LangGraph
-pip install 'quraite[langgraph]'
+# LangChain
+pip install 'quraite[langchain]'
 
 # Pydantic AI
 pip install 'quraite[pydantic-ai]'
@@ -83,42 +82,45 @@ pip install 'quraite[smolagents]'
 pip install 'quraite[bedrock]'
 
 # Multiple frameworks
-pip install 'quraite[langgraph,pydantic-ai,agno]'
+pip install 'quraite[langchain,pydantic-ai,agno]'
 ```
 
 ## Quick Start
 
-### Example: LangGraph Agent with Local Server
+### Example: LangChain Agent with Local Server
 
-Pass your compiled LangGraph agent to the adapter and expose it as an HTTP API:
+Pass your compiled LangChain agent to the adapter and expose it as an HTTP API:
 
 ```python
+import asyncio
 import uvicorn
 from dotenv import load_dotenv
 from openinference.instrumentation import TracerProvider
 from openinference.instrumentation.langchain import LangChainInstrumentor
 
-from quraite.adapters import LanggraphAdapter
+from quraite.adapters import LangChainAdapter
 from quraite.serve.local_agent import LocalAgentServer
 from quraite.tracing.span_exporter import QuraiteInMemorySpanExporter
 from quraite.tracing.span_processor import QuraiteSimpleSpanProcessor
 
 load_dotenv()
 
-# Set up tracing (optional)
+# Set up tracing
+# Use Quraite's in-memory span exporter to capture the agent trajectory
+# and use it for evaluation.
 tracer_provider = TracerProvider()
 quraite_span_exporter = QuraiteInMemorySpanExporter()
 quraite_span_processor = QuraiteSimpleSpanProcessor(quraite_span_exporter)
 tracer_provider.add_span_processor(quraite_span_processor)
 LangChainInstrumentor().instrument(tracer_provider=tracer_provider)
 
-# Your compiled LangGraph agent (created elsewhere)
+# Your compiled LangChain agent (created elsewhere)
 # agent = create_agent(...)
 
 # Wrap with Quraite adapter
-adapter = LanggraphAdapter(
-    agent_graph=agent,  # Pass your compiled LangGraph agent here
-    tracer_provider=tracer_provider,  # Optional: for tracing
+adapter = LangChainAdapter(
+    agent_graph=agent,  # Pass your compiled LangChain agent here
+    tracer_provider=tracer_provider,
 )
 
 # Create and start server with Cloudflare tunnel
@@ -133,14 +135,18 @@ app = server.create_app(
     tunnel="cloudflare",  # Options: "cloudflare", "ngrok", or "none"
 )
 
-if __name__ == "__main__":
-    uvicorn.run("local_server:app", host="0.0.0.0", port=8080)
+# Option 1: Use the start method to start the server
+asyncio.run(server.start(host="0.0.0.0", port=8080))
+
+# Option 2: Use uvicorn to start the server for auto-reload
+# if __name__ == "__main__":
+#     uvicorn.run("local_server:app", host="0.0.0.0", port=8080, reload=True)
 ```
 
 The server exposes:
 
 - `GET /` - Health check endpoint
-- `POST /v1/agents/completions` - Agent invocation endpoint
+- `POST /v1/agents/completions` - Agent invocation endpoint. This is the endpoint that Quraite will use to invoke your agent.
 
 When using `tunnel="cloudflare"` or `tunnel="ngrok"`, your agent will be publicly accessible via the generated URL.
 
@@ -148,7 +154,7 @@ When using `tunnel="cloudflare"` or `tunnel="ngrok"`, your agent will be publicl
 
 | Framework            | Adapter                  | Installation                           |
 | -------------------- | ------------------------ | -------------------------------------- |
-| **LangGraph**        | `LanggraphAdapter`       | `pip install 'quraite[langgraph]'`     |
+| **LangChain**        | `LangChainAdapter`       | `pip install 'quraite[langchain]'`     |
 | **Pydantic AI**      | `PydanticAIAdapter`      | `pip install 'quraite[pydantic-ai]'`   |
 | **Agno**             | `AgnoAdapter`            | `pip install 'quraite[agno]'`          |
 | **Google ADK**       | `GoogleADKAdapter`       | `pip install 'quraite[google-adk]'`    |
@@ -159,27 +165,28 @@ When using `tunnel="cloudflare"` or `tunnel="ngrok"`, your agent will be publicl
 | **Langflow**         | `LangflowAdapter`        | Included in base package               |
 | **N8n**              | `N8nAdapter`             | Included in base package               |
 | **HTTP**             | `HttpAdapter`            | Included in base package               |
-| **LangGraph Server** | `LanggraphServerAdapter` | `pip install 'quraite[langgraph]'`     |
+| **LangChain Server** | `LangChainServerAdapter` | `pip install 'quraite[langchain]'`     |
 
 ## Core Concepts
 
 ### Adapters
 
-Adapters provide a unified interface (`BaseAdapter`) for different agent frameworks. Each adapter:
+Adapters provide a unified interface (`BaseAdapter`) for different agent frameworks. Each adapter converts framework-specific agent response formats to the Quraite agent message format.
+
+If you are building your own agent framework, you can create a custom adapter by extending the `BaseAdapter` class and implementing the `ainvoke` method.
+
+### Tracing for Agent Trajectory Evaluation
 
-- Converts framework-specific agents to a standard interface
-- Handles message format conversion
-- Supports optional tracing integration
-- Provides async invocation via `ainvoke()`
+**Capture agent trajectories without modifying your code.** Get comprehensive trace data including token usage, costs, and latency for every agent step.
 
-### Tracing
+Most agent frameworks return agent steps, but lack critical observability data. We solve this with **OpenInference instrumentation** (OpenTelemetry instrumentation support coming soon) that automatically captures:
 
-The SDK includes built-in OpenTelemetry-based tracing that captures:
+- Complete agent trajectories
+- Token usage and costs
+- Step-by-step latency
+- Full execution context
 
-- **Agent Trajectory**: Complete conversation flow with all messages
-- **Tool Calls**: Tool invocations with inputs and outputs
-- **Performance Metrics**: Token usage, costs, latency
-- **Model Information**: Model name and provider details
+**Works with your existing setup.** We provide OpenInference-compatible span exporters and processors that integrate seamlessly with your current observability platform - no vendor lock-in required.
 
 To enable tracing:
 
@@ -189,11 +196,13 @@ from quraite.tracing.span_exporter import QuraiteInMemorySpanExporter
 from quraite.tracing.span_processor import QuraiteSimpleSpanProcessor
 
 tracer_provider = TracerProvider()
+
+# Add Quraite span exporter and processor to the tracer provider
 quraite_span_exporter = QuraiteInMemorySpanExporter()
 quraite_span_processor = QuraiteSimpleSpanProcessor(quraite_span_exporter)
 tracer_provider.add_span_processor(quraite_span_processor)
 
-# Instrument your framework (example for LangChain)
+# Instrument your framework with OpenInference
 from openinference.instrumentation.langchain import LangChainInstrumentor
 LangChainInstrumentor().instrument(tracer_provider=tracer_provider)
 ```
@@ -251,18 +260,15 @@ response: AgentInvocationResponse = await adapter.ainvoke(
 # Access trajectory (list of messages)
 trajectory = response.agent_trajectory
 
-# Access trace (if tracing enabled)
+# Access trace
 trace = response.agent_trace
-
-# Access final response text
-final_response = response.agent_final_response
 ```
 
 ## Examples
 
 The repository includes comprehensive examples for each supported framework:
 
-- [`langgraph_calculator_agent`](examples/langgraph_calculator_agent/) - LangGraph calculator agent
+- [`langchain_calculator_agent`](examples/langchain_calculator_agent/) - LangChain calculator agent
 - [`pydantic_calculator_agent`](examples/pydantic_calculator_agent/) - Pydantic AI calculator agent
 - [`agno_calculator_agent`](examples/agno_calculator_agent/) - Agno calculator agent
 - [`google_adk_weather_agent`](examples/google_adk_weather_agent/) - Google ADK weather agent
@@ -302,6 +308,7 @@ class MyAdapter(BaseAdapter):
 Create a local HTTP server for your agent:
 
 ```python
+import asyncio
 from quraite.serve.local_agent import LocalAgentServer
 
 server = LocalAgentServer(
@@ -314,6 +321,8 @@ app = server.create_app(
     host="0.0.0.0",
     tunnel="cloudflare",  # or "ngrok" or "none"
 )
+
+asyncio.run(server.start(host="0.0.0.0", port=8080))
 ```
 
 ## Development

{quraite-0.1.1.dist-info → quraite-0.1.3.dist-info}/RECORD

@@ -1,25 +1,25 @@
 quraite/__init__.py,sha256=vxU3HsbCj6AT_rl5bZJA-e3R_bzqLhMGCe96_KM4Biw,48
-quraite/adapters/__init__.py,sha256=Uw2dV1_Acj_hT8N1GnQzVQEIMm_3BvZzLkWc5KfhbMw,4842
-quraite/adapters/agno_adapter.py,sha256=savrQqE0iuXyFprjlhFNZ-WpZpkfqJ9Y4OeaddCtQ_Y,5639
-quraite/adapters/base.py,sha256=sgzXuCRt81LyH7kjP3UsccbgDbgVQeHKOfqcXah1mHo,3917
+quraite/adapters/__init__.py,sha256=-2FPY_cUHtIKVlB7O3SUkgrEp1iybJ1z3VM52SjYk3I,4842
+quraite/adapters/agno_adapter.py,sha256=mZukC0ItxhhreHQB4V2xPDXJ7JUXpEG60rtj25_iRdg,5572
+quraite/adapters/base.py,sha256=7wRwmcjLg73cec_VKk2jwwPLyDRiutgtCuREnpgyVYw,3928
 quraite/adapters/bedrock_agents_adapter.py,sha256=2G-zUXqhNSzpyxut2UQgqTfe01MWcdjt1ajZIb43CUM,14136
 quraite/adapters/flowise_adapter.py,sha256=yLJ0tjDWMtTzm0bRYbhjfRm6wd5A6DqbHhqemy_FW48,10349
-quraite/adapters/google_adk_adapter.py,sha256=Ci7L54gA6pEH3-qcZ0PW1qODV6flJsVVbL9sN78FT_Y,7390
-quraite/adapters/http_adapter.py,sha256=y5ft65fF6SfvJXkhDkoglvq6dv6_VlCWDTZSCLEgssE,7883
+quraite/adapters/google_adk_adapter.py,sha256=ObVojr9sChciayYaZzrCwXUk4kjqdEMMRm4ObYqPmcE,7433
+quraite/adapters/http_adapter.py,sha256=HY9qRj_enxED73TaEIPN06l9ooqkLjBiPHssBdMPLJM,7990
+quraite/adapters/langchain_adapter.py,sha256=PnJUMUVMJptoOE13gIMYkbq3h3ZF1ihEEYroWZQzuSs,11581
+quraite/adapters/langchain_server_adapter.py,sha256=t5wUZrpIRtPN-CbRK3-I0yFfdTpvsbqFzZgrrvkleLQ,9694
 quraite/adapters/langflow_adapter.py,sha256=zGbDSd7Q_AZZ0ICByedsBIl5yNJ0hN6tQZgpUyN41-E,6946
-quraite/adapters/langgraph_adapter.py,sha256=WqmbP6Zw1lwfSCBf_O7oKNoGEb_1-zw_PMS1v71i3-w,11603
-quraite/adapters/langgraph_server_adapter.py,sha256=OhMx370Uzrvbp4yMOtgKkjQFI5u1xboKq0ybQRsBD90,9694
 quraite/adapters/n8n_adapter.py,sha256=CCIOcZNxQw-69xdf9BVX9Jyt8i666AlsE2DJHsY8lUc,7967
-quraite/adapters/openai_agents_adapter.py,sha256=iCFOWrZ-HnLoWOB-xsyJZf37Nh5QW5j8sHNSkjSWdGc,9665
-quraite/adapters/pydantic_ai_adapter.py,sha256=gps_90Zp8NcAiDX26-py4MKN2B5_jPEvgroRi8kjfQU,10811
-quraite/adapters/smolagents_adapter.py,sha256=QhEyMDlFkkXPSc5PiQTxMA9i2fRitzNcMdEsZwe9QVY,5448
+quraite/adapters/openai_agents_adapter.py,sha256=J404wIy9OyUOB0wTtEy6RIiKijMfQk1oLxu1vC7Je5U,9595
+quraite/adapters/pydantic_ai_adapter.py,sha256=BeP0En6gHxszrwwnpM0NJJ7dtkJTB3YNYG4EktJAL0w,10698
+quraite/adapters/smolagents_adapter.py,sha256=rFnHkF4oHOWQRq2nfIluwWEQwxFk2xbFfJupiu90L-k,5345
 quraite/logger.py,sha256=Py5GRQfD_s5FVb2Ziz5JxJk9AT4ve6w_iePbOSQkwH4,1601
 quraite/schema/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 quraite/schema/message.py,sha256=D6HWaZJOcoKObzDD-vo4Qg-chJDyOSwC-9XiNv_0xFc,2416
 quraite/schema/response.py,sha256=HUD_TyU6nibfXgRzdpD9LGoRtptD663oq7INy1sqaS4,412
 quraite/serve/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 quraite/serve/cloudflared.py,sha256=7XR1tPl0E3Feawo-6VCM8SXfCAie4cw9T1mx-ZNVJKw,6482
-quraite/serve/local_agent.py,sha256=8-a_4AeHeK3nTsgoDJVcTx7s4YvPoUhd6Zu3KVWEVAQ,12845
+quraite/serve/local_agent.py,sha256=G398f-kqzPjFEaaFuh4i-Y0qtrimP0SLSO7kyAPxcqU,12921
 quraite/traces/traces_adk_openinference.json,sha256=QjXAxMUEdSBcA5pCMOPiDU2_0NDsctEP6IFB6BIps9U,35957
 quraite/traces/traces_agno_multi_agent.json,sha256=FEW_zkSCKYizKG40KNvfXuouXsmOTdsPC7nnXWaKLfE,65098
 quraite/traces/traces_agno_openinference.json,sha256=p_tyBAp9KaT23PqGBU1cSMli7By0vss9Vpm3tL4pTMM,36871
@@ -34,16 +34,16 @@ quraite/traces/traces_pydantic_openinference_multi_agent_1.json,sha256=FjiPOvbhz
 quraite/traces/traces_pydantic_openinference_multi_agent_2.json,sha256=bV3z56JmzoLmxdDvL4RE9opgq3kFnMxNJFD5D4CbDtw,24751
 quraite/traces/traces_smol_agents_openinference.json,sha256=JVgRniA-VCuQ0oKWSqW0d09K4RcRFoOq5pcbejBigAc,83161
 quraite/traces/traces_smol_agents_tool_calling_openinference.json,sha256=QnKnCBukoNyR8ufTPLbjpWBFSguBRSUyd0-zLMNL2sw,217626
-quraite/tracing/__init__.py,sha256=ZAI6uLooKU8n6Np3TIAS8JN7-6bAdtajeT1PdFU-4_8,751
-quraite/tracing/constants.py,sha256=KhBIHkHRXAGW6xqa9vFa1LnA94C-EUTrWh5zNsx_z4Y,358
-quraite/tracing/span_exporter.py,sha256=0S3qyPgtPfZtb-IhEoQKm0ciFZoHvlaFUcqbNtDh7kM,4676
-quraite/tracing/span_processor.py,sha256=mp5AR5RbRz1ddgJEK07CbXRL8NfaFj2DXP1bs9xcf4w,1603
-quraite/tracing/tool_extractors.py,sha256=BXTr0lT570jSlQtwLvFGarEvBSkvAs07YSo6Ah9Qkkw,9232
-quraite/tracing/trace.py,sha256=bLIXyk8XXRC6LcPImDnwowW20eg2WI6qUW6-SFrTLpQ,21646
+quraite/tracing/__init__.py,sha256=uDML55hjgQ8W2thaAcZFFooy4aEIExxKzeBFXJGVPm4,763
+quraite/tracing/constants.py,sha256=W2z9RsDMvXfCpyhhlm_5E0EVjw-a9GGNq6wHliM3A_g,338
+quraite/tracing/span_exporter.py,sha256=Y5bJDwNeV62s3UIAykOSvTC3eOSuwYH9j0L4sxhZK-I,3940
+quraite/tracing/span_processor.py,sha256=GKxZGL5D71YVGukns2-tpnng8n1Ds8M1w3D7FIBETZg,1436
+quraite/tracing/tool_extractors.py,sha256=6YuCcb_aL_lyRJAp_A5-kZVK29ARU73mqjmiJnjtbGU,9800
+quraite/tracing/trace.py,sha256=wumQwANCw9KY_pMDjS-10EO8lyO8qHxKZ02Dnq74WgI,21677
 quraite/tracing/types.py,sha256=sWyp-7Qc8zsWN6ltem8OSTRIgKWbqnQSfsTKX6RrrB8,4948
 quraite/tracing/utils.py,sha256=Vm5q_iN_K1f_nEMpkQzv6jiUPpS2Yzo_VP5ZVmJZdBQ,5673
 quraite/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 quraite/utils/json_utils.py,sha256=RewoObREfHnLBVI6MBCIEov6CaIxs8d67jbKEH79mQ0,18686
-quraite-0.1.1.dist-info/WHEEL,sha256=5w2T7AS2mz1-rW9CNagNYWRCaB0iQqBMYLwKdlgiR4Q,78
-quraite-0.1.1.dist-info/METADATA,sha256=av4RLcrkIZpgsYRyY3IZ1G8opLtP_6QBOBM-ft-p64M,11163
-quraite-0.1.1.dist-info/RECORD,,
+quraite-0.1.3.dist-info/WHEEL,sha256=5w2T7AS2mz1-rW9CNagNYWRCaB0iQqBMYLwKdlgiR4Q,78
+quraite-0.1.3.dist-info/METADATA,sha256=82tXqkmPtK4XJcZFNI_fZuBIZjLFWJHoCX2kFJB02TQ,12063
+quraite-0.1.3.dist-info/RECORD,,