dexcost 0.8.0

Agent Unit Economics SDK for Rust — track end-to-end business-task costs for AI agents.
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

use std::fmt;

/// Error type for the dexcost SDK.
#[derive(Debug)]
pub enum DexcostError {
    /// The SDK has not been initialized. Call `init()` first.
    NotInitialized,
    /// The SDK has already been initialized.
    AlreadyInitialized,
    /// The API key has an invalid format.
    InvalidApiKey(String),
    /// The task has already been ended.
    TaskAlreadyEnded,
    /// An HTTP transport error occurred.
    Transport(String),
    /// A serialization/deserialization error occurred.
    Serialization(String),
    /// A configuration error occurred.
    Config(String),
    /// A storage error occurred (SQLite).
    Storage(String),
    /// Durable records that could not satisfy the attribution v2 contract.
    /// These are quarantined locally and are not transport failures.
    AttributionConversion(Vec<String>),
}

impl fmt::Display for DexcostError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            DexcostError::NotInitialized => {
                write!(f, "dexcost: init() must be called before using the SDK")
            }
            DexcostError::AlreadyInitialized => {
                write!(f, "dexcost: SDK already initialized")
            }
            DexcostError::InvalidApiKey(msg) => {
                write!(f, "dexcost: invalid API key: {}", msg)
            }
            DexcostError::TaskAlreadyEnded => {
                write!(f, "dexcost: task already ended")
            }
            DexcostError::Transport(msg) => {
                write!(f, "dexcost: transport error: {}", msg)
            }
            DexcostError::Serialization(msg) => {
                write!(f, "dexcost: serialization error: {}", msg)
            }
            DexcostError::Config(msg) => {
                write!(f, "dexcost: config error: {}", msg)
            }
            DexcostError::Storage(msg) => {
                write!(f, "dexcost: storage error: {}", msg)
            }
            DexcostError::AttributionConversion(event_ids) => {
                let preview = event_ids
                    .iter()
                    .take(3)
                    .cloned()
                    .collect::<Vec<_>>()
                    .join(", ");
                write!(
                    f,
                    "dexcost: {} event(s) were quarantined because they cannot be represented by attribution v2 (event IDs: {})",
                    event_ids.len(),
                    preview
                )
            }
        }
    }
}

impl std::error::Error for DexcostError {}

impl From<reqwest::Error> for DexcostError {
    fn from(err: reqwest::Error) -> Self {
        DexcostError::Transport(err.to_string())
    }
}

impl From<serde_json::Error> for DexcostError {
    fn from(err: serde_json::Error) -> Self {
        DexcostError::Serialization(err.to_string())
    }
}