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.
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

Bases: Exception

Base exception for all Praval-related errors.

exception praval.core.exceptions.ProviderError

Bases: PravalError

Raised when there are issues with LLM provider operations.

exception praval.core.exceptions.ConfigurationError

Bases: PravalError

Raised when there are configuration validation issues.

exception praval.core.exceptions.ToolError

Bases: PravalError

Raised when there are issues with tool registration or execution.

exception praval.core.exceptions.StateError

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='')

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='')

Parameters:

• intervention_id (str)

• run_id (str)

• agent_name (str)

• tool_name (str)

• reason (str)

exception praval.core.exceptions.HITLConfigurationError

Bases: PravalError

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