vex-api

Industry-grade HTTP API gateway for the VEX Protocol.

Features

• RESTful API - Full CRUD operations for agents
• JWT Authentication - Secure API access
• Rate Limiting - Protect against abuse
• Circuit Breaker - Resilient external service calls
• OpenTelemetry - Production observability

Installation

[dependencies]
vex-api = "0.1"

Quick Start

use vex_api::Server;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let server = Server::new()
        .bind("0.0.0.0:3000")
        .build()
        .await?;
    
    server.run().await?;
    Ok(())
}

API Endpoints

• POST /api/v1/agents - Create a new agent
• POST /api/v1/agents/:id/execute - Execute agent task (Adversarial/Verified)
• GET /api/v1/jobs/:id - Poll execution results
• GET /api/v1/routing/stats - View routing cost savings
• GET /api/v1/routing/config - Configure routing strategy (Admin)
• GET /health - Health check

License

Apache-2.0 License - see LICENSE for details.