seher-sdk 0.0.32

Seher SDK: agent resolution, rate-limit checks, and provider clients
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

use chrono::{DateTime, Utc};

const LIMIT_EPSILON: f64 = 1e-9;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum OpencodeGoUsageSource {
    LocalDatabase,
}

#[derive(Debug, Clone, PartialEq)]
pub struct OpencodeGoUsageWindow {
    pub entry_type: &'static str,
    pub spent_usd: f64,
    pub limit_usd: f64,
    pub resets_at: Option<DateTime<Utc>>,
}

impl OpencodeGoUsageWindow {
    /// A `limit_usd <= 0` window is **disabled** (the user opted out of this
    /// window via env): never limited, regardless of spend.
    #[must_use]
    pub fn is_limited(&self) -> bool {
        self.limit_usd > 0.0 && self.spent_usd + LIMIT_EPSILON >= self.limit_usd
    }

    #[must_use]
    pub fn utilization(&self) -> f64 {
        if self.limit_usd <= 0.0 {
            0.0
        } else {
            self.spent_usd / self.limit_usd * 100.0
        }
    }
}

#[derive(Debug, Clone, PartialEq)]
pub struct OpencodeGoUsageSnapshot {
    pub source: OpencodeGoUsageSource,
    pub credentials_available: bool,
    pub total_messages: usize,
    pub windows: Vec<OpencodeGoUsageWindow>,
}

impl OpencodeGoUsageSnapshot {
    #[must_use]
    pub fn reset_time(&self) -> Option<DateTime<Utc>> {
        self.windows
            .iter()
            .filter(|window| window.is_limited())
            .filter_map(|window| window.resets_at)
            .max()
    }
}