Add a source adapter
Use a source adapter when a provider or local input surface needs to publish a new Rainrail event.
- Define the provider input shape and the normalized event names it can emit.
- Map provider delivery metadata into
delivery,occurredAt,source, andsubject. - Put workflow-needed facts in
payloadand keep raw provider data behindrawPayloadreferences or redacted markers. - Generate deterministic event IDs for retries and duplicate deliveries.
- Add focused tests for normalization, redaction, credential-looking values, and edge-case provider payloads.
- Update the source spec and contracts manifest if public exports or contract docs change.
Source spec
Section titled “Source spec”Adapter boundaries are defined in docs/core-eep-bridge-source-adapter-boundary.md.