Class BoundedParam

src/orgkernel/schemas/execution_token.py:51–81

A named tool call parameter with numeric bounds. Calls exceeding bounds are blocked at the Tool Gateway.

class BoundedParam(BaseModel):
    """
    A named tool call parameter with numeric bounds.
    Calls exceeding bounds are blocked at the Tool Gateway.
    """
    model_config = {"frozen": True}

    param_name: str
    upper_bound: float | None = None
    lower_bound: float | None = None
    unit: str | None = None

    @model_validator(mode="after")
    def _validate_bounds(self) -> BoundedParam:
        if (
            self.upper_bound is not None
            and self.lower_bound is not None
            and self.upper_bound < self.lower_bound
        ):
            raise ValueError(
                f"upper_bound ({self.upper_bound}) must be >= lower_bound ({self.lower_bound})."
            )
        return self

    def check(self, value: float) -> bool:
        """Return True if value is within bounds."""
        if self.upper_bound is not None and value > self.upper_bound:
            return False
        if self.lower_bound is not None and value < self.lower_bound:
            return False
        return True


class ScopeCheckResult(BaseModel):