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

Embed the runtime.

Sonder is a library — you embed it in a host process. Each faculty (Engram, Parliament, Lattice, ACR, AWM, Le-WM) is independently installable and speaks Sonder. Ginnung is the optional cockpit over it.

# Embed Sonder as a library in your own host process
pnpm add @heybeaux/sonder-core
# (See the docs for the SonderBus + adapter wire-up.)

# Or run the Ginnung cockpit, which embeds Sonder for you
curl -fsSL https://ginnung.ai/install | sh
ginnung up

Sonder is a library — you embed it in a host process (your agent runtime, Ginnung, or your own). A standalone runtime container is on the roadmap.

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 + library

The event bus runs, the SonderEvent schema is locked, the core library (@heybeaux/sonder-core) 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