llm_conductor 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d361f0593674c6ca79eb53b6884c200a804d104e92f59e1f6fe5a75c2138dd4
-  data.tar.gz: b8476bdaa573306af54d7f5cbb49e94357d359f357f45d14eecb4889c49e8ba0
+  metadata.gz: 80aca14904612848b82ee2f4e08d05d3b3a0cc4a44e6d754d9f785905aa8c447
+  data.tar.gz: c4496c6b595bb737583ab72a861942df62c06f3e2200e061afd07ccf08a35bde
 SHA512:
-  metadata.gz: 80cbe8b64fa36e18a8cb117ed5d72742ceeaae3336d317a3cee90fc343c2a8cc5148b595cf8c41f35000ca9d49d396253f4e7a3922155f025a90cbdd65a32e34
-  data.tar.gz: bd7f70f9bd41889e8c481c1e4f75c0c8f8ef9c1592cfe5b5f1f8584c7c087e9a3ddaa01c0397dbad6d45af53449bdb005490d5054228434b2a27650386334f8d
+  metadata.gz: f1d6e0b0d0c185c28dba1d7c26e94aceee1ddfd3f5278cea73d03eeb719c12b79cc3319e214ee8e1e5e99c861f98fce5e39b1c3c041c1ee49ea33accc2e15c36
+  data.tar.gz: 4ea5a87ba4c4870756153e71ab92fdcb935d804a915fc49fac96f40291c2d6d3e1730e7a4acea8fb8528ea816a9675f5935cb93deb6b32706e80e36659bfb23d

data/docs/custom-parameters.md

@@ -29,7 +29,8 @@ params: { temperature: 0.3, top_p: 0.85 }
 | Provider | Status |
 |----------|--------|
 | Ollama | ✅ Supported |
-| OpenAI, Anthropic, Gemini, etc. | 🔜 Coming soon |
+| Gemini | ✅ Supported |
+| OpenAI, Anthropic, etc. | 🔜 Coming soon |
 
 ---
 
@@ -133,6 +134,42 @@ response = LlmConductor.generate(
 )
 ```
 
+## Gemini Parameters Reference
+
+Below are common parameters supported by Google Gemini via `generationConfig`. For a complete list, see the [Gemini API docs](https://ai.google.dev/gemini-api/docs/text-generation).
+
+### Supported Parameters
+
+| Ruby Key | Gemini API Key | Type | Description |
+|----------|---------------|------|-------------|
+| `temperature` | `temperature` | Float | Controls randomness (0.0-2.0) |
+| `top_p` | `topP` | Float | Nucleus sampling threshold (0.0-1.0) |
+| `top_k` | `topK` | Integer | Top-k sampling limit |
+| `max_tokens` | `maxOutputTokens` | Integer | Maximum tokens to generate |
+| `max_output_tokens` | `maxOutputTokens` | Integer | Alias for max_tokens |
+| `candidate_count` | `candidateCount` | Integer | Number of candidates to return |
+| `stop_sequences` | `stopSequences` | Array | Stop sequences that end generation |
+
+### Gemini Usage Examples
+
+```ruby
+# Low temperature for focused output
+response = LlmConductor.generate(
+  model: 'gemini-2.5-flash',
+  prompt: 'Summarize this article.',
+  vendor: :gemini,
+  params: { temperature: 0.3, max_tokens: 500 }
+)
+
+# Creative writing with Gemini
+response = LlmConductor.generate(
+  model: 'gemini-2.5-flash',
+  prompt: 'Write a poem about the ocean.',
+  vendor: :gemini,
+  params: { temperature: 0.9, top_p: 0.95, top_k: 40 }
+)
+```
+
 ## Ollama Parameters Reference
 
 Below are common parameters supported by Ollama. For a complete list, see the [Ollama documentation](https://github.com/ollama/ollama/blob/main/docs/modelfile.md#valid-parameters-and-values).
@@ -311,11 +348,11 @@ Always refer to your provider's documentation for supported parameters.
 
 Currently, custom parameters are fully supported for:
 - ✅ **Ollama**
+- ✅ **Google (Gemini)** — maps snake_case Ruby keys to camelCase `generationConfig`
 
 Coming soon:
 - 🔜 OpenAI (GPT)
 - 🔜 Anthropic (Claude)
-- 🔜 Google (Gemini)
 - 🔜 Groq
 - 🔜 OpenRouter
 - 🔜 Z.ai

data/lib/llm_conductor/clients/gemini_client.rb

@@ -15,6 +15,17 @@ module LlmConductor
 
       private
 
+      # Gemini REST API uses camelCase keys in generationConfig.
+      PARAM_KEY_MAP = {
+        temperature: :temperature,
+        top_p: :topP,
+        top_k: :topK,
+        max_tokens: :maxOutputTokens,
+        max_output_tokens: :maxOutputTokens,
+        candidate_count: :candidateCount,
+        stop_sequences: :stopSequences
+      }.freeze
+
       def generate_content(prompt)
         content = format_content(prompt)
         parts = build_parts_for_gemini(content)
@@ -25,10 +36,28 @@ module LlmConductor
           ]
         }
 
+        # Inject generationConfig from params when present
+        generation_config = build_generation_config
+        payload[:generationConfig] = generation_config if generation_config
+
         response = client.generate_content(payload)
         response.dig('candidates', 0, 'content', 'parts', 0, 'text')
       end
 
+      # Build Gemini generationConfig from params hash.
+      # Maps snake_case Ruby keys to camelCase Gemini API keys.
+      # @return [Hash, nil] generationConfig hash or nil if no mapped params
+      def build_generation_config
+        return unless params.is_a?(Hash) && params.any?
+
+        gen_cfg = {}
+        params.each do |key, value|
+          mapped = PARAM_KEY_MAP[key.to_sym]
+          gen_cfg[mapped] = value if mapped
+        end
+        gen_cfg.any? ? gen_cfg : nil
+      end
+
       # Build parts array for Gemini API from formatted content
       # Converts VisionSupport format to Gemini's specific format
       # @param content [String, Array] Formatted content from VisionSupport

data/lib/llm_conductor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmConductor
-  VERSION = '1.5.0'
+  VERSION = '1.6.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: llm_conductor
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Ben Zheng
 bindir: exe
 cert_chain: []
-date: 2025-12-12 00:00:00.000000000 Z
+date: 2026-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport