tower-a2a 1.0.0

A Tower middleware layer for the A2A Protocol
Documentation

tower middleware layer for the A2A Protocol

This library provides a composable, transport-agnostic implementation of the A2A protocol as Tower middleware. It enables Rust applications to communicate with AI agents using standardized protocol operations, task management, and authentication schemes.

Why Tower A2A?

By leveraging the tower::Service abstraction, this library separates the protocol logic from the transport layer. This allows you to swap HTTP for WebSockets or add standard middleware like tower-http (for tracing or compression) directly into your agent communication pipeline.

Easily inject Retry, RateLimit, or Timeout layers using the standard Tower ecosystem. We have a production-ready HTTP client, but allow you to build custom Connector implementations for gRPC or proprietary backends.

[ Your App ] -> [ tower-a2a ] -> [ Layer: Auth ] -> [ Layer: Log ] -> [ Transport: HTTP | gRPC | WebSocket ] ( -> [ TCP ])

Features

  • Tower Integration - Implements Tower's Service and Layer traits for composable middleware
  • Transport Agnostic - HTTP transport included, extensible to gRPC, WebSocket, and custom transports
  • Multiple Auth Schemes - Built-in support for Bearer tokens, API keys, and Basic authentication
  • Type-Safe Protocol - Strongly-typed message, task, and agent types with serde serialization
  • Task Lifecycle Management - Full support for task submission, polling, cancellation, and status tracking
  • Agent Discovery - Automatic agent capability discovery via standard agent-card endpoint
  • Async/Await - Built on Tokio for high-performance async I/O

Installation

Add this to your Cargo.toml:

[dependencies]
tower-a2a = "0.1.0"

Quick Start

use tower_a2a::prelude::*;
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Build client with HTTP transport and authentication
    let mut client = A2AClientBuilder::new("https://agent.example.com")
        .with_http()
        .with_bearer_auth("your-token".to_string())
        .with_timeout(Duration::from_secs(30))
        .build()?;

    // Discover agent capabilities
    let agent_card = client.discover().await?;
    println!("Connected to: {}", agent_card.name);

    // Send a message
    let task = client.send_message(
        Message::user("What is the weather in San Francisco?")
    ).await?;

    // Poll for completion
    let result = client.poll_until_complete(task.id, 1000, 30).await?;
    println!("Task status: {:?}", result.status);

    // Access artifacts from completed task
    for Artifact { artifact_id, .. } in &result.artifacts {
        println!("Artifact: {artifact_id}");
    }

    Ok(())
}

Examples

See examples/simple_client.rs for a complete working example demonstrating agent discovery, message sending, task polling, and task listing.

Run the example with:

cargo run --example simple_client

Contributing

Contributions in good faith are welcome! Please open an issue or submit a pull request. Do note that only if the authors deem it to be appropriate will they be considered.

Resources

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.