# 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.

writes · not idempotent · MCP tool · [Agent](https://komrad.dev/latest/api/agent.md)

Komrad mails the agent under review once, naming the review for [`get_review`](https://komrad.dev/latest/api/agent/get-review.md). An approval tells the agent its work is done.

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ReleaseReview \
  -H 'Content-Type: application/json' \
  -d '{}'
```

```bash
komrad rpc release-review
```

```json
{
  "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](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewRequest-task) |  | The task the review is on. Unset uses the caller's own task. |
| [`task_id`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewRequest-task_id) | uuid | The task, by id. |
| [`task_slug`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewRequest-task_slug) | string not empty | The task, by slug. |
| [`verdict`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewRequest-verdict) | [ReviewVerdict](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewVerdict) | The review's verdict. |
| [`body`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewRequest-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

| Field | Type | Description |
| --- | --- | --- |
| [`review`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewResponse-review) | [Review](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review) | The review as released, with its verdict. |
| [`comments`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewResponse-comments) | int32 | How many comments the review released. |
| [`path`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReleaseReviewResponse-path) | string | The absolute path of the file the review was written to. |

## 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`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-id) | uuid\* | The review's id. |
| [`task_id`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-task_id) | uuid\* | The id of the task the review is on. |
| [`snapshot_id`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-snapshot_id) | uuid\* | The id of the snapshot the review is written against. |
| [`snapshot_ordinal`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-snapshot_ordinal) | int32 | The number of the snapshot the review is written against. |
| [`author_kind`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-author_kind) | [ReviewAuthorKind](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewAuthorKind) | Who wrote the review. |
| [`author_agent_id`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-author_agent_id) | uuid | The id of the agent that wrote the review. Unset when a forge user wrote it. |
| [`verdict`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-verdict) | [ReviewVerdict](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewVerdict) | The review's verdict. Unspecified until the review is released. |
| [`released_at`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-released_at) | timestamp | When the review was released. Unset until then. |
| [`path`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-path) | string | The absolute path of the file the released review was written to. |
| [`created_at`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-created_at) | timestamp | When the review was created with its first comment. |
| [`updated_at`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-updated_at) | timestamp | When the review last changed. |
| [`body`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-body) | string | What the author said about the work as a whole. Empty when the author said nothing. |
| [`open_threads`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-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`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-Review-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`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewVerdict-approved) | The snapshot is good as it stands. |
| [`changes_requested`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewVerdict-changes_requested) | The writer has more to do. |
| [`commented`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewVerdict-commented) | Comments without a conclusion either way. |

### ReviewAuthorKind

ReviewAuthorKind is who wrote a review or comment.

| Value | Description |
| --- | --- |
| [`human`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewAuthorKind-human) | The person. |
| [`agent`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewAuthorKind-agent) | An agent, either the writer or a reviewer. |
| [`forge`](https://komrad.dev/latest/api/agent/release-review.md#komrad-agent-v1-ReviewAuthorKind-forge) | A forge user, whose comment komrad copied from the pull request. |
