haive.core.schema.prebuilt.tools.validation_state

Enhanced validation state for tool message routing and conditional branching.

Classes

RouteRecommendation	Routing recommendations for validated tools.
ToolValidationResult	Result of validating a single tool call.
ValidationRoutingState	State for managing validation results and routing decisions.
ValidationStateManager	Manager for validation state operations.
ValidationStatus	Status of tool validation.

Module Contents

class haive.core.schema.prebuilt.tools.validation_state.RouteRecommendation

Bases: str, enum.Enum

Routing recommendations for validated tools.

Initialize self. See help(type(self)) for accurate signature.

class haive.core.schema.prebuilt.tools.validation_state.ToolValidationResult(/, **data)

Bases: pydantic.BaseModel

Result of validating a single tool call.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Parameters:

data (Any)

class haive.core.schema.prebuilt.tools.validation_state.ValidationRoutingState(/, **data)

Bases: pydantic.BaseModel

State for managing validation results and routing decisions.

Create a new model by parsing and validating input data from keyword arguments.

Raises [ValidationError][pydantic_core.ValidationError] if the input data cannot be validated to form a valid model.

self is explicitly positional-only to allow self as a field name.

Parameters:

data (Any)

add_validation_result(result)

Add a validation result and update routing state.

Parameters:

result (ToolValidationResult)

Return type:

None

get_correctable_tool_calls()

Get tool calls that have corrections available.

Return type:

list[ToolValidationResult]

get_error_tool_calls()

Get validation results for error tool calls.

Return type:

list[ToolValidationResult]

get_invalid_tool_calls()

Get validation results for invalid tool calls.

Return type:

list[ToolValidationResult]

get_routing_decision()

Get routing decision data for conditional branching.

Return type:

dict[str, Any]

get_routing_summary()

Get a human-readable summary of routing decisions.

Return type:

str

get_valid_tool_calls()

Get validation results for valid tool calls.

Return type:

list[ToolValidationResult]

should_continue_execution()

Check if execution should continue based on validation results.

Return type:

bool

should_end_processing()

Check if processing should end.

Return type:

bool

should_return_to_agent()

Check if processing should return to agent.

Return type:

bool

class haive.core.schema.prebuilt.tools.validation_state.ValidationStateManager

Manager for validation state operations.

static create_routing_state()

Create a new validation routing state.

Return type:

ValidationRoutingState

static create_validation_result(tool_call_id, tool_name, status, route_recommendation=RouteRecommendation.EXECUTE, errors=None, warnings=None, corrected_args=None, target_node=None, engine_name=None, priority=0, metadata=None)

Create a validation result with all parameters.

Parameters:

• tool_call_id (str)

• tool_name (str)

• status (ValidationStatus)

• route_recommendation (RouteRecommendation)

• errors (list[str] | None)

• warnings (list[str] | None)

• corrected_args (dict[str, Any] | None)

• target_node (str | None)

• engine_name (str | None)

• priority (int)

• metadata (dict[str, Any] | None)

Return type:

ToolValidationResult

static merge_routing_states(states)

Merge multiple routing states into one.

Parameters:

states (list[ValidationRoutingState])

Return type:

ValidationRoutingState

class haive.core.schema.prebuilt.tools.validation_state.ValidationStatus

Bases: str, enum.Enum

Status of tool validation.

Initialize self. See help(type(self)) for accurate signature.