list_reviews

Read every review released on an agent, in the order their rounds were taken, each with the verdict it carried.

Agentread-onlyidempotentMCP tool

This is how you find where a change stands: whether the person reviewing has approved it, asked for changes, or only commented, and how many rounds it took to get there. The findings themselves are in the threads, which list_review_threads reads; this is the verdict on each round rather than the comments under it. agentId names whose reviews to read. The path of the file a review was written out to is dropped for anyone but the agent that wrote that review, so your own reviews come back with their paths and somebody else's do not. A review nobody has released is left out for the same reason, since what is in it is the reviewer's until they let go of it; a person running this from a terminal is drawn the open ones too. You may read your own reviews and those of the agent you are a child of, and anybody else's are refused as permission_denied.

Calling it#

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

komrad rpc list-reviews \
  --agent-id <string>

{
  "name": "list_reviews",
  "arguments": {
    "agentId": "<agentId>"
  }
}

Offered by the komrad MCP server to implementer, reviewer, orchestrator agents.

Request#

ListReviewsRequest#

Field Type Description

Field	Type	Description
`agentId`	string	Whose reviews to read. required

agentId

string

Whose reviews to read.

required

Response#

ListReviewsResponse#

Field	Type	Description
`reviews`	list of Review	Every review given on that agent, in the order their rounds were taken.

Types#

Review#

Review is one author's batch of comments against one round, private while it is written and released as a whole, the way a pending review on a forge is.

Field	Type	Description
`id`	string	The handle the threads in this batch name it by.
`agentId`	string	Whose work is being read.
`roundId`	string	The snapshot the batch was written against.
`roundOrdinal`	int32	Which round that is, counting from one, so a caller need not fetch the round to say.
`authorKind`	ReviewAuthorKind	Whether a person or an agent wrote it.
`authorAgentId`	string	The agent giving the review, absent when the person reviewing is.
`verdict`	ReviewVerdict	What the author concluded, unspecified while the review is still open.
`releasedAt`	string	When the review was let go of, empty while nothing in it has reached the agent.
`path`	string	The absolute path the released review was written to.
`deliveredAt`	string	When the agent claimed the mail that told it the review was waiting.
`createdAt`	string	When the batch was opened, which is the first comment written into it.
`updatedAt`	string	When anything in it last moved.
`body`	string	What the author said about the work as a whole rather than about any one line, empty when they said nothing.
`openThreads`	int32	How many of this review's comments nobody has settled. A released review with none left is finished, which the verdict does not say, since a verdict is what its author concluded at the time rather than what has happened since.

ReviewAuthorKind#

ReviewAuthorKind is who wrote a review message.

Value	Description
`REVIEW_AUTHOR_KIND_HUMAN`	The person running komrad.
`REVIEW_AUTHOR_KIND_AGENT`	The agent whose work is being read, or the reviewer reading it.

ReviewVerdict#

ReviewVerdict is what an author concluded about a round, which is what tells the agent whether it is done rather than leaving it to read that out of the prose.

Value	Description
`REVIEW_VERDICT_APPROVED`	This round is good as it stands.
`REVIEW_VERDICT_CHANGES_REQUESTED`	The agent should keep working.
`REVIEW_VERDICT_COMMENTED`	Notes without a conclusion either way.