> This page is for version 0.4.0.
> 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

Opt-in context management shared by sequential Responses agents.

## Submodules

* **[`nemo_gym.agents.context_management.client`](/nemo/gym/nemo-gym/nemo_gym/agents/context_management/client)**
* **[`nemo_gym.agents.context_management.config`](/nemo/gym/nemo-gym/nemo_gym/agents/context_management/config)**
* **[`nemo_gym.agents.context_management.controller`](/nemo/gym/nemo-gym/nemo_gym/agents/context_management/controller)**
* **[`nemo_gym.agents.context_management.history`](/nemo/gym/nemo-gym/nemo_gym/agents/context_management/history)**
* **[`nemo_gym.agents.context_management.materialization`](/nemo/gym/nemo-gym/nemo_gym/agents/context_management/materialization)**
* **[`nemo_gym.agents.context_management.policies`](/nemo/gym/nemo-gym/nemo_gym/agents/context_management/policies)**

## Package Contents

### Classes

| Name                                                                                                        | Description                                                                       |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [`ContextGuardRejected`](#nemo_gym-agents-context_management-client-ContextGuardRejected)                   | The next action cannot satisfy the configured guards, even after compaction.      |
| [`ContextHistoryConfig`](#nemo_gym-agents-context_management-config-ContextHistoryConfig)                   | Capability-gated semantic context-history configuration for a Gym agent.          |
| [`ContextManagedResponsesClient`](#nemo_gym-agents-context_management-client-ContextManagedResponsesClient) | One logical rollout. A transport ambiguity is terminal; it is never retried here. |

### API

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

**Bases:** `RuntimeError`

The next action cannot satisfy the configured guards, even after compaction.

```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.ContextManagedResponsesClient(
    server_client: nemo_gym.client.server_client.ServerClient,
    model_server: nemo_gym.config.config_types.ModelServerRef,
    logical_rollout_id: str,
    config: nemo_gym.agents.context_management.config.ContextHistoryConfig,
    initial_request: nemo_gym.core.responses_api_types.NeMoGymResponseCreateParamsNonStreaming,
    seed_observations: collections.abc.Sequence[typing.Any] = (),
    cookies: typing.Any = None
)
```

One logical rollout. A transport ambiguity is terminal; it is never retried here.

Agents may pass their complete append-only history to `create(body)` or call
`append_observation(items)` followed by `create()`. Both use the same history.
`select_response` permits bounded, deliberate resampling of definite responses.

**`_last_accepted_response_id`** `str | None = None`

---

**`_model_calls`** `= 0`

---

**`_request`** `= initial_request.model_copy(deep=True)`

---

**`_seed_event_count`** `= len(self.history.events)`

---

**`_selected_ids`** `set[str] = set()`

---

**`_step`** `= 1`

---

**`config`** `= config.model_copy(deep=True)`

---

**`controller`**

---

**`cookies`** `= dict(cookies or {})`

---

**`history`** `= SemanticHistory(logical_rollout_id)`

---

**`output_items`** `list[dict[str, Any]]`

Materialize the final conversation once, not a full prefix per action.

---

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._accept(
    prepared: nemo_gym.agents.context_management.history.PreparedHistoryView,
    response: nemo_gym.core.responses_api_types.NeMoGymResponse
) -> None
```

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._append_suffix(
    body: nemo_gym.core.responses_api_types.NeMoGymResponseCreateParamsNonStreaming
) -> None
```

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._call(
    prepared: nemo_gym.agents.context_management.history.PreparedHistoryView
) -> nemo_gym.core.responses_api_types.NeMoGymResponseCreateParamsNonStreaming
```

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._check_open() -> None
```

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._measure(
    prepared: nemo_gym.agents.context_management.history.PreparedHistoryView
) -> nemo_gym.agents.context_management.history.ContextMeasurements
```

async

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._prepare() -> nemo_gym.agents.context_management.history.PreparedHistoryView
```

async

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient._semantic_source() -> list[dict[str, typing.Any]]
```

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient.append_observation(
    items: collections.abc.Sequence[typing.Any]
) -> None
```

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient.create(
    body: nemo_gym.core.responses_api_types.NeMoGymResponseCreateParamsNonStreaming | None = None,
    select_response: collections.abc.Callable[[NeMoGymResponse], bool | collections.abc.Awaitable[bool]] | None = None
) -> nemo_gym.core.responses_api_types.NeMoGymResponse
```

async

```python
nemo_gym.agents.context_management.ContextManagedResponsesClient.finish(
    response: nemo_gym.core.responses_api_types.NeMoGymResponse
) -> None
```

Validate the final accepted response and close the policy lifecycle.