agent-protocols 0.11.0

Rust SDK for Agent Identity, Profile, Delegation, Discourse, Knowledge, and Mail protocols
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

use crate::identity::{AgentId, Envelope};
use serde::{Deserialize, Serialize};
use serde_json::Value;

pub type MailboxCard = Envelope<MailboxCardPayload>;
pub type Letter = Envelope<Value>;
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct MailboxCardPayload {
    pub mailbox_id: String,
    pub expires_at: i64,
    pub receive_until: i64,
    pub public_key: String,
    /// Zero to eight relay origins; an empty list closes the mailbox.
    pub routes: Vec<String>,
    pub max_packet_bytes: usize,
}
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct MessagePayload {
    pub to: AgentId,
    pub expires_at: i64,
    pub thread_id: String,
    pub parts: Vec<MailPart>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub subject: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub in_reply_to: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub reply_card: Option<Value>,
}
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct MailPart {
    pub media_type: String,
    pub data: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
}
impl MailPart {
    pub fn text(text: &str) -> Self {
        Self {
            media_type: "text/plain".into(),
            data: super::encode_bytes(text.as_bytes()),
            name: None,
        }
    }
    pub fn bytes(media_type: impl Into<String>, bytes: &[u8], name: Option<String>) -> Self {
        Self {
            media_type: media_type.into(),
            data: super::encode_bytes(bytes),
            name,
        }
    }
}
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct PacketHeader {
    pub protocol: String,
    pub mailbox_id: String,
    pub card_hash: String,
    pub expires_at: i64,
}
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct Packet {
    pub header: PacketHeader,
    pub enc: String,
    pub ciphertext: String,
}
/// Anonymous delivery result. It never carries the mailbox `seq`.
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct DeliveryResult {
    pub packet_id: String,
    pub accepted_at: i64,
}
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[serde(deny_unknown_fields)]
pub struct PacketRecord {
    pub packet_id: String,
    pub packet: Packet,
    pub accepted_at: i64,
    pub seq: u64,
}
/// A parsed mailbox address (Mail Section 3.3). `routes` is empty for the stable form.
#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
#[serde(deny_unknown_fields)]
pub struct MailAddress {
    pub owner: AgentId,
    pub mailbox_id: String,
    pub routes: Vec<String>,
}
#[derive(Clone, Debug, PartialEq)]
pub enum InboxAcceptance {
    Accepted(Box<Letter>),
    Duplicate(Box<Letter>),
}