> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Context Ledger • Rust AI Agent SDK

> ContextLedger: Tracks token usage across different context segments.

# ContextLedger

> Defined in the [**context**](../modules/context) module.

<Badge color="orange">Rust AI Agent SDK</Badge>

Tracks token usage across different context segments.

## Fields

| Name           | Type                        | Description            |
| -------------- | --------------------------- | ---------------------- |
| `segments`     | `Vec&lt;ContextSegment&gt;` | Segments in the ledger |
| `total_tokens` | `usize`                     | Total tokens used      |
| `max_tokens`   | `usize`                     | Maximum allowed tokens |

## Methods

### `new`

```rust theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
fn new(max_tokens: usize) -> Self
```

Create a new ledger with max tokens

**Parameters:**

| Name         | Type    |
| ------------ | ------- |
| `max_tokens` | `usize` |

### `add`

```rust theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
fn add(&mut self, segment: ContextSegment) -> ()
```

Add a segment to the ledger

**Parameters:**

| Name      | Type             |
| --------- | ---------------- |
| `segment` | `ContextSegment` |

### `remaining`

```rust theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
fn remaining(&self) -> usize
```

Get remaining tokens

### `is_over_budget`

```rust theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
fn is_over_budget(&self) -> bool
```

Check if over budget

### `utilization`

```rust theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
fn utilization(&self) -> f64
```

Get utilization percentage

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-rust/praisonai/src/context/mod.rs#L95">
  `praisonai/src/context/mod.rs` at line 95
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Rust Context Management" icon="layer-group" href="/docs/rust/context-management" />

  <Card title="Rust Token Management" icon="coins" href="/docs/rust/token-management" />
</CardGroup>
