release_review
Release the caller's review with a verdict: approved only when the caller started no thread on the snapshot, changes requested when it started any.
writesnot idempotentMCP toolAgent
Komrad mails the agent under review once, naming the review for get_review. An approval tells the agent its work is done.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ReleaseReview \
-H 'Content-Type: application/json' \
-d '{}'komrad rpc release-review{
"name": "release_review",
"arguments": {}
}Offered by the komrad MCP server to reviewer agents.
Request#
ReleaseReviewRequest#
ReleaseReviewRequest releases the caller's open review on a task.
| Field | Type | Description |
|---|---|---|
| one of | The task the review is on. Unset uses the caller's own task. | |
task_id | uuid | The task, by id. |
task_slug | string not empty | The task, by slug. |
verdict | ReviewVerdict | The review's verdict. |
body | string at most 1500 characters | What the reviewer says about the work as a whole. The writer reads it before the threads. |
Response#
ReleaseReviewResponse#
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. |
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. |
ReviewAuthorKind#
ReviewAuthorKind is who wrote a review or comment.