komrad

take_review_snapshot

Take a snapshot of a task's checkout to review, the caller's task by default.

writesidempotentMCP toolAgent

Diff the snapshot's base_sha against its sha to read the change. A checkout that hasn't changed since the newest snapshot returns that snapshot.

Calling it#

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

Request#

TakeReviewSnapshotRequest#

TakeReviewSnapshotRequest saves a task's worktree as its next snapshot. When the worktree has not changed since the newest snapshot, the call returns that snapshot.

FieldTypeDescription
one of

The task whose worktree to save. Unset uses the caller's own task.

task_iduuid

The task, by id.

task_slugstring

not empty

The task, by slug.

Response#

TakeReviewSnapshotResponse#

FieldTypeDescription
snapshotReviewSnapshot

The snapshot to review. The newest existing snapshot when the worktree has not changed.

Types#

ReviewSnapshot#

ReviewSnapshot is a snapshot of a task's worktree, saved as a commit, that a review is written against. A snapshot never changes.

FieldTypeDescription
iduuid*

The snapshot's id.

task_iduuid*

The id of the task the snapshot was taken of.

ordinalint32

The snapshot's number within its task, counting from one.

base_shastring

The commit on the base branch that the task's branch started from when the snapshot was taken.

shastring

The commit holding the whole worktree, tracked and untracked files alike.

created_attimestamp

When the snapshot was taken.