Enum ActionOutcome 

pub enum ActionOutcome {
    Accepted {
        session_id: Option<String>,
    },
    Busy,
    SessionBusy,
    NotCancellable,
    Refused(Refusal),
    Failed {
        reference: String,
    },
}

The controller’s answer to one phone action.

The answer means “accepted”, not “finished”: provisioning, resume and close run for minutes, and a phone on a mobile network drops a request held open that long. How the action then goes travels in snapshots — session state, queued prompts, transcripts, and has_error.

Only the outcome crosses this boundary. The controller’s own failure text names profile homes, project paths and SSH hosts, so it stays on the controller. A caller therefore gets one of two things: a Refusal, whose sentence was written for it at the place the failure was produced, or a generic internal failure carrying a reference that also appears in the daemon log.

Variants

Accepted

Admitted and now running; watch the snapshot for what happens next.

A new action carries the published session id, which is the only way its caller learns what it just created.

Fields

session_id: Option<String>

Busy

The controller already runs as many phone actions as it allows.

SessionBusy

This session already has an operation running.

NotCancellable

A cancel found no operation to cancel.

Refused(Refusal)

The action was refused for a reason the caller can act on, and the refusal says what it is.

Failed

The controller could not start the action, for a reason that stays server-side. reference is logged with the failure, so the person who owns the daemon can find the entry that explains it.

Fields

reference: String

Implementations

impl ActionOutcome

pub const fn accepted() -> Self

Admitted, with no session id to report.

pub fn session_id(&self) -> Option<&str>

The published session id, when this outcome carries one.

Trait Implementations

impl Clone for ActionOutcome

fn clone(&self) -> ActionOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActionOutcome

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

Formats the value using the given formatter.

impl Eq for ActionOutcome

impl PartialEq for ActionOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ActionOutcome