OSSS.ai.exceptions.orchestration_errors

OSSS.ai.exceptions.orchestration_errors

Orchestration and pipeline-related exceptions for OSSS.

This module defines exceptions related to agent orchestration, pipeline execution, and workflow management with LangGraph DAG compatibility.

FailurePropagationStrategy

Bases: Enum

Strategy for handling agent failures in pipeline execution.

Defines how failures should propagate through the agent graph, designed for future LangGraph conditional edge mapping.

ExecutionPath

Bases: Enum

Execution path types for conditional workflow routing.

Designed to map to LangGraph DAG conditional edges.

OrchestrationError

Bases: OSSSError

Base exception for orchestration and pipeline failures.

Represents errors in agent orchestration, pipeline execution, and workflow management designed for LangGraph DAG compatibility.

PipelineExecutionError

Bases: OrchestrationError

Exception raised when pipeline execution fails.

Represents failures during multi-agent pipeline execution, including partial failures and agent dependency issues.

get_user_message()

Get user-friendly error message with pipeline details.

DependencyResolutionError

Bases: OrchestrationError

Exception raised when agent dependencies cannot be resolved.

Represents circular dependencies, missing dependencies, or invalid dependency configurations in the agent graph.

get_user_message()

Get user-friendly error message with dependency guidance.

WorkflowTimeoutError

Bases: OrchestrationError

Exception raised when workflow execution times out.

Represents timeout failures at the workflow level, including overall pipeline timeouts and stage timeouts.

get_user_message()

Get user-friendly error message with timeout guidance.

StateTransitionError

Bases: OrchestrationError

Exception raised when context state transitions fail.

Represents failures in context state management, snapshot operations, or state rollback operations critical for LangGraph compatibility.

get_user_message()

Get user-friendly error message with state guidance.

CircuitBreakerError

Bases: OrchestrationError

Exception raised when circuit breaker is open.

Represents circuit breaker activation due to repeated failures, preventing further attempts until the circuit recovers.

get_user_message()

Get user-friendly error message with circuit breaker guidance.

ConditionalExecutionError

Bases: OrchestrationError

Exception raised when conditional execution logic fails.

Represents failures in agent dependency validation, conditional path routing, or execution guard logic.

get_user_message()

Get user-friendly error message with conditional execution guidance.

GracefulDegradationWarning

Bases: OrchestrationError

Warning exception for graceful degradation scenarios.

Represents non-critical agent failures where the pipeline can continue with reduced functionality.

get_user_message()

Get user-friendly warning message for graceful degradation.