architecture-cortex-ledger

What problem does it solve?

The Theseus Database Cortex replaces static file-based memory with a continuous, event-driven ledger, enabling persistent, auditable memory streams across agents.

Core Features & Use Cases

• Event-sourced memory ledger: stores a sequential timeline of all agent actions and external inputs.
• Dossiers: group related events into thematic contexts for efficient retrieval.
• Inter-agent inbox: lightweight pub/sub via PostgreSQL to coordinate tasks without heavy protocols.
• Watchtower sync: automatic synchronization of local state to the central mothership database.
• Ingestion pipeline: deterministic processing of events via dreaming agents that classify, summarize, and attach context.
• Schema-driven: explicit definitions for events and dossiers to ensure consistency across agents.

Quick Start

Follow the Theseus Cortex setup guide at ~/office/knowledge/cortex/agent_cortex_setup.md to bootstrap and initialize the event-sourcing ledger in your environment.