# `MingaClaudeBridge.Wire.Usage`
[🔗](https://github.com/jsmestad/minga-claude-bridge/blob/main/lib/minga_claude_bridge/wire/usage.ex#L1)

Token counts from an Anthropic `usage` object.

Claude Code reports usage on `message_start`, `message_delta`, `assistant` messages, and `result`. A count the frame does not carry is `nil`, not zero: a `message_delta` often carries only `output_tokens`, and a missing count is unknown rather than zero.

# `count`

```elixir
@type count() :: non_neg_integer() | nil
```

# `t`

```elixir
@type t() :: %MingaClaudeBridge.Wire.Usage{
  cache_creation_input_tokens: count(),
  cache_read_input_tokens: count(),
  input_tokens: count(),
  output_tokens: count()
}
```

# `field`

```elixir
@spec field(MingaClaudeBridge.Wire.Field.json_map(), String.t()) ::
  {:ok, t() | nil} | :error
```

Reads an optional `usage` field from a wire map.

# `from_wire`

```elixir
@spec from_wire(MingaClaudeBridge.Wire.Field.json_map() | nil) ::
  {:ok, t() | nil} | :error
```

Decodes a wire `usage` object. `nil` decodes to `nil`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
