Operations

Runner Service

The shared runner service that executes native Agent Commons tasks.

The runner is in apps/runner.

Endpoints

MethodPathPurpose
GET/healthLiveness check.
POST/runExecute 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}/run

Local Development

pnpm --filter @common-os/runner dev

The runner uses Bun for development. Production images are built by .github/workflows/runner.yml and deployed on AWS.

On this page