llm-chat/com.siddharth.kmp.llmchat

Package-level declarations

Types

AiConfig

data class AiConfig(val maxTokens: Int = 256, val temperature: Float = 0.7f)

AiMessage

data class AiMessage(val role: AiMessage.Role, val content: String)

AiProvider

interface AiProvider

A cloud (or on-device) chat-completion backend — one turn in, one text reply out.

AiProviderConfig

data class AiProviderConfig(val selectedProvider: ProviderId = ProviderId.OFFLINE_FALLBACK, val anthropicKey: String? = null, val openAiKey: String? = null, val geminiKey: String? = null, val useOnDevice: Boolean = false)

AnthropicProvider

class AnthropicProvider(apiKey: String, engine: HttpClientEngine = httpClientEngine()) : AiProvider

GeminiProvider

class GeminiProvider(apiKey: String, engine: HttpClientEngine = httpClientEngine()) : AiProvider

OpenAiProvider

class OpenAiProvider(apiKey: String, engine: HttpClientEngine = httpClientEngine()) : AiProvider

ProviderId

enum ProviderId : Enum<ProviderId>

Which provider a consumer has selected + the keys needed to build the fallback chain (buildProviderChain). ON_DEVICE and OFFLINE_FALLBACK are the two slots every consumer plugs their own AiProvider into (buildProviderChain's onDevice/fallback params) — this module doesn't ship either implementation.

Functions

buildProviderChain

fun buildProviderChain(config: AiProviderConfig, fallback: AiProvider, onDevice: AiProvider? = null): List<AiProvider>

Builds the provider fallback chain from config: on-device first (if enabled and onDevice is supplied) → configured cloud providers (Anthropic/OpenAI/Gemini, in that priority order) → fallback last. onDevice and fallback are caller-supplied rather than hardcoded — this module ships no on-device LLM or app-specific offline fallback of its own.

firstAvailable

suspend fun firstAvailable(chain: List<AiProvider>, fallback: AiProvider): AiProvider

Returns the first available provider in chain, or fallback if none report available.