komrad

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.