Agent
AgentService creates, reads and changes agents, with their mail, transcripts, documents and reviews.
komrad.agent.v1.AgentService
list_agents#List the agents komrad tracks, most recently updated first.
get_agent#Get one agent by id, archived or not, with its prompt in full.
create_agent#Create an agent and launch it with a prompt.
request_review#Create a reviewer for the caller's committed work, on the caller's task and in the caller's checkout.
adopt#Create an agent on a branch that already exists, such as one the person pushed.
log#Write one line to komrad's log, under the caller unless `id` names another agent.
send_mail#Send mail to another agent by `to_agent_id` or `to_agent_name`, setting `reply_to` when answering.
forward_last_turns#Send an agent's latest turns to another agent as mail, without the text passing through the caller.
read_mail#Read the caller's waiting mail, oldest first.
list_mail#List an agent's mail without claiming it, most recent first.
get_mail#Get one mail by id with its body whole, read or not, without claiming it.
delete_mail#Delete mail for good by id, read or not.
archive_agents#Archive agents, stopping each and keeping its record and transcript for `restore_agents`.
restore_agents#Restore archived agents, dormant, with their workflows.
resume_agent#Resume an agent on its existing conversation, such as when its pane died.
restart_agent#Restart a task's writer or a workflow's orchestrator on a new conversation.
retry_agent#Retry an agent whose create failed, with new flags, prompt or harness if given.
rename_agent#Rename an agent by id.
search_transcripts#Search transcripts by full text, archived agents included.
get_transcript#Read an agent's whole transcript, one window at a time, passing the returned cursor back to read on.
get_last_turns#Read the newest turns of an agent's transcript.
write_document#Write a markdown document for the person, as a type from `list_document_types` and following its context.
list_documents#List the documents agents have written, without their bodies.
search_documents#Search documents by full text, reading each as it is now and never an earlier version.
get_document#Read one document in full, or an earlier version of it.
list_document_versions#List every write of a document, newest first, saying which the person made.
list_document_types#List the document types with their contexts.
get_document_type#Read one document type and its context by name.
list_document_type_versions#List every write of a document type, newest first.
write_document_type#Create a document type, or rewrite the one `id` names, passing the version last read.
delete_documents#Delete documents and every earlier version of each.
delete_document_type#Delete a document type.
list_review_threads#List the threads on a task's diff, the caller's task by default.
get_review_thread#Get one thread on a task's diff by id, with its quoted lines and every comment whole.
create_review_thread#Start a thread on a line range of the diff under review, with the diff lines as `quoted_lines` and the snapshot's `sha` as `snapshot_sha`, or on the change as a whole without a file or lines.
add_review_message#Reply in a thread on the caller's own diff.
plan_rebase#Preview a rebase of a task's branch onto its base branch without moving anything: what would be replayed, dropped and flattened, and which paths may conflict.
rebase_worktree#Rebase a task's branch onto the newest commit of its base branch.
plan_push#Preview a push of a task's branch to origin without pushing anything.
push_worktree#Push a task's branch to origin under its own name.
pick_fork_point#Record the fork point of an orphaned child, the commit its own commits sit on.
abort_sequence#Abort the sequence in a task's checkout.
start_orchestrator#Resume a workflow's orchestrator, or create one when the workflow has none.
resolve_review_thread#Resolve a thread, or reopen one.
take_review_snapshot#Take a snapshot of a task's checkout to review, the caller's task by default.
list_review_snapshots#List the snapshots of a task, the caller's task by default, oldest first.
list_reviews#List the reviews released on a task, the caller's task by default, in snapshot order, each with its verdict.
get_review#Read one released review in full: the verdict, the note on the work, then each thread with the code it is pinned to.
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.