ai-usagebar 1.39.1

Omarchy/Waybar widgets + TUI for tracking multi-provider AI plan usage
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

use crate::error::{AppError, Result};
use crate::usage::{SyntheticSnapshot, UsageWindow};

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Response {
    pub subscription: Subscription,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
#[serde(rename_all = "camelCase")]
pub struct Subscription {
    pub limit: f64,
    pub requests: f64,
    pub renews_at: String,
}

impl Response {
    pub fn snapshot(&self) -> Result<SyntheticSnapshot> {
        let sub = &self.subscription;
        if !sub.limit.is_finite()
            || sub.limit <= 0.0
            || !sub.requests.is_finite()
            || sub.requests < 0.0
        {
            return Err(AppError::Schema(
                "Synthetic subscription quota contains an invalid limit or request count".into(),
            ));
        }
        let renews_at = DateTime::parse_from_rfc3339(&sub.renews_at)
            .map_err(|_| AppError::Schema("Synthetic subscription renewal is invalid".into()))?
            .with_timezone(&Utc);
        let utilization_pct = (sub.requests / sub.limit * 100.0).round().clamp(0.0, 100.0) as i32;
        Ok(SyntheticSnapshot {
            subscription: UsageWindow {
                utilization_pct,
                resets_at: Some(renews_at),
                // The API documents the next renewal, not a fixed cycle
                // length. Zero deliberately disables guessed pacing.
                window_duration: chrono::Duration::zero(),
            },
            requests: sub.requests,
            limit: sub.limit,
        })
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn documented_example_projects_without_guessing_a_cycle() {
        let response: Response = serde_json::from_str(
            r#"{"subscription":{"limit":135,"requests":27,"renewsAt":"2026-11-01T00:00:00Z"}}"#,
        )
        .unwrap();
        let snapshot = response.snapshot().unwrap();
        assert_eq!(snapshot.subscription.utilization_pct, 20);
        assert_eq!(snapshot.requests, 27.0);
        assert_eq!(snapshot.limit, 135.0);
        assert_eq!(
            snapshot.subscription.window_duration,
            chrono::Duration::zero()
        );
    }

    #[test]
    fn invalid_or_ambiguous_numbers_are_rejected() {
        for raw in [
            r#"{"subscription":{"limit":0,"requests":0,"renewsAt":"2026-11-01T00:00:00Z"}}"#,
            r#"{"subscription":{"limit":135,"requests":-1,"renewsAt":"2026-11-01T00:00:00Z"}}"#,
            r#"{"subscription":{"limit":135,"requests":1,"renewsAt":"not-a-time"}}"#,
            r#"{"subscription":{"limit":135,"requests":1}}"#,
            r#"{"error":"unauthorized"}"#,
        ] {
            let result = serde_json::from_str::<Response>(raw)
                .map_err(AppError::from)
                .and_then(|response| response.snapshot());
            assert!(result.is_err(), "accepted {raw}");
        }
    }

    #[test]
    fn over_limit_usage_is_bounded_for_frontends() {
        let response: Response = serde_json::from_str(
            r#"{"subscription":{"limit":10,"requests":12,"renewsAt":"2026-11-01T00:00:00Z"}}"#,
        )
        .unwrap();
        assert_eq!(
            response.snapshot().unwrap().subscription.utilization_pct,
            100
        );
    }
}