UsageTotals

Content-free aggregate measurements for one usage scope or reporting row.

Provider token fields remain optional so an unavailable measurement cannot be mistaken for a reported zero. Context counts and bytes are measured by Koru itself and therefore have exact zero values.

Type object

Shape

Field	Type	Description
attemptsrequired	integer (uint64, >= 0)
attempts_with_reported_usagerequired	integer (uint64, >= 0)
request_payload_bytes	integer (uint64, >= 0) or null
web_search_calls	integer (uint64, >= 0)	Default `0`
context_payload_bytesrequired	integer (uint64, >= 0)
message_countrequired	integer (uint64, >= 0)
context_document_countrequired	integer (uint64, >= 0)
context_message_block_countrequired	integer (uint64, >= 0)
prompt_tokens	integer (uint64, >= 0) or null
cached_prompt_tokens	integer (uint64, >= 0) or null
completion_tokens	integer (uint64, >= 0) or null
reasoning_tokens	integer (uint64, >= 0) or null
total_tokens	integer (uint64, >= 0) or null
average_context_assembly_ms	integer (uint64, >= 0) or null
average_provider_start_ms	integer (uint64, >= 0) or null
average_time_to_first_token_ms	integer (uint64, >= 0) or null
average_generation_ms	integer (uint64, >= 0) or null
average_total_ms	integer (uint64, >= 0) or null
good_feedbackrequired	integer (uint64, >= 0)
bad_feedbackrequired	integer (uint64, >= 0)

Example

{
  "attempts": 0,
  "attempts_with_reported_usage": 0,
  "request_payload_bytes": 0,
  "web_search_calls": 0,
  "context_payload_bytes": 0,
  "message_count": 0,
  "context_document_count": 0,
  "context_message_block_count": 0,
  "prompt_tokens": 0,
  "cached_prompt_tokens": 0,
  "completion_tokens": 0,
  "reasoning_tokens": 0,
  "total_tokens": 0,
  "average_context_assembly_ms": 0,
  "average_provider_start_ms": 0,
  "average_time_to_first_token_ms": 0,
  "average_generation_ms": 0,
  "average_total_ms": 0,
  "good_feedback": 0,
  "bad_feedback": 0
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.