OSSS.ai.orchestration.semantic_validation

OSSS.ai.orchestration.semantic_validation

Semantic validation layer for OSSS graph patterns.

This module provides domain-specific validation for agent workflows, ensuring that agent combinations and patterns create semantically meaningful executions. The validation layer is optional and can be bypassed for maximum flexibility.

ValidationSeverity

Bases: Enum

Unified severity levels for validation issues across all domains.

Consolidates: - Semantic: INFO, WARNING, ERROR - Workflow: INFO, WARNING, ERROR, STYLE (with int levels 1-10) - Pattern: PASS, WARN, FAIL, ERROR

from_string(value) classmethod

Convert string to ValidationSeverity with alias handling.

to_pattern_result()

Convert to pattern validation result format.

SemanticValidationIssue

Bases: ValidationIssue

Validation issue specific to semantic validation domain.

Extends base ValidationIssue with agent-specific context. Used in langgraph_backend.semantic_validation module.

to_legacy_dataclass()

Convert to legacy dataclass format for backward compatibility.

SemanticValidationResult dataclass

Result of semantic validation with detailed feedback.

has_errors property

Check if validation has any errors.

has_warnings property

Check if validation has any warnings.

error_messages property

Get all error messages.

warning_messages property

Get all warning messages.

add_issue(severity, message, agent=None, suggestion=None, code=None)

Add a validation issue.

WorkflowSemanticValidator

Bases: ABC

Abstract base class for semantic validation of agent workflows.

Workflow semantic validators check whether agent combinations and patterns create meaningful and valid workflows according to domain rules.

validate_workflow(agents, pattern, **kwargs) abstractmethod

Validate an agent workflow for semantic correctness.

Parameters

agents : List[str] List of agent names in the workflow pattern : str Name of the graph pattern being used **kwargs : Any Additional context for validation

Returns

SemanticValidationResult Detailed validation result with issues and suggestions

get_supported_patterns() abstractmethod

Get the set of graph patterns this validator supports.

Returns

Set[str] Set of supported pattern names

validate_agents(agents)

Validate individual agents regardless of pattern.

Parameters

agents : List[str] List of agent names to validate

Returns

SemanticValidationResult Basic agent validation result

OSSSValidator

Bases: WorkflowSemanticValidator

Domain-specific semantic validator for OSSS workflows.

This validator implements OSSS's semantic rules about agent relationships, execution order, and meaningful workflow composition.

__init__(strict_mode=False)

Initialize the OSSS validator.

Parameters

strict_mode : bool If True, enforces stricter validation rules

get_supported_patterns()

Get patterns supported by OSSS validator.

validate_workflow(agents, pattern, **kwargs)

Validate a OSSS workflow for semantic correctness.

Parameters

agents : List[str] List of agent names in the workflow pattern : str Name of the graph pattern being used **kwargs : Any Additional validation context

Returns

SemanticValidationResult Comprehensive validation result

ValidationError

Bases: Exception

Raised when semantic validation fails with errors.

create_default_validator(strict_mode=False)

Create the default OSSS semantic validator.

Parameters

strict_mode : bool Whether to enable strict validation mode

Returns

OSSSValidator Configured validator instance