Enum SomaAction 

pub enum SomaAction {
    Greet {
        name: Option<String>,
    },
    Echo {
        message: String,
    },
    Status,
    PythonEnvironmentStatus,
    PythonEnvironmentPrunePlan {
        stale_before_unix_seconds: u64,
        max_entries: usize,
    },
    PythonEnvironmentPrune {
        stale_before_unix_seconds: u64,
        max_entries: usize,
    },
    PythonEnvironmentRepair {
        provider_path: String,
    },
    PythonEnvironmentUpdate {
        provider_path: String,
    },
    PythonWorkerStatus,
    PythonWorkerCancel {
        provider: String,
    },
    PythonWorkerReset {
        provider: String,
    },
    PythonGenerationStatus,
    PythonGenerationRollback {
        generation_id: u64,
    },
    PythonGraduationStatus {
        workspace: String,
    },
    PythonGraduationApply {
        operation: String,
        workspace: String,
        source: Option<String>,
        component: Option<String>,
        fixtures: Option<String>,
        wheelhouse: Option<String>,
    },
    Help,
    ElicitName,
    ScaffoldIntent,
}

A parsed, validated action request ready for dispatch.

Variants

Greet

Return a greeting, optionally addressed to name.

Fields

name: Option<String>

Name to greet; greets the world when absent.

Echo

Echo message back unchanged.

Fields

message: String

Message to echo back.

Status

Return server status and configuration info.

PythonEnvironmentStatus

Inspect immutable Python environment cache state.

PythonEnvironmentPrunePlan

Plan a bounded prune of stale non-ready Python environment entries.

Fields

stale_before_unix_seconds: u64

Oldest modification timestamp selected by the plan.

max_entries: usize

Maximum number of entries included in the plan.

PythonEnvironmentPrune

Apply a bounded prune of stale non-ready Python environment entries.

Fields

stale_before_unix_seconds: u64

Oldest modification timestamp selected by the plan.

max_entries: usize

Maximum number of entries removed.

PythonEnvironmentRepair

Repair one managed Python provider environment.

Fields

provider_path: String

Provider path relative to the configured provider root, or an absolute managed path.

PythonEnvironmentUpdate

Prepare and atomically activate one managed Python provider update.

Fields

provider_path: String

Provider path relative to the configured provider root, or an absolute managed path.

PythonWorkerStatus

Inspect persistent Python worker state and bounded redacted logs.

PythonWorkerCancel

Cancel one active persistent Python invocation.

Fields

provider: String

Loaded persistent Python provider name.

PythonWorkerReset

Clear one persistent Python worker crash-loop quarantine.

Fields

provider: String

Loaded persistent Python provider name.

PythonGenerationStatus

Inspect active and retained Python provider generations.

PythonGenerationRollback

Atomically reactivate one retained generation.

Fields

generation_id: u64

Retained generation identifier.

PythonGraduationStatus

Inspect one Python graduation workspace.

Fields

workspace: String

Absolute graduation workspace path.

PythonGraduationApply

Run one confirmed Python graduation mutation.

Fields

operation: String

Operation name.

workspace: String

Absolute graduation workspace path.

source: Option<String>

Optional Python source path.

component: Option<String>

Optional component path.

fixtures: Option<String>

Optional fixture corpus path.

wheelhouse: Option<String>

Optional directory containing authenticated pure-Python wheels.

Help

Show the action reference.

ElicitName

Ask the MCP client to collect a name, then greet it (MCP-only).

ScaffoldIntent

Collect scaffold setup intent via MCP elicitation (MCP-only).

Implementations

impl SomaAction

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

Returns the canonical action name for this variant.

pub fn from_mcp_args(args: &Value) -> Result<Self>

Parses an action from an MCP tool-call argument object.

pub fn from_rest(action: &str, params: &Value) -> Result<Self>

Parses an action from a REST request, rejecting MCP-only actions.

Trait Implementations

impl Clone for SomaAction

fn clone(&self) -> SomaAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SomaAction

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

Formats the value using the given formatter.

impl PartialEq for SomaAction

fn eq(&self, other: &SomaAction) -> 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 Eq for SomaAction

impl StructuralPartialEq for SomaAction