Architecture overview
One route from provider events to agent execution.
Rainrail separates event ingestion from workflow selection so each adapter can stay small, testable, and accountable.
Source pluginAccepts provider input and normalizes it.
RainrailEventEnvelopeCaptures event kind, source, identity, and safe metadata.
Workflow pluginMaps neutral events to task-specific agent instructions.
Runtime providerStarts or resumes the agent workflow with deterministic inputs.
Implementation contracts stay in engineering docs
The product site summarizes the architecture. Payload shapes, plugin API signatures, retry behavior, and runtime semantics remain in the repository documentation so implementation decisions have a single source of truth.