List subagents from user and/or project directories.
Scans for subagent definitions in the provided directories. Project subagents override user subagents with the same name.
list_subagents(
*,
user_agents_dir: Path | None = None,
project_agents_dir: Path | None = None
) -> list[SubagentMetadata]