Package org.machanism.machai.process.tools

Class FunctionToolsLoader

java.lang.Object

org.machanism.machai.process.tools.FunctionToolsLoader

public class FunctionToolsLoader
extends Object

Discovers and applies FunctionTools implementations using Java's ServiceLoader mechanism.

This class acts as the entry point for registering a curated set of local capabilities (such as file access, command execution, and HTTP retrieval) with a ProcessProvider provider. Implementations are discovered from the classpath (typically via META-INF/services provider configuration) and then applied to the provider in discovery order.

Usage Example

 ProcessProvider provider = ...;
 Class<?> appClass = ...;
 FunctionToolsLoader loader = new FunctionToolsLoader();
 loader.applyTools(provider, appClass);
 

The loader maintains a list of discovered FunctionTools instances and applies them to the provider, filtered by application class compatibility.

Author:

Viktor Tovstyi

Field Summary

Fields

Modifier and Type	Field	Description
private final List<FunctionTools>	functionTools	List of discovered FunctionTools instances, loaded from the classpath.
private static final org.slf4j.Logger	logger	Logger for debug output during tool discovery and application.

Constructor Summary

Constructors

Constructor	Description
FunctionToolsLoader()	Constructs a new FunctionToolsLoader and discovers available FunctionTools implementations using ServiceLoader.

Method Summary

Modifier and Type	Method	Description
void	applyTools(ProcessProvider provider, String[] tools, Class<?> appClass)	Applies all discovered FunctionTools installers to the given provider, filtered by application class compatibility.
private boolean	isSupportedFor(Class<?> appClass, Class<? extends FunctionTools> functionToolsClass)	Checks whether the given FunctionTools implementation supports assignment to the specified application class.
private void	loadLegacyServiceDescriptor()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

logger

private static final org.slf4j.Logger logger

Logger for debug output during tool discovery and application.

functionTools

private final List<FunctionTools> functionTools

List of discovered FunctionTools instances, loaded from the classpath.

Constructor Details

FunctionToolsLoader

public FunctionToolsLoader()

Constructs a new FunctionToolsLoader and discovers available FunctionTools implementations using ServiceLoader.

Each discovered tool is added to the internal list and logged for debugging.

Method Details

loadLegacyServiceDescriptor

private void loadLegacyServiceDescriptor()

applyTools

public void applyTools(ProcessProvider provider,
 String[] tools,
 Class<?> appClass)

Applies all discovered FunctionTools installers to the given provider, filtered by application class compatibility.

For each compatible tool, both tool functions and prompts are registered with the provider.

Parameters:

provider - the ProcessProvider provider instance to augment with tools, prompts, and resources

tools - names of tools that the provider should register; provider-specific filtering is applied by ProcessProvider.addTools(FunctionTools, String[])

appClass - the application class requesting tool assignment; only tools compatible with this class are applied

isSupportedFor

private boolean isSupportedFor(Class<?> appClass,
 Class<? extends FunctionTools> functionToolsClass)

Checks whether the given FunctionTools implementation supports assignment to the specified application class.

If the SupportedFor annotation is present, only classes listed in its value are considered compatible. If the annotation is absent, compatibility is assumed.

Parameters:

appClass - the application class requesting tool assignment

functionToolsClass - the FunctionTools implementation class

Returns:

true if the tool is compatible with the application class, false otherwise