[Nitin-Sagar-B]

Summary

Adds optional session-only BYOK cloud providers while preserving local Ollama as SparkOllama's default route.

• keeps loopback-only Ollama and installed-model discovery
• adds Google Gemini, OpenAI, and Anthropic Claude provider adapters
• uses the OpenAI Responses API with response storage disabled
• uses the Anthropic Messages streaming API and Gemini content streaming API
• accepts editable model IDs so users can choose models available to their accounts
• requires a password-field key and explicit cloud-transmission consent
• never persists keys or copies them into process-global environment variables
• clears conversation context when the selected provider/model changes
• updates privacy, architecture, limitations, GEO metadata, optional dependencies, and CI

Validation

• 35 tests
• Ruff format and lint
• strict mypy
• locked environment with all cloud extras installed
• wheel and source distribution builds
• Python 3.11–3.13 package workflow validates all optional providers

Scope

SparkOllama remains local-first and has no Sparkience-hosted backend. Cloud provider availability, billing, retention, and model access remain governed by the user's provider account.