Reconcile Token Ledger

Tokens spent since the caller's last reconcile, and what kind of activity produced them.

consumed=0 is the expected shape for a pure balance read (used once per session/run, at cold start, before any billable activity has happened yet). consumption_type is required so this M2M endpoint can never be used to write a source other than the four debit categories it is meant for - grants, topups, and refunds each have their own dedicated, separately authorized call sites and must never be reachable here.

provider_id names the Provider whose rate this debit should convert consumed through - required for tts_character_debit/stt_second_debit (see reconcile_ledger's own 422 validation, raises if that provider has no rate configured); optional for llm_completion_debit, which converts through the named provider's rate when it resolves to an LLM-kind provider with a configured rate, and otherwise defaults to 1 raw unit = 1 credit; ignored entirely for mcp_tool_debit, which always stays 1 raw unit = 1 credit. model names the specific vendor model this usage ran on; input_tokens/output_tokens, when both given for an llm_completion_debit, must sum to consumed and price the two directions separately through that model's own input/output rates. cache_read_tokens/cache_write_tokens, which require that split, price prompt-cache reads and writes through the same model (see model_pricing.llm_debit_amount).