Struct TaskSpec 

pub struct TaskSpec { /* private fields */ }

Desired state specification.

TaskSpec describes what should be run and how it should be managed by the runtime.

Fields cover:

• logical grouping (slot)
• execution backend (kind)
• concurrency control (admission)
• lifecycle policies (timeout, restart, backoff)

Also

• TaskSpecBuilder validated builder (via TaskSpec::builder).
• TaskKind execution backend variants.
• RestartPolicy / BackoffPolicy lifecycle policies.
• AdmissionPolicy duplicate handling.
• RunnerSelector label-based runner routing.

Implementations

impl TaskSpec

pub fn slot(&self) -> &Slot

Logical slot name for concurrency control.

pub fn kind(&self) -> &TaskKind

Execution backend used to run the task.

pub fn timeout(&self) -> Timeout

Hard timeout in milliseconds.

pub fn restart(&self) -> RestartPolicy

Restart policy applied after completion or failure.

pub fn backoff(&self) -> &BackoffPolicy

Backoff configuration between restart attempts.

pub fn admission(&self) -> AdmissionPolicy

Admission policy for handling slot conflicts.

pub fn max_retries(&self) -> u32

Maximum failure-driven retries per run (0 = unlimited, the default).

Counts only failure retries (the counter resets on success); when the budget is exhausted the supervisor stops restarting the task.

pub fn runner_selector(&self) -> Option<&RunnerSelector>

Label selector for runner routing (if present).

pub fn labels(&self) -> &Labels

Metadata labels for routing / scheduling / observability.

impl TaskSpec

pub fn builder( slot: impl Into<Slot>, kind: TaskKind, timeout: impl Into<Timeout>, ) -> TaskSpecBuilder

Create a TaskSpecBuilder with the three required fields.

use solti_model::{TaskSpec, TaskKind, SubprocessSpec, SubprocessMode, RestartPolicy};

let spec = TaskSpec::builder(
    "my-slot",
    TaskKind::Subprocess(SubprocessSpec {
        mode: SubprocessMode::Command {
            command: "echo".into(),
            args: vec!["hello".into()],
        },
        env: Default::default(),
        cwd: None,
        fail_on_non_zero: Default::default(),
    }),
    5_000u64,
)
.restart(RestartPolicy::OnFailure)
.build()
.expect("valid spec");

impl TaskSpec

pub fn with_runner_selector(self, sel: RunnerSelector) -> Self

Attach a runner selector used by the router (consuming builder-style).

pub fn with_admission(self, admission: AdmissionPolicy) -> Self

Override the admission policy (consuming builder-style).

Used by the apply/upgrade path to force AdmissionPolicy::Replace regardless of the spec’s declared admission.

impl TaskSpec

pub fn validate(&self) -> ModelResult<()>

Validate the spec at the submit boundary.

Trait Implementations

impl Clone for TaskSpec

fn clone(&self) -> TaskSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TaskSpec

impl PartialEq for TaskSpec

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TaskSpec