nemo_gym.web.session

Backend-neutral session state and lifecycle errors for web runtimes.

Module Contents

Classes

Name	Description
`BenchmarkPreconditionError`	A deterministic task/environment setup failure for the deployment.
`CapacityUnavailableError`	-
`EvaluatorConfigurationError`	A required model-backed evaluator is not configured for a task.
`EvaluatorInfrastructureError`	A benchmark evaluator or post-action environment operation failed.
`SessionConflictError`	-
`SessionNotFoundError`	-
`WebSessionState`	Process-local state for one leased visual-browser rollout.

API

class nemo_gym.web.session.BenchmarkPreconditionError()

Bases: RuntimeError

A deterministic task/environment setup failure for the deployment.

class nemo_gym.web.session.CapacityUnavailableError()

Bases: RuntimeError

class nemo_gym.web.session.EvaluatorConfigurationError()

Bases: RuntimeError

A required model-backed evaluator is not configured for a task.

class nemo_gym.web.session.EvaluatorInfrastructureError()

Bases: RuntimeError

A benchmark evaluator or post-action environment operation failed.

class nemo_gym.web.session.SessionConflictError()

Bases: RuntimeError

class nemo_gym.web.session.SessionNotFoundError()

Bases: KeyError

class nemo_gym.web.session.WebSessionState(
    session_id: str,
    task: nemo_gym.web.models.WebTask,
    backend: nemo_gym.web.protocol.WebEnvironmentBackend,
    browser_lease: nemo_gym.web.browser_session.BrowserSessionHandle,
    site_lease: nemo_gym.web.site_pool.SiteLease,
    observation: nemo_gym.web.models.WebObservation,
    seed_info: dict[str, typing.Any],
    created_at: float,
    last_access_at: float,
    operation_runner: nemo_gym.web.operation_runner.WebOperationRunner,
    status: str = 'ready',
    fenced: bool = False,
    lock: asyncio.Lock = asyncio.Lock(),
    operations: collections.OrderedDict[str, nemo_gym.web.api_models.WebStepResponse] = OrderedDict(),
    verifier_result: nemo_gym.web.models.WebVerifierResult | None = None,
    browser_heartbeat_failures: int = 0
)

Dataclass

Process-local state for one leased visual-browser rollout.

backend

WebEnvironmentBackend

browser_heartbeat_failures

int = 0

browser_lease

BrowserSessionHandle

created_at

float

fenced

bool = False

last_access_at

float

lock

Lock = field(default_factory=(asyncio.Lock))

observation

WebObservation

operation_runner

WebOperationRunner

operations

OrderedDict[str, WebStepResponse] = field(default_factory=OrderedDict)

seed_info

dict[str, Any]

session_id

str

site_lease

SiteLease

status

str = 'ready'

task

WebTask

verifier_result

WebVerifierResult | None = None