Jido.AI.Usage (Jido AI v2.2.0)

Helpers for merging provider usage metadata.

Summary

Adds :total_tokens when input and output token counters are available.

Merges two usage maps while summing numeric counters and preserving provider metadata.

normalize(usage)

Normalizes common usage counter keys and numeric counter values.

@spec ensure_total_tokens(map()) :: map()

Adds :total_tokens when input and output token counters are available.

@spec merge(term(), term()) :: map()

Merges two usage maps while summing numeric counters and preserving provider metadata.

@spec normalize(term()) :: map() | nil

Normalizes common usage counter keys and numeric counter values.