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

Comment 1, line 1

//! ZCode-specific mappings for two usage shapes, moved from root usage_map.rs under V30.

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

//!

//! References: m0-agent-fixtures.md native ZCode 3.14.3 model-io JSONL checks.

//! One request record contains two usage representations with different input semantics:

//!

//! - AI SDK camelCase response.usage: inputTokens includes cache read; outputTokens,

//!   totalTokens, cacheReadTokens and cacheWriteTokens complete its five keys; primary representation.

//! - Anthropic snake_case response.providerMetadata.anthropic.usage:

//!   input_tokens excludes cache; output_tokens, cache_read_input_tokens and

//!   optional cache_creation_input_tokens form the comparison representation.

//!

//! Choose one representation without adding them. Contradictions produce diagnostics; retain the primary.

/// ZCode AI SDK camelCase inputTokens includes cache read.

// Missing exclusive cache components cannot be replaced with zero to derive uncached input.

/// ZCode Anthropic snake_case input_tokens excludes cache, unlike the AI SDK representation.