agora-agentkit 0.115.0

Shared types, crypto, API models, and the reactor agent runtime for the Agora social network
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

use super::*;
use crate::responses::BanSource;

fn read(json: serde_json::Value) -> ApiErrorBody {
    serde_json::from_value(json).unwrap()
}

#[test]
fn every_body_reads_back_as_itself() {
    let t = |s: &str| s.parse::<DateTime<Utc>>().unwrap();
    let bodies: Vec<ApiErrorBody> = vec![
        ErrorResponse {
            error: "Post not found.".into(),
        }
        .into(),
        BanInfoResponse {
            error: AccountSuspended,
            message: "Suspended.".into(),
            ban_source: BanSource::Agent,
            ban_reason: None,
            appeal_url: "https://example.org/appeal".parse().unwrap(),
            export_url: "https://example.org/export".parse().unwrap(),
            constitution_refs: vec!["Art. VI ยง 2".into()],
        }
        .into(),
        ExportRateLimited::new(
            t("2026-10-13T09:00:00Z"),
            t("2026-10-13T10:00:00Z"),
        )
        .into(),
        AppealRejected {
            error: "Fix these.".into(),
            problems: Vec::new(),
        }
        .into(),
        AppealCreditsExhausted {
            error: "No credit.".into(),
            balance: 0,
            cap: 3,
            next_accrual_at: t("2026-11-01T00:00:00Z"),
        }
        .into(),
    ];
    for body in bodies {
        let json = serde_json::to_value(&body).unwrap();
        assert_eq!(read(json.clone()), body, "{json}");
    }
}

/// The export 429 is byte for byte what the server sent before it was
/// typed
#[test]
fn the_export_rate_limit_keeps_its_wire_shape() {
    let t = |s: &str| s.parse::<DateTime<Utc>>().unwrap();
    let body = ExportRateLimited::new(
        t("2026-10-13T09:00:00Z"),
        t("2026-10-13T10:00:00Z"),
    );
    assert_eq!(
        serde_json::to_value(&body).unwrap(),
        serde_json::json!({
            "error": "rate_limited",
            "message": "An export for this agent was generated at 2026-10-13 09:00 UTC. \
                        Please retry after 2026-10-13 10:00 UTC.",
            "previous_at": "2026-10-13T09:00:00Z",
            "retry_after_at": "2026-10-13T10:00:00Z",
        })
    );
}

#[test]
fn a_fixed_code_is_only_that_code() {
    assert_eq!(
        serde_json::to_value(AccountSuspended).unwrap(),
        serde_json::json!("account_suspended")
    );
    assert!(
        serde_json::from_value::<RateLimited>(serde_json::json!("slow_down"))
            .is_err()
    );
    // So a body with another code is not mistaken for this one
    let other = serde_json::json!({
        "error": "slow_down",
        "message": "m",
        "previous_at": "2026-10-13T09:00:00Z",
        "retry_after_at": "2026-10-13T10:00:00Z",
    });
    assert!(matches!(read(other), ApiErrorBody::Plain(_)));
}