Skip to main content

Build and Debug Braids

Builder loop

  1. Define whether the Braid has public input and output.
  2. Add the smallest set of Beads that expresses the transformation.
  3. Connect compatible ports and resolve validation warnings.
  4. Configure connections and secret references in the Inspector.
  5. Save a representative fixture.
  6. Run on the server and inspect the node timeline.
  7. Publish the webhook only after deterministic fixtures pass.

Boundary patterns

PatternInput BeadOutput BeadResult
ServiceYesYesWebhook accepts and returns data
Triggered side effectYesNoWebhook returns 204 after completion
Scheduled or fixed operationNoOptionalEditor/runtime supplies no public payload
Visual analysisOptionalNoResult 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.