Defining Goals

from framework.graph.goal import Goal, SuccessCriterion, Constraint

goal = Goal(
    id="my-goal",
    name="My Agent Goal",
    description="What this agent should accomplish",
    success_criteria=[...],
    constraints=[...],
)

SuccessCriterion(
    id="unique-id",
    description="Human-readable description",
    metric="how to measure",
    target="target value",
    weight=1.0,  # Relative importance (0-1)
)

success_criteria = [
    SuccessCriterion(
        id="completeness",
        description="Response covers all requested topics",
        metric="llm_judge",
        target=">= 0.9",
        weight=0.5,
    ),
    SuccessCriterion(
        id="accuracy",
        description="Information is factually correct",
        metric="llm_judge",
        target=">= 0.95",
        weight=0.5,
    ),
]

constraints = [
    Constraint(
        id="no-external-apis",
        description="Do not call external APIs without user approval",
        constraint_type="hard",
        category="safety",
    ),
    Constraint(
        id="response-length",
        description="Keep responses under 500 words",
        constraint_type="soft",
        category="quality",
    ),
]

from framework.graph.goal import Goal, SuccessCriterion, Constraint

research_goal = Goal(
    id="research-agent-goal",
    name="Technical Research Agent",
    description="Research technical topics and provide comprehensive summaries",
    
    success_criteria=[
        SuccessCriterion(
            id="topic-coverage",
            description="Covers all major aspects of the topic",
            metric="llm_judge",
            target=">= 0.9",
            weight=0.4,
        ),
        SuccessCriterion(
            id="source-quality",
            description="Uses credible sources",
            metric="llm_judge",
            target=">= 0.8",
            weight=0.3,
        ),
        SuccessCriterion(
            id="clarity",
            description="Output is clear and well-structured",
            metric="llm_judge",
            target=">= 0.85",
            weight=0.3,
        ),
    ],
    
    constraints=[
        Constraint(
            id="verify-sources",
            description="All information must be from verifiable sources",
            constraint_type="hard",
            category="quality",
        ),
        Constraint(
            id="no-speculation",
            description="Do not include unverified speculation",
            constraint_type="hard",
            category="safety",
        ),
        Constraint(
            id="time-limit",
            description="Complete research within 5 minutes",
            constraint_type="soft",
            category="time",
        ),
    ],
    
    required_capabilities=["web_search", "llm"],
    
    context={
        "domain": "technology",
        "audience": "developers",
    },
)