release_review

Let go of the review you have been writing on another agent's diff, which is what sends it.

Agentwritesnot idempotentMCP tool

Komrad mails that agent to say the review is there, and it reads the review with get_review, so the whole review arrives as one thing rather than a comment at a time. Give a verdict: approved if you wrote no comments on the round, changes requested if you wrote any, since every comment is blocking and a nit is still a comment; commented for notes without a conclusion. Approved is what tells that agent it is done and sends it off to open its pull request, so it is the last thing you say about that change rather than something to pair with findings. Interrupt stops it where it stands rather than waiting for the turn to end. The body is what you say about the work as a whole, and the comments carry the findings, so keep it to a few sentences in the same plain English they are written in. Each call sends another review, so do not retry a call that may have succeeded.

Calling it#

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

komrad rpc release-review \
  --agent-id <string>

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

Offered by the komrad MCP server to reviewer agents.

Request#

ReleaseReviewRequest#

ReleaseReviewRequest lets go of the author's open batch. Komrad sends the agent one piece of ordinary mail naming the review, which it reads whole with get_review, so nothing here decides when the agent is interrupted or typed at: that is mail's own affair.

Field	Type	Description
`agentId`	string	Whose work the batch was written against. required
`verdict`	ReviewVerdict	What the review concludes, which is what tells the agent whether it is done.
`interrupt`	bool	Stop the agent where it stands before telling it, so it reads now rather than at the end of whatever it is doing.
`body`	string	What to say about the work as a whole rather than about any one line, which the agent reads before the first thread. Optional: a review of pinned comments alone is complete. at most 1500 characters

Response#

ReleaseReviewResponse#

Field	Type	Description
`review`	Review	The review as released, carrying its verdict.
`comments`	int32	How many comments the released batch carried.
`path`	string	The absolute path the review was written to.

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.

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.

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.