"""Agents - Persistent AI agents with skills.

Agents are the "characters" that use Packs as their skill libraries.
They maintain state across interactions and can act proactively.

This module provides:
- Agent registration via @agent decorator
- Built-in agent discovery and bootstrapping
- Agent service integration

Usage:
    from agents.registry import list_available_agents, get_agent_by_id

    # List all registered agents
    for agent in list_available_agents():
        print(f"{agent.id}: {agent.name}")

    # Get specific agent
    my_agent = get_agent_by_id("my_agent")
"""

from agents.registry import (
    agent,
    register_agent,
    list_available_agents,
    get_agent_by_id,
    resolve_agent_ids,
    clear_registry,
)

__all__ = [
    "agent",
    "register_agent",
    "list_available_agents",
    "get_agent_by_id",
    "resolve_agent_ids",
    "clear_registry",
]
