Module usage 

Structs

SessionUsageRecord

Usage row returned by read helpers, including provenance and attribution.

UsageCostBreakdown

Stored dollar cost at request time.

UsageDedupeKey

Stable request identity used for dedupe across copied/forked session history.

UsageRecordV1

Canonical usage record stored inside SessionEntry::Custom.

UsageTokens

Raw token accounting captured at request time.

UsageTotals

Aggregate totals across usage records.

Enums

UsageRecordSource

Where a usage report came from when reading session history.

Constants

USAGE_CUSTOM_TYPE

Session custom entry type used for canonical usage accounting.

USAGE_RECORD_VERSION

Current canonical usage record schema version.

Functions

aggregate_usage

Sum usage rows without dedupe.

aggregate_usage_deduped

Sum usage rows while deduping copied/forked history by stable request id.

canonical_usage_record_for_assistant_turn

Build a canonical usage record for a persisted assistant turn.

canonical_usage_record_for_assistant_turn_with_model_meta

Build a canonical usage record for a persisted assistant turn from model metadata.

dedupe_usage_records

Return a deduped record set while preserving a stable canonical ordering.

usage_record_entry

Build a canonical session custom entry for persistence.

usage_records_from_entries

Read usage rows from a single session entry slice.

usage_records_from_session

Read usage rows from a session manager, attaching the session path when known.