Build and Debug Braids
Builder loop
- Define whether the Braid has public input and output.
- Add the smallest set of Beads that expresses the transformation.
- Connect compatible ports and resolve validation warnings.
- Configure connections and secret references in the Inspector.
- Save a representative fixture.
- Run on the server and inspect the node timeline.
- Publish the webhook only after deterministic fixtures pass.
Boundary patterns
| Pattern | Input Bead | Output Bead | Result |
|---|---|---|---|
| Service | Yes | Yes | Webhook accepts and returns data |
| Triggered side effect | Yes | No | Webhook returns 204 after completion |
| Scheduled or fixed operation | No | Optional | Editor/runtime supplies no public payload |
| Visual analysis | Optional | No | Result appears in Data Probe or browser sink |
Debugging order
Check the run status, then the first failed node, then its redacted input/output summaries. Provider errors preserve upstream status where safe. A missing secret reference is different from a provider rejecting an existing credential.
Use replay only for inputs explicitly retained by the user. Run summaries are not a raw payload archive.