Struct Controls 

pub struct Controls {
    pub model_id: Option<ModelId>,
    pub locale: Option<String>,
    pub reasoning: Option<ReasoningConfig>,
    pub speed: Option<String>,
    pub verbosity: Option<String>,
    pub error_disclosure: Option<String>,
    pub hints: Option<HashMap<String, Value>>,
}

Runtime controls for message processing

Fields

model_id: Option<ModelId>

Model ID to use for this message (format: model_{32-hex}). Overrides session and agent model settings.

locale: Option<String>

Locale override for this message turn (BCP 47, e.g. uk-UA). Overrides the session locale for backend-authored strings and prompts.

reasoning: Option<ReasoningConfig>

Reasoning configuration

speed: Option<String>

Speed (service tier) for this message turn: “flex”, “default”, or “priority”. Only sent to providers whose model profile advertises a speed config (OpenAI service_tier).

verbosity: Option<String>

Verbosity for this message turn: “low”, “medium”, or “high”. Only sent to providers whose model profile advertises a verbosity config (OpenAI verbosity).

error_disclosure: Option<String>

Error disclosure override for this turn: “generic”, “standard”, or “detailed”. Clamped to at most the mode allowed by the agent’s error_disclosure capability (capability absent => “standard”), so a client can narrow but never widen disclosure.

hints: Option<HashMap<String, Value>>

Generic client hints — arbitrary key-value pairs declared by the client. Session-level defaults are set at session creation; per-message values override session hints key-by-key (shallow merge).

Examples: {"setup_connection": true, "rich_media": true}

Implementations

impl Controls

pub fn resolve_hints( session_hints: Option<&HashMap<String, Value>>, message_hints: Option<&HashMap<String, Value>>, ) -> HashMap<String, Value>

Resolve effective hints by shallow-merging session-level defaults with per-message overrides. Per-message hints take precedence key-by-key.

Trait Implementations

impl Clone for Controls

fn clone(&self) -> Controls

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Controls

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

Formats the value using the given formatter.

impl Default for Controls

fn default() -> Controls

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Controls

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Controls

fn eq(&self, other: &Controls) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Controls

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 Controls