asa runtime serve

Exposes the persistent runtime for embedding and SDK clients.

HTTP (localhost)

asa runtime serve --port 8765

Binds 127.0.0.1 only.

Unix socket

asa runtime serve --socket .asagiri/runtime/runtime.sock

You can run HTTP and Unix together: keep --port while passing --socket.

With worker

asa daemon run --api-port 8765

Observability

GET /v1/status returns daemon counters and metrics:

• active_sessions
• memory_hits
• context_reduction_ratio
• runtime_event_rate
• agent_failure_rate
• flow_completion_rate
• review_rejection_rate

Authentication

Token file: .asagiri/runtime/api.token

Authorization: Bearer <token>

SDKs

• Go: Connect, ConnectHTTP
• TypeScript: @laprogrammerie/asagiri

Runtime modes

Configure in .asagiri/config.yaml:

runtime:
  mode: guided  # guided | interactive | headless | ci | review | exploration