Purpose of this page: identify who talks to the daemon and through
which door — the shell for the operator, HTTP for the worker.
Layer 0
Actors
Everyone outside the daemon. An operator drives the CLI from a shell. A worker is a machine actor that talks to the HTTP API.
Components
Operator (shell)
A human in a terminal. Runs kanthord serve, kanthord db migrate,
kanthord config generate, and the remote resource commands
(project, node, plan, repository, credential, actor, event, status).
External worker / coding agent
A separate process that owns execution. It claims nodes, sends heartbeats, and reports outcomes over HTTP with a Bearer token. It never touches SQLite directly.
Outbound edges
| From | To | Meaning |
|---|---|---|
| Operator | kanthord bin | runs kanthord … |
| Operator | remote commands | invokes resource subcommands |
| Worker | listen(bind:port) | claim · heartbeat · report |
Rules
- An actor never reaches past Layer 4. The HTTP API is the only machine entrance.
- The operator reaches storage directly once, through
db migrate, before first serve.