Struct InteractionDescriptor 

#[non_exhaustive]
pub struct InteractionDescriptor {

    pub interaction_id: InteractionId,
    pub kind: InteractionKind,
    pub label: String,
    pub required_permission: Option<String>,
    pub input_schema: Option<SchemaContract>,
    pub result_schema: Option<SchemaContract>,
    pub sensitive_fields: Vec<String>,
    pub timeout_seconds: Option<u16>,
    pub confirmation: Option<InteractionConfirmation>,
    pub transport: InteractionTransport,
    pub workflow_steps: Vec<WorkflowStepDescriptor>,
    pub form_ui: Option<FormUiDescriptor>,
    pub icon: Option<String>,
    pub submit_label: Option<String>,
}

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

interaction_id: InteractionId

kind: InteractionKind

label: String

required_permission: Option<String>

input_schema: Option<SchemaContract>

result_schema: Option<SchemaContract>

sensitive_fields: Vec<String>

timeout_seconds: Option<u16>

confirmation: Option<InteractionConfirmation>

transport: InteractionTransport

workflow_steps: Vec<WorkflowStepDescriptor>

form_ui: Option<FormUiDescriptor>

icon: Option<String>

submit_label: Option<String>

Implementations

impl InteractionDescriptor

pub fn new( interaction_id: InteractionId, kind: InteractionKind, label: impl Into<String>, transport: InteractionTransport, ) -> InteractionDescriptor

Creates a new InteractionDescriptor with all optional fields set to their defaults.

pub fn validate_for_provider( &self, provider_kind: ProviderKind, ) -> Result<(), InteractionValidationError>

Validates provider-specific interaction contract rules.

Errors

Returns InteractionValidationError::DirectBuiltInApiForbiddenForProvider when a non-built-in provider uses direct_built_in_api transport. Returns InteractionValidationError::TimeoutOutOfRange when timeout_seconds falls outside MIN_INTERACTION_TIMEOUT_SECONDS..=MAX_INTERACTION_TIMEOUT_SECONDS. Returns InteractionValidationError::WorkflowMissingSteps when a workflow interaction declares no steps. Returns InteractionValidationError::ConfirmableActionMissingConfirmation when a confirmable interaction omits confirmation metadata. Returns InteractionValidationError::BlankLabel when label is empty or whitespace-only. Returns InteractionValidationError::BlankWorkflowStepLabel when any workflow step has an empty or whitespace-only label. Returns InteractionValidationError::IconInvalid when icon is Some but fails kebab-case validation.

Trait Implementations

impl Clone for InteractionDescriptor

fn clone(&self) -> InteractionDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InteractionDescriptor

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InteractionDescriptor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for InteractionDescriptor

impl PartialEq for InteractionDescriptor

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

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.

impl StructuralPartialEq for InteractionDescriptor