Struct AgentPlugin 

pub struct AgentPlugin { /* private fields */ }

Agent spawn/stop/list plugin.

Manages ralph agent processes spawned from within a room. Tracks PIDs, provides /agent spawn, /agent list, and /agent stop commands.

Implementations

impl AgentPlugin

pub fn new(state_path: PathBuf, socket_path: PathBuf, log_dir: PathBuf) -> Self

Create a new agent plugin.

Loads previously persisted agent state and prunes entries whose processes are no longer running.

pub fn default_commands() -> Vec<CommandInfo>

Returns the command info for the TUI command palette without needing an instantiated plugin. Used by all_known_commands().

Trait Implementations

impl Plugin for AgentPlugin

fn name(&self) -> &str

Unique identifier for this plugin (e.g. "stats", "help").

fn version(&self) -> &str

Semantic version of this plugin (e.g. "1.0.0").

fn commands(&self) -> Vec<CommandInfo>

Commands this plugin handles. Each entry drives /help output and TUI autocomplete.

fn on_message(&self, msg: &Message)

Called after every message is broadcast to the room. The default is a no-op.

fn handle(&self, ctx: CommandContext) -> BoxFuture<'_, Result<PluginResult>>

Handle an invocation of one of this plugin’s commands.

fn api_version(&self) -> u32

Plugin API version this plugin was written against.

fn min_protocol(&self) -> &str

Minimum room-protocol crate version this plugin requires, as a semver string (e.g. "3.1.0").

fn on_user_join(&self, _user: &str)

Called after a user joins the room. The default is a no-op.

fn on_user_leave(&self, _user: &str)

Called after a user leaves the room. The default is a no-op.