Struct WorkflowAgentDefinition 

pub struct WorkflowAgentDefinition {
    pub name: String,
    pub description: String,
    pub version: String,
    pub definition: Value,
    pub input_schema: Option<Value>,
    pub triggers: Vec<WorkflowTrigger>,
    pub channels: Option<ChannelBindings>,
    pub connections: Vec<ConnectionRequirement>,
    pub tools: Option<ToolsConfig>,
}

Definition for a workflow-based agent. The workflow definition is stored as JSON to avoid crate dependency on distri-workflow. Deserialize to distri_workflow::WorkflowDefinition at execution time.

Fields

name: String

description: String

version: String

definition: Value

The workflow definition as JSON.

input_schema: Option<Value>

JSON Schema for required inputs (validated before execution).

triggers: Vec<WorkflowTrigger>

Agent-level triggers — applied to the default entry point. Empty = Manual only (direct API/UI invocation). Entry-point triggers (in WorkflowDefinition.entry_points[*].triggers) take precedence per-entry-point.

channels: Option<ChannelBindings>

Channel chrome when this workflow agent backs a bot. Optional.

connections: Vec<ConnectionRequirement>

Workspace connections this workflow needs. Resolved at run start — each connection’s tokens are injected into ExecutorContext.env_vars (usable from api_call steps via {env.X}), and the connection’s MCP tools become available to tool_call steps by name.

Same shape as StandardDefinition.connections; the connection’s own auth_scope (Workspace vs User) determines the fire mode for triggered runs.

tools: Option<ToolsConfig>

Explicit tool allowlist (mirrors StandardDefinition.tools). Optional — when absent, the workflow agent gets the MCP tools implied by its declared connections plus nothing else.

Trait Implementations

impl Clone for WorkflowAgentDefinition

fn clone(&self) -> WorkflowAgentDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WorkflowAgentDefinition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WorkflowAgentDefinition

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for WorkflowAgentDefinition

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 WorkflowAgentDefinition

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

where __S: Serializer,

Serialize this value into the given Serde serializer.