deconvolute.errors

DeconvoluteError Objects

class DeconvoluteError(Exception)

Base exception class for all errors raised by the Deconvolute SDK. Catching this allows users to handle any library-specific error.

ConfigurationError Objects

class ConfigurationError(DeconvoluteError)

Raised when the SDK is misconfigured or a method is called with invalid arguments. Example: Invalid prompt template, missing API keys, etc.

SecurityResultError Objects

class SecurityResultError(DeconvoluteError)

Raised when a security threat is detected or a policy violation occurs.

This exception carries the SecurityResult payload, allowing the calling application to inspect exactly why the request was blocked (e.g. specific scanner, rule ID, or confidence score).

Attributes:

• result SecurityResult - The detailed security result.

MCPSessionError Objects

class MCPSessionError(DeconvoluteError)

Raised when an integrity violation or state error occurs within the MCP Firewall.

Examples:

• Attempting to register a tool without a name.
• Accessing a tool that was never registered (shadowing).

PolicyCompilationError Objects

class PolicyCompilationError(ConfigurationError)

Raised when a CEL policy condition contains syntax or logic errors.

PolicyValidationError Objects

class PolicyValidationError(ConfigurationError)

Custom exception for clear policy formatting errors.

TransportSpoofingError Objects

class TransportSpoofingError(MCPSessionError)

Raised when the physical origin of a connection does not match the transport requirements defined in the security policy.