add_review_message
Reply in a thread on the caller's own diff.
writesnot idempotentMCP toolAgent
With addressed set, the reply pins a new snapshot of the worktree. The reply leaves the thread open. Komrad refuses addressed when the worktree has not changed since the thread's snapshot.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/AddReviewMessage \
-H 'Content-Type: application/json' \
-d '{
"thread_id": "<thread_id>",
"body": "<body>"
}'komrad rpc add-review-message \
--thread-id '<uuid>' \
--body '<string>'{
"name": "add_review_message",
"arguments": {
"thread_id": "<thread_id>",
"body": "<body>"
}
}Offered by the komrad MCP server to writer, reviewer, orchestrator agents.
Request#
AddReviewMessageRequest#
| Field | Type | Description |
|---|---|---|
thread_id | uuid* | The thread to reply in, by id. |
body | string* at most 1000 characters | The reply's text. |
suggestion | string[] | The lines proposed in place of the thread's range. Empty for a plain reply. |
addressed | bool | Whether the reply says the change the thread asks for is made. Komrad then saves a snapshot of the worktree and pins it to the reply. |
Response#
AddReviewMessageResponse#
| Field | Type | Description |
|---|---|---|
message | ReviewMessage | The comment as written. |
hint | string | A reminder to set |
Types#
ReviewMessage#
ReviewMessage is one comment in a review thread.
| Field | Type | Description |
|---|---|---|
id | uuid* | The comment's id. |
thread_id | uuid* | The id of the comment's thread. |
author_kind | ReviewAuthorKind | Who wrote the comment. |
author_agent_id | uuid | The id of the agent that wrote the comment. Unset when the person or a forge user wrote it, or when the agent was deleted. |
body | string | The comment's text. |
suggestion | string[] | The lines the author proposes in place of the thread's range. Empty for a plain comment. |
created_at | timestamp | When the comment was written. |
updated_at | timestamp | When the comment was last edited. |
review_id | uuid | The id of the review a reviewer agent released the comment with. Unset for the person's comments and the writer's replies. |
snapshot_id | uuid | The id of the snapshot saved with an addressed reply. Unset on every other comment. |
forge | ForgeOrigin | The forge comment this comment was copied from. Unset for a comment written in komrad. |
accepted_from | uuid | The id of the held forge comment the person accepted this comment as a copy of. Unset otherwise. |
held | bool | Whether the comment is kept from the agent, because a forge user without write access wrote the comment or its thread, or the person held it or its thread from the writer when posting it. |
read_at | timestamp | When the agent read the person's comment. Unset until then, and on every other comment. |
read_snapshot_id | uuid | The id of the snapshot taken as the agent read the person's comment, which an addressed reply is compared against. Unset until then, and on every other comment. |
held_by_person | bool | Whether the person held this forge comment from the writer when posting it, which keeps it, and the thread it opens, from the agent for good. |
ForgeOrigin#
ForgeOrigin is the forge comment a review comment was copied from.
| Field | Type | Description |
|---|---|---|
login | string | The forge login of the comment's author. Empty when the forge no longer has the account. |
comment_id | uuid* | The forge comment's id. The forge may have deleted the comment since. |
edited_at | timestamp | When the forge comment was last edited. Unset when it was never edited. |
yours | bool | Whether the person wrote the forge comment, as the account komrad connects to the forge with. Always false on a connection made from a GitHub App. |
ReviewAuthorKind#
ReviewAuthorKind is who wrote a review or comment.