Skip to content

OSSS.ai.exceptions.agent_errors

OSSS.ai.exceptions.agent_errors

Agent-specific exceptions for OSSS.

This module defines exceptions related to agent execution, dependency management, and agent-level failures with LangGraph node compatibility.

AgentExecutionError

Bases: OSSSError

Base exception for agent execution failures.

Represents errors that occur during agent execution, designed to be compatible with LangGraph node error handling patterns.

AgentDependencyMissingError

Bases: AgentExecutionError

Exception raised when an agent's dependencies are not satisfied.

This error occurs when an agent requires output from another agent that either failed or was not executed. Maps to LangGraph conditional edge logic for handling missing upstream nodes.

get_user_message()

Get user-friendly error message with dependency guidance.

AgentTimeoutError

Bases: AgentExecutionError

Exception raised when an agent execution times out.

Represents timeout failures during agent execution, with configurable retry policies for different timeout scenarios.

get_user_message()

Get user-friendly error message with timeout guidance.

AgentConfigurationError

Bases: AgentExecutionError

Exception raised when an agent has invalid configuration.

Represents configuration-related failures that prevent agent execution, such as missing required parameters or invalid settings.

get_user_message()

Get user-friendly error message with configuration guidance.

AgentResourceError

Bases: AgentExecutionError

Exception raised when an agent cannot access required resources.

Represents resource availability issues such as memory constraints, disk space, or external service dependencies.

get_user_message()

Get user-friendly error message with resource guidance.

AgentValidationError

Bases: AgentExecutionError

Exception raised when agent input or output validation fails.

Represents validation failures for agent inputs, outputs, or internal state validation during execution.

get_user_message()

Get user-friendly error message with validation guidance.