anamdb 1.0.0

AnamDB — the AI-native, differentiable logic kernel for autonomous 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

//! Usage metering for AnamDB.
//!
//! Tracks queries, storage, and GPU usage per tenant. In production the
//! accumulated counters are periodically flushed to a billing backend
//! (e.g. Stripe Metering).

use std::sync::atomic::{AtomicUsize, Ordering};
use tracing::info;

/// In-memory usage counters for a single tenant.
#[derive(Debug, Default)]
pub struct TenantMeter {
    /// Total queries executed.
    pub query_count: AtomicUsize,
    /// Total rows scanned across all queries.
    pub rows_scanned: AtomicUsize,
    /// Cumulative GPU milliseconds consumed.
    pub gpu_ms: AtomicUsize,
}

impl TenantMeter {
    /// Create a zeroed meter.
    pub fn new() -> Self {
        Self::default()
    }

    /// Record a single query execution.
    pub fn record_query(&self, rows: usize, gpu_time_ms: usize) {
        self.query_count.fetch_add(1, Ordering::Relaxed);
        self.rows_scanned.fetch_add(rows, Ordering::Relaxed);
        self.gpu_ms.fetch_add(gpu_time_ms, Ordering::Relaxed);
    }

    /// Atomically read and reset all counters, returning `(queries, rows, gpu_ms)`.
    pub fn flush(&self) -> (usize, usize, usize) {
        let q = self.query_count.swap(0, Ordering::Relaxed);
        let r = self.rows_scanned.swap(0, Ordering::Relaxed);
        let g = self.gpu_ms.swap(0, Ordering::Relaxed);
        (q, r, g)
    }
}

/// Global metering coordinator.
///
/// In a real deployment this would hold a `DashMap<String, TenantMeter>`
/// and run a background flush loop pushing data to Stripe.
pub struct MeteringSystem {
    // Placeholder — expand when billing integration lands.
}

impl MeteringSystem {
    /// Create an idle metering system.
    pub fn new() -> Self {
        Self {}
    }

    /// Start the background flush loop (currently a no-op stub).
    pub async fn start_flush_loop(&self) {
        info!("metering flush loop started (stub — no billing backend configured)");
    }
}

impl Default for MeteringSystem {
    fn default() -> Self {
        Self::new()
    }
}