Add CatIndexTool

[dbwiddis]

Description

Adds a CatIndexTool for the agent framework.

• This is an exact copy of the current class on feature/agent_framework_dev branch, except that I removed the getName() and setName() methods which duplicated the Lombok annotations.

Tests pass locally for this module, other failing tests related to memory are unassociated with this PR.

ml-commons git:(cat-index-tool) ./gradlew :opensearch-ml-algorithms:test

BUILD SUCCESSFUL in 1s
11 actionable tasks: 11 up-to-date

Issues Resolved

Fixes #1547 but on main this time.

Check List

• New functionality includes testing.
  • All tests pass
• New functionality has been documented.
  • New functionality has javadoc added
• Commits are signed per the DCO using --signoff

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[codecov]

Codecov Report

Attention: 33 lines in your changes are missing coverage. Please review.

Comparison is base (2761d7d) 82.07% compared to head (cd051f5) 82.05%.

❗ Current head cd051f5 differs from pull request most recent head 4afb1e8. Consider uploading reports for the commit 4afb1e8 to get more accurate results

Files	Patch %	Lines
...a/org/opensearch/ml/engine/tools/CatIndexTool.java	79.50%	19 Missing and 14 partials ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #1746      +/-   ##
============================================
- Coverage     82.07%   82.05%   -0.03%     
- Complexity     4427     4445      +18     
============================================
  Files           425      426       +1     
  Lines         17583    17744     +161     
  Branches       1870     1884      +14     
============================================
+ Hits          14431    14559     +128     
- Misses         2410     2429      +19     
- Partials        742      756      +14     

Flag	Coverage Δ
ml-commons	82.05% <79.50%> (-0.03%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.