Struct OneOffActuatorAgent 

pub struct OneOffActuatorAgent { /* private fields */ }

Ephemeral actor that resolves and executes one-shot HA service calls.

Spawned on demand by the orchestrator. Exits after processing a single message, matching the Python implementation’s lifecycle.

Implementations

impl OneOffActuatorAgent

pub fn new(config: ActorConfig, task_id: String, reply_to_id: String) -> Self

Create a new OneOffActuatorAgent for the given task_id.

The actor name is derived from the last 8 characters of task_id, matching the Python naming convention.

pub fn with_publisher(self, p: EventPublisher) -> Self

Attach an event publisher for MQTT output.

pub fn with_ha_config(self, url: String, token: String) -> Self

Configure the Home Assistant base URL and long-lived access token.

Trait Implementations

impl Actor for OneOffActuatorAgent

fn id(&self) -> String

Return this actor’s unique WID identifier.

fn name(&self) -> &str

Return this actor’s human-readable name.

fn state(&self) -> ActorState

Return the current lifecycle state.

fn metrics(&self) -> Arc<ActorMetrics>

Return a reference to this actor’s metrics.

fn mailbox(&self) -> Sender<Message>

Return a sender handle to this actor’s mailbox.

fn is_protected(&self) -> bool

Return whether this actor is protected from external kill commands.

fn on_start<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called once after the actor is created, before the message loop starts.

fn handle_message<'life0, 'async_trait>( &'life0 mut self, message: Message, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called with each incoming message from the mailbox.

fn run<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Drive the actor’s main loop.

fn on_heartbeat<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Called on heartbeat tick; default implementation is a no-op.

fn on_stop<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Called once just before the actor loop exits.