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

Comment 1, line 1

//! DSH usage mapping originates in fixed token-meter README 46a7f68, A08.

//! Legacy persistence references remain distinct from the separately checked native v4 reader.

//!

//! Reference: packages/llm/token-meter/README.md at 46a7f68.

//! - "tokenUsage carries the complete durable log's `uncachedInputTokens`,

//!   `outputTokens`, `cacheReadTokens`, and `cacheWriteTokens`"; all four fields

//!   are optional: "each corresponding aggregate appears only when every

//!   participating attempt reports its optional cache, reasoning, or route

//!   value". Missing cache is unknown, without zero substitution.

//! - uncachedInputTokens is uncached input;

//!   input_total derives uncached + cacheRead + cacheWrite;

//!   total_tokens derives input_total + output.

//!

//! Shared MappedUsage/finish logic remains in cross-product usage_map.rs.

/// Four optional DSH durable-log usage fields carried by assistant/message records.

/// Serde persists unfinished attempt samples across scan rounds.

/// True when all four usage fields are absent.