Package org.machanism.machai.ai.provider

Class GenaiAdapter

java.lang.Object

org.machanism.machai.ai.provider.GenaiAdapter

All Implemented Interfaces:

Genai

Direct Known Subclasses:

CodeMieProvider

public class GenaiAdapter
extends Object
implements Genai

Delegating Genai implementation.

This adapter forwards all Genai calls to an underlying provider instance configured via setProvider(Genai).

Intended use cases include decorating providers (for example, adding cross-cutting concerns like logging, metrics, retries, or request shaping) while preserving the Genai contract.

Thread-safety: Instances are not thread-safe unless the delegated provider is thread-safe and access is externally synchronized.

Field Summary

Fields

Modifier and Type	Field	Description
protected Genai	provider	Delegate provider.

Constructor Summary

Constructors

Constructor	Description
GenaiAdapter()	Creates an adapter without a delegate.

Method Summary

Modifier and Type	Method	Description
void	addPrompts(FunctionTools functionTool)	Scans the provided FunctionTools instance for methods annotated with Prompt, and registers each prompt for use during a run.
void	addResources(FunctionTools tools)	Scans the provided FunctionTools instance for methods annotated with Resource, and registers each resource for use during a run.
void	addTools(FunctionTools tools)	Registers a set of tool functions that may be invoked during a run.
void	clear()	Clears any stored files and session/provider state.
void	init(String model, Configurator conf)	Initializes the provider with application configuration.
void	instructions(String instructions)	Sets system/session instructions for the current conversation.
String	perform()	Executes the provider to produce a response based on the accumulated prompts and state.
void	prompt(String text)	Adds a user prompt to the current session.
void	setEnabledTools(String[] tools)	Configures the list of tool names that are enabled and allowed to be used by the AI provider.
void	setErrorHandling(boolean errorHandling)	Configures whether tool invocation errors should be returned to the model for conversational recovery or propagated as exceptions.
void	setProjectDir(File projectDir)	Sets the working directory for the provider, which may be used by tool handlers.
void	setProvider(Genai provider)	Sets the delegate provider.

Methods inherited from class java.lang.Object

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

Field Details

provider

protected Genai provider

Delegate provider.

Subclasses typically set this value during construction or initialization using setProvider(Genai).

Constructor Details

GenaiAdapter

public GenaiAdapter()

Creates an adapter without a delegate.

Call setProvider(Genai) before invoking any other methods.

Method Details

setProvider

public void setProvider(Genai provider)

Sets the delegate provider.

Parameters:

provider - the provider to delegate to

Throws:

IllegalArgumentException - if provider is null

init

public void init(String model,
 Configurator conf)

Initializes the provider with application configuration.

Specified by:

init in interface Genai

Parameters:

model - the model identifier or name to use

conf - configuration source

prompt

public void prompt(String text)

Adds a user prompt to the current session.

Specified by:

prompt in interface Genai

Parameters:

text - the prompt text

clear

public void clear()

Clears any stored files and session/provider state.

This resets the conversation and any accumulated context.

Specified by:

clear in interface Genai

instructions

public void instructions(String instructions)

Sets system/session instructions for the current conversation.

Specified by:

instructions in interface Genai

Parameters:

instructions - instruction text

perform

public String perform()

Executes the provider to produce a response based on the accumulated prompts and state.

Specified by:

perform in interface Genai

Returns:

the provider response as a string

setProjectDir

public void setProjectDir(File projectDir)

Sets the working directory for the provider, which may be used by tool handlers.

Specified by:

setProjectDir in interface Genai

Parameters:

projectDir - the project directory

addTools

public void addTools(FunctionTools tools)

Registers a set of tool functions that may be invoked during a run.

Specified by:

addTools in interface Genai

Parameters:

tools - the FunctionTools instance containing tool methods

addPrompts

public void addPrompts(FunctionTools functionTool)

Scans the provided FunctionTools instance for methods annotated with Prompt, and registers each prompt for use during a run.

Specified by:

addPrompts in interface Genai

Parameters:

functionTool - the FunctionTools instance whose methods will be scanned for Prompt annotations

addResources

public void addResources(FunctionTools tools)

Scans the provided FunctionTools instance for methods annotated with Resource, and registers each resource for use during a run.

This method inspects the given class instance to register executable resource utilities that can be dynamically called by the AI model during generation processes.

Specified by:

addResources in interface Genai

Parameters:

tools - the FunctionTools instance whose methods will be scanned for resource annotations

setErrorHandling

public void setErrorHandling(boolean errorHandling)

Configures whether tool invocation errors should be returned to the model for conversational recovery or propagated as exceptions.

Specified by:

setErrorHandling in interface Genai

Parameters:

errorHandling - true to return tool errors as response text; false to propagate them immediately

setEnabledTools

public void setEnabledTools(String[] tools)

Configures the list of tool names that are enabled and allowed to be used by the AI provider.

If the specified array is null or empty, all registered tools are typically enabled by default. Only tools whose identifiers are present in this collection will be active during provider execution.

Specified by:

setEnabledTools in interface Genai

Parameters:

tools - the array of unique tool names to enable; if null or empty, all tools are enabled