Brain Bus

The Brain Bus is the runtime context layer around agent turns: it injects recalled context before an LLM call and records the turn after. It’s mounted at /v1/brain/bus (requires the brain primitive; not plan-metered).

List recent events

GET /v1/brain/bus/events?limit=50 — recent bus events (max 200).

{
  "events": [
    {
      "id": "evt-uuid",
      "channel": "llm_proxy",
      "actor_type": "agent",
      "direction": "turn",
      "input_preview": "...",
      "output_preview": "...",
      "created_at": "2026-07-09T12:00:00.000Z"
    }
  ]
}

Stream events (SSE)

GET /v1/brain/bus/events/stream — server-sent events: brain_bus.event and company_channel.message. Used by Mission Control’s live feed.

Ingest a turn

POST /v1/brain/bus/events — record a turn (best-effort remember). Returns 202.

string

Turn input text.

string

Turn output text.

string

Channel label (default llm_proxy).

string

input | output | turn | message | maintenance.

Bus recall/remember internally call query (10 credits) and document ingest (5 credits) when they materialize durable evidence. The LLM proxy performs recall/remember automatically around agent turns; send the header x-naive-brain-bus: off to opt a request out.

{
  "events": [
    {
      "id": "evt-uuid",
      "channel": "llm_proxy",
      "actor_type": "agent",
      "direction": "turn",
      "input_preview": "...",
      "output_preview": "...",
      "created_at": "2026-07-09T12:00:00.000Z"
    }
  ]
}

Overview

Endpoints

List recent events

Stream events (SSE)

Ingest a turn

​List recent events

​Stream events (SSE)

​Ingest a turn

List recent events

Stream events (SSE)

Ingest a turn