Skip to main content

qualia_core_db/net/qdnf/fabric/
referent.rs

1//! NaturalAgent is not inferred from a verified route, instrument, AI agent,
2//! machine device, organization, or role capacity (IDF-02).
3
4use crate::net::qdnf::errors::QdnfError;
5
6/// Network-facing referent. Distinct from identifier-fabric planes.
7#[repr(u8)]
8#[derive(Clone, Copy, Debug, PartialEq, Eq)]
9pub enum NetworkReferent {
10    NaturalAgent = 1,
11    VerifiedRoute = 2,
12    Instrument = 3,
13    AiAgent = 4,
14    MachineDevice = 5,
15    Organization = 6,
16    RoleCapacity = 7,
17}
18
19impl NetworkReferent {
20    pub const ALL: [Self; 7] = [
21        Self::NaturalAgent,
22        Self::VerifiedRoute,
23        Self::Instrument,
24        Self::AiAgent,
25        Self::MachineDevice,
26        Self::Organization,
27        Self::RoleCapacity,
28    ];
29}
30
31/// A verified route, instrument, AI agent, device, organization, or role capacity
32/// cannot be treated as a NaturalAgent.
33#[inline]
34pub fn as_natural_agent(referent: NetworkReferent) -> Result<(), QdnfError> {
35    match referent {
36        NetworkReferent::NaturalAgent => Ok(()),
37        NetworkReferent::VerifiedRoute
38        | NetworkReferent::Instrument
39        | NetworkReferent::AiAgent
40        | NetworkReferent::MachineDevice
41        | NetworkReferent::Organization
42        | NetworkReferent::RoleCapacity => Err(QdnfError::Unauthorized),
43    }
44}
45
46#[cfg(test)]
47mod tests {
48    use super::*;
49
50    #[test]
51    fn verified_route_is_not_a_natural_agent() {
52        assert_eq!(
53            as_natural_agent(NetworkReferent::VerifiedRoute),
54            Err(QdnfError::Unauthorized)
55        );
56    }
57
58    #[test]
59    fn instrument_is_not_a_natural_agent() {
60        assert_eq!(
61            as_natural_agent(NetworkReferent::Instrument),
62            Err(QdnfError::Unauthorized)
63        );
64    }
65
66    #[test]
67    fn ai_agent_device_org_and_role_are_not_natural_agents() {
68        for referent in [
69            NetworkReferent::AiAgent,
70            NetworkReferent::MachineDevice,
71            NetworkReferent::Organization,
72            NetworkReferent::RoleCapacity,
73        ] {
74            assert_eq!(as_natural_agent(referent), Err(QdnfError::Unauthorized));
75        }
76    }
77
78    #[test]
79    fn explicit_natural_agent_is_not_rewritten() {
80        assert!(as_natural_agent(NetworkReferent::NaturalAgent).is_ok());
81    }
82}