Class EvolutionContext

openspace/skill_engine/evolver.py:121–151

Unified context for all evolution triggers. For trigger 1 (ANALYSIS): source_task_id is set, recent_analyses may be just the single triggering analysis. For triggers 2/3: source_task_id is None, recent_analyses are loaded from the skill's historical records.

@dataclass
class EvolutionContext:
    """Unified context for all evolution triggers.

    For trigger 1 (ANALYSIS): source_task_id is set, recent_analyses may be
    just the single triggering analysis.
    For triggers 2/3: source_task_id is None, recent_analyses are loaded
    from the skill's historical records.
    """
    trigger: EvolutionTrigger
    suggestion: EvolutionSuggestion

    # Parent skill context
    skill_records: List[SkillRecord] = field(default_factory=list)
    skill_contents: List[str] = field(default_factory=list)
    skill_dirs: List[Path] = field(default_factory=list)

    # Task context
    source_task_id: Optional[str] = None
    recent_analyses: List[ExecutionAnalysis] = field(default_factory=list)

    # Trigger-specific context
    tool_issue_summary: str = ""             # For TOOL_DEGRADATION
    metric_summary: str = ""                 # For METRIC_MONITOR

    # Available tools for agent loop (read_file, web_search, shell, MCP, etc.)
    available_tools: List["BaseTool"] = field(default_factory=list)

    # For CAPTURED: preferred directory to write the new skill.
    # Set from the calling host agent's skill directory so captured skills
    # are written back to the correct host, not always to _skill_dirs[0].
    capture_dir: Optional[Path] = None


class SkillEvolver: