list_reviews
List the reviews released on a task, the caller's task by default, in snapshot order, each with its verdict.
read-onlyidempotentMCP toolAgent
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ListReviews \
-H 'Content-Type: application/json' \
-d '{}'komrad rpc list-reviews{
"name": "list_reviews",
"arguments": {}
}Offered by the komrad MCP server to writer, reviewer, orchestrator agents.
Request#
ListReviewsRequest#
Response#
ListReviewsResponse#
Types#
Review#
Review is a reviewer agent's comments on one snapshot, released to the writer together. The review is private until the agent releases it.
| Field | Type | Description |
|---|---|---|
id | uuid* | The review's id. |
task_id | uuid* | The id of the task the review is on. |
snapshot_id | uuid* | The id of the snapshot the review is written against. |
snapshot_ordinal | int32 | The number of the snapshot the review is written against. |
author_kind | ReviewAuthorKind | Who wrote the review. |
author_agent_id | uuid | The id of the agent that wrote the review. Unset when a forge user wrote it. |
verdict | ReviewVerdict | The review's verdict. Unspecified until the review is released. |
released_at | timestamp | When the review was released. Unset until then. |
path | string | The absolute path of the file the released review was written to. |
created_at | timestamp | When the review was created with its first comment. |
updated_at | timestamp | When the review last changed. |
body | string | What the author said about the work as a whole. Empty when the author said nothing. |
open_threads | int32 | How many of the review's threads are not resolved. A released review with none is finished, whatever its verdict. |
external_login | string | The forge login of the author of a review copied from the forge. Empty otherwise. |
ReviewAuthorKind#
ReviewAuthorKind is who wrote a review or comment.
ReviewVerdict#
ReviewVerdict is what a review concludes about a snapshot.
| Value | Description |
|---|---|
approved | The snapshot is good as it stands. |
changes_requested | The writer has more to do. |
commented | Comments without a conclusion either way. |