# SessionStats

> **Class** in `deepagents_code`

📖 [View in docs](https://reference.langchain.com/python/deepagents-code/_session_stats/SessionStats)

Stats accumulated over a single agent turn (or full session).

## Signature

```python
SessionStats(
    self,
    request_count: int = 0,
    invocation_count: int = 0,
    input_tokens: int = 0,
    output_tokens: int = 0,
    cache_read_tokens: int = 0,
    cache_write_tokens: int = 0,
    total_cost_usd: float = 0.0,
    priced_request_count: int = 0,
    wall_time_seconds: float = 0.0,
    per_model: dict[ModelStatsKey, ModelStats] = dict(),
    per_kind: dict[UsageKind, KindStats] = dict(),
)
```

## Constructors

```python
__init__(
    self,
    request_count: int = 0,
    invocation_count: int = 0,
    input_tokens: int = 0,
    output_tokens: int = 0,
    cache_read_tokens: int = 0,
    cache_write_tokens: int = 0,
    total_cost_usd: float = 0.0,
    priced_request_count: int = 0,
    wall_time_seconds: float = 0.0,
    per_model: dict[ModelStatsKey, ModelStats] = dict(),
    per_kind: dict[UsageKind, KindStats] = dict(),
) -> None
```

| Name | Type |
|------|------|
| `request_count` | `int` |
| `invocation_count` | `int` |
| `input_tokens` | `int` |
| `output_tokens` | `int` |
| `cache_read_tokens` | `int` |
| `cache_write_tokens` | `int` |
| `total_cost_usd` | `float` |
| `priced_request_count` | `int` |
| `wall_time_seconds` | `float` |
| `per_model` | `dict[ModelStatsKey, ModelStats]` |
| `per_kind` | `dict[UsageKind, KindStats]` |


## Properties

- `request_count`
- `invocation_count`
- `input_tokens`
- `output_tokens`
- `cache_read_tokens`
- `cache_write_tokens`
- `total_cost_usd`
- `priced_request_count`
- `wall_time_seconds`
- `per_model`
- `per_kind`

## Methods

- [`record_invocation()`](https://reference.langchain.com/python/deepagents-code/_session_stats/SessionStats/record_invocation)
- [`record_request()`](https://reference.langchain.com/python/deepagents-code/_session_stats/SessionStats/record_request)
- [`retract_request()`](https://reference.langchain.com/python/deepagents-code/_session_stats/SessionStats/retract_request)
- [`merge()`](https://reference.langchain.com/python/deepagents-code/_session_stats/SessionStats/merge)

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/caaa7e7c12d214afa5cf0a1afed8eb6232aa6f7b/libs/code/deepagents_code/_session_stats.py#L212)