Exceptions 

interface NrLlmExceptionInterface
Fully qualified name
\Netresearch\NrLlm\Exception\NrLlmExceptionInterface

Marker interface implemented by every exception this extension throws on its public API surface — including the fromArray() normalisation errors of ChatMessage / ToolSpec / ToolCall. Catch this when any nr_llm failure should take the same error path (ADR-053):

try {
    $response = $this->llmManager->chatWithTools($messages, $tools);
} catch (NrLlmExceptionInterface $e) {
    throw new MyDomainException($e->getMessage(), 0, $e);
}
Copied!
class ProviderException
Fully qualified name
\Netresearch\NrLlm\Provider\Exception\ProviderException

Base exception for provider errors.

getProvider(): string

Get the provider that threw the exception.

class ProviderConfigurationException
Fully qualified name
\Netresearch\NrLlm\Provider\Exception\ProviderConfigurationException

Thrown when a provider is incorrectly configured.

Extends \Netresearch\NrLlm\Provider\Exception\ProviderException

class ProviderConnectionException
Fully qualified name
\Netresearch\NrLlm\Provider\Exception\ProviderConnectionException

Thrown when a connection to the provider fails.

Extends \Netresearch\NrLlm\Provider\Exception\ProviderException

class ProviderResponseException
Fully qualified name
\Netresearch\NrLlm\Provider\Exception\ProviderResponseException

Thrown when the provider returns an unexpected or error response.

Extends \Netresearch\NrLlm\Provider\Exception\ProviderException

class UnsupportedFeatureException
Fully qualified name
\Netresearch\NrLlm\Provider\Exception\UnsupportedFeatureException

Thrown when a requested feature is not supported by the provider.

Extends \Netresearch\NrLlm\Provider\Exception\ProviderException

class InvalidArgumentException
Fully qualified name
\Netresearch\NrLlm\Exception\InvalidArgumentException

Thrown for invalid method arguments.

class ConfigurationNotFoundException
Fully qualified name
\Netresearch\NrLlm\Exception\ConfigurationNotFoundException

Thrown when a named configuration is not found.

class ConfigurationInactiveException
Fully qualified name
\Netresearch\NrLlm\Exception\ConfigurationInactiveException

Thrown when a named configuration exists but is deactivated (ADR-070).

Only ConfigurationResolver::getActiveByIdentifier() differentiates inactive from not-found; the user-aware LlmConfigurationServiceInterface::getConfiguration() signals the inactive case as ConfigurationNotFoundException (code 2690936773).

Events