Sonder · The runtime

The cognitive runtime
AI agents speak through.

Six faculties. One event bus. The audit log regulators read.

Sonder is the event bus, cognitive runtime, and audit trail at the heart of the Ginnung ecosystem. Every agent action emits a typed SonderEvent carrying structured context from the faculties — memory, reasoning, governance, capability, intent, prediction — producing a queryable record of every decision.

InstallSee the cockpit (Ginnung)

Install

Run the runtime.

Sonder runs standalone. Each faculty (Engram, Parliament, Lattice, ACR, AWM, Le-WM) is independently installable and speaks Sonder. Ginnung is the optional cockpit over it.

# Install via the Ginnung composer (recommended)
curl -fsSL https://ginnung.ai/install | sh
ginnung up sonder

# Or pull the runtime container directly
docker pull ghcr.io/heybeaux/sonder:latest
docker run -p 4242:4242 ghcr.io/heybeaux/sonder:latest

Install paths above are placeholders pending the 0.1 release. See version story below for what ships when.

API

The SonderEvent.

Every action emits one. Every field is required. The faculties contribute their own block; nothing is optional, nothing is implicit.

{
  "event_id":   "evt_01HX5R...",
  "agent_id":   "agent_research_v2",
  "timestamp":  "2026-05-11T18:22:04.118Z",
  "action": {
    "type":     "tool_invocation",
    "tool":     "search.web",
    "args":     { "query": "EU AI Act Article 12" }
  },
  "memory":     { "recalled": ["engram-7c2a", "engram-9d11"], "confidence": 0.82 },
  "reasoning":  { "verdict": "proceed", "minority": [], "rounds": 1 },
  "governance": { "tier": "L2", "verdict": "pass", "policy": "pii-v3" },
  "capability": { "tool": "search.web", "receipt": "rcpt-91f0", "cost_usd": 0.004 },
  "intent":     { "goal": "draft_summary", "planned": ["read", "summarize"] },
  "prediction": { "outcome_p": 0.71, "confidence_interval": [0.62, 0.79] },
  "signature":  "ed25519:0x9f2a..."
}

Signed by the runtime, append-only, queryable by event ID, agent ID, time range, faculty field, or policy verdict. Full schema reference, publisher SDK, and consumer endpoints land with 0.1.

Version story

What ships when.

0.1 · runtime preview

Bus + schema + container

The event bus runs, the SonderEvent schema is locked, the container ships, and at least three faculties speak it end-to-end (Engram, Parliament, Lattice).

0.2 · full faculty set

All six bound to the bus

ACR, AWM, and Le-WM land on the bus. The audit trail answers the five regulator-questions structurally, not narratively.

1.0 · production

Signed, append-only, audited

Cryptographic signing, append-only storage guarantees, third-party audit. Targeted to align with EU AI Act enforcement (August 2, 2026).

Version targets above are directional; concrete dates land with the 0.1 release notes.

Want the cockpit?

Ginnung is the dashboard over Sonder.

Sonder gives you the event stream. Ginnung gives you the cockpit to see it — install faculties, watch the bus, query the audit trail without writing SQL.

Open GinnungStart with Engram