runcycles 0.2.4

Runtime authority for AI agents in Rust — hard limits on agent spend, risky tool actions, and audit gaps. Tokio-native client for the Cycles protocol (reserve-commit lifecycle, RAII guards).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! Error handling patterns.
//!
//! Demonstrates how to match on different error types and handle
//! budget exceeded, retryable errors, and transport failures.

use runcycles::models::*;
use runcycles::{CyclesClient, Error};

#[tokio::main]
async fn main() {
    let client = CyclesClient::builder("my-api-key", "http://localhost:7878")
        .tenant("acme")
        .build();

    let result = client
        .reserve(
            ReservationCreateRequest::builder()
                .subject(Subject {
                    tenant: Some("acme".into()),
                    ..Default::default()
                })
                .action(Action::new("llm.completion", "gpt-4o"))
                .estimate(Amount::usd_microcents(5000))
                .build(),
        )
        .await;

    match result {
        Ok(guard) => {
            println!("Reserved: {}", guard.reservation_id());
            // In production, you would do work here and then commit.
            // For this example, just release.
            let _ = guard.release("example_done").await;
        }
        Err(Error::BudgetExceeded {
            message,
            retry_after,
            ..
        }) => {
            println!("Budget exceeded: {message}");
            if let Some(delay) = retry_after {
                println!("Retry after: {:?}", delay);
            }
        }
        Err(Error::Api {
            status,
            code,
            message,
            ..
        }) => {
            println!("API error ({status}): {message}");
            if let Some(code) = code {
                println!("Error code: {code:?}");
            }
        }
        Err(Error::Transport(e)) => {
            println!("Network error: {e}");
            println!("Is retryable: true");
        }
        Err(e) => {
            println!("Other error: {e}");
            println!("Retryable: {}", e.is_retryable());
        }
    }
}