The Next Frontier of AI Agent Runtimes: Observability, MCP, and High-Precision RAG

TL;DR: HazelJS is evolving from a library to a robust Agent Runtime. New updates include native OpenTelemetry tracing, full Model Context Protocol (MCP) integration, and Cohere-powered RAG reranking.

In the fast-paced world of AI engineering, developers are moving past simple prompt-response loops and into the era of autonomous agent runtimes. At HazelJS, our mission has always been to provide the most robust, type-safe, and production-grade environment for these agents.

Today, we are excited to announce a major evolution in the HazelJS ecosystem: the introduction of Native OpenTelemetry Observability, Full Model Context Protocol (MCP) Support, and High-Precision RAG Reranking.

---

🏗️ 1. Observability: Ending the Debugging Nightmare

Traditional AI agents are "black boxes." When an agent fails after the 15th tool call in a complex flow, standard console logs are useless. You need a full stack trace of the AI's "thought process."

The HazelJS Way: Native OpenTelemetry

We’ve launched @hazeljs/observability, built directly on OpenTelemetry. Instead of boilerplate code, we’ve introduced a smart @Trace() decorator that works across both synchronous and asynchronous methods.

class FinancialAgent {
  @Trace('analyze_risk')
  async calculatePortfolioRisk(data: PortfolioData) {
    // Automatically creates spans, tracks duration, and captures metadata
    const result = await this.llm.generate(...);

    // Built-in cost and token tracking
    this.observability.trackCost('gpt-4o', result.usage.prompt, result.usage.completion);

    return result;
  }
}

[!TIP]
Zero Overhead: Our tracing implementation uses asynchronous BatchSpanProcessors to ensure observability never blocks your agent's execution performance.

---

🔌 2. Breaking Silos with Model Context Protocol (MCP)

Agents have historically been "islands"—limited by the tools hardcoded into their runtime. Connecting a GitHub agent to a Slack tool usually required custom, brittle glue code.

The HazelJS Solution: MCP-as-a-First-Class-Citizen

By integrating support for the Model Context Protocol (MCP), HazelJS agents can now instantly connect to a vast ecosystem of external tools via Standardized STDIO or HTTP Transports.

• Instant Toolkits: Connect to a local GitHub MCP server or a remote Database bridge in seconds.
• Dynamic Schema Mapping: HazelJS automatically translates MCP JSON-RPC definitions into internal ToolRegistry types.

---

🎯 3. High-Precision RAG: Quality Over Quantity

Standard Vector Search (RAG) often suffers from "noise" in the top-k results. Getting the right context is the difference between an expert agent and a confidently incorrect one.

Semantic Reranking with Cohere

We’ve integrated the CohereReranker (using Cohere Rerank 3) into the @hazeljs/rag pipeline.

• Why Rerank?: Vector embeddings are great for finding "related" concepts, but Rerankers are experts at identifying the specific chunk that answers the query.
• Deep Integration: Reranking is now an optional middleware step in the RAGPipeline, ensuring your LLM only sees the most relevant truth.

---

🛡️ 4. Production-Grade at Scale

"Move fast and break things" doesn't work for AI agents controlling real-world APIs. That's why we’ve overhauled our internal runtime stability.

• A2A Protocol Compliance: Full adherence to the Agent-to-Agent (A2A) specification for cross-runtime interoperability.

---

HazelJS vs. The Competition

Feature	HazelJS	LangChain	Vercel AI SDK
Execution	Runtime-First (A2A)	Library-First	Framework-First
Observability	Native OTel Decorators	3rd Party (LangSmith)	Basic Telemetry
Tooling	Native MCP Support	Manual Adapters	Tool Definitions
Type Safety	Strict TypeScript	Mixed/Loose	High
Scaling	Distributed (Redis Store)	Often Single-process	Serverless-centric

---

Getting Started

Ready to build the next generation of observable AI?

npm install @hazeljs/agent @hazeljs/observability @hazeljs/mcp

Explore our updated Documentation or join the community on GitHub.