Struct ConnectionRequirement 

pub struct ConnectionRequirement {
    pub provider: Option<String>,
    pub connection_id: Option<Uuid>,
    pub scopes: Vec<String>,
    pub env_var: Option<String>,
    pub required: bool,
}

Declarative reference to a connection that an agent definition requires.

Resolved at agent-run start: the orchestrator matches this against the workspace’s connections table, fetches the secret (OAuth token / custom fields / distri-native session), and injects the result into ExecutorContext.env_vars + dynamic_values.available_connections.

Prefer provider (portable across workspaces) over connection_id.

Fields

provider: Option<String>

Match by provider name (preferred): “google”, “slack”, … Resolved against the Connection’s auth.provider for Oauth, the Connection’s name for Custom, and "distri" for DistriNative.

connection_id: Option<Uuid>

Pin to a specific connection ID. Takes precedence over provider.

scopes: Vec<String>

Minimum OAuth scopes required. Resolution fails (when required=true) or marks the requirement unmet (when required=false) if the connected token doesn’t cover all of these.

env_var: Option<String>

Env var name override. Default: <PROVIDER>_TOKEN for OAuth, <PROVIDER>_<FIELD_KEY> for each Custom field.

required: bool

If true, the agent fails to start when this connection can’t be resolved. If false (default), the agent starts and the requirement is surfaced in {{available_providers}} so the LLM can prompt the user to connect.

Trait Implementations

impl Clone for ConnectionRequirement

fn clone(&self) -> ConnectionRequirement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for ConnectionRequirement

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

impl Debug for ConnectionRequirement

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

Formats the value using the given formatter.

impl Default for ConnectionRequirement

fn default() -> ConnectionRequirement

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConnectionRequirement

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ConnectionRequirement

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 Serialize for ConnectionRequirement

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToSchema for ConnectionRequirement

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

Return name of the schema.

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

Implement reference utoipa::openapi::schema::Schemas for this type.