systemprompt-cloud 0.2.1

Cloud API client, credentials, OAuth, and tenant management for systemprompt.io AI governance deployments. Remote sync and multi-tenant orchestration for the MCP governance pipeline.
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
108
109
110
111
112
113
114
115
116
117
118
119
120

use thiserror::Error;

#[derive(Debug, Error)]
pub enum CloudError {
    #[error("Authentication required.\n\nRun: systemprompt cloud login")]
    NotAuthenticated,

    #[error("Token expired.\n\nRun: systemprompt cloud login")]
    TokenExpired,

    #[error("No tenant configured.\n\nRun: systemprompt cloud setup")]
    TenantNotConfigured,

    #[error("No app configured.\n\nRun: systemprompt cloud setup")]
    AppNotConfigured,

    #[error(
        "Profile required: {message}\n\nSet SYSTEMPROMPT_PROFILE or run 'systemprompt cloud \
         config'"
    )]
    ProfileRequired { message: String },

    #[error("Missing profile field: {field}\n\nAdd to your profile:\n{example}")]
    MissingProfileField { field: String, example: String },

    #[error("JWT decode error")]
    JwtDecode,

    #[error("Credentials file corrupted.\n\nRun: systemprompt cloud login")]
    CredentialsCorrupted {
        #[source]
        source: serde_json::Error,
    },

    #[error("Tenants not synced.\n\nRun: systemprompt cloud login")]
    TenantsNotSynced,

    #[error("Tenants store corrupted.\n\nRun: systemprompt cloud login")]
    TenantsStoreCorrupted {
        #[source]
        source: serde_json::Error,
    },

    #[error("Tenants store invalid: {message}")]
    TenantsStoreInvalid { message: String },

    #[error("Tenant '{tenant_id}' not found.\n\nRun: systemprompt cloud config")]
    TenantNotFound { tenant_id: String },

    #[error("API error: {message}")]
    ApiError { message: String },

    #[error(transparent)]
    Network(#[from] reqwest::Error),

    #[error(transparent)]
    Io(#[from] std::io::Error),
}

pub type CloudResult<T> = Result<T, CloudError>;

impl CloudError {
    pub const fn user_message(&self) -> &'static str {
        match self {
            Self::NotAuthenticated => "Not logged in to systemprompt.io Cloud",
            Self::TokenExpired => "Your session has expired",
            Self::TenantNotConfigured => "No project linked to this environment",
            Self::AppNotConfigured => "No deployment target configured",
            Self::ProfileRequired { .. } => "Profile configuration required",
            Self::MissingProfileField { .. } => "Missing required profile field",
            Self::JwtDecode => "Failed to decode authentication token",
            Self::CredentialsCorrupted { .. } => "Credentials file is corrupted",
            Self::TenantsNotSynced => "Tenants not synced locally",
            Self::TenantsStoreCorrupted { .. } => "Tenants store is corrupted",
            Self::TenantsStoreInvalid { .. } => "Tenants store is invalid",
            Self::TenantNotFound { .. } => "Tenant not found",
            Self::ApiError { .. } => "API request failed",
            Self::Network(_) => "Network error communicating with cloud",
            Self::Io(_) => "File system error",
        }
    }

    pub const fn recovery_hint(&self) -> &'static str {
        match self {
            Self::NotAuthenticated | Self::TokenExpired => {
                "Run 'systemprompt cloud login' to authenticate"
            },
            Self::TenantNotConfigured | Self::AppNotConfigured => {
                "Run 'systemprompt cloud setup' to configure your project"
            },
            Self::ProfileRequired { .. } => {
                "Set SYSTEMPROMPT_PROFILE or run 'systemprompt cloud config'"
            },
            Self::MissingProfileField { .. } => "Add the missing field to your profile YAML",
            Self::JwtDecode | Self::CredentialsCorrupted { .. } => {
                "Run 'systemprompt cloud login' to re-authenticate"
            },
            Self::TenantsNotSynced
            | Self::TenantsStoreCorrupted { .. }
            | Self::TenantsStoreInvalid { .. } => "Run 'systemprompt cloud login' to sync tenants",
            Self::TenantNotFound { .. } => {
                "Run 'systemprompt cloud config' to select a valid tenant"
            },
            Self::ApiError { .. } => "Check the error message and try again",
            Self::Network(_) => "Check your internet connection and try again",
            Self::Io(_) => "Check file permissions and disk space",
        }
    }

    pub const fn requires_login(&self) -> bool {
        matches!(
            self,
            Self::NotAuthenticated | Self::TokenExpired | Self::CredentialsCorrupted { .. }
        )
    }

    pub const fn requires_setup(&self) -> bool {
        matches!(self, Self::TenantNotConfigured | Self::AppNotConfigured)
    }
}