/agents

/agents [ACTION] [FILTER or AGENT-ID]

/agents list

/agents search osint

/agents show intel-osint-specialist

/agents capabilities storage

/agents status

/agents stats

defmodule PrismaticAgents.Discovery.Command do
  @moduledoc """
  Agent discovery and management command handler.
  Provides comprehensive agent ecosystem visibility with
  multi-domain search, filtering, and health monitoring.
  """

  @agent_spec_dir ".aiad/agents/"
  @agent_registry ".claude/AGENT_REGISTRY.md"

  @spec list(keyword()) :: {:ok, map()}
  def list(opts \\ []) do
    agents =
      discover_all_agents()
      |> group_by_domain()
      |> apply_filters(opts)
      |> sort_by_authority()

    {:ok, %{
      total: count_total(agents),
      domains: map_size(agents),
      agents_by_domain: agents
    }}
  end

  @spec search(String.t()) :: {:ok, [map()]}
  def search(pattern) do
    results =
      discover_all_agents()
      |> Enum.filter(&matches_pattern?(&1, pattern))
      |> Enum.sort_by(& &1.relevance_score, :desc)

    {:ok, results}
  end

  @spec show(String.t()) :: {:ok, map()} | {:error, :not_found}
  def show(agent_id) do
    case find_agent_by_id(agent_id) do
      nil -> {:error, :not_found}
      agent -> {:ok, parse_full_specification(agent)}
    end
  end

  defp discover_all_agents do
    Path.wildcard(Path.join(@agent_spec_dir, "*.agent.md"))
    |> Enum.map(&parse_agent_spec/1)
    |> Enum.reject(&is_nil/1)
  end

  defp group_by_domain(agents) do
    Enum.group_by(agents, & &1.domain)
  end
end

Related Commands