meerkat-tools 0.5.2

Tool validation and dispatch for Meerkat
Documentation
//! CommsToolSet - groups all comms tools together

use super::tools::{CommsToolState, PeersTool, SendTool};
use meerkat_comms::{Router, TrustedPeers};
use parking_lot::RwLock;
use std::sync::Arc;

/// Collection of all comms tools: `send` and `peers`.
pub struct CommsToolSet {
    pub send: SendTool,
    pub peers: PeersTool,
}

impl CommsToolSet {
    /// Create a new comms tool set
    pub fn new(router: Arc<Router>, trusted_peers: Arc<RwLock<TrustedPeers>>) -> Self {
        let state = CommsToolState::new(router, trusted_peers);
        Self {
            send: SendTool::new(state.clone()),
            peers: PeersTool::new(state),
        }
    }

    /// Get tool names for collision detection
    pub fn tool_names(&self) -> Vec<&str> {
        vec!["send", "peers"]
    }

    /// Usage instructions for comms tools
    pub fn usage_instructions() -> &'static str {
        r"## Inter-Agent Communication Tools

You have access to comms tools for communicating with other agents:

- `send`: Send a message, request, or response to a peer. Use `kind` to select the type.
- `peers`: List all visible peers.

When communicating with other agents, identify them by their peer name (not pubkey)."
    }
}

#[cfg(test)]
#[allow(clippy::unwrap_used, clippy::expect_used)]
mod tests {
    use super::*;
    use meerkat_comms::{CommsConfig, Keypair, TrustedPeer, TrustedPeers};

    #[test]
    fn test_comms_tool_set_creation() {
        let keypair = Keypair::generate();
        let peer_keypair = Keypair::generate();
        let trusted_peers = TrustedPeers {
            peers: vec![TrustedPeer {
                name: "test-peer".to_string(),
                pubkey: peer_keypair.public_key(),
                addr: "tcp://127.0.0.1:4200".to_string(),
                meta: meerkat_comms::PeerMeta::default(),
            }],
        };
        let trusted_peers = Arc::new(RwLock::new(trusted_peers));
        let (_, inbox_sender) = meerkat_comms::Inbox::new();
        let router = Arc::new(Router::with_shared_peers(
            keypair,
            trusted_peers.clone(),
            CommsConfig::default(),
            inbox_sender,
            true,
        ));

        let tool_set = CommsToolSet::new(router, trusted_peers);
        assert_eq!(tool_set.tool_names().len(), 2);
    }
}