tools for agents

[mawinter69]

Add 4 new tools to work with agents

• listAgentNames: returns a list of all agents (doesn't include the built-in)
• getAgent: Returns the Computer for the given agent (i.e. what also the api returns)
• takeAgentOffline: take an agent offline with the given reason
• takeAgentOnline: turn online

Testing done

full coverage with unit tests

Submitter checklist

• Make sure you are opening from a topic/feature/bugfix branch (right side) and not your main branch!
• Ensure that the pull request title represents the desired changelog entry
• Please describe what you did
• Link to relevant issues in GitHub or Jira
• Link to relevant pull requests, esp. upstream and downstream changes
• Ensure you have provided tests that demonstrate the feature works or the issue is fixed

[mawinter69]

The getAgent returns the Computer object. So this is what you get when you access /computer//api/json. That might be a lot of data, when an agent has many executors and many labels. Though as an ExportedBean it supports to restrict the data with the tree argument

[olamy]

Instead of having both takeAgentOffline and takeAgentOnline, could we have a single mcp tool, such as agentStatus, with a parameter status (ONLINE or OFFLINE).
Bear in mind MCP servers are not API endpoints, it's a recommendation to avoid having too many tools to not blow up context