https://eventboat.dev/docs/introduction/Recent content in Introduction on EventboatHugoen-USSat, 05 Sep 2026 01:05:51 +0800https://eventboat.dev/docs/introduction/overview/Mon, 01 Jan 0001 00:00:00 +0000https://eventboat.dev/docs/introduction/overview/<p>Eventboat routes events through directed acyclic graphs (DAGs) of transforms — from <strong>sources</strong> (Kafka, HTTP, cron, SQL, files) to <strong>sinks</strong> (Kafka, HTTP, files), with at-least-once delivery, dead-lettering, and replay.</p> <p>It is <strong>agent-native</strong>: every capability is accessible through MCP (Model Context Protocol), CLI, and a language server — so AI agents can write, verify, deploy, and operate pipelines autonomously.</p> <h2 id="what-makes-it-different">What makes it different </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Dimension</th> <th scope="col">Approach</th> </tr> </thead> <tbody> <tr> <td><strong>Predicates</strong></td> <td>CEL (Kubernetes standard) — zero custom DSL, huge training corpus</td> </tr> <tr> <td><strong>Transforms</strong></td> <td>Starlark (Python dialect, sandboxed, deterministic)</td> </tr> <tr> <td><strong>Verification</strong></td> <td>Four machine gates: verify, test, explain, operate</td> </tr> <tr> <td><strong>Reliability</strong></td> <td>Seven invariant tests, spool/settle/checkpoint engine on SQLite</td> </tr> <tr> <td><strong>Jobs</strong></td> <td>Cron scheduling, catchup windows, typed parameters, backfill</td> </tr> <tr> <td><strong>Extension</strong></td> <td>CEL → Starlark → WASM → gRPC out-of-process plugins</td> </tr> <tr> <td><strong>Interop</strong></td> <td>CESQL dialect (CloudEvents), official TCK 100%</td> </tr> </tbody> </table> </div> <h2 id="the-one-line-pitch">The one-line pitch </h2> <blockquote> <p>Eventboat lets AI agents build and run event pipelines that don&rsquo;t lose messages — because machines verify every step before it goes live.</p>https://eventboat.dev/docs/introduction/architecture/Mon, 01 Jan 0001 00:00:00 +0000https://eventboat.dev/docs/introduction/architecture/<h2 id="three-layer-model">Three-layer model </h2> <div class="td-code td-code--untitled" id="td-code-a40c6ace-fence-0" data-td-code data-td-code-auto-id data-td-language="" data-td-line-count="3"> <div class="td-code__viewport" id="td-code-a40c6ace-fence-0-viewport" data-td-code-viewport><pre tabindex="0"><code>YAML (+overlay) → Config (typed) → Static IR → Runtime Engine ↓ Source → Transform → Sink plugins</code></pre></div> </div> <ul> <li><strong>Config layer</strong>: YAML parsing, strict schema validation, variable substitution</li> <li><strong>Static IR</strong>: validated DAG + precompiled CEL programs + Starlark programs + schema</li> <li><strong>Runtime</strong>: spool + settle + checkpoint engine, consuming only the IR</li> </ul> <h2 id="reliability-model">Reliability model </h2> <div class="td-code td-code--untitled" id="td-code-a40c6ace-fence-1" data-td-code data-td-code-auto-id data-td-language="" data-td-line-count="3"> <div class="td-code__viewport" id="td-code-a40c6ace-fence-1-viewport" data-td-code-viewport><pre tabindex="0"><code>source → [spool: append-only durable queue] → in-memory DAG → sinks │ │ └── checkpoint ←── settle tracker ←── terminal states</code></pre></div> </div> <ul> <li><strong>Spool</strong>: every message hits SQLite before the DAG sees it (invariant 1)</li> <li><strong>Settle</strong>: each message settles when all branches reach terminal state</li> <li><strong>Checkpoint</strong>: advances only over settled prefix (invariant 2)</li> <li><strong>Crash recovery</strong>: kill -9 → restart → replay from checkpoint, never lose (invariant 3)</li> <li><strong>Dead letters</strong>: exhausted retries → DLQ store with query + replay CLI</li> </ul> <h2 id="seven-invariant-tests">Seven invariant tests </h2> <p>Each has a dedicated test that must pass in CI:</p>