v0.3.0-alpha — Multi-Language SDK Release

What's New

4 SDKs, full feature parity, one telemetry schema.

Go SDK (go.agenttel.dev/agenttel)

• Full AgentTel span processor with baseline/anomaly/SLO enrichment
• HTTP, Gin, and gRPC middleware
• GenAI instrumentation: OpenAI + Anthropic (sync + streaming)
• MCP server with Bearer token auth + RBAC
• Agentic tracing: invocation, step, tool call scopes

Node.js SDK (@agenttel/node)

• Full AgentTel span processor with baseline/anomaly/SLO enrichment
• Express and Fastify middleware
• GenAI instrumentation: OpenAI + Anthropic (sync + streaming)
• MCP server with Bearer token auth + RBAC
• Agentic tracing: invocation, step, tool call scopes

Python SDK (agenttel)

• Full AgentTel span processor with baseline/anomaly/SLO enrichment
• FastAPI middleware and @agent_operation decorator
• GenAI instrumentation: OpenAI, Anthropic, LangChain, AWS Bedrock
• MCP server (JSON-RPC 2.0) with 15 built-in tools
• Agentic tracing with 10 scope context managers

Java SDK (dev.agenttel)

• MCP server auth: Bearer token + API key registry + RBAC
• Version bump to 0.3.0-alpha

Cross-SDK

• attributes.json — canonical attribute schema (single source of truth)
• CI attribute parity validation across all 4 SDKs
• Unified CI: Java (JDK 17/21), Go (1.24), Node (20), Python (3.11/3.12/3.13)
• 6 example apps: Spring Boot, Go net/http, Gin, Express, Fastify, FastAPI

Install

# Java (Maven)
<dependency>
  <groupId>dev.agenttel</groupId>
  <artifactId>agenttel-core</artifactId>
  <version>0.3.0-alpha</version>
</dependency>

# Go
go get go.agenttel.dev/agenttel@v0.3.0-alpha

# Node.js
npm install @agenttel/node@0.3.0-alpha

# Python
pip install agenttel==0.3.0-alpha

v0.2.0-alpha

What's New in v0.2.0-alpha

Agentic Observability (agenttel-agentic)

New module for tracing AI agent invocations with full lifecycle support:

• AgentTracer — trace agent invocations with steps, tool calls, tasks, and handoffs
• AgentInvocation — auto-closing scope with step counting, loop detection, and cost aggregation
• AgentCostAggregator — SpanProcessor that rolls up GenAI token costs to parent agent spans
• LoopDetector — configurable detection of repetitive tool call patterns
• Agent types — SINGLE, REACT, PLAN_AND_EXECUTE, MULTI_AGENT, CUSTOM

Config-Driven Agent Observability

Zero-code agent observability via YAML configuration and annotations:

• YAML config (agenttel.agentic.agents.*) — define agent identity (name, type, framework, version) and guardrails (maxSteps, loopThreshold, costBudgetUsd)
• @AgentMethod annotation — auto-wrap methods in AgentInvocation scopes via AOP
• Config priority — YAML > @AgentMethod annotation > programmatic defaults
• AgentConfigRegistry — centralized registry for per-agent configurations

Testing Support

• AgenticAssertions — fluent test assertions for verifying agent span attributes

Fixes

• Fixed McpServer port binding — getPort() now returns actual bound port (supports port 0 for random assignment)
• Fixed PaymentServiceIntegrationTest BindException when port 8081 is in use

Installation

Maven:

<dependency>
    <groupId>dev.agenttel</groupId>
    <artifactId>agenttel-agentic</artifactId>
    <version>0.2.0-alpha</version>
</dependency>

Gradle:

implementation("dev.agenttel:agenttel-agentic:0.2.0-alpha")

Full changelog: v0.1.0-alpha...v0.2.0-alpha

v0.1.0-alpha

Initial alpha release — agent-ready telemetry