Chapters
DOC-05 / Technical reference
Technical Documentation
The harness of the Synedre, in depth. A public, sanitised reference: how the data layer, the agentic core, chantiers, automates, the hub, email, memory, deployment and façades actually fit together.
11 chapters
Chapters
Harness Overview
The machinery that turns a request into a deployed action, around a single database.
The Data Layer
A single PostgreSQL database, three access paths, and naming conventions that hold the whole edifice together.
The Agentic Core
How an incoming email becomes an action: intent classification, agent spawn and post-spawn orchestration.
Chantiers, travaux & tasks
The data model that organises all work: one chantier, N travaux, N tasks — created atomically, locked, cascaded.
Automates, crons & runs
The non-conversational execution layer: façades, registry, schedulers, runs and the distributed browser worker.
The Hub
The mothership's private cockpit: /hub/* routes, layered modules, agent consoles and two-tier authentication.
Inbox, Atlas Inbox & Email
Two IMAP→database pipelines, one outbound facade, and two blocking doctrines: AV scan before opening, zero direct client contact.
Memory & Learning
Three memories (reflex, doctrine, intuition), a semantic recall, and a loop that turns every error into a safeguard.
Deployment & Infrastructure
The ship/deploy asymmetry, host-side build, zero-downtime swap and a single source-of-truth inventory in the database.
The Catalogue of Façades
One façade per module: a map of the agentic harness's executable entry points, by family and invocation mode.
Skills, Agents & Hooks
How the harness wires skills, delegable sub-agents and event hooks to enforce doctrine.