agent-relay 0.3.1

Agent-to-agent messaging for AI coding tools. Local or networked — run a relay server and let Claude talk to Gemini across the internet.
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

//! HTTP client for connecting to a remote relay server.

use crate::{AgentRegistration, Message};

pub struct RemoteRelay {
    base_url: String,
}

impl RemoteRelay {
    pub fn new(server_url: &str) -> Self {
        let base_url = server_url.trim_end_matches('/').to_string();
        Self { base_url }
    }

    pub fn health(&self) -> Result<String, String> {
        let resp = ureq::get(&format!("{}/health", self.base_url))
            .call()
            .map_err(|e| format!("Connection failed: {}", e))?;
        resp.into_string().map_err(|e| format!("Read error: {}", e))
    }

    pub fn register(
        &self,
        agent_id: &str,
        session_id: &str,
        pid: u32,
    ) -> Result<AgentRegistration, String> {
        let resp = ureq::post(&format!("{}/agents/register", self.base_url))
            .send_json(serde_json::json!({
                "session_id": session_id,
                "agent_id": agent_id,
                "pid": pid,
            }))
            .map_err(|e| format!("Request failed: {}", e))?;

        let body: AgentRegistration = resp
            .into_json()
            .map_err(|e| format!("Parse error: {}", e))?;
        Ok(body)
    }

    pub fn unregister(&self, session_id: &str) -> Result<(), String> {
        ureq::post(&format!("{}/agents/unregister", self.base_url))
            .send_json(serde_json::json!({"session_id": session_id}))
            .map_err(|e| format!("Request failed: {}", e))?;
        Ok(())
    }

    pub fn agents(&self) -> Result<Vec<AgentRegistration>, String> {
        let resp = ureq::get(&format!("{}/agents", self.base_url))
            .call()
            .map_err(|e| format!("Request failed: {}", e))?;

        let body: Vec<AgentRegistration> = resp
            .into_json()
            .map_err(|e| format!("Parse error: {}", e))?;
        Ok(body)
    }

    pub fn send(
        &self,
        from_session: &str,
        from_agent: &str,
        to_session: Option<&str>,
        content: &str,
    ) -> Result<Message, String> {
        let resp = ureq::post(&format!("{}/messages/send", self.base_url))
            .send_json(serde_json::json!({
                "from_session": from_session,
                "from_agent": from_agent,
                "to_session": to_session,
                "content": content,
            }))
            .map_err(|e| format!("Request failed: {}", e))?;

        let body: Message = resp
            .into_json()
            .map_err(|e| format!("Parse error: {}", e))?;
        Ok(body)
    }

    pub fn inbox(&self, session_id: &str, limit: usize) -> Result<Vec<Message>, String> {
        let resp = ureq::get(&format!(
            "{}/messages/inbox?session={}&limit={}",
            self.base_url, session_id, limit
        ))
        .call()
        .map_err(|e| format!("Request failed: {}", e))?;

        let body: Vec<Message> = resp
            .into_json()
            .map_err(|e| format!("Parse error: {}", e))?;
        Ok(body)
    }

    pub fn unread_count(&self, session_id: &str) -> Result<u64, String> {
        let resp = ureq::get(&format!(
            "{}/messages/unread?session={}",
            self.base_url, session_id
        ))
        .call()
        .map_err(|e| format!("Request failed: {}", e))?;

        let body: serde_json::Value = resp
            .into_json()
            .map_err(|e| format!("Parse error: {}", e))?;
        Ok(body["count"].as_u64().unwrap_or(0))
    }
}