static-rust

name	static-rust
description	Use for Soma built-in Rust actions, scaffold intent collection, MCP elicitation flows, and CLI/REST action reference.

Generated by cargo xtask generate-provider-surfaces from the current provider catalog.

static-rust Provider

Native service actions compiled into Soma.

When To Use

Use for Soma built-in Rust actions, scaffold intent collection, MCP elicitation flows, and CLI/REST action reference.

Surface Selection

• Use MCP first when the server is connected, especially for MCP-only actions.
• Use CLI only when the action's CLI surface is yes; do not invent commands for N/A entries.
• Use REST only when the action's REST surface is yes; send JSON bodies matching the action schema.
• MCP-only elicitation actions require an elicitation-capable MCP client; do not attempt CLI or REST fallbacks.

Tools

tool	MCP	CLI	REST	CLI command	REST route	purpose
greet	yes	yes	yes	greet	POST /v1/greet	Return a greeting.
echo	yes	yes	yes	echo	POST /v1/echo	Echo a message back unchanged.
status	yes	yes	yes	status	GET /v1/status	Return server status and configuration info.
python_environment_status	yes	yes	yes	python_environment_status	GET /v1/python/environments	Inspect immutable Python environment cache state without executing provider code.
python_environment_prune_plan	yes	yes	yes	python_environment_prune_plan	POST /v1/python/environments/prune-plan	Plan a bounded prune of stale non-ready Python environment cache entries.
python_environment_prune	yes	yes	yes	python_environment_prune	POST /v1/python/environments/prune	Apply a bounded prune of stale non-ready Python environment cache entries.
python_environment_repair	yes	yes	yes	python_environment_repair	POST /v1/python/environments/repair	Repair the immutable environment for one managed Python provider.
python_environment_update	yes	yes	yes	python_environment_update	POST /v1/python/environments/update	Resolve, prepare, validate, and atomically activate an immutable update for one managed Python provider.
python_worker_status	yes	yes	yes	python_worker_status	GET /v1/python/workers	Inspect persistent Python worker health, quarantine, restart counts, and bounded redacted logs.
python_worker_cancel	yes	yes	yes	python_worker_cancel	POST /v1/python/workers/cancel	Cancel one active persistent Python invocation by terminating its process tree.
python_worker_reset	yes	yes	yes	python_worker_reset	POST /v1/python/workers/reset	Clear one persistent Python worker crash-loop quarantine.
python_generation_status	yes	yes	yes	python_generation_status	GET /v1/python/generations	Inspect the active Python provider generation and bounded rollback history.
python_generation_rollback	yes	yes	yes	python_generation_rollback	POST /v1/python/generations/rollback	Atomically reactivate a retained Python provider generation.
python_graduation_status	yes	yes	yes	python_graduation_status	POST /v1/python/graduation/status	Inspect digest-bound Python graduation, conformance, activation, and rollback state.
python_graduation_apply	yes	yes	yes	python_graduation_apply	POST /v1/python/graduation/apply	Scaffold, componentize, build, verify, compare, activate, or roll back a Python graduation workspace.
elicit_name	yes	no	no	N/A	N/A	Ask the MCP client to collect a name, then return a personalised greeting.
scaffold_intent	yes	no	no	N/A	N/A	Collect scaffold setup intent through MCP elicitation and return JSON for the scaffold-project skill.
help	yes	yes	yes	help	GET /v1/help	Show the action reference.

Action Reference

greet

Return a greeting.

• Scope: soma:read
• Cost: cheap
• Destructive: false
• Requires admin: false
• Required args: none
• Optional args: name: string
• Output: Greeting
• MCP: soma(action="greet")
• CLI: soma greet [--name NAME]
• CLI flags: --name NAME optional
• REST: POST /v1/greet

echo

Echo a message back unchanged.

• Scope: soma:read
• Cost: cheap
• Destructive: false
• Requires admin: false
• Required args: message: string
• Optional args: none
• Output: EchoResult
• MCP: soma(action="echo")
• CLI: soma echo --message MSG
• CLI flags: --message MSG required
• REST: POST /v1/echo

status

Return server status and configuration info.

• Scope: soma:read
• Cost: cheap
• Destructive: false
• Requires admin: false
• Required args: none
• Optional args: none
• Output: Status
• MCP: soma(action="status")
• CLI: soma status
• REST: GET /v1/status

python_environment_status

Inspect immutable Python environment cache state without executing provider code.

• Scope: soma:write
• Cost: cheap
• Destructive: false
• Requires admin: true
• Required args: none
• Optional args: none
• Output: PythonEnvironmentStatus
• MCP: soma(action="python_environment_status")
• CLI: soma python_environment_status
• REST: GET /v1/python/environments

python_environment_prune_plan

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

• Scope: soma:write
• Cost: moderate
• Destructive: false
• Requires admin: true
• Required args: stale_before_unix_seconds: integer
• Optional args: max_entries: integer
• Output: PythonEnvironmentPrunePlan
• MCP: soma(action="python_environment_prune_plan")
• CLI: soma python_environment_prune_plan --json '{"stale_before_unix_seconds": 0}'
• REST: POST /v1/python/environments/prune-plan

python_environment_prune

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

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: false
• Required args: stale_before_unix_seconds: integer, confirm: boolean
• Optional args: max_entries: integer
• Output: PythonEnvironmentPruneReport
• MCP: soma(action="python_environment_prune")
• CLI: soma python_environment_prune --json '{"stale_before_unix_seconds": 0, "confirm": true}'
• REST: POST /v1/python/environments/prune

python_environment_repair

Repair the immutable environment for one managed Python provider.

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: false
• Required args: provider_path: string, confirm: boolean
• Optional args: none
• Output: PythonEnvironmentRepairReport
• MCP: soma(action="python_environment_repair")
• CLI: soma python_environment_repair --json '{"provider_path": "example.py", "confirm": true}'
• REST: POST /v1/python/environments/repair

python_environment_update

Resolve, prepare, validate, and atomically activate an immutable update for one managed Python provider.

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: false
• Required args: provider_path: string, confirm: boolean
• Optional args: none
• Output: PythonEnvironmentUpdateReport
• MCP: soma(action="python_environment_update")
• CLI: soma python_environment_update --json '{"provider_path": "example.py", "confirm": true}'
• REST: POST /v1/python/environments/update

python_worker_status

Inspect persistent Python worker health, quarantine, restart counts, and bounded redacted logs.

• Scope: soma:write
• Cost: cheap
• Destructive: false
• Requires admin: true
• Required args: none
• Optional args: none
• Output: PythonWorkerStatus
• MCP: soma(action="python_worker_status")
• CLI: soma python_worker_status
• REST: GET /v1/python/workers

python_worker_cancel

Cancel one active persistent Python invocation by terminating its process tree.

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: false
• Required args: provider: string, confirm: boolean
• Optional args: none
• Output: PythonWorkerCancellation
• MCP: soma(action="python_worker_cancel")
• CLI: soma python_worker_cancel --json '{"provider": "example", "confirm": true}'
• REST: POST /v1/python/workers/cancel

python_worker_reset

Clear one persistent Python worker crash-loop quarantine.

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: false
• Required args: provider: string, confirm: boolean
• Optional args: none
• Output: PythonWorkerReset
• MCP: soma(action="python_worker_reset")
• CLI: soma python_worker_reset --json '{"provider": "example", "confirm": true}'
• REST: POST /v1/python/workers/reset

python_generation_status

Inspect the active Python provider generation and bounded rollback history.

• Scope: soma:read
• Cost: cheap
• Destructive: false
• Requires admin: false
• Required args: none
• Optional args: none
• Output: PythonGenerationStatus
• MCP: soma(action="python_generation_status")
• CLI: soma python_generation_status
• REST: GET /v1/python/generations

python_generation_rollback

Atomically reactivate a retained Python provider generation.

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: false
• Required args: generation_id: integer, confirm: boolean
• Optional args: none
• Output: PythonGenerationRollback
• MCP: soma(action="python_generation_rollback")
• CLI: soma python_generation_rollback --json '{"generation_id": 1, "confirm": true}'
• REST: POST /v1/python/generations/rollback

python_graduation_status

Inspect digest-bound Python graduation, conformance, activation, and rollback state.

• Scope: soma:read
• Cost: cheap
• Destructive: false
• Requires admin: true
• Required args: workspace: string
• Optional args: none
• Output: PythonGraduationStatus
• MCP: soma(action="python_graduation_status")
• CLI: soma python_graduation_status --json '{"workspace":"/absolute/path"}'
• REST: POST /v1/python/graduation/status

python_graduation_apply

Scaffold, componentize, build, verify, compare, activate, or roll back a Python graduation workspace.

• Scope: soma:write
• Cost: write
• Destructive: true
• Requires admin: true
• Required args: operation: string, workspace: string, confirm: boolean
• Optional args: source: string, component: string, fixtures: string, wheelhouse: string
• Output: PythonGraduationReport
• MCP: soma(action="python_graduation_apply")
• CLI: soma python_graduation_apply --json '{"operation":"compare","workspace":"/absolute/path","fixtures":"/absolute/fixtures.json","confirm":true}'
• REST: POST /v1/python/graduation/apply

elicit_name

Ask the MCP client to collect a name, then return a personalised greeting.

• Scope: soma:read
• Cost: cheap
• Destructive: false
• Requires admin: false
• Required args: none
• Optional args: none
• Output: Greeting
• MCP: soma(action="elicit_name")
• CLI: N/A - do not call this action from CLI.
• REST: N/A - do not invent an HTTP route.

scaffold_intent

Collect scaffold setup intent through MCP elicitation and return JSON for the scaffold-project skill.

• Scope: soma:read
• Cost: moderate
• Destructive: false
• Requires admin: false
• Required args: none
• Optional args: none
• Output: ScaffoldIntentReport
• MCP: soma(action="scaffold_intent")
• CLI: N/A - do not call this action from CLI.
• REST: N/A - do not invent an HTTP route.
• Elicitation fallback: recommended_skill: scaffold-project. Ask the user for the scaffold fields manually, then create the same JSON shape documented by the scaffold-project skill. Do not mutate files until the user approves the plan.

help

Show the action reference.

• Scope: public/default
• Cost: cheap
• Destructive: false
• Requires admin: false
• Required args: none
• Optional args: none
• Output: HelpPayload
• MCP: soma(action="help")
• CLI: soma help
• REST: GET /v1/help

Prompts

• quick_start: Check the server status and get a personalised greeting to verify the MCP connection is working end-to-end.