rullama-a2a 0.12.0

Agent-to-Agent (A2A) protocol — JSON-RPC, REST, and gRPC bindings
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

//! Push notification configuration types.

use serde::{Deserialize, Serialize};

/// Authentication details for push notifications.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AuthenticationInfo {
    /// HTTP authentication scheme (e.g. `Bearer`, `Basic`).
    pub scheme: String,
    /// Credentials (format depends on scheme).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub credentials: Option<String>,
}

/// Push notification configuration for a task.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TaskPushNotificationConfig {
    /// Optional tenant identifier.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tenant: Option<String>,
    /// Configuration identifier.
    #[serde(rename = "configId", skip_serializing_if = "Option::is_none")]
    pub config_id: Option<String>,
    /// Associated task identifier.
    #[serde(rename = "taskId")]
    pub task_id: String,
    /// URL where the notification should be sent.
    pub url: String,
    /// Session/task-specific token.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub token: Option<String>,
    /// Authentication information for sending the notification.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub authentication: Option<AuthenticationInfo>,
    /// ISO 8601 timestamp when this configuration was created.
    #[serde(rename = "createdAt", skip_serializing_if = "Option::is_none")]
    pub created_at: Option<String>,
}

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

    fn minimal_config() -> TaskPushNotificationConfig {
        TaskPushNotificationConfig {
            tenant: None,
            config_id: None,
            task_id: "task-1".to_string(),
            url: "https://example.com/notify".to_string(),
            token: None,
            authentication: None,
            created_at: None,
        }
    }

    #[test]
    fn minimal_config_roundtrip() {
        let cfg = minimal_config();
        let json = serde_json::to_string(&cfg).unwrap();
        let back: TaskPushNotificationConfig = serde_json::from_str(&json).unwrap();
        assert_eq!(back.task_id, cfg.task_id);
        assert_eq!(back.url, cfg.url);
    }

    #[test]
    fn optional_fields_omitted_when_none() {
        let cfg = minimal_config();
        let json = serde_json::to_string(&cfg).unwrap();
        assert!(!json.contains("tenant"));
        assert!(!json.contains("configId"));
        assert!(!json.contains("token"));
        assert!(!json.contains("authentication"));
        assert!(!json.contains("createdAt"));
    }

    #[test]
    fn json_uses_camel_case_task_id() {
        let cfg = minimal_config();
        let json = serde_json::to_string(&cfg).unwrap();
        assert!(json.contains("taskId"));
        assert!(!json.contains("task_id"));
    }

    #[test]
    fn with_authentication_roundtrip() {
        let mut cfg = minimal_config();
        cfg.authentication = Some(AuthenticationInfo {
            scheme: "Bearer".to_string(),
            credentials: Some("token-abc".to_string()),
        });
        let json = serde_json::to_string(&cfg).unwrap();
        let back: TaskPushNotificationConfig = serde_json::from_str(&json).unwrap();
        let auth = back.authentication.unwrap();
        assert_eq!(auth.scheme, "Bearer");
        assert_eq!(auth.credentials.as_deref(), Some("token-abc"));
    }

    #[test]
    fn authentication_info_credentials_omitted_when_none() {
        let auth = AuthenticationInfo {
            scheme: "Basic".to_string(),
            credentials: None,
        };
        let json = serde_json::to_string(&auth).unwrap();
        assert!(!json.contains("credentials"));
    }
}