Enum ActionResult 

pub enum ActionResult {
    Success {
        exports: HashMap<String, Value>,
    },
    NeedClarification {
        question: String,
    },
    NeedApproval {
        request: ApprovalRequest,
    },
    RetryableError {
        message: String,
        retry_after: Option<Duration>,
        attempt: u32,
    },
    Error {
        message: String,
    },
}

Action execution result with retry semantics

Variants

Success

Execution succeeded exports can be empty (side-effect only)

Fields

exports: HashMap<String, Value>

Output values to export to WorkingSet

NeedClarification

Need user clarification to proceed

Fields

question: String

Question to ask the user

NeedApproval

Need explicit user approval before continuing

Fields

request: ApprovalRequest

RetryableError

Retryable error (rate limit / timeout / external service flakiness)

Fields

message: String

Error message

retry_after: Option<Duration>

Suggested wait time before retry

attempt: u32

Current attempt number

Error

Non-recoverable error

Fields

message: String

Error message

Implementations

impl ActionResult

pub fn success() -> ActionResult

Convenience: create a success result with no exports

pub fn success_with(exports: HashMap<String, Value>) -> ActionResult

Convenience: create a success result with exports

pub fn success_with_one(key: impl Into<String>, value: Value) -> ActionResult

Convenience: create a success result with a single export

pub fn need_clarification(question: impl Into<String>) -> ActionResult

Convenience: create a clarification request

pub fn need_approval( reason: impl Into<String>, command: Option<String>, ) -> ActionResult

Convenience: create an approval request

pub fn retryable( message: impl Into<String>, retry_after: Option<Duration>, attempt: u32, ) -> ActionResult

Convenience: create a retryable error

pub fn error(message: impl Into<String>) -> ActionResult

Convenience: create a non-recoverable error

pub fn is_success(&self) -> bool

Check if the result is successful

pub fn is_retryable(&self) -> bool

Check if the result is retryable

pub fn is_error(&self) -> bool

Check if the result is a terminal error

pub fn needs_user_input(&self) -> bool

Check if the result needs user input

Trait Implementations

impl Clone for ActionResult

fn clone(&self) -> ActionResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActionResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ActionResult

fn deserialize<__D>( __deserializer: __D, ) -> Result<ActionResult, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ActionResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.