> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/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. ## Docs - [nemo_gym.agents.context_management.client](https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/client.md) - [nemo_gym.agents.context_management.config](https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/config.md) - [nemo_gym.agents.context_management.controller](https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/controller.md) - [nemo_gym.agents.context_management.history](https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/history.md) - [nemo_gym.agents.context_management.materialization](https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/materialization.md) - [nemo_gym.agents.context_management.policies](https://docs.nvidia.com/nemo/gym/v0.3.0/nemo-gym/nemo_gym/agents/context_management/policies.md)