Class GeminiProvider

java.lang.Object

ai.doctruth.GeminiProvider

All Implemented Interfaces:

LlmProvider

public non-sealed class GeminiProvider
extends Object
implements LlmProvider

Google Gemini generateContent provider. Per ADR 0003 the vendor SDK is NOT on the classpath; this class is a thin facade that delegates to a hand-rolled GeminiHttpClient (JDK HttpClient + Jackson + Failsafe via RetryGate).

non-sealed so test code (and advanced users) can anonymously subclass to supply canned responses or wrap behaviour.

Since:

0.1.0

Constructor Summary

Constructors

Constructor	Description
GeminiProvider(String apiKey)	Production constructor — talks to generativelanguage.googleapis.com.
GeminiProvider(String apiKey, URI endpoint, String model)	Test / advanced-user constructor: point at an alternative base URL (e.g.

Method Summary

Modifier and Type	Method	Description
String	apiKey()
ProviderResponse	complete(ProviderRequest request)	Execute one extraction call against the provider.
String	name()	Logical lower-case name of the provider, e.g.

Methods inherited from class Object

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

Methods inherited from interface LlmProvider

region

Constructor Details

GeminiProvider

public GeminiProvider(String apiKey)

Production constructor — talks to generativelanguage.googleapis.com.

GeminiProvider

public GeminiProvider(String apiKey,
 URI endpoint,
 String model)

Test / advanced-user constructor: point at an alternative base URL (e.g. WireMock) or pin a specific model id.

Parameters:

apiKey - Gemini API key; non-null and non-blank.

endpoint - base URL for the API (the client appends /v1beta/models/{model}:generateContent); non-null.

model - Gemini model id; non-null and non-blank.

Method Details

apiKey

public String apiKey()

name

public String name()

Description copied from interface: LlmProvider

Logical lower-case name of the provider, e.g. "anthropic". Recorded into Provenance.model() on every ExtractionResult.

Specified by:

name in interface LlmProvider

complete

public ProviderResponse complete(ProviderRequest request)
                          throws ProviderException

Description copied from interface: LlmProvider

Execute one extraction call against the provider.

Specified by:

complete in interface LlmProvider

Parameters:

request - the prepared request; never null.

Returns:

the provider's raw JSON response and usage metadata.

Throws:

ProviderException - on transport, schema, or upstream failure.