Enum GoalOutcome 

pub enum GoalOutcome {
    Succeeded {
        summary: String,
        extracted_data: Value,
    },
    Failed(FailureReport),
    Refused {
        summary: String,
    },
}

Terminal outcome of a whole agent run.

Every caller — CLI, MCP, eval harness — consumes this exact shape. There is no “timeout” or “max steps” variant: those are budget limits, and exhausting one produces a FailureReport whose attempts describe why the agent used up the budget.

Variants

Succeeded

The agent reached a satisfying end state. summary is the natural-language recap (what the CLI prints after === Result ===, what the MCP response shows). extracted_data is the plan’s final shared_memory — prices, URLs, confirmation numbers, etc.

Fields

summary: String

extracted_data: Value

Failed(FailureReport)

The agent gave up. report names which sub-goal and step died, and carries the last three error messages.

Refused

The agent refused to act because the goal was too ambiguous or destructive to attempt safely, and asked the user for clarification instead.

Terminal like Failed but semantically distinct: the agent isn’t broken, the goal is. summary carries the clarification question — verbatim what the planner emitted in NextMove::Clarify. Callers (CLI, MCP server, eval harness) render it back to the user as a prompt, not an error.

Fields

summary: String

The clarification question (or refusal explanation) the planner produced. Free-form text; the runner does not re-format it. Callers may choose to wrap it in a “the agent asked: …” frame.

Trait Implementations

impl Clone for GoalOutcome

fn clone(&self) -> GoalOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GoalOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GoalOutcome

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GoalOutcome

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

where __S: Serializer,

Serialize this value into the given Serde serializer.