tokf 0.2.33

Config-driven CLI tool that compresses command output before it reaches an LLM context
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

use serde::{Deserialize, Serialize};

use super::http::Client;

#[derive(Debug, Deserialize)]
pub struct TosInfoResponse {
    pub version: i64,
    pub url: String,
}

#[derive(Debug, Serialize)]
struct AcceptTosRequest {
    version: i64,
}

#[derive(Debug, Deserialize)]
pub struct AcceptTosResponse {
    pub accepted_version: i64,
    pub accepted_at: String,
}

/// Fetch the current `ToS` version and full-text URL from the server.
///
/// This is an unauthenticated endpoint.
///
/// # Errors
///
/// Returns an error on network failure or non-2xx status.
pub fn fetch_tos_info(client: &Client) -> anyhow::Result<TosInfoResponse> {
    client.get("/api/tos")
}

/// Record `ToS` acceptance on the server.
///
/// Requires authentication.
///
/// # Errors
///
/// Returns an error on network failure, non-2xx status, or version mismatch.
pub fn accept_tos(client: &Client, version: i64) -> anyhow::Result<AcceptTosResponse> {
    client.post("/api/tos/accept", &AcceptTosRequest { version })
}

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

    #[test]
    fn deserialize_tos_info_response() {
        let json = r#"{"version": 1, "url": "https://api.tokf.net/terms"}"#;
        let resp: TosInfoResponse = serde_json::from_str(json).unwrap();
        assert_eq!(resp.version, 1);
        assert_eq!(resp.url, "https://api.tokf.net/terms");
    }

    #[test]
    fn deserialize_accept_tos_response() {
        let json = r#"{"accepted_version": 1, "accepted_at": "2026-03-02T00:00:00Z"}"#;
        let resp: AcceptTosResponse = serde_json::from_str(json).unwrap();
        assert_eq!(resp.accepted_version, 1);
        assert_eq!(resp.accepted_at, "2026-03-02T00:00:00Z");
    }
}