chio_metering/lib.rs
1//! Receipt metering and economics for the Chio protocol.
2//!
3//! This crate provides per-receipt cost attribution, cumulative cost queries,
4//! monetary budget enforcement via chio-link oracle integration, and
5//! billing-export-compatible cost metadata.
6//!
7//! # Modules
8//!
9//! - [`cost`] -- Per-receipt cost metadata (compute time, data volume, API cost)
10//! - [`query`] -- CLI-style cost queries by session, agent, tool, or time range
11//! - [`budget`] -- Monetary budget enforcement with denominated currency
12//! - [`budget_hierarchy`] -- Tree-structured budget governance across
13//! organizational scopes (org -> department -> team -> agent)
14//! - [`export`] -- Billing-export-compatible cost records
15
16#![cfg_attr(test, allow(clippy::expect_used, clippy::unwrap_used))]
17
18pub mod budget;
19pub mod budget_hierarchy;
20pub mod cost;
21pub mod export;
22pub mod query;
23
24pub use budget::{BudgetEnforcer, BudgetPolicy, BudgetViolation};
25pub use budget_hierarchy::{
26 AggregateSpend, BudgetDecision, BudgetDenyReason, BudgetError, BudgetLimits, BudgetNode,
27 BudgetNodeId, BudgetTree, BudgetWindow, PerWindowSpend, SpendSnapshot,
28};
29pub use cost::{CostDimension, CostMetadata};
30pub use export::{BillingExport, BillingRecord};
31pub use query::{CostQuery, CostQueryResult, CostSummary};