> This page is for version Main (default).
> 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.controller

Rewrite-boundary controllers and context-admission guards.

## Module Contents

### Classes

| Name                                                                                                          | Description                                                      |
| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [`HistoryController`](#nemo_gym-agents-context_management-controller-HistoryController)                       | Retry-safe per-rollout owner of request-view rewrite boundaries. |
| [`TurnChunkedHistoryController`](#nemo_gym-agents-context_management-controller-TurnChunkedHistoryController) | Freeze one compacted base and append a tail for up to K actions. |

### Functions

| Name                                                                                                            | Description                                                          |
| --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`build_guard_outcome_records`](#nemo_gym-agents-context_management-controller-build_guard_outcome_records)     | -                                                                    |
| [`evaluate_context_guards`](#nemo_gym-agents-context_management-controller-evaluate_context_guards)             | Evaluate every configured hard limit without changing history state. |
| [`pending_observation_group_ids`](#nemo_gym-agents-context_management-controller-pending_observation_group_ids) | -                                                                    |

### API

```python
class nemo_gym.agents.context_management.controller.HistoryController(
    history: 'SemanticHistory',
    policy: 'HistoryPolicy'
)
```

Retry-safe per-rollout owner of request-view rewrite boundaries.

**`_boundary_events`** `list[RewriteBoundaryEvent] = []`

---

**`_completed_descriptor`** `tuple[str, ...] | None = None`

---

**`_completed_image_part_ids`** `tuple[str, ...] | None = None`

---

**`_completed_items`** `tuple | None = None`

---

**`_completed_view_digest`** `str | None = None`

---

**`_context_epoch`** `= 0`

---

**`_pending_boundary`** `RewriteBoundaryEvent | None = None`

---

**`boundary_events`** `tuple[RewriteBoundaryEvent, ...]`

---

**`evaluation_count`** `= 0`

---

**`pending_boundary`** `RewriteBoundaryEvent | None`

---

```python
nemo_gym.agents.context_management.controller.HistoryController._make_boundary(
    applies_to_step: int,
    previous_view_digest: str,
    view: nemo_gym.agents.context_management.history.MaterializedHistoryView,
    current_view_digest: str
) -> nemo_gym.agents.context_management.history.RewriteBoundaryEvent
```

```python
nemo_gym.agents.context_management.controller.HistoryController._plan(
    applies_to_step: int
) -> nemo_gym.agents.context_management.history.HistoryViewPlan
```

```python
nemo_gym.agents.context_management.controller.HistoryController.acknowledge(
    prepared: nemo_gym.agents.context_management.history.PreparedHistoryView
) -> None
```

```python
nemo_gym.agents.context_management.controller.HistoryController.prepare(
    applies_to_step: int
) -> nemo_gym.agents.context_management.history.PreparedHistoryView
```

```python
class nemo_gym.agents.context_management.controller.TurnChunkedHistoryController(
    history: 'SemanticHistory',
    policy: 'HistoryPolicy',
    actions_per_chunk: int
)
```

**Bases:** [HistoryController](#nemo_gym-agents-context_management-controller-HistoryController)

Freeze one compacted base and append a tail for up to K actions.

**`_action_ids`** `list[str] = []`

---

**`_action_turns`** `list[int] = []`

---

**`_base_plan`** `HistoryViewPlan | None = None`

---

**`_block_index`** `= -1`

---

**`_chunk_id`** `str | None = None`

---

**`_chunk_records`** `list[FinalizedChunkRecord] = []`

---

**`_completion_ids`** `list[str] = []`

---

**`_known_base_part_ids`** `frozenset[str] = frozenset()`

---

**`_last_acknowledged`** `PreparedHistoryView | None = None`

---

**`chunk_records`** `tuple[FinalizedChunkRecord, ...]`

---

**`completed_actions_in_current_chunk`** `int`

---

**`current_chunk_id`** `str | None`

---

**`schedule_config_digest`**

---

**`schedule_name`** `= 'turn_chunked_recency'`

---

**`schedule_version`** `= '1'`

---

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController._finalize_chunk(
    early_close_reason: str | None
) -> None
```

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController._make_boundary(
    applies_to_step: int,
    previous_view_digest: str,
    view: nemo_gym.agents.context_management.history.MaterializedHistoryView,
    current_view_digest: str
) -> nemo_gym.agents.context_management.history.RewriteBoundaryEvent
```

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController._plan(
    applies_to_step: int
) -> nemo_gym.agents.context_management.history.HistoryViewPlan
```

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController._start_chunk(
    applies_to_step: int
) -> None
```

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController.acknowledge_action(
    prepared: nemo_gym.agents.context_management.history.PreparedHistoryView,
    action_id: str,
    completion_id: str
) -> None
```

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController.close_for_guard(
    guard_name: str
) -> bool
```

Close a non-empty chunk before its next action and allow recompaction.

```python
nemo_gym.agents.context_management.controller.TurnChunkedHistoryController.finalize_terminal() -> None
```

```python
nemo_gym.agents.context_management.controller.build_guard_outcome_records(
    rollout_id: str,
    chunk_id: str | None,
    applies_to_step: int,
    completed_action_count: int,
    pending_group_ids: typing.Sequence[str],
    before: typing.Sequence[nemo_gym.agents.context_management.history.GuardEvaluation],
    after: typing.Sequence[nemo_gym.agents.context_management.history.GuardEvaluation] | None,
    early_chunk_close: bool
) -> tuple[nemo_gym.agents.context_management.history.GuardOutcomeRecord, ...]
```

```python
nemo_gym.agents.context_management.controller.evaluate_context_guards(
    config: nemo_gym.agents.context_management.config.ContextGuardConfig,
    measurements: nemo_gym.agents.context_management.history.ContextMeasurements
) -> tuple[nemo_gym.agents.context_management.history.GuardEvaluation, ...]
```

Evaluate every configured hard limit without changing history state.

```python
nemo_gym.agents.context_management.controller.pending_observation_group_ids(
    history: nemo_gym.agents.context_management.history.SemanticHistory,
    applies_to_step: int
) -> tuple[str, ...]
```