nemo_gym.sandbox.failures

Shared sandbox failure-event construction from facts classified by each provider.

Module Contents

Functions

Name	Description
`sandbox_failure`	Build a sandbox event from explicit facts; callers raise it `from cause`.

API

nemo_gym.sandbox.failures.sandbox_failure(
    operation: str,
    failure_kind: str,
    sandbox_id: str | None = None,
    cause: BaseException | None = None,
    reason: str | None = None,
    execution_id: str | None = None,
    provider: str | None = None,
    provider_status_reason: str | None = None,
    exit_code: int | None = None,
    http_status: int | None = None
) -> nemo_gym.core.typed_exceptions.NgFailureEvent

Build a sandbox event from explicit facts; callers raise it from cause.

This shared factory does not classify SDK exceptions or choose policy actions. Each provider translates its SDK errors into a registered kind before calling it (for example, opensandbox_failure). HTTP status must describe this operation, not a child failure; causes retain their own evidence.