Skip to content
This repository was archived by the owner on Sep 10, 2026. It is now read-only.

Describe pagination cursors as opaque - #46

Merged
seenu-k merged 1 commit into
mainfrom
docs/opaque-pagination-cursors
Aug 12, 2026
Merged

seenu-k merged 1 commit into
mainfrom
docs/opaque-pagination-cursors

Conversation

@seenu-k

@seenu-k seenu-k commented Aug 12, 2026

Copy link
Copy Markdown
Collaborator

Docs half of eigeninteractive/eigen-server#60. Draft: describes behaviour that has not shipped yet.

docs/how-it-works/transport.md had the only hand-written sentence about cursors, and it is now wrong:

the cursor is the previous page's last sort value

That was true. Cursors are now opaque tokens returned as nextCursor, null exactly when the list is exhausted, and composing one is unsupported (invalidCursor).

The generated docs/reference/* pages carry the parameter and response shapes and are synced from the engine by CI, so this is the only edit needed here.

Mark ready once eigen-server#60 releases.

🤖 Generated with Claude Code

The one hand-written sentence about cursors said the cursor is the previous
page's last sort value, which is what it used to be. It is now an opaque token
the server returns as `nextCursor`, null exactly when the list is exhausted.

The generated `docs/reference/*` pages carry the parameter and response shapes
and are synced from the engine by CI, so this is the only edit needed here.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@seenu-k
seenu-k marked this pull request as ready for review August 12, 2026 18:08
@seenu-k
seenu-k merged commit f25d256 into main Aug 12, 2026
1 check passed
@seenu-k
seenu-k deleted the docs/opaque-pagination-cursors branch August 12, 2026 18:09
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant