protocol-droid 0.3.0

A Model Context Protocol toolkit that speaks every published spec revision, with one canonical IR behind many per-revision codecs.
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

//! Errors the [`AgentCardBuilder`](super::AgentCardBuilder) can raise.
//!
//! A single enum in its own file so a `match` is greppable and a
//! new variant does not touch the value-object file.

use std::sync::Arc;

use thiserror::Error;

/// Errors a builder can raise.
#[derive(Debug, Error, PartialEq, Eq)]
pub enum AgentCardError {
    /// `name` was empty.
    #[error("AgentCard.name must be non-empty")]
    EmptyName,
    /// `description` was empty.
    #[error("AgentCard.description must be non-empty")]
    EmptyDescription,
    /// `version` was empty.
    #[error("AgentCard.version must be non-empty")]
    EmptyVersion,
    /// `supported_interfaces` was empty.
    #[error("AgentCard.supported_interfaces must contain at least one interface")]
    NoSupportedInterfaces,
    /// `default_input_modes` was empty.
    #[error("AgentCard.default_input_modes must contain at least one mode")]
    NoInputModes,
    /// `default_output_modes` was empty.
    #[error("AgentCard.default_output_modes must contain at least one mode")]
    NoOutputModes,
    /// A skill was given an empty id, name, or description.
    #[error("AgentCard.skills[{index}].{field} must be non-empty")]
    EmptySkillField {
        /// The skill's position in `skills`.
        index: usize,
        /// The empty field, one of `id`, `name`, `description`.
        field: &'static str,
    },
    /// The provider's organization was empty.
    #[error("AgentCard.provider.organization must be non-empty")]
    EmptyProviderOrganization,
    /// A protocol extension was given an empty uri or description.
    #[error("AgentCard.capabilities.extensions[{index}].{field} must be non-empty")]
    EmptyExtensionField {
        /// The extension's position in `capabilities.extensions`.
        index: usize,
        /// The empty field, one of `uri`, `description`.
        field: &'static str,
    },
    /// A security scheme was registered with an empty name.
    #[error("AgentCard.security_schemes key must be non-empty")]
    EmptySecuritySchemeName,
    /// An API key security scheme has an empty `name` (the
    /// parameter name, not the scheme key).
    #[error("AgentCard.security_schemes[{name}].name must be non-empty")]
    EmptyAPIKeyParameterName {
        /// The scheme key in the `security_schemes` map.
        name: Arc<str>,
    },
    /// An HTTP security scheme has an empty `scheme` (the
    /// IANA-registered auth scheme, e.g. `Bearer`).
    #[error("AgentCard.security_schemes[{name}].scheme must be non-empty")]
    EmptyHTTPAuthScheme {
        /// The scheme key in the `security_schemes` map.
        name: Arc<str>,
    },
    /// An OAuth 2.0 security scheme has no flow set. The
    /// proto's `oneof flow` and the `OpenAPI 3.x` wire
    /// form both require at least one of
    /// `authorizationCode`, `clientCredentials`, or
    /// `deviceCode` to be present.
    #[error("AgentCard.security_schemes[{name}].flows must declare at least one flow")]
    EmptyOAuthFlows {
        /// The scheme key in the `security_schemes` map.
        name: Arc<str>,
    },
}