yog 0.0.18

yog: the standalone server for litany loops — the world, the balls and the conversations, behind one wire
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! The §5.1 #35 derivation: the latest step of the root, its prompt reading,
//! and every way the figure declines to be fabricated.

use super::{Fullness, of_agent};
use crate::budgets::{BudgetSpend, StepBill};
use std::collections::BTreeMap;

const ROOT: &str = "20260802T120000Z-root";
const KID: &str = "20260802T120000Z-root-20260802T120100Z-kid0";

fn usage(input: u64, read: u64, write: u64) -> BudgetSpend {
    BudgetSpend {
        input_tokens: input,
        output_tokens: 7,
        cache_read_tokens: read,
        cache_write_tokens: write,
    }
}

fn bill(conv: &str, seq: &str, model: Option<&str>, last: BudgetSpend) -> StepBill {
    StepBill {
        conv: conv.to_owned(),
        seq: seq.to_owned(),
        model: model.map(str::to_owned),
        spend: usage(999, 999, 999),
        last_usage: last,
        wall_secs: 0,
    }
}

fn windows() -> BTreeMap<String, u64> {
    BTreeMap::from([("sonnet".to_owned(), 200_000)])
}

/// The prompt reading itself is pinned where the formula lives
/// (`budgets::BudgetSpend::prompt_tokens`); what this module owes is that the
/// fullness figure asks for THAT reading of the right step. A contained cached
/// slice is the case that used to divide the two: a step reading `input 2_000,
/// cache_read 48_000` is a 48,000-token context, not a 50,000-token one.
#[test]
fn fullness_reads_the_folded_prompt_not_the_bare_input_counter() {
    let bills = [bill(ROOT, "001", Some("sonnet"), usage(2_000, 48_000, 0))];
    let full = of_agent(&bills, ROOT, &windows()).expect("a measured context");
    assert_eq!(full.prompt_tokens, 48_000);
}

/// The figure is the LATEST step of the ROOT: an earlier step of the same
/// conversation is history, and a dispatched child runs its own context.
#[test]
fn the_root_s_latest_step_is_the_context() {
    let bills = [
        bill(ROOT, "001", Some("sonnet"), usage(10_000, 0, 0)),
        bill(ROOT, "002", Some("sonnet"), usage(2_000, 48_000, 0)),
        bill(KID, "009", Some("sonnet"), usage(190_000, 0, 0)),
    ];
    let full = of_agent(&bills, ROOT, &windows()).expect("a measured context");
    assert_eq!(
        full,
        Fullness {
            model: "sonnet".to_owned(),
            prompt_tokens: 48_000,
            window: 200_000,
        }
    );
    assert_eq!(full.percent(), 24);
}

/// Step order is the zero-padded dir name's own order, so `010` follows `009`
/// — the property the fixed width exists for.
#[test]
fn step_order_is_lexical_because_the_width_is_fixed() {
    let bills = [
        bill(ROOT, "009", Some("sonnet"), usage(9, 0, 0)),
        bill(ROOT, "010", Some("sonnet"), usage(100_000, 0, 0)),
    ];
    let full = of_agent(&bills, ROOT, &windows()).expect("a measured context");
    assert_eq!(full.prompt_tokens, 100_000);
    assert_eq!(full.percent(), 50);
}

/// Three silences, each rendering nothing rather than a guess: no step, a step
/// whose `request.json` named no model, and a model nothing declared a window
/// for.
#[test]
fn nothing_honest_to_say_is_no_figure_at_all() {
    assert_eq!(of_agent(&[], ROOT, &windows()), None);
    assert_eq!(
        of_agent(
            &[bill(ROOT, "001", None, usage(10, 0, 0))],
            ROOT,
            &windows()
        ),
        None
    );
    assert_eq!(
        of_agent(
            &[bill(ROOT, "001", Some("opus"), usage(10, 0, 0))],
            ROOT,
            &windows()
        ),
        None
    );
}

/// An overflowing context reads as itself. A clamp would render "the
/// declaration is stale" and "the context is exactly full" as the same 100%.
#[test]
fn a_context_past_its_declared_window_is_not_clamped() {
    let bills = [bill(ROOT, "001", Some("sonnet"), usage(280_000, 0, 0))];
    let full = of_agent(&bills, ROOT, &windows()).expect("a measured context");
    assert_eq!(full.percent(), 140);
}