agentstategraph-policy 1.3.1

Policy primitive (authorization + change-cost gating + fallback) for AgentStateGraph
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

//! Error type for `PolicyStore` operations.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum PolicyError {
    #[error("policy not found: {0}")]
    NotFound(String),

    #[error("policy already exists at path {0}")]
    AlreadyExists(String),

    #[error("policy is already ratified: {0}")]
    AlreadyRatified(String),

    #[error("policy is not a proposal (already ratified or superseded): {0}")]
    NotProposal(String),

    #[error("invalid policy path: {0}")]
    InvalidPath(String),

    #[error("invalid policy: {0}")]
    Invalid(String),

    #[error("repository error: {0}")]
    Repo(String),

    #[error("serialization error: {0}")]
    Serde(#[from] serde_json::Error),
}

impl PolicyError {
    /// A stable, low-cardinality code for this error, which telemetry
    /// records as `error.type`.
    pub fn code(&self) -> &'static str {
        match self {
            PolicyError::NotFound(_) => "policy_not_found",
            PolicyError::AlreadyExists(_) => "policy_already_exists",
            PolicyError::AlreadyRatified(_) => "policy_already_ratified",
            PolicyError::NotProposal(_) => "policy_not_proposal",
            PolicyError::InvalidPath(_) => "invalid_policy_path",
            PolicyError::Invalid(_) => "invalid_policy",
            PolicyError::Repo(_) => "repository_error",
            PolicyError::Serde(_) => "serialization_error",
        }
    }
}

impl From<agentstategraph::RepoError> for PolicyError {
    fn from(e: agentstategraph::RepoError) -> Self {
        PolicyError::Repo(e.to_string())
    }
}