概念

Provider event を agent workflow に流すための語彙。

Rainrail は source system、workflow decision、agent runtime を別々の contract に分け、自動化が大きくなっても adapter が一回限りの script へ崩れないようにします。

Source bundleGitHub、Cloudflare、manual、chat の入口を束ねます。

Source plugin各 input を event envelope に正規化します。

RainrailEventEnvelopedelivery、source、subject、payload metadata を安定させます。

Workflow plugin決定的な automation path を選びます。

Runtime providercapability gate の後ろで agent run を起動します。

初期 concept map

schema version、source identity、delivery metadata、subject、normalized payload、raw payload reference を運ぶ中立な event shape です。

GitHub webhook や Cloudflare tail event のような provider 固有 input を受け取り、RainrailEventEnvelope へ正規化する境界です。

EEP Bridge、manual input、web chat など、ひとつ以上の source adapter を Core intake へ接続する composition layer です。

neutral event を受け取り、task provider call、runtime start、local deterministic decision へ写像する routing unit です。

OpenClaw、devteam、Codex などの execution backend で agent run を開始または再開する adapter です。runtime secret は workflow に露出させません。

GitHub issue operation と Project queue selection を安定した method の後ろに置き、workflow logic が GraphQL detail に依存しないようにします。

publish、replay、SSE delivery、duplicate delivery handling を agent と operator が観測できる event bus layer です。

このページは product-facing な地図です。正確な payload field、plugin API signature、capability gate、Bridge room replay behavior は engineering docs に残します。