pub type Result<T> = std::result::Result<T, OpenAgentError>;

use openagent_sdk::errors::{OpenAgentError, Result};

fn example() -> Result<()> {
    // Errors from any wrapped SDK convert via `?`.
    Ok(())
}

#[derive(Debug, Error)]
pub enum OpenAgentError {
    /// An error from the OAS identity layer.
    #[error("identity error: {0}")]
    Identity(#[from] oas_sdk::error::OasError),

    /// An error from the Arsenal capability/credential layer.
    #[cfg(feature = "arsenal")]
    #[error("credential error: {code:?}: {message}")]
    Credential {
        /// Numeric Arsenal error code.
        code: arsenal_core::error::ErrorCode,
        /// Human-readable description of what went wrong.
        message: String,
    },

    /// An error from the AEGIS verification layer.
    #[error("verification error: {0}")]
    Verification(String),

    /// An error from the AEGIS authentication layer.
    #[error("authentication error: {0}")]
    Authentication(String),

    /// An error from the AEGIS policy / authorization layer.
    #[error("authorization error: {0}")]
    Authorization(String),

    /// An error from the AEGIS delegation layer.
    #[error("delegation error: {0}")]
    Delegation(String),

    /// A skill policy violation reported by the [`crate::skills`] layer.
    #[error("skill denied: {skill}: {reason}")]
    SkillDenied {
        /// Name of the skill that was denied.
        skill: String,
        /// Reason the skill is denied.
        reason: String,
    },

    /// A configuration error in the SDK itself (missing parent, invalid scope, etc.).
    #[error("configuration error: {0}")]
    Config(String),

    /// An error in the underlying HTTP transport when proxying credentials.
    #[error("transport error: {0}")]
    Transport(String),

    /// A JSON serialization error from any of the layers.
    #[error("serialization error: {0}")]
    Json(#[from] serde_json::Error),
}

pub fn config(msg: impl Into<String>) -> Self;

pub fn transport(msg: impl Into<String>) -> Self;