atomr-agents-tool 0.16.2

Tool trait, ToolSet, registry, permission spec, and tool-call parsers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! `HandoffTool` — built-in helper for multi-agent handoff patterns.
//!
//! Returns a `ToolReturn::Command(ToolControl::Handoff)` that downstream
//! routers (supervisor / swarm / network / hierarchical) interpret to
//! transfer control. Lives in `agents-tool::stdlib::handoff`.

use async_trait::async_trait;
use atomr_agents_core::{InvokeCtx, Result, ToolId, Value};

use crate::descriptor::{ToolDescriptor, ToolSchema};
use crate::tool_return::{RichTool, ToolControl, ToolReturn};

pub struct HandoffTool {
    pub default_target: String,
    descriptor: ToolDescriptor,
}

impl HandoffTool {
    pub fn new(default_target: impl Into<String>) -> Self {
        let target = default_target.into();
        Self {
            descriptor: ToolDescriptor {
                id: ToolId::from(format!("handoff_{target}")),
                name: format!("handoff_to_{target}"),
                description: format!("Hand off control to the {target} agent."),
                schema: ToolSchema(serde_json::json!({
                    "type": "object",
                    "properties": {
                        "target": {"type": "string"},
                        "payload": {},
                    }
                })),
            },
            default_target: target,
        }
    }
}

#[async_trait]
impl RichTool for HandoffTool {
    fn descriptor(&self) -> &ToolDescriptor {
        &self.descriptor
    }
    async fn invoke_rich(&self, args: Value, _ctx: &InvokeCtx) -> Result<ToolReturn> {
        let target = args
            .get("target")
            .and_then(|v| v.as_str())
            .map(|s| s.to_string())
            .unwrap_or_else(|| self.default_target.clone());
        let payload = args.get("payload").cloned().unwrap_or(Value::Null);
        Ok(ToolReturn::Command(ToolControl::Handoff { target, payload }))
    }
}