Enum AdminEvent 

#[non_exhaustive]
pub enum AdminEvent {
    HostUpdated {
        id: Uuid,
    },
    HostCreated {
        id: Uuid,
    },
    HostDeleted {
        id: Uuid,
    },
    ServiceStatusChanged {
        id: Uuid,
        status: String,
    },
    SoftwareItemUpdated {
        id: Uuid,
    },
    SoftwareItemCreated {
        id: Uuid,
    },
    VersionCheckCompleted {
        host_id: Uuid,
        software_item_id: Uuid,
    },
    UpdateTriggered {
        update_history_id: Uuid,
        host_id: Uuid,
        software_item_id: Uuid,
    },
    UpdateProtectionStarted {
        update_history_id: Uuid,
        host_id: Uuid,
        software_item_id: Uuid,
    },
    UpdateStarted {
        update_history_id: Uuid,
        host_id: Uuid,
        software_item_id: Uuid,
        interactive: bool,
    },
    UpdateCompleted {
        update_history_id: Uuid,
        host_id: Uuid,
        software_item_id: Uuid,
        status: String,
    },
    DiscoveryCompleted {
        host_id: Uuid,
    },
    SystemServiceStatusChanged {
        id: Uuid,
        status: String,
    },
    SchedulerTaskCompleted {
        task_id: Uuid,
    },
    HostTagCreated {
        id: Uuid,
    },
    HostTagUpdated {
        id: Uuid,
    },
    HostTagDeleted {
        id: Uuid,
    },
    HostTagsChanged {
        host_id: Uuid,
    },
    GlobalGitHubProviderMisconfigured {
        problem: String,
    },
    DataReset,
}

A real-time event pushed to admin SSE subscribers.

Each variant represents a state change that the frontend can use to invalidate and refresh the relevant data. Events are lightweight invalidation signals — they carry only enough context (entity IDs, status strings) for the subscriber to decide whether to refetch.

Wire format

Sent as SSE with event: set to event_name() and data: set to the JSON-serialised inner fields of the variant.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

HostUpdated

A host’s metadata was updated.

Fields

id: Uuid

HostCreated

A new host was created (e.g. reported by an agent).

Fields

id: Uuid

HostDeleted

A host was deactivated / deleted.

Fields

id: Uuid

ServiceStatusChanged

A service’s status changed (approved, rejected, deactivated).

Fields

id: Uuid

status: String

SoftwareItemUpdated

A software item was updated.

Fields

id: Uuid

SoftwareItemCreated

A new software item was created.

Fields

id: Uuid

VersionCheckCompleted

A version check completed for a host + software item pair.

Fields

host_id: Uuid

software_item_id: Uuid

UpdateTriggered

A software update was created and dispatched to the agent.

Emitted immediately after trigger_update_for_host succeeds, before the agent confirms start. Allows the History page to show the new pending/queued entry in real-time without polling.

Fields

update_history_id: Uuid

host_id: Uuid

software_item_id: Uuid

UpdateProtectionStarted

Controller pre-update protection started for a software update.

Emitted by the orchestrator when protection (snapshot/backup) begins. The frontend transitions the update record to In Progress state on receipt.

Fields

update_history_id: Uuid

host_id: Uuid

software_item_id: Uuid

UpdateStarted

A software update started executing.

Fields

update_history_id: Uuid

host_id: Uuid

software_item_id: Uuid

interactive: bool

Whether the update was dispatched in interactive mode (PTY allocated).

Allows the history list to show an “Input Required” badge in real-time without reloading, as soon as the update transitions to in_progress.

UpdateCompleted

A software update completed (successfully or with failure).

Fields

update_history_id: Uuid

host_id: Uuid

software_item_id: Uuid

status: String

DiscoveryCompleted

Autodiscovery completed for a host.

Fields

host_id: Uuid

SystemServiceStatusChanged

A system service’s status changed (approved, rejected, deactivated).

Fields

id: Uuid

status: String

SchedulerTaskCompleted

A scheduled task completed execution.

Fields

task_id: Uuid

HostTagCreated

A host tag was created.

Fields

id: Uuid

HostTagUpdated

A host tag was updated.

Fields

id: Uuid

HostTagDeleted

A host tag was deleted.

Fields

id: Uuid

HostTagsChanged

Tag assignments changed on a host.

Fields

host_id: Uuid

GlobalGitHubProviderMisconfigured

The global GitHub provider settings are stored in an invalid state.

Fields

problem: String

DataReset

All tenant data was reset (hosts, software items, etc. deleted).

Implementations

impl AdminEvent

pub fn event_name(&self) -> &'static str

Returns the SSE event: field name for this variant.

The name is the snake_case version of the variant name, matching the serde rename_all = "snake_case" serialisation.

Trait Implementations

impl Clone for AdminEvent

fn clone(&self) -> AdminEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AdminEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AdminEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AdminEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.