agenterra 0.2.1

Generate production-ready MCP (Model Context Protocol) servers and clients from OpenAPI specs
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

//! Protocol behavior traits and interfaces

use async_trait::async_trait;
use serde_json::Value as JsonValue;

/// Input data for protocol processing
#[derive(Debug, Clone)]
pub struct ProtocolInput {
    pub openapi_spec: Option<crate::generation::OpenApiContext>,
    pub config: ProtocolConfig,
    pub role: crate::protocols::Role,
    pub language: crate::generation::Language,
}

/// Configuration for protocol behavior
#[derive(Debug, Clone)]
pub struct ProtocolConfig {
    pub project_name: String,
    pub version: Option<String>,
    pub options: std::collections::HashMap<String, JsonValue>,
}

/// Core protocol handler trait
#[async_trait]
pub trait ProtocolHandler: Send + Sync {
    /// Returns the protocol this handler implements
    fn protocol(&self) -> crate::protocols::Protocol;

    /// Prepares generation context from input
    async fn prepare_context(
        &self,
        input: ProtocolInput,
    ) -> Result<crate::generation::GenerationContext, crate::protocols::ProtocolError>;

    /// Validates protocol-specific configuration
    fn validate_configuration(
        &self,
        config: &ProtocolConfig,
    ) -> Result<(), crate::protocols::ProtocolError>;
}