quraite 0.1.1__tar.gz → 0.1.2__tar.gz

{quraite-0.1.1 → quraite-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: quraite
-Version: 0.1.1
+Version: 0.1.2
 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 → quraite-0.1.2}/README.md

@@ -2,16 +2,15 @@
 
 [![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
 
@@ -26,8 +25,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]'
@@ -48,42 +47,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
@@ -98,14 +100,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.
 
@@ -113,7 +119,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]'`    |
@@ -124,27 +130,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:
 
@@ -154,11 +161,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)
 ```
@@ -216,18 +225,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
@@ -267,6 +273,7 @@ class MyAdapter(BaseAdapter):
 Create a local HTTP server for your agent:
 
 ```python
+import asyncio
 from quraite.serve.local_agent import LocalAgentServer
 
 server = LocalAgentServer(
@@ -279,6 +286,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 → quraite-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quraite"
-version = "0.1.1"
+version = "0.1.2"
 description = "This project provides adaptors and methods to integrate with the Quraite platform"
 readme = "README.md"
 authors = [
@@ -24,7 +24,7 @@ agno = ["agno>=2.3.4"]
 
 google-adk = ["google-adk>=1.18.0"]
 
-langgraph = [
+langchain = [
     "langchain>=1.0.5",
     "langgraph>=1.0.3"
 ]

{quraite-0.1.1 → quraite-0.1.2}/quraite/adapters/__init__.py

@@ -9,8 +9,8 @@ if TYPE_CHECKING:
     from quraite.adapters.flowise_adapter import FlowiseAdapter
     from quraite.adapters.google_adk_adapter import GoogleADKAdapter
     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.langchain_adapter import LangchainAdapter
+    from quraite.adapters.langchain_server_adapter import LangchainServerAdapter
     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-0.1.1 → quraite-0.1.2}/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-0.1.1 → quraite-0.1.2}/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-0.1.1 → quraite-0.1.2}/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,