navigate
Go to an agent, task, workflow, document, schedule or worktree, or to a screen and the record on it, in every client following navigations.
writesnot idempotentCLI onlyNavigation
Fails when no client is following, or when every one is behind.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.navigation.v1.NavigationService/Navigate \
-H 'Content-Type: application/json' \
-d '{
"agent": "<agent>"
}'komrad rpc navigate \
--agent '<AgentDestination>'Request#
NavigateRequest#
NavigateRequest names one record, or one screen and the record on it, to go to.
| Field | Type | Description |
|---|---|---|
| one of* | The record, or location, to go to. | |
agent | AgentDestination | An agent. |
task | TaskDestination | A task. |
workflow | WorkflowDestination | A workflow. |
document | DocumentDestination | A document. |
schedule | ScheduleDestination | A schedule. |
worktree | WorktreeDestination | A worktree. |
location | Location | A screen, and the record on it to stand on. |
Response#
Empty#
No fields.
Types#
AgentDestination#
AgentDestination is an agent to go to.
| Field | Type | Description |
|---|---|---|
id | uuid* | The agent's id. |
TaskDestination#
TaskDestination is a task to go to.
| Field | Type | Description |
|---|---|---|
id | uuid* | The task's id. |
WorkflowDestination#
WorkflowDestination is a workflow to go to.
| Field | Type | Description |
|---|---|---|
id | uuid* | The workflow's id. |
DocumentDestination#
DocumentDestination is a document to go to.
| Field | Type | Description |
|---|---|---|
id | uuid* | The document's id. |
ScheduleDestination#
ScheduleDestination is a schedule to go to.
| Field | Type | Description |
|---|---|---|
id | uuid* | The schedule's id. |
WorktreeDestination#
WorktreeDestination is a worktree to go to.
| Field | Type | Description |
|---|---|---|
dir | string* | The worktree's directory. |
Location#
Location is a screen, the record it stands on, and what the screen needs to stand there.
| Field | Type | Description |
|---|---|---|
screen | Screen* | The screen to show. |
| one of | The record the screen stands on. Unset to show the screen's list from the top. | |
agent | AgentDestination | An agent. |
task | TaskDestination | A task. |
workflow | WorkflowDestination | A workflow. |
document | DocumentDestination | A document. |
schedule | ScheduleDestination | A schedule. |
worktree | WorktreeDestination | A worktree. |
system_kind | SystemKind | What the system screen lists. Unset keeps the kind it listed last. |
Screen#
Screen is one of the panel's screens, which a location stands on.
| Value | Description |
|---|---|
agents | The agents, grouped under their workflows and tasks. |
schedules | The schedules that start agents on a timer. |
review | The review of a task's change. |
documents | The documents agents have written. |
logs | The logs of komrad or an agent. |
status_checks | The status checks run on a task's pull request. |
status_check_logs | The logs of the status checks run on a task's pull request. |
system | What komrad and its agents hold in memory and on disk. |
SystemKind#
SystemKind is what the system screen lists.