Enum ExecutionPhase 

pub enum ExecutionPhase {
    Commentary,
    FinalAnswer,
}

Execution phase for assistant messages in multi-step tool-calling flows.

Providers that natively support phases (OpenAI GPT-5.x) send the phase value directly in the API request. For providers without native support (Anthropic, Gemini), the phase is still tracked internally and derived from state in the ReasonAtom, but is not sent to the provider API.

Serialized as lowercase strings for backward compatibility with existing persisted messages: "commentary" and "final_answer".

Legacy values "in_progress" and "completed" are accepted during deserialization for backward compatibility.

Variants

Commentary

Intermediate update — preamble or commentary before/between tool calls. The model is still working and may issue more tool calls.

FinalAnswer

Final completed response — no more tool calls expected.

Implementations

impl ExecutionPhase

pub fn from_has_tool_calls(has_tool_calls: bool) -> Self

Derive phase from whether the response contains tool calls.

pub fn from_provider_str(s: &str) -> Option<Self>

Parse a provider wire value into an ExecutionPhase. Returns None for unrecognized values.

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

Wire value used by providers that support native phases (OpenAI).

Trait Implementations

impl Clone for ExecutionPhase

fn clone(&self) -> ExecutionPhase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ExecutionPhase

impl Debug for ExecutionPhase

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExecutionPhase

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for ExecutionPhase

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

Formats the value using the given formatter.

impl Eq for ExecutionPhase

impl PartialEq for ExecutionPhase

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

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ExecutionPhase