praval.core.exceptions

Custom exceptions for the Praval framework.

These exceptions provide clear error handling and debugging information for common issues in LLM agent operations.

Exceptions

ConfigurationError

Raised when there are configuration validation issues.

EmbeddingConfigurationError

Raised when persistent vectors do not match embedding configuration.

HITLConfigurationError

Raised when HITL policy requires approval for a HITL-disabled agent.

InterventionRequired(intervention_id, ...[, ...])

Raised when a tool call is paused waiting for human intervention.

PravalError

Base exception for all Praval-related errors.

ProviderError

Raised when there are issues with LLM provider operations.

StateError

Raised when there are issues with state persistence operations.

ToolError

Raised when there are issues with tool registration or execution.
exception praval.core.exceptions.PravalError[source]

Bases: Exception

Base exception for all Praval-related errors.

exception praval.core.exceptions.ProviderError[source]

Bases: PravalError

Raised when there are issues with LLM provider operations.

exception praval.core.exceptions.ConfigurationError[source]

Bases: PravalError

Raised when there are configuration validation issues.

exception praval.core.exceptions.EmbeddingConfigurationError[source]

Bases: ConfigurationError

Raised when persistent vectors do not match embedding configuration.

exception praval.core.exceptions.ToolError[source]

Bases: PravalError

Raised when there are issues with tool registration or execution.

exception praval.core.exceptions.StateError[source]

Bases: PravalError

Raised when there are issues with state persistence operations.

exception praval.core.exceptions.InterventionRequired(intervention_id, run_id, agent_name, tool_name, reason='')[source]

Bases: PravalError

Raised when a tool call is paused waiting for human intervention.

Parameters:

  • intervention_id (str)

  • run_id (str)

  • agent_name (str)

  • tool_name (str)

  • reason (str)

__init__(intervention_id, run_id, agent_name, tool_name, reason='')[source]
Parameters:

  • intervention_id (str)

  • run_id (str)

  • agent_name (str)

  • tool_name (str)

  • reason (str)

exception praval.core.exceptions.HITLConfigurationError[source]

Bases: PravalError

Raised when HITL policy requires approval for a HITL-disabled agent.