# RecordedRequest

> **Class** in `deepagents_code`

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

What a stream consumer last recorded for one request.

Held so a later chunk of the same request can retract that exact
contribution and re-record the running totals, keeping one API call to one
request and one per-model row.

## Signature

```python
RecordedRequest(
    self,
    model_name: str,
    provider: str,
    kind: UsageKind,
    input_tokens: int,
    output_tokens: int,
    cache_read_tokens: int,
    cache_write_tokens: int,
    cost_usd: float | None,
    usage_metadata: Mapping[str, Any],
    finalized: bool,
    message_ids: frozenset[str] = frozenset(),
    ledger_key: UsageLedgerKey | None = None,
    request_bucket: str | None = None,
    invocation_id: str | None = None,
    aliases: frozenset[UsageLedgerKey] = frozenset(),
)
```

## Constructors

```python
__init__(
    self,
    model_name: str,
    provider: str,
    kind: UsageKind,
    input_tokens: int,
    output_tokens: int,
    cache_read_tokens: int,
    cache_write_tokens: int,
    cost_usd: float | None,
    usage_metadata: Mapping[str, Any],
    finalized: bool,
    message_ids: frozenset[str] = frozenset(),
    ledger_key: UsageLedgerKey | None = None,
    request_bucket: str | None = None,
    invocation_id: str | None = None,
    aliases: frozenset[UsageLedgerKey] = frozenset(),
) -> None
```

| Name | Type |
|------|------|
| `model_name` | `str` |
| `provider` | `str` |
| `kind` | `UsageKind` |
| `input_tokens` | `int` |
| `output_tokens` | `int` |
| `cache_read_tokens` | `int` |
| `cache_write_tokens` | `int` |
| `cost_usd` | `float \| None` |
| `usage_metadata` | `Mapping[str, Any]` |
| `finalized` | `bool` |
| `message_ids` | `frozenset[str]` |
| `ledger_key` | `UsageLedgerKey \| None` |
| `request_bucket` | `str \| None` |
| `invocation_id` | `str \| None` |
| `aliases` | `frozenset[UsageLedgerKey]` |


## Properties

- `model_name`
- `provider`
- `kind`
- `input_tokens`
- `output_tokens`
- `cache_read_tokens`
- `cache_write_tokens`
- `cost_usd`
- `usage_metadata`
- `finalized`
- `message_ids`
- `ledger_key`
- `request_bucket`
- `invocation_id`
- `aliases`

---

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