Skip to content

MSC4492: Clarify that pagination tokens are directionless#4492

Open
clokep wants to merge 8 commits into
mainfrom
clokep/pagination-tokens
Open

MSC4492: Clarify that pagination tokens are directionless#4492
clokep wants to merge 8 commits into
mainfrom
clokep/pagination-tokens

Conversation

@clokep

@clokep clokep commented Jun 16, 2026

Copy link
Copy Markdown
Member

@clokep clokep changed the title MSCXXXX: Clarify that pagination tokens are directionless MSC4492: Clarify that pagination tokens are directionless Jun 16, 2026
@clokep clokep added proposal A matrix spec change proposal. Process state. A-Client Server Client-Server API kind:maintenance MSC which clarifies/updates existing spec labels Jun 16, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implementation not required: the MSC is effectively already implemented.

Comment thread proposals/4492-directionless-pagination-tokens.md Outdated
Comment thread proposals/4492-directionless-pagination-tokens.md Outdated
Comment on lines +32 to +33
Pagination tokens produced by `/messages`, `/relations`, `/context`, and `/search`'s
`context` field represent a position in the event stream and MUST be indistinguishable.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the omission of /sync deliberate here? Are you trying to draw a distinction between the room-scoped tokens and the globally-scoped next_batch from /sync? It could maybe do with a little clarification.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

next_batch isn't room scoped, right? So it isn't indistinguishable. Although it should include: "prev_batch response field of /sync", I think.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I ended up combining this paragraph and the one after it since they seem repetitive. Hopefully that's clear.

Comment thread proposals/4492-directionless-pagination-tokens.md Outdated
Comment thread proposals/4492-directionless-pagination-tokens.md Outdated
Comment thread proposals/4492-directionless-pagination-tokens.md Outdated
clokep and others added 3 commits June 17, 2026 08:50
Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
Co-authored-by: Patrick Cloke <clokep@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Client Server Client-Server API kind:maintenance MSC which clarifies/updates existing spec proposal A matrix spec change proposal. Process state.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants