Skill Factory API

/**
 * Factory interface for creating agent skills from internal capabilities.
 */
interface AgentSkillFactory {
    /**
     * Create skills for the given namespace.
     * @param namespace Skill namespace prefix (typically agent platform name)
     * @return List of AgentSkill objects
     */
    fun skills(namespace: String): List<AgentSkill>
}

/**
 * Converts Embabel Goals to A2A AgentSkills.
 * @param goals Set of goals to convert
 */
class FromGoalsAgentSkillFactory(
    private val goals: Set<Goal>
) : AgentSkillFactory {
    override fun skills(namespace: String): List<AgentSkill>
}

AgentSkill(
    id = "${namespace}_goal_${goal.name}",
    name = goal.name,
    description = goal.description,
    tags = goal.tags.toList(),
    examples = goal.examples.toList(),
    acceptedInputModes = listOf("application/json"),
    acceptedOutputModes = listOf("application/json"),
    configuration = null
)

val goals = setOf(
    Goal(
        name = "findNews",
        description = "Find news based on a person's star sign",
        tags = setOf("news", "astrology"),
        examples = setOf("Find news for Scorpios", "What news is relevant for Aries?")
    ),
    Goal(
        name = "researchTopic",
        description = "Research a topic using web tools",
        tags = setOf("research", "web"),
        examples = setOf("Research Australian elections", "Find information about climate change")
    )
)

val factory = FromGoalsAgentSkillFactory(goals)
val skills = factory.skills("my_agent")

// Results:
// - ID: "my_agent_goal_findNews"
//   Name: "findNews"
//   Description: "Find news based on a person's star sign"
//   Tags: ["news", "astrology"]
//
// - ID: "my_agent_goal_researchTopic"
//   Name: "researchTopic"
//   Description: "Research a topic using web tools"
//   Tags: ["research", "web"]

class EmbabelServerGoalsAgentCardHandler(
    private val agentPlatform: AgentPlatform,
    private val goalFilter: GoalFilter,
    /* ... */
) {
    override fun agentCard(scheme: String, host: String, port: Int): AgentCard {
        return AgentCard.Builder()
            .skills(
                FromGoalsAgentSkillFactory(
                    goals = agentPlatform.goals.filter { goalFilter.invoke(it) }.toSet()
                ).skills(agentPlatform.name)
            )
            .build()
    }
}

class CustomSkillFactory : AgentSkillFactory {

    override fun skills(namespace: String): List<AgentSkill> {
        return listOf(
            AgentSkill(
                id = "${namespace}_custom_search",
                name = "customSearch",
                description = "Perform a custom search operation",
                tags = listOf("search", "custom"),
                examples = listOf("Search for X", "Find Y"),
                acceptedInputModes = listOf("application/json", "text/plain"),
                acceptedOutputModes = listOf("application/json"),
                configuration = mapOf("maxResults" to 10)
            ),
            AgentSkill(
                id = "${namespace}_data_analysis",
                name = "dataAnalysis",
                description = "Analyze data and generate insights",
                tags = listOf("analysis", "data"),
                examples = listOf("Analyze sales data", "Generate report"),
                acceptedInputModes = listOf("application/json"),
                acceptedOutputModes = listOf("application/json", "text/html"),
                configuration = null
            )
        )
    }
}

Goal(
    name = "researchTopic",
    description = "Research a topic using web tools and summarize findings",
    tags = setOf("research", "web", "summarization"),
    examples = setOf(
        "Research the recent Australian federal election",
        "Find information about renewable energy trends",
        "What are the latest developments in quantum computing?"
    )
)

Goal(
    name = "doResearch",
    description = "Does research",  // Too vague
    tags = setOf("RESEARCH", "Web"),  // Inconsistent casing
    examples = setOf("research")  // Not specific
)