Struct TransferToAgentTool 

pub struct TransferToAgentTool { /* private fields */ }

Tool that signals the agent loop to transfer conversation to another agent.

When called, validates the target exists in the AgentRegistry (and optionally that it appears in the allowed-targets set), then returns an AgentToolResult carrying a TransferSignal. The agent loop detects the signal and terminates the turn with StopReason::Transfer.

Implementations

impl TransferToAgentTool

pub fn new(registry: Arc<AgentRegistry>) -> Self

Create a new transfer tool that can transfer to any registered agent.

pub fn with_allowed_targets( registry: Arc<AgentRegistry>, targets: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Create a transfer tool restricted to the given set of allowed target agents.

Trait Implementations

impl AgentTool for TransferToAgentTool

fn name(&self) -> &str

Unique routing key used to dispatch tool calls.

fn label(&self) -> &str

Human-readable display name for logging and UI.

fn description(&self) -> &str

Natural-language description included in the LLM prompt.

fn parameters_schema(&self) -> &Value

JSON Schema describing the tool’s input shape, used for validation.

fn execute( &self, _tool_call_id: &str, params: Value, cancellation_token: CancellationToken, _on_update: Option<Box<dyn Fn(AgentToolResult) + Send + Sync>>, _state: Arc<RwLock<SessionState>>, _credential: Option<ResolvedCredential>, ) -> ToolFuture<'_>

Execute the tool with validated parameters.

fn requires_approval(&self) -> bool

Whether this tool requires user approval before execution. Default is false — tools execute immediately.

fn metadata(&self) -> Option<ToolMetadata>

Optional organizational metadata (namespace, version).

fn approval_context(&self, _params: &Value) -> Option<Value>

Optional rich context for the approval UI.

fn auth_config(&self) -> Option<AuthConfig>

Optional authentication configuration for this tool.