Enum SubagentOutcome 

pub enum SubagentOutcome {
    Success,
    Suspended {
        interrupt_ids: Option<Vec<String>>,
    },
}

How a subagent invocation’s stream segment closed for this run.

Mirrors RunOutcome one level down. The field is optional on SUBAGENT_FINISHED, and absent reads as success — but an explicit null is rejected, because the field is newer than the fix that made every official producer omit valueless fields.

Variants

Success

The work completed.

Suspended

The workflow is paused awaiting outside input — a human approval raised inside the subagent, say. The run then ends with an interrupt outcome, and because every started subagent closes before RUN_FINISHED, the paused one still emits SUBAGENT_FINISHED — with this outcome, so a UI can show “waiting” rather than “done”.

Fields

interrupt_ids: Option<Vec<String>>

The run-level interrupts this subagent directly owns; each such Interrupt carries subagent_run_id back. May be empty or absent: an ancestor suspended because a descendant interrupted owns no interrupt itself. Absent or a list, never null, like every other field on this surface.

Implementations

impl SubagentOutcome

pub fn suspended(interrupt_ids: impl Into<Vec<String>>) -> Self

Builds a suspended outcome naming the interrupts the subagent owns.

pub const fn is_suspended(&self) -> bool

Whether the subagent is waiting rather than done.

pub fn interrupt_ids(&self) -> &[String]

The interrupts a suspended subagent owns, or an empty slice.

Trait Implementations

impl Clone for SubagentOutcome

fn clone(&self) -> SubagentOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for SubagentOutcome

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for SubagentOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SubagentOutcome

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for SubagentOutcome

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for SubagentOutcome

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

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 SubagentOutcome

impl ToSchema for SubagentOutcome

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference [utoipa::openapi::schema::Schema]s for this type.