librefang 2026.3.31-beta4

Official Rust client for LibreFang Agent OS
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

use crate::{extract_error, Result};
use reqwest::Client;
use serde::Deserialize;

#[derive(Debug, Deserialize)]
pub struct Provider {
    pub id: String,
    #[serde(rename = "display_name")]
    pub display_name: Option<String>,
    pub status: Option<String>,
    #[serde(rename = "api_key_env")]
    pub api_key_env: Option<String>,
    #[serde(rename = "api_key_configured")]
    pub api_key_configured: Option<bool>,
    #[serde(rename = "default_model")]
    pub default_model: Option<String>,
}

#[derive(Debug, Deserialize)]
pub struct ProvidersResponse {
    pub providers: Vec<Provider>,
}

pub struct Providers {
    base_url: String,
    client: Client,
}

impl std::fmt::Debug for Providers {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("Providers").finish()
    }
}

impl Providers {
    pub fn new(base_url: String, client: Client) -> Self {
        Self { base_url, client }
    }

    pub async fn list(&self) -> Result<ProvidersResponse> {
        let url = format!("{}/api/providers", self.base_url);
        let response = self.client.get(&url).send().await?;
        let status = response.status();
        let body = response.text().await?;

        if status.is_success() {
            Ok(serde_json::from_str(&body)?)
        } else {
            Err(extract_error(status, &body))
        }
    }
}