Struct AgentSpecPatch 

pub struct AgentSpecPatch {

    pub model_id: Option<String>,
    pub system_prompt: Option<String>,
    pub max_rounds: Option<usize>,
    pub max_continuation_retries: Option<usize>,
    pub context_policy: Option<Option<ContextWindowPolicy>>,
    pub plugin_ids: Option<Vec<String>>,
    pub active_hook_filter: Option<HashSet<String>>,
    pub sections: Option<HashMap<String, Value>>,
    pub allowed_tools: Option<Option<Vec<String>>>,
    pub excluded_tools: Option<Option<Vec<String>>>,
    pub delegates: Option<Vec<String>>,
    pub reasoning_effort: Option<Option<ReasoningEffort>>,
    pub endpoint: Option<Option<RemoteEndpoint>>,
}

Patch for built-in agent customization.

Override support covers runtime-safe AgentSpec fields. Adding more fields later is purely additive because missing fields decode as “inherit”.

#[serde(deny_unknown_fields)] rejects payloads containing field names that don’t exist on this struct, preventing silent drift when callers misspell or target deprecated fields.

Fields

model_id: Option<String>

system_prompt: Option<String>

max_rounds: Option<usize>

max_continuation_retries: Option<usize>

context_policy: Option<Option<ContextWindowPolicy>>

plugin_ids: Option<Vec<String>>

active_hook_filter: Option<HashSet<String>>

sections: Option<HashMap<String, Value>>

Per-key shallow merge: patch keys override base keys; un-patched keys preserved from base. To delete a base key, set its value to JSON null in this map (handled at merge time).

allowed_tools: Option<Option<Vec<String>>>

Whitelist of tool IDs. Some([..]) overrides; None keeps base. JSON null clears to “all tools”; missing inherits base.

excluded_tools: Option<Option<Vec<String>>>

Blacklist of tool IDs. Same semantics as allowed_tools.

delegates: Option<Vec<String>>

Sub-agent IDs this agent can delegate to. Some([..]) overrides.

reasoning_effort: Option<Option<ReasoningEffort>>

Reasoning effort override. JSON null clears the base value.

endpoint: Option<Option<RemoteEndpoint>>

Remote endpoint override. JSON null clears the base value.

Implementations

impl AgentSpecPatch

pub fn is_empty(&self) -> bool

True when no field is set — equivalent to “no override”.

Trait Implementations

impl Clone for AgentSpecPatch

fn clone(&self) -> AgentSpecPatch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentSpecPatch

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

Formats the value using the given formatter.

impl Default for AgentSpecPatch

fn default() -> AgentSpecPatch

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentSpecPatch

where AgentSpecPatch: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for AgentSpecPatch

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 PartialEq for AgentSpecPatch

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

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 AgentSpecPatch