Skip to content

Release Notes v0.5.0

Release Date: May 2026

Highlights

  • Cross-Protocol Bridging: New bridge/ package enables interoperability between ID-JAG, AIMS, and AAuth protocols
  • Observability Integration: New bridge/observe/ package provides distributed tracing, metrics, and logging via OmniObserve
  • Protocol-Bridge Demo: Working example demonstrating multi-protocol authentication in a single service

New Features

Cross-Protocol Bridge (bridge/)

A unified bridge package that enables seamless interoperability between all three authentication protocols.

import "github.com/aistandardsio/agent-protocols/bridge"

// Multi-protocol middleware accepts any protocol
middleware := bridge.MultiProtocolMiddleware(
    bridge.WithIDJAGVerifier(idjagVerifier),
    bridge.WithAIMSVerifier(aimsVerifier),
    bridge.WithAAuthVerifier(aauthVerifier),
)

http.Handle("/api/", middleware(apiHandler))

Features:

  • Canonical Identity: bridge.Identity provides unified representation across protocols
  • Protocol Detection: Automatic detection from JWT typ header
  • Token Parsing: Extract identity from any protocol token
  • Cross-Protocol Conversion: Convert identities between protocols

Observability Integration (bridge/observe/)

Production-ready observability for authentication flows using OmniObserve.

import (
    "github.com/aistandardsio/agent-protocols/bridge/observe"
    "github.com/plexusone/omniobserve/observops"
)

provider, _ := observops.Open("otlp",
    observops.WithEndpoint("localhost:4317"),
)

middleware := observe.Middleware(provider,
    bridge.WithIDJAGVerifier(verifier),
)

Metrics recorded:

  • auth.requests - Total authentication requests
  • auth.success - Successful authentications by protocol
  • auth.failure - Failed authentications by protocol and reason
  • auth.duration - Authentication latency histogram
  • auth.delegation_depth - Delegation chain depth gauge

Protocol-Bridge Demo (demos/protocol-bridge/)

Complete working example demonstrating:

  • Multi-protocol endpoint accepting ID-JAG, AIMS, and AAuth tokens
  • Canonical identity extraction
  • Protocol-specific metadata preservation

Added

  • bridge/ package with canonical identity and multi-protocol middleware (23ee068)
  • bridge.Identity canonical representation for cross-protocol interop (23ee068)
  • bridge.DetectProtocol() for automatic protocol detection (2d6a7c5)
  • bridge.Parse() for unified token parsing (2d6a7c5)
  • bridge.MultiProtocolMiddleware() HTTP handler (373cef4)
  • bridge/observe/ package for OmniObserve integration (ed19b4f)
  • observe.Middleware() with tracing, metrics, logging (ed19b4f)
  • observe.DelegationTracker for delegation chain tracing (ed19b4f)
  • demos/protocol-bridge/ cross-protocol demo (a3fd63c)

Documentation

  • Bridge package documentation (c077900)
  • OAuth to Agent migration guide (48c9c96)
  • Hybrid authentication guide (48c9c96)
  • Updated roadmap with Phase 7 and 8 progress (e6d6db0)

Tests

  • Comprehensive bridge package tests (4eaaa30)
  • Protocol-bridge demo integration test (f84073e)

Dependencies

  • github.com/plexusone/omniobserve v0.10.0