komrad

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 '{}'

Request#

ListReviewsRequest#

FieldTypeDescription
one of

The task whose reviews to list. Unset uses the caller's own task.

task_iduuid

The task, by id.

task_slugstring

not empty

The task, by slug.

Response#

ListReviewsResponse#

FieldTypeDescription
reviewsReview[]

Every review on the task, in snapshot order.

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.

FieldTypeDescription
iduuid*

The review's id.

task_iduuid*

The id of the task the review is on.

snapshot_iduuid*

The id of the snapshot the review is written against.

snapshot_ordinalint32

The number of the snapshot the review is written against.

author_kindReviewAuthorKind

Who wrote the review.

author_agent_iduuid

The id of the agent that wrote the review. Unset when a forge user wrote it.

verdictReviewVerdict

The review's verdict. Unspecified until the review is released.

released_attimestamp

When the review was released. Unset until then.

pathstring

The absolute path of the file the released review was written to.

created_attimestamp

When the review was created with its first comment.

updated_attimestamp

When the review last changed.

bodystring

What the author said about the work as a whole. Empty when the author said nothing.

open_threadsint32

How many of the review's threads are not resolved. A released review with none is finished, whatever its verdict.

external_loginstring

The forge login of the author of a review copied from the forge. Empty otherwise.

ReviewAuthorKind#

ReviewAuthorKind is who wrote a review or comment.

ValueDescription
human

The person.

agent

An agent, either the writer or a reviewer.

forge

A forge user, whose comment komrad copied from the pull request.

ReviewVerdict#

ReviewVerdict is what a review concludes about a snapshot.

ValueDescription
approved

The snapshot is good as it stands.

changes_requested

The writer has more to do.

commented

Comments without a conclusion either way.