list_review_rounds

Read the rounds taken of an agent, oldest first.

Agentread-onlyidempotentMCP tool

A round is a frozen snapshot of everything it had written at that moment, so this is how you find what a review was given against, and how you see what changed between two of them: git diff one round's snapshotSha against the next. Your own rounds are yours to read, which is how you see the code a comment on your work was written about even after you have edited it. Use open_review_round to take one of the work as it stands now.

Calling it#

curl -X POST http://127.0.0.1:8787/agent.v1.AgentService/ListReviewRounds \
  -H 'Content-Type: application/json' \
  -d '{
  "agentId": "<agentId>"
}'

Request#

ListReviewRoundsRequest#

FieldTypeDescription
agentIdstring

Whose rounds to read.

required

Response#

ListReviewRoundsResponse#

FieldTypeDescription
roundslist of ReviewRound

Every round taken of that agent, oldest first.

Types#

ReviewRound#

ReviewRound is one immutable snapshot of what an agent has written, which is what a review is given against. Nothing a comment is pinned to can move underneath the person reading it, because the snapshot is a commit rather than the worktree.

FieldTypeDescription
idstring

The handle a review or a viewed-file record names this round by.

agentIdstring

Whose work the snapshot was taken of.

ordinalint32

Which round this is for its agent, counting from one.

baseShastring

The commit the agent's branch left its base at when the round was taken.

snapshotShastring

The commit the whole worktree was written out as, tracked and untracked alike.

createdAtstring

When the snapshot was taken, in RFC 3339.