Expand description
BackoffNoticePayload - typed wire payload for the backpressure
protocol per
docs/internal/superpowers/specs/2026-06-23-backpressure-runtime.md
§2.
The framework synthesizes one of these whenever
BackpressureTracker::observe_overload returns
super::BackpressureDecision::EmitNotice. The payload is
serialized with bincode (matches the universal SlotValue wire
encoding at bb-ir/src/slot_value.rs:194-196), stamped with a
stable type_hash discriminator, packed into a single
crate::envelope::SlotFill inside a crate::envelope::WireEnvelope
addressed to the originating sender, and pushed onto the
receiver’s OutboundQueue.
Receivers detect the notice by matching the per-fill type_hash
against backoff_notice_type_hash in their inbound envelope
routing - the framework intercepts BackoffNotice envelopes before
data-plane / control-plane dispatch so user Components never see
them. Sender-side handling updates the sender’s
crate::framework::BackoffTable so the existing
BackoffGateTx consultation gates the next outbound send to
that peer.
Structs§
- Backoff
Notice Payload - Wire-encoded BackoffNotice payload.
Enums§
- Backoff
Cause Wire - Wire-stable encoding of
BackoffCause. Serialized as a u8 so the on-wire representation never bit-shifts when the framework enum evolves. Always derived from the framework enum at the send site + mapped back at the receive site.
Constants§
- BACKPRESSURE_
DOMAIN - Domain string the framework uses to namespace the backpressure
protocol per
bb-runtime/src/bus.rs:155reserved framework prefix. Surfaced for cross-referencing in docs + tests; the actual routing key is the per-filltype_hashfrombackoff_notice_type_hash.
Functions§
- backoff_
notice_ type_ hash - Stable u64 discriminator for
BackoffNoticePayload. Matches the canonicalSlotFill.type_hashthe framework stamps at send time and consults at receive time perbb-ir/src/slot_value.rs:203-210. - build_
backoff_ notice_ envelope - Build a
BackoffNoticewire envelope addressed tosender.