nemo_gym.agents.utils.sandbox_observation

Sandbox observations built only from lifecycle facts an AsyncSandbox actually saw.

Module Contents

Functions

Name	Description
`lifecycle_observation`	The owner’s observation of one created sandbox, or None when there is no AsyncSandbox to observe.

API

nemo_gym.agents.utils.lifecycle_observation(
    sandbox: nemo_gym.sandbox.api.AsyncSandbox | None,
    role: typing.Literal['agent', 'verifier', 'environment']
) -> dict[str, typing.Any] | None

The owner’s observation of one created sandbox, or None when there is no AsyncSandbox to observe.

outcome is sandbox_error only when every provider close failed; otherwise it stays unknown: a confirmed teardown says nothing about the command or the grade. Cleanup failures stay listed after a retry, with the first as error_type. Resource usage and remote lifetime are never estimated.