Struct ActorRuntime 

pub struct ActorRuntime {
    pub actor_id: TheaterId,
    pub handler_tasks: Vec<JoinHandle<()>>,
    pub shutdown_controller: ShutdownController,
}

ActorRuntime

Coordinates the execution and lifecycle of a single WebAssembly actor within the Theater system.

ActorRuntime manages the various components that make up an actor’s execution environment, including handlers and communication channels. It’s responsible for starting the actor, setting up its capabilities via handlers, executing operations, and ensuring proper shutdown.

Fields

actor_id: TheaterId

Unique identifier for this actor

handler_tasks: Vec<JoinHandle<()>>

Handles to the running handler tasks

shutdown_controller: ShutdownController

Controller for graceful shutdown of all components

Implementations

impl ActorRuntime

pub async fn start( id: TheaterId, config: &ManifestConfig, state_bytes: Option<Vec<u8>>, theater_tx: Sender<TheaterCommand>, actor_sender: Sender<ActorMessage>, actor_mailbox: Receiver<ActorMessage>, operation_rx: Receiver<ActorOperation>, operation_tx: Sender<ActorOperation>, info_rx: Receiver<ActorInfo>, info_tx: Sender<ActorInfo>, control_rx: Receiver<ActorControl>, control_tx: Sender<ActorControl>, init: bool, parent_shutdown_receiver: ShutdownReceiver, response_tx: Sender<StartActorResult>, engine: Engine, parent_permissions: HandlerPermission, )

Start a new actor runtime

Initializes and starts an actor runtime with the specified configuration, setting up all necessary components for the actor to run.

Parameters

• id - Unique identifier for the actor
• config - Configuration for the actor from its manifest
• state_bytes - Optional initial state for the actor
• theater_tx - Channel for sending commands back to the Theater runtime
• actor_sender - Channel for sending messages to the actor
• actor_mailbox - Channel for receiving messages from other actors
• operation_rx - Channel for receiving operations to perform
• operation_tx - Channel for sending operations to the executor
• init - Whether to initialize the actor (call the init function)
• parent_shutdown_receiver - Receiver for shutdown signals from the parent
• response_tx - Channel for sending the start result back to the caller

This method is “start and forget” - it spawns the actor task and does not return anything.

pub async fn stop(self) -> Result<()>

Stop the actor runtime

Gracefully shuts down the actor runtime and all its components. This method is retained for API compatibility but delegates to the shutdown controller.

Returns

• Ok(()) - The runtime was successfully shut down
• Err(anyhow::Error) - An error occurred during shutdown