Struct RunAgentInput 

pub struct RunAgentInput {
    pub thread_id: String,
    pub run_id: String,
    pub messages: Vec<Message>,
    pub tools: Vec<Tool>,
    pub context: Vec<Context>,
    pub state: Option<Value>,
    pub parent_run_id: Option<String>,
    pub parent_thread_id: Option<String>,
    pub model: Option<String>,
    pub system_prompt: Option<String>,
    pub config: Option<Value>,
    pub forwarded_props: Option<Value>,
}

Request to run an AG-UI agent.

Fields

thread_id: String

Thread identifier.

run_id: String

Run identifier.

messages: Vec<Message>

Conversation messages.

tools: Vec<Tool>

Available tools.

context: Vec<Context>

Frontend readable context entries.

state: Option<Value>

Initial state.

parent_run_id: Option<String>

Parent run ID (for sub-runs).

parent_thread_id: Option<String>

Parent thread ID (for delegated/sub-agent lineage).

model: Option<String>

Model to use.

system_prompt: Option<String>

System prompt.

config: Option<Value>

Additional configuration.

forwarded_props: Option<Value>

Additional forwarded properties from AG-UI client runtimes.

Implementations

impl RunAgentInput

pub fn new(thread_id: impl Into<String>, run_id: impl Into<String>) -> Self

Create a new request with minimal required fields.

pub fn with_message(self, message: Message) -> Self

Add a message.

pub fn with_messages(self, messages: Vec<Message>) -> Self

Add messages.

pub fn with_state(self, state: Value) -> Self

Set initial state.

pub fn with_parent_thread_id(self, parent_thread_id: impl Into<String>) -> Self

Set parent thread ID.

pub fn with_model(self, model: impl Into<String>) -> Self

Set model.

pub fn with_system_prompt(self, prompt: impl Into<String>) -> Self

Set system prompt.

pub fn with_forwarded_props(self, forwarded_props: Value) -> Self

Set forwarded props.

pub fn validate(&self) -> Result<(), RequestError>

Validate the request.

pub fn frontend_tools(&self) -> Vec<&Tool>

Get frontend tools from the request.

pub fn has_any_interaction_responses(&self) -> bool

Check if any interaction responses exist in this request.

pub fn has_any_suspension_decisions(&self) -> bool

Check if any suspension decisions exist in this request.

pub fn has_user_input(&self) -> bool

Check if this request contains non-empty user input.

pub fn into_runtime_run_request(self, agent_id: String) -> RunRequest

Convert this AG-UI request to the internal runtime request.

Mapping rules:

• thread_id, run_id, parent_run_id, state are forwarded directly.
• messages are converted via convert_agui_messages (assistant/activity/reasoning inbound messages are intentionally skipped at runtime input boundary).
• resource_id is not provided by AG-UI and remains None.

pub fn interaction_responses(&self) -> Vec<SuspensionResponse>

Extract all interaction responses from tool messages.

pub fn suspension_decisions(&self) -> Vec<ToolCallDecision>

Extract all suspension decisions from tool messages.

pub fn approved_target_ids(&self) -> Vec<String>

Get all approved interaction IDs.

pub fn denied_target_ids(&self) -> Vec<String>

Get all denied interaction IDs.

Trait Implementations

impl Clone for RunAgentInput

fn clone(&self) -> RunAgentInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunAgentInput

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunAgentInput

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RunAgentInput

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

where __S: Serializer,

Serialize this value into the given Serde serializer.