Operations
Runner Service
The shared runner service that executes native Agent Commons tasks.
The runner is in apps/runner.
Endpoints
| Method | Path | Purpose |
|---|---|---|
GET | /health | Liveness check. |
POST | /run | Execute a prompt through Agent Commons CLI. |
Request Shape
{
"agentId": "agt_xxx",
"sessionId": "optional-session",
"prompt": "Build the auth module"
}Who Calls It
The daemon calls the runner for native integration tasks:
daemon executeTask()
-> runViaNative()
-> POST {RUNNER_URL}/runLocal Development
pnpm --filter @common-os/runner devThe runner uses Bun for development. Production images are built by
.github/workflows/runner.yml and deployed on AWS.