sprawling-wire 0.0.12

The process boundary of a sprawling city: the frames its clients speak, and the server that answers them.
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

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
// Copyright (c) 2026 2youg1 and the sprawling contributors

//! The city's cost view: one authoritative total and the cuts of it a
//! page draws (`crates/wire/spec/Server.lean` ยง8-2).

use kernel::UsdMicros;
use serde::{Deserialize, Serialize};

/// The five cuts of one authoritative total. Four cuts sum to `total`;
/// `by_run` names the active runs and the few billed most, so it may sum
/// to less. Shares render against `total`, so a remainder stays visible.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct CostAnswer {
    pub total: UsdMicros,
    pub by_run: Vec<(String, UsdMicros)>,
    pub by_actor: Vec<(String, UsdMicros)>,
    pub by_segment: Vec<(String, UsdMicros)>,
    pub by_tool: Vec<(String, UsdMicros)>,
    pub by_skill: Vec<(String, UsdMicros)>,
    /// The calls no provider priced, which `total` cannot show.
    pub unpriced: UnpricedCalls,
    /// The keep-warm renewals: their spend, already inside `total`, and
    /// how many there were by what each showed.
    pub renewals: Renewals,
}

/// The model calls that came back with no authoritative amount, and the
/// tokens they used. A city whose provider never prices a call has a
/// zero `total` after any number of runs; this is what tells that city
/// apart from one where nothing ran.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct UnpricedCalls {
    pub calls: u64,
    pub tokens: u64,
}

/// The keep-warm renewals the city sent, as `storage::Renewals` counts
/// them (storage D35, D36). `billed` is already inside `total` and the
/// cuts, under the room and the `keep_warm` bucket, so a page draws it
/// as a line inside the total and never adds it again. The four counts
/// sum to the renewals sent; `late` ones arrived after the cache had
/// gone and paid the write price for the prefix.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct Renewals {
    pub billed: UsdMicros,
    pub read: u64,
    pub late: u64,
    pub unreported: u64,
    pub refused: u64,
}