> This page is for version 0.5.1.
> For other versions, use one of these documentation indexes:
> - Main (default): https://docs.nvidia.com/nemo/gym/main/llms.txt
> - 0.7.0: https://docs.nvidia.com/nemo/gym/v0.7.0/llms.txt
> - 0.6.0: https://docs.nvidia.com/nemo/gym/v0.6.0/llms.txt
> - 0.5.1: https://docs.nvidia.com/nemo/gym/v0.5.1/llms.txt
> - 0.5.0: https://docs.nvidia.com/nemo/gym/v0.5.0/llms.txt
> - 0.4.0: https://docs.nvidia.com/nemo/gym/v0.4.0/llms.txt
> - 0.3.0: https://docs.nvidia.com/nemo/gym/v0.3.0/llms.txt
> - 0.2.1: https://docs.nvidia.com/nemo/gym/v0.2.1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/gym/llms.txt.

# nemo_gym.agents.context_management.config

Configuration models for semantic context compaction.

## Module Contents

### Classes

| Name                                                                                                  | Description                                                              |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`CompactionScheduleConfig`](#nemo_gym-agents-context_management-config-CompactionScheduleConfig)     | Choose when an already-selected historical base may be rewritten.        |
| [`ContextGuardConfig`](#nemo_gym-agents-context_management-config-ContextGuardConfig)                 | Hard generation-admission limits evaluated only between turns.           |
| [`ContextHistoryConfig`](#nemo_gym-agents-context_management-config-ContextHistoryConfig)             | Capability-gated semantic context-history configuration for a Gym agent. |
| [`HistoryPolicyConfig`](#nemo_gym-agents-context_management-config-HistoryPolicyConfig)               | Select a built-in or agent-registered history policy.                    |
| [`ImageRecencyConfig`](#nemo_gym-agents-context_management-config-ImageRecencyConfig)                 | Retention controls for image observation groups.                         |
| [`ReasoningRecencyConfig`](#nemo_gym-agents-context_management-config-ReasoningRecencyConfig)         | Retention controls for reasoning blocks grouped by model-call turn.      |
| [`RecencyHistoryPolicyConfig`](#nemo_gym-agents-context_management-config-RecencyHistoryPolicyConfig) | Composable per-kind recency configuration.                               |

### API

```python
class nemo_gym.agents.context_management.config.CompactionScheduleConfig()
```

**Bases:** `BaseModel`

Choose when an already-selected historical base may be rewritten.

**`actions_per_chunk`** `int = Field(default=1, ge=1)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

**`type`** `Literal['rolling_recency', 'turn_chunked_recency'] = 'rolling_recency'`

---

```python
nemo_gym.agents.context_management.config.CompactionScheduleConfig.validate_actions_per_chunk() -> 'CompactionScheduleConfig'
```

```python
class nemo_gym.agents.context_management.config.ContextGuardConfig()
```

**Bases:** `BaseModel`

Hard generation-admission limits evaluated only between turns.

**`max_active_images`** `int | None = Field(default=None, ge=0)`

---

**`max_total_tokens`** `int | None = Field(default=None, ge=1)`

---

**`max_vision_tokens`** `int | None = Field(default=None, ge=0)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

**`projected_vision_tokens_per_image`** `int | None = Field(default=None, ge=0)`

---

**`reserved_generation_tokens`** `int = Field(default=0, ge=0)`

---

```python
nemo_gym.agents.context_management.config.ContextGuardConfig.validate_vision_projection() -> 'ContextGuardConfig'
```

```python
class nemo_gym.agents.context_management.ContextHistoryConfig()
```

**Bases:** `BaseModel`

Capability-gated semantic context-history configuration for a Gym agent.

**`enabled`** `bool = False`

---

**`guards`** `ContextGuardConfig = Field(default_factory=ContextGuardConfig)`

---

**`max_model_calls`** `int = Field(default=256, ge=1)`

---

**`max_response_retries`** `int = Field(default=0, ge=0)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

**`policy`** `HistoryPolicyConfig = Field(default_factory=HistoryPolicyConfig)`

---

**`schedule`** `CompactionScheduleConfig = Field(default_factory=CompactionScheduleConfig)`

---

```python
class nemo_gym.agents.context_management.config.HistoryPolicyConfig()
```

**Bases:** `BaseModel`

Select a built-in or agent-registered history policy.

**`config`** `RecencyHistoryPolicyConfig | dict[str, Any] = Field(default_factory=dict)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

**`type`** `str = Field(default='identity', min_length=1)`

---

```python
nemo_gym.agents.context_management.config.HistoryPolicyConfig.validate_builtin_policy_config() -> 'HistoryPolicyConfig'
```

```python
class nemo_gym.agents.context_management.config.ImageRecencyConfig()
```

**Bases:** `BaseModel`

Retention controls for image observation groups.

**`enabled`** `bool = False`

---

**`keep_last_groups`** `int = Field(default=3, ge=0)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

**`omission_marker`** `str | None = '[Earlier image omitted]'`

---

**`protect_initial_context`** `bool = True`

---

```python
nemo_gym.agents.context_management.config.ImageRecencyConfig.validate_disabled_configuration() -> 'ImageRecencyConfig'
```

```python
class nemo_gym.agents.context_management.config.ReasoningRecencyConfig()
```

**Bases:** `BaseModel`

Retention controls for reasoning blocks grouped by model-call turn.

**`enabled`** `bool = False`

---

**`keep_first_block`** `bool = False`

---

**`keep_last_blocks`** `int = Field(default=3, ge=0)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

```python
nemo_gym.agents.context_management.config.ReasoningRecencyConfig.validate_disabled_configuration() -> 'ReasoningRecencyConfig'
```

```python
class nemo_gym.agents.context_management.config.RecencyHistoryPolicyConfig()
```

**Bases:** `BaseModel`

Composable per-kind recency configuration.

**`images`** `ImageRecencyConfig = Field(default_factory=ImageRecencyConfig)`

---

**`model_config`** `= ConfigDict(extra='forbid')`

---

**`reasoning`** `ReasoningRecencyConfig = Field(default_factory=ReasoningRecencyConfig)`

---

```python
nemo_gym.agents.context_management.config.RecencyHistoryPolicyConfig.validate_at_least_one_kind() -> 'RecencyHistoryPolicyConfig'
```