desktop/src-tauri/crates/core/src/adapters/codex/common.rs

Comment 1, line 1

//! Codex usage mapping moved from root usage_map.rs under the V30 directory rules.

//! Shared MappedUsage/finish/sub_checked/contradiction checks remain in usage_map.rs.

/// Cumulative snapshots are comparisons only; per-record read errors determine file health.

/// TokenCountEvent.info is Option<TokenUsageInfo>; quota-only updates may lack usage.

/// Verified against official rust-v0.144.0 protocol.rs and native 0.144.0-alpha.4 samples.

/// Codex rollout usage: input includes cache read, with no cache-creation field;

/// output includes reasoning, and total=input+output.

/// declares_no_cache_creation requires a verified version/format declaration:

/// only then derive uncached=input-cached and cache write=0.

/// Complete Codex 0.155.0-alpha.16.3 usage in token_usage_record.payload.usage

/// and token_count total/last_token_usage has the same six required fields.

/// cached is an input subset (319/319 native samples); reasoning is an output subset;

/// total=input+output. Cache-write inclusion is a schema-based mapping assumption:

/// native samples cover cache_write=0 only. Diagnose contradictions instead of hiding them with max(0, ...).