open_review_round

Freeze what an agent has written right now and get back the round to review against, which is a snapshot commit covering its whole worktree, committed and uncommitted alike.

AgentwritesidempotentMCP tool

Call this before reading its diff, and diff the round's baseSha against its snapshotSha to see exactly what you are reviewing. A tree that has not moved since the last round gives that round back rather than a new one, so calling it twice is safe.

Calling it#

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

komrad rpc open-review-round \
  --agent-id <string>

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

Offered by the komrad MCP server to reviewer agents.

Request#

OpenReviewRoundRequest#

OpenReviewRoundRequest freezes what an agent has written now and records it as its next round. A tree that has not moved since the last round is that round again rather than a new one, so opening the diff twice does not walk the ordinal on.

Field Type Description

Field	Type	Description
`agentId`	string	Whose worktree to freeze. required

agentId

string

Whose worktree to freeze.

required

Response#

OpenReviewRoundResponse#

Field	Type	Description
`round`	ReviewRound	The round to review against, which is the last one again if nothing has moved.

Types#

ReviewRound#

ReviewRound is one immutable snapshot of what an agent has written, which is what a review is given against. Nothing a comment is pinned to can move underneath the person reading it, because the snapshot is a commit rather than the worktree.

Field	Type	Description
`id`	string	The handle a review or a viewed-file record names this round by.
`agentId`	string	Whose work the snapshot was taken of.
`ordinal`	int32	Which round this is for its agent, counting from one.
`baseSha`	string	The commit the agent's branch left its base at when the round was taken.
`snapshotSha`	string	The commit the whole worktree was written out as, tracked and untracked alike.
`createdAt`	string	When the snapshot was taken, in RFC 3339.