Enum AgentRef 

pub enum AgentRef {
    Named {
        agent_id: String,
        instructions_overlay: Option<String>,
    },
    AdHoc {
        system_prompt: String,
        tools: Option<ToolsConfig>,
    },
}

How to identify the agent for a target.

Variants

Named

Named agent looked up by agent_id in the agent store.

instructions_overlay, when Some, is appended to the named agent’s own instructions for this invocation only (via DefinitionOverrides::instructions_append). This is how a skill-fork is expressed: “the same agent that’s running, plus this skill body as task-specific direction.” The agent keeps its identity, tools and scaffolding; the overlay adds the brief. None = the agent runs exactly as defined.

Fields

agent_id: String

instructions_overlay: Option<String>

AdHoc

Ad-hoc agent built on the fly. The system_prompt is appended to _adhoc_base.md’s body; tools (if Some) replace the seeded ToolsConfig. Mirrors today’s call_agent({system_prompt, tools}).

Fields

system_prompt: String

tools: Option<ToolsConfig>

Implementations

impl AgentRef

pub fn named(agent_id: impl Into<String>) -> Self

A plain named-agent reference (no overlay).

pub fn named_with_overlay( agent_id: impl Into<String>, overlay: impl Into<String>, ) -> Self

A named-agent reference with an instruction overlay appended for this invocation (the skill-fork shape).

Trait Implementations

impl Clone for AgentRef

fn clone(&self) -> AgentRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentRef

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

where __S: Serializer,

Serialize this value into the given Serde serializer.