adk-rs 0.6.0

Rust port of the Google Agent Development Kit (ADK).
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

//! A [`Toolset`] is a lazy supplier of tools, used for dynamic sources like
//! MCP servers or OpenAPI specs that fetch tool lists at runtime.

use std::sync::Arc;

use async_trait::async_trait;

use crate::core::{DynTool, ReadonlyContext};
use crate::error::Result;

/// Anything that can yield tools at runtime.
#[async_trait]
pub trait Toolset: Send + Sync + std::fmt::Debug + 'static {
    /// Return the current set of tools.
    async fn list_tools(&self, ctx: &ReadonlyContext) -> Result<Vec<Arc<dyn DynTool>>>;

    /// Optional graceful shutdown for backends that hold OS resources.
    async fn shutdown(&self) -> Result<()> {
        Ok(())
    }
}

/// Trivial toolset over a fixed `Vec<Arc<dyn DynTool>>`.
#[derive(Debug, Default, Clone)]
pub struct StaticToolset {
    tools: Vec<Arc<dyn DynTool>>,
}

impl StaticToolset {
    /// Construct from a vec.
    pub fn new(tools: Vec<Arc<dyn DynTool>>) -> Self {
        Self { tools }
    }

    /// Push a tool.
    pub fn push(&mut self, t: Arc<dyn DynTool>) {
        self.tools.push(t);
    }
}

#[async_trait]
impl Toolset for StaticToolset {
    async fn list_tools(&self, _ctx: &ReadonlyContext) -> Result<Vec<Arc<dyn DynTool>>> {
        Ok(self.tools.clone())
    }
}