Concepts

Rainrail is easiest to work on when provider integration, routing policy, and agent execution stay separate. These concepts describe those boundaries before you read the exact TypeScript contracts.

What to read

• Event model explains normalized event envelopes.
• Runtime boundaries separates source adapters, source bundles, workflow plugins, and runtime providers.
• Event delivery covers publish, retry, replay, and stream behavior.
• Operational state explains the durable records behind dashboards, queues, and agent timelines.

Source specs

These concept pages summarize the public model. Exact contract decisions live in the linked source spec pages under the Rainrail repository.