Enum AppEvent 

pub enum AppEvent {
    Emit {
        name: String,
        value_bytes: Vec<u8>,
    },
    Notify {
        name: String,
    },
}

App-Op-emitted events surfaced as EngineStep::AppEvent.

Application code constructs these via AppEvent::emit / AppEvent::notify which reject framework-reserved topic prefixes (bb., ai.bytesandbrains.) so the framework’s own InfraEvent topic namespace can never be impersonated by user publish calls (closes the trust-boundary requirement in §Trust boundary). The struct variants stay constructible directly for framework-internal forwarding paths that are not crossing the application boundary.

Variants

Emit

AppEmit(name, value_bytes) - full app event carrying bytes.

Fields

name: String

Event topic.

value_bytes: Vec<u8>

Encoded value payload.

Notify

AppNotify(name) - marker-only notification.

Fields

name: String

Event topic.

Implementations

impl AppEvent

pub fn emit( name: impl Into<String>, value_bytes: Vec<u8>, ) -> Result<Self, AppEventError>

Construct an AppEvent::Emit, rejecting framework-reserved topic prefixes. The trust boundary AppEvent::new referenced in docs-plan/CORRECTED_ARCHITECTURE.md §Trust boundary.

pub fn notify(name: impl Into<String>) -> Result<Self, AppEventError>

Construct an AppEvent::Notify, rejecting framework- reserved topic prefixes. See Self::emit.

Trait Implementations

impl Clone for AppEvent

fn clone(&self) -> AppEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.