$j,dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z e dZ e Gdd Z ddZdS)z-Pagination utilities for MCP list operations.) annotationsN)Sequence) dataclass)TypeVarTc>eZdZUdZded<d dZed dZd S) CursorStatezInternal representation of pagination cursor state. The cursor encodes the offset into the result set. This is opaque to clients per the MCP spec - they should not parse or modify cursors. intoffsetreturnstrctjd|ji}tj|S)z(Encode cursor state to an opaque string.o)jsondumpsr base64urlsafe_b64encodeencodedecode)selfdatas d/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/fastmcp/utilities/pagination.pyrzCursorState.encodes=z3 ,--' 66==???cursorcL tjtj|}||dS#tjttttj f$r}td||d}~wwxYw)z}Decode cursor from an opaque string. Raises: ValueError: If the cursor is invalid or malformed. rr zInvalid cursor: N) rloadsrurlsafe_b64decoderrJSONDecodeErrorKeyError ValueError TypeErrorbinasciiError)clsrres rrzCursorState.decodes A:f6v}}GGNNPPQQD3d3i((( (     N   A A A88899q @ AsAA-B# BB#N)r r )rr r r )__name__ __module__ __qualname____doc____annotations__r classmethodrrrr r si KKK@@@@ AAA[AAArr items Sequence[T]r str | None page_sizer r tuple[list[T], str | None]cd}|r!t|}|j}||z}t|||}d}|t |kr"t|}||fS)ayPaginate a sequence of items. Args: items: The full sequence to paginate. cursor: Optional cursor from a previous request. None for first page. page_size: Maximum number of items per page. Returns: Tuple of (page_items, next_cursor). next_cursor is None if no more pages. Raises: ValueError: If the cursor is invalid. rNr)r rr listlenr)r.rr1r stateendpage next_cursors rpaginate_sequencer:2s$F ""6** 9 C fSj! " "DK SZZ!---4466  r)r.r/rr0r1r r r2)r* __future__rrr#rcollections.abcr dataclassesrtypingrrr r:r-rrr?s33""""""  $$$$$$!!!!!! GCLL AAAAAAA ADr