agents.common.models.task_analysis.solvability¶

Task solvability and readiness assessment.

This module analyzes whether tasks are currently solvable, what barriers exist, and what would be required to make unsolvable tasks solvable.

Classes¶

`SolvabilityAssessment`	Comprehensive assessment of task solvability and readiness.
`SolvabilityBarrier`	Types of barriers that prevent task solvability.

Module Contents¶

class agents.common.models.task_analysis.solvability.SolvabilityAssessment(/, **data)¶

Bases: pydantic.BaseModel

Comprehensive assessment of task solvability and readiness.

Analyzes whether a task can be solved with current capabilities, what barriers exist, and what would be required to overcome them.

Parameters:: data (Any)

solvability_status¶: Current solvability classification

is_currently_solvable¶: Whether task can be solved right now

confidence_level¶: Confidence in the solvability assessment

primary_barriers¶: Main obstacles preventing solution

secondary_barriers¶: Additional challenges that may arise

enabling_factors¶: Factors that make the task more solvable

breakthrough_requirements¶: What breakthroughs would be needed

estimated_time_to_solvable¶: Time until task becomes solvable

alternative_approaches¶: Possible alternative solution paths

Example

# Simple factual lookup - highly solvable
assessment = SolvabilityAssessment(
solvability_status=SolvabilityStatus.READY,
is_currently_solvable=True,
confidence_level=0.95,
primary_barriers=[],
enabling_factors=["web_search", "public_databases"],
estimated_time_to_solvable=timedelta(0)
)

# Cancer cure - major breakthrough required
assessment = SolvabilityAssessment(
solvability_status=SolvabilityStatus.THEORETICAL,
is_currently_solvable=False,
confidence_level=0.7,
primary_barriers=[
SolvabilityBarrier.KNOWLEDGE_GAP,
SolvabilityBarrier.TECHNOLOGY_LIMITATION,
SolvabilityBarrier.RESOURCE_CONSTRAINT
],
breakthrough_requirements=[
"fundamental_understanding_of_cancer_biology",
"advanced_genetic_engineering_tools",
"personalized_medicine_capabilities"
],
estimated_time_to_solvable=timedelta(days=7300)  # ~20 years
)

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.

estimate_breakthrough_timeline()¶

Estimate timeline for required breakthroughs.

Returns:: Dictionary with breakthrough timeline analysis
Return type:: dict[str, Any]

generate_solvability_report()¶

Generate a comprehensive solvability report.

Returns:: Formatted report string
Return type:: str

get_addressable_barriers()¶

Get barriers that could potentially be addressed.

Returns:: List of barriers that might be overcome
Return type:: list[SolvabilityBarrier]

get_immediate_actions()¶

Get recommended immediate actions to improve solvability.

Returns:: List of actionable recommendations
Return type:: list[str]

get_solvability_score()¶

Get solvability as a normalized score (0.0-1.0).

Returns:: Normalized solvability score
Return type:: float

has_showstopper_barriers()¶

Check if task has barriers that are absolute showstoppers.

Returns:: True if task has insurmountable barriers
Return type:: bool

validate_solvability_consistency()¶

Validate that solvability assessment is internally consistent.

Returns:: Self if validation passes
Raises:: ValueError – If assessment has inconsistencies
Return type:: SolvabilityAssessment

model_config¶: Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class agents.common.models.task_analysis.solvability.SolvabilityBarrier¶

Bases: str, enum.Enum

Types of barriers that prevent task solvability.

KNOWLEDGE_GAP¶: Missing fundamental knowledge or understanding

TECHNOLOGY_LIMITATION¶: Current technology is insufficient

RESOURCE_CONSTRAINT¶: Insufficient computational, financial, or material resources

THEORETICAL_IMPOSSIBILITY¶: Task violates known physical or logical laws

REGULATORY_BARRIER¶: Legal, ethical, or regulatory constraints

COORDINATION_COMPLEXITY¶: Too complex to coordinate effectively

TIME_CONSTRAINT¶: Not enough time available given current methods

DATA_UNAVAILABILITY¶: Required data doesn’t exist or isn’t accessible

EXPERT_UNAVAILABILITY¶: Required human expertise not available

INFRASTRUCTURE_LIMITATION¶: Missing necessary infrastructure or systems

ETHICAL_CONCERN¶: Ethical issues prevent pursuit of solution

SAFETY_RISK¶: Safety risks are too high to attempt

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