Module agentforge4j.llm

Package com.agentforge4j.llm

Class DefaultLlmClientResolver

java.lang.Object

com.agentforge4j.llm.DefaultLlmClientResolver

All Implemented Interfaces:

LlmClientResolver

public final class DefaultLlmClientResolver
extends Object
implements LlmClientResolver

Default LlmClientResolver: builds an immutable map of provider id to LlmClient.

discover(ObjectMapper, Collection, LlmSecretResolver) loads LlmClientFactory implementations via JPMS ServiceLoader, pairs each with a matching LlmClientConfiguration by provider id (case-insensitive), and constructs clients. resolve(String) looks up a client or fails with IllegalArgumentException.

Constructor Summary

Constructors

Constructor	Description
DefaultLlmClientResolver(Collection<LlmClient> clients)	Creates a resolver backed by an explicit non-empty client list (typically used in tests).

Method Summary

Modifier and Type	Method	Description
static DefaultLlmClientResolver	discover(com.fasterxml.jackson.databind.ObjectMapper objectMapper, Collection<LlmClientConfiguration> configs, LlmSecretResolver secretResolver)	Discovers LlmClientFactory implementations and builds clients for each configuration that matches a factory's provider id, resolving each provider's credential reference via secretResolver.
boolean	isProviderAvailable(String provider)
List<String>	listAvailableClients()
LlmClient	resolve(String provider)	Returns the client for the given provider id (matched case-insensitively by typical implementations).

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultLlmClientResolver

public DefaultLlmClientResolver(Collection<LlmClient> clients)

Creates a resolver backed by an explicit non-empty client list (typically used in tests).

Parameters:

clients - non-empty, no null elements, unique LlmClient.getProviderName() per entry

Throws:

IllegalArgumentException - if validation fails

Method Details

discover

public static DefaultLlmClientResolver discover(com.fasterxml.jackson.databind.ObjectMapper objectMapper,
 Collection<LlmClientConfiguration> configs,
 LlmSecretResolver secretResolver)

Discovers LlmClientFactory implementations and builds clients for each configuration that matches a factory's provider id, resolving each provider's credential reference via secretResolver. Each client is constructed through LlmClientFactory.create(LlmClientFactoryContext).

Factories without a matching configuration are skipped (warning logged). At least one client must be created or IllegalStateException is thrown.

Parameters:

objectMapper - passed to each factory

configs - one or more LlmClientConfiguration entries (duplicate provider ids fail)

secretResolver - resolver for credential references; must not be null

Returns:

resolver over all constructed clients

Throws:

IllegalStateException - when no client could be built (missing provider modules or configs)

resolve

public LlmClient resolve(String provider)

Returns the client for the given provider id (matched case-insensitively by typical implementations).

Specified by:

resolve in interface LlmClientResolver

Parameters:

provider - provider id such as "openai" or "ollama"

Returns:

client for that provider

isProviderAvailable

public boolean isProviderAvailable(String provider)

Specified by:

isProviderAvailable in interface LlmClientResolver

listAvailableClients

public List<String> listAvailableClients()

Specified by:

listAvailableClients in interface LlmClientResolver