Source code for sequince.steps.mutation.adaptive.state

"""Complete budget state shared by eager and functional adaptation."""

from dataclasses import dataclass
from typing import Generic, Self, TypeVar

from ....utils.pytrees import pytree_dataclass

_Scalar = TypeVar("_Scalar")


[docs] @pytree_dataclass( data_fields=( "current_iteration", "current_n_steps", "next_n_steps", "last_updated_iteration", ) ) @dataclass(frozen=True) class MutationBudgetState(Generic[_Scalar]): """Immutable current and pending budgets with iteration markers. Eager fields are host integers; functional fields are scalar int32 arrays. Both budgets initially equal ``initial_steps``; unset iterations use -1.""" current_iteration: _Scalar current_n_steps: _Scalar next_n_steps: _Scalar last_updated_iteration: _Scalar
[docs] @classmethod def initial(cls, initial_steps: _Scalar, unset_iteration: _Scalar) -> Self: """Allocate both budget slots and mark both iterations as unset.""" return cls( unset_iteration, initial_steps, initial_steps, unset_iteration )
__all__ = ["MutationBudgetState"]