Module agentforge4j.llm

Package com.agentforge4j.llm

package com.agentforge4j.llm

LLM implementation support: client resolution, service discovery, and provider wiring.

The reusable LLM contract lives in com.agentforge4j.llm.api. This package contains implementation-layer types used to construct, register, and resolve provider clients without making the runtime depend on vendor SDKs.

Key types:

• LlmClientFactory — constructs clients from LlmClientConfiguration
• LlmClientResolver — selects a client by provider id
• LlmClientConfiguration — provider client configuration

Core invocation contracts such as LlmClient, LlmExecutionRequest, and LlmInvocationException are defined in the API module.

Related Packages

Module	Package	Description
agentforge4j.llm.api	com.agentforge4j.llm.api	Public LLM invocation contract shared by runtime callers and provider adapters.
agentforge4j.llm.fake	com.agentforge4j.llm.fake

Class	Description
AbstractHttpLlmClient	Base LlmClient for HTTP JSON APIs: shared validation, transport, logging, and error wrapping.
ConfigModelTierResolver	In-memory ModelTierResolver backed by a static provider→tier→model map.
DefaultLlmClientResolver	Default LlmClientResolver: builds an immutable map of provider id to LlmClient.
LlmClientConfiguration	Settings used to construct an LlmClient for one provider: provider id, default model, and HTTP connect timeout.
LlmClientConfigurationAdapter	Provider-owned mapping from a provider's agentforge4j.llm.<providerId>.* configuration subtree to a neutral LlmClientConfiguration.
LlmClientFactory	Factory for creating LlmClient instances for one provider.
LlmClientFactoryContext	Inputs passed to LlmClientFactory.create(LlmClientFactoryContext): the JSON mapper, the neutral provider LlmClientConfiguration, and the LlmSecretResolver a provider uses to resolve its credential reference.
LlmClientResolver	Resolves a provider id string to the configured LlmClient.
LlmExecutionRequestValidator	Shared validation for LlmExecutionRequest across HTTP and non-HTTP clients.
LlmProviderConfigurationException	Thrown for provider configuration-time failures: an unknown provider, a missing or invalid provider option, an unresolvable credential reference, or a duplicate provider contributor.
LlmProviderOptions	Validated, provider-specific configuration transport for the LLM SPI.
LlmSecret	A resolved LLM provider credential.
LlmSecretReference	An opaque reference to an LLM provider credential, carried through neutral provider configuration so a raw credential value never has to travel through the wiring layer.
LlmSecretResolver	Resolves an LlmSecretReference to a live LlmSecret at the point of use.
NeutralOptions	Small builder for the canonical dotted provider-option map emitted by LlmClientConfigurationAdapter implementations.
RawConfigurationSource	Provider-scoped lookup of a single raw property value, backing RawProviderConfiguration.
RawProviderConfiguration	Immutable neutral view over a provider's agentforge4j.llm.<providerId>.* configuration subtree, handed to a LlmClientConfigurationAdapter.
RetryingLlmClient	Wraps an LLM client with retry logic for transient failures (decorrelated jitter backoff).
RetryingLlmClientResolver	Wraps an LLM client resolver with retrying clients (cached per normalized provider id).
ShippedModelTierDefaults	The shipped OSS default mapping of ModelTier to a concrete, versioned model string for each of the nine built-in providers.
StandardNeutralConfiguration	Standard LlmClientConfiguration shape shared by every provider's LlmClientConfigurationAdapter.