runcycles 0.2.3

Rust client for the Cycles budget-management protocol — deterministic spend control for AI agents and LLM workflows
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

//! Basic low-level client usage.
//!
//! Demonstrates creating a reservation, committing, and error handling
//! using the low-level client API directly.

use runcycles::models::*;
use runcycles::CyclesClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = CyclesClient::builder("my-api-key", "http://localhost:7878")
        .tenant("acme")
        .build();

    // Create a reservation
    let resp = client
        .create_reservation(
            &ReservationCreateRequest::builder()
                .subject(Subject {
                    tenant: Some("acme".into()),
                    ..Default::default()
                })
                .action(Action::new("llm.completion", "gpt-4o"))
                .estimate(Amount::usd_microcents(5000))
                .build(),
        )
        .await?;

    println!("Decision: {:?}", resp.decision);

    if resp.decision.is_allowed() {
        let id = resp.reservation_id.expect("id present when allowed");
        println!("Reservation ID: {id}");

        // Simulate work...

        // Commit actual spend
        let commit_resp = client
            .commit_reservation(
                &id,
                &CommitRequest::builder()
                    .actual(Amount::usd_microcents(3200))
                    .build(),
            )
            .await?;

        println!("Committed: {:?}", commit_resp.charged);
    }

    Ok(())
}