opencrabs 0.3.19

The autonomous, self-improving AI agent. Single Rust binary. Every channel. Install with: cargo install opencrabs
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

//! Agent Card generation for `.well-known/agent.json`.
//!
//! Builds an `AgentCard` from the running OpenCrabs configuration,
//! exposing available skills and capabilities to other A2A agents.

use crate::a2a::types::*;
use crate::brain::tools::registry::ToolRegistry;

/// Build the Agent Card for this OpenCrabs instance.
///
/// Skills are generated dynamically based on available tools in the registry.
pub fn build_agent_card(host: &str, port: u16, tool_registry: Option<&ToolRegistry>) -> AgentCard {
    let base_url = format!("http://{}:{}", host, port);

    let mut skills = vec![AgentSkill {
        id: "code-analysis".to_string(),
        name: "Code Analysis & Refactoring".to_string(),
        description: Some(
            "Analyze source code, identify issues, and suggest improvements.".to_string(),
        ),
        tags: vec![
            "code".to_string(),
            "analysis".to_string(),
            "refactoring".to_string(),
        ],
        examples: vec!["Analyze this Rust module for performance issues.".to_string()],
        input_modes: vec!["text/plain".to_string(), "application/json".to_string()],
        output_modes: vec!["text/plain".to_string(), "application/json".to_string()],
    }];

    // Research skill requires search tools
    let has_search = tool_registry
        .map(|r| r.has_tool("web_search") || r.has_tool("memory_search"))
        .unwrap_or(true);
    if has_search {
        skills.push(AgentSkill {
            id: "research".to_string(),
            name: "Deep Research".to_string(),
            description: Some(
                "Perform multi-source research using web search, memory search, and document analysis. Runs in read-only mode."
                    .to_string(),
            ),
            tags: vec![
                "research".to_string(),
                "analysis".to_string(),
                "synthesis".to_string(),
            ],
            examples: vec![
                "Research the latest developments in AI agent security.".to_string(),
            ],
            input_modes: vec!["text/plain".to_string()],
            output_modes: vec!["text/plain".to_string(), "application/json".to_string()],
        });
    }

    skills.push(AgentSkill {
        id: "debate".to_string(),
        name: "Multi-Agent Debate".to_string(),
        description: Some(
            "Participate in structured multi-round debates with other A2A agents using knowledge-enriched context."
                .to_string(),
        ),
        tags: vec![
            "debate".to_string(),
            "council".to_string(),
            "multi-agent".to_string(),
        ],
        examples: vec![
            "Debate the pros and cons of microservices vs monoliths.".to_string(),
        ],
        input_modes: vec!["text/plain".to_string(), "application/json".to_string()],
        output_modes: vec!["text/plain".to_string(), "application/json".to_string()],
    });

    AgentCard {
        name: format!("OpenCrabs Bee (v{})", crate::VERSION),
        description: Some(
            "High-performance AI orchestration agent with A2A protocol support. \
             Part of the Bee Colony multi-agent system."
                .to_string(),
        ),
        version: Some(crate::VERSION.to_string()),
        documentation_url: Some("https://github.com/adolfousier/opencrabs".to_string()),
        icon_url: None,
        supported_interfaces: vec![SupportedInterface {
            url: format!("{}/a2a/v1", base_url),
            protocol_binding: "JSONRPC".to_string(),
            protocol_version: Some("1.0".to_string()),
        }],
        provider: Some(AgentProvider {
            organization: "OpenCrabs Contributors".to_string(),
            url: Some("https://github.com/adolfousier/opencrabs".to_string()),
        }),
        capabilities: Some(AgentCapabilities {
            streaming: true,
            push_notifications: false,
            state_transition_history: true,
        }),
        skills,
        default_input_modes: vec!["text/plain".to_string(), "application/json".to_string()],
        default_output_modes: vec!["text/plain".to_string(), "application/json".to_string()],
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_build_agent_card_default() {
        let card = build_agent_card("127.0.0.1", 18790, None);
        assert!(card.name.contains("OpenCrabs"));
        assert_eq!(card.skills.len(), 3);
        assert_eq!(
            card.supported_interfaces[0].url,
            "http://127.0.0.1:18790/a2a/v1"
        );
    }

    #[test]
    fn test_build_agent_card_with_registry() {
        let registry = ToolRegistry::new();
        let card = build_agent_card("127.0.0.1", 18790, Some(&registry));
        // No search tools registered, so no research skill
        assert_eq!(card.skills.len(), 2);
        assert_eq!(card.skills[0].id, "code-analysis");
        assert_eq!(card.skills[1].id, "debate");
    }
}