Skip to navigation

nemo_gym.agents.context_management.config

View as MarkdownOpen in Claude

Configuration models for semantic context compaction.

Module Contents

Classes

NameDescription
CompactionScheduleConfigChoose when an already-selected historical base may be rewritten.
ContextGuardConfigHard generation-admission limits evaluated only between turns.
ContextHistoryConfigCapability-gated semantic context-history configuration for a Gym agent.
HistoryPolicyConfigSelect a built-in or agent-registered history policy.
ImageRecencyConfigRetention controls for image observation groups.
ReasoningRecencyConfigRetention controls for reasoning blocks grouped by model-call turn.
RecencyHistoryPolicyConfigComposable per-kind recency configuration.

API

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'
nemo_gym.agents.context_management.config.CompactionScheduleConfig.validate_actions_per_chunk() -> 'CompactionScheduleConfig'
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)
nemo_gym.agents.context_management.config.ContextGuardConfig.validate_vision_projection() -> 'ContextGuardConfig'
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)
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)
nemo_gym.agents.context_management.config.HistoryPolicyConfig.validate_builtin_policy_config() -> 'HistoryPolicyConfig'
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
nemo_gym.agents.context_management.config.ImageRecencyConfig.validate_disabled_configuration() -> 'ImageRecencyConfig'
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')
nemo_gym.agents.context_management.config.ReasoningRecencyConfig.validate_disabled_configuration() -> 'ReasoningRecencyConfig'
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)
nemo_gym.agents.context_management.config.RecencyHistoryPolicyConfig.validate_at_least_one_kind() -> 'RecencyHistoryPolicyConfig'