Function encode_page_id

openhands/app_server/utils/paging_utils.py:12–26

Encode an integer page identifier as an opaque base64 string. This function exists to ensure that page IDs are opaque tokens that do not reveal the underlying pagination strategy to API consumers. The encoding format may change in the future, so consumers should treat page_id as an

(value: int)

def encode_page_id(value: int) -> str:
    """Encode an integer page identifier as an opaque base64 string.

    This function exists to ensure that page IDs are opaque tokens that do not
    reveal the underlying pagination strategy to API consumers. The encoding
    format may change in the future, so consumers should treat page_id as an
    opaque string and not attempt to parse or construct it themselves.

    Args:
        value: The integer value to encode.

    Returns:
        Base64-encoded string (URL-safe, without padding).
    """
    return base64.urlsafe_b64encode(str(value).encode()).decode().rstrip('=')


def decode_page_id(page_id: str | None) -> int | None: