a2a-mcp 0.3.0

Bidirectional integration between A2A Protocol and Model Context Protocol (MCP)
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

//! Adapter that exposes RMCP tools as A2A agents

use crate::error::{Error, Result};
use crate::message::MessageConverter;
use a2a_rs::domain::{agent::{AgentCard, Capabilities, Authentication, Skill}, task::{Task, TaskState, TaskStatus}, message::{Message, MessagePart}};
use rmcp::{Tool, ToolCall, ToolResponse};
use std::sync::Arc;
use uuid::Uuid;

/// Adapts RMCP tools to A2A agent capabilities
pub struct ToolToAgentAdapter {
    tools: Vec<Tool>,
    agent_name: String,
    agent_description: String,
    converter: Arc<MessageConverter>,
}

impl ToolToAgentAdapter {
    /// Create a new adapter with the given tools
    pub fn new(tools: Vec<Tool>, agent_name: String, agent_description: String) -> Self {
        Self {
            tools,
            agent_name,
            agent_description,
            converter: Arc::new(MessageConverter::new()),
        }
    }
    
    /// Generate A2A agent card from RMCP tools
    pub fn generate_agent_card(&self) -> AgentCard {
        // Create skills from tools
        let skills = self.tools.iter().map(|tool| {
            Skill {
                name: tool.name.clone(),
                description: tool.description.clone(),
                inputs: None,
                outputs: None,
                input_modes: Some(vec!["text".to_string(), "data".to_string()]),
                output_modes: Some(vec!["text".to_string(), "data".to_string()]),
                metadata: None,
            }
        }).collect();
        
        AgentCard {
            name: self.agent_name.clone(),
            description: self.agent_description.clone(),
            url: "https://example.com/agent".to_string(), // Would be configured
            version: "1.0.0".to_string(),
            capabilities: Capabilities {
                streaming: true,
                push_notifications: false,
                state_transition_history: true,
            },
            authentication: Authentication {
                schemes: vec!["Bearer".to_string()],
                // Other auth fields
            },
            default_input_modes: vec!["text".to_string()],
            default_output_modes: vec!["text".to_string()],
            skills,
            metadata: None,
        }
    }
    
    /// Map RMCP tool call to A2A task
    pub fn tool_call_to_task(&self, call: &ToolCall) -> Result<Task> {
        // Create an A2A task from an RMCP tool call
        let task_id = Uuid::new_v4().to_string();
        
        let initial_message = Message {
            role: "user".to_string(),
            parts: vec![
                MessagePart::Text { 
                    text: format!("Call tool: {}", call.method) 
                },
                MessagePart::Data { 
                    data: call.params.clone(),
                    mime_type: Some("application/json".to_string()),
                },
            ],
        };
        
        Ok(Task {
            id: task_id,
            status: TaskStatus {
                state: TaskState::Submitted,
                message: Some("Task submitted".to_string()),
            },
            messages: vec![initial_message],
            artifacts: Vec::new(),
            history_ttl: Some(3600), // 1 hour default
            metadata: None,
        })
    }
    
    /// Map A2A task result to RMCP tool response
    pub fn task_to_tool_response(&self, task: &Task) -> Result<ToolResponse> {
        // Extract the last agent message from the task
        let last_message = self.converter.extract_agent_message(task)?;
        
        // Convert to tool response
        self.converter.message_to_tool_response(last_message)
    }

    /// Find a tool by name
    pub fn find_tool(&self, name: &str) -> Option<&Tool> {
        self.tools.iter().find(|tool| tool.name == name)
    }

    /// Extract tool name and parameters from an A2A message
    pub fn extract_tool_call(&self, message: &Message) -> Result<(String, serde_json::Value)> {
        // Try to find a text part with "Call tool: " prefix
        let tool_name = message.parts.iter()
            .find_map(|part| {
                if let MessagePart::Text { text } = part {
                    if text.starts_with("Call tool: ") {
                        Some(text.trim_start_matches("Call tool: ").to_string())
                    } else {
                        None
                    }
                } else {
                    None
                }
            })
            .ok_or_else(|| Error::Translation("Unable to extract tool name from message".into()))?;
        
        // Try to find a data part
        let params = message.parts.iter()
            .find_map(|part| {
                if let MessagePart::Data { data, .. } = part {
                    Some(data.clone())
                } else {
                    None
                }
            })
            .unwrap_or(serde_json::Value::Null);
        
        Ok((tool_name, params))
    }
}