Enum UserAction 

pub enum UserAction {
    SendMessage(String),
    RunShell(String),
    ConfirmPlan,
    RejectPlan(String),
    ApprovePlanMode,
    RejectPlanMode(String),
    Compact,
    SetPlanningMode(bool),
    Interrupt,
    Shutdown,
    SetGoal {
        condition: String,
        max_turns: u32,
    },
    ClearGoal,
    RunSkillPrompt {
        prompt: String,
    },
    ResumeSession {
        session_dir: PathBuf,
    },
    ListMcpServers,
}

Actions originating from key events that the backend worker must service against the [recursive::AgentRuntime].

Variants

SendMessage(String)

Send a user message and run one turn.

RunShell(String)

Run a shell command directly via the runtime’s tool registry, bypassing the LLM. The command is dispatched to the run_shell tool and its result surfaces as a UiEvent::ToolCall + UiEvent::ToolResult pair, but is not appended to the runtime transcript.

Goal-145: this powers the !-prefixed bash mode of the PromptInput so users get a quick scratch shell without polluting the agent dialogue.

ConfirmPlan

Confirm the pending plan and resume execution.

RejectPlan(String)

Reject the pending plan with a free-form reason.

ApprovePlanMode

Goal-202: user approves the plan-mode entry request (request_plan_mode).

RejectPlanMode(String)

Goal-202: user rejects the plan-mode entry request; agent executes directly.

Compact

Goal-146: trigger a transcript compaction pass via [AgentRuntime::compact_now]. The worker pushes a Compacted event when summarisation succeeds.

SetPlanningMode(bool)

Goal-146: flip the runtime’s planning mode. true enables plan-first mode, false reverts to immediate execution. The worker echoes a System block confirming the new state.

Interrupt

Goal-147: signal the worker to abort the in-flight turn. The worker flips its cancel_flag, and any tokio::select! waiting on wait_for_cancel returns immediately. The runtime is not cancelled mid-HTTP-request (reqwest doesn’t support that); on the next tool-call boundary the next turn will surface as a UiEvent::Error { message: "interrupted" }.

Shutdown

Tear down the worker and exit the runtime.

SetGoal

Start a condition-based autonomous loop. The backend will kick off run_goal_loop and emit GoalContinuing/GoalAchieved events.

Fields

condition: String

The completion condition.

max_turns: u32

Hard cap on autonomous turns (default 20).

ClearGoal

Clear the active goal immediately.

RunSkillPrompt

Send an already-expanded skill prompt to the runtime.

Fields

prompt: String

The expanded prompt text (with $ARGUMENTS substituted).

ResumeSession

Load a previously saved session transcript into the runtime.

Fields

session_dir: PathBuf

The session directory path (absolute).

ListMcpServers

List configured MCP servers.

Trait Implementations

impl Clone for UserAction

fn clone(&self) -> UserAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UserAction

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

Formats the value using the given formatter.

impl Eq for UserAction

impl PartialEq for UserAction

fn eq(&self, other: &UserAction) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for UserAction