lex-llm-gemini 0.3.0 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5809a1fe2d0614ca09803118c54d0bf53d86253c5877a60e9e8607974f9ba09
-  data.tar.gz: 51b3697e7ecd2f87e030b180878fe23052e22a67b20e7f89ab635e503db2d019
+  metadata.gz: dc50ce20a2bc5b62e79854004feee5aa14ee1d26a8dfee8698a37f387d72392c
+  data.tar.gz: ef401f8e9fa5a521a3b5930e835a6aa11b707ed2dd7c304e51115a27b1ba1732
 SHA512:
-  metadata.gz: 155271bed61b4a5daf51c364721350f4f58f4c9bf1277e1d889f0a19996772af855f75d63ecd26b99b1ea3f4a2a9fc65092508c612d1f0ec88792f0eaa8789ae
-  data.tar.gz: 2f52cc4ef38d97f53709ef9222e89b60b16487a5fa7b76e070d11a3eff7c8e5bb6b50b75bd03ee15997ea9d7c54232137202364d40d03c3448a2400aa8f222fa
+  metadata.gz: 03bb48c71874f80bcad9739a59e0d7d0377aa935bee79e8fe0eb3a2dff8f700537ac480a406a86b1f21f3e35a1dc3401c1443e3004ecec3de6aa9c044f8b89ce
+  data.tar.gz: 3c650b57f45a6cc93f1634595dc0fc14926526bd666ab57e7c824e11e889fc0ce44b4494b8b95729303170b8a29e98e31221d1d4afc3953957ae3095c91d6543

data/.github/workflows/ci.yml

@@ -8,8 +8,20 @@ jobs:
   ci:
     uses: LegionIO/.github/.github/workflows/ci.yml@main
 
+  excluded-files:
+    uses: LegionIO/.github/.github/workflows/excluded-files.yml@main
+
+  security:
+    uses: LegionIO/.github/.github/workflows/security-scan.yml@main
+
+  version-changelog:
+    uses: LegionIO/.github/.github/workflows/version-changelog.yml@main
+
+  dependency-review:
+    uses: LegionIO/.github/.github/workflows/dependency-review.yml@main
+
   release:
-    needs: ci
+    needs: [ci, excluded-files, security]
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     uses: LegionIO/.github/.github/workflows/release.yml@main
     secrets:

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.3.6 - 2026-05-06
+
+- Load provider-owned fleet actors through the LegionIO subscription base and the canonical Gemini provider root.
+- Keep fleet runners anchored on the provider root namespace so provider constants and instance discovery are always loaded.
+- Strip temporary generic API key fields from discovered Gemini instance configs after credential deduplication.
+- Gate release publishing on the shared security workflow.
+
+## 0.3.5 - 2026-05-06
+
+- Keep the default Gemini endpoint on the versioned `v1beta` API base when instance settings are normalized.
+- Refresh the README for the current `lex-llm >= 0.4.3` provider registry and fleet responder boundary.
+
+## 0.3.4 - 2026-05-06
+
+- Use the shared `lex-llm` fleet provider responder helper for provider-owned fleet workers.
+- Remove the runtime `legion-llm` dependency and require `lex-llm >= 0.4.3` for responder-side fleet execution.
+
+## 0.3.3 - 2026-05-06
+
+- Remove require-time provider self-registration; `legion-llm` now owns adapter creation and registry writes from loaded provider discovery metadata.
+- Bump dependency floors to `lex-llm >= 0.4.1` and `legion-llm >= 0.9.1`.
+
+## 0.3.2 - 2026-05-06
+
+- Add provider contract specs for the shared keyword-only `lex-llm` provider API.
+- Move Gemini defaults back to `Legion::Extensions::Llm.provider_settings` with credentials and instance-level fleet responder settings.
+- Add provider-owned fleet responder actor and runner backed by `legion-llm` fleet policy execution.
+- Bump the transport dependency floor to `legion-transport >= 1.4.14`.
+
+## 0.3.1 - 2026-05-03
+
+- Normalize generic settings keys to Gemini provider config keys during instance discovery.
+
 ## 0.3.0 - 2026-05-01
 
 - Add auto-discovery via CredentialSources and AutoRegistration from lex-llm 0.3.0

data/Gemfile

@@ -4,6 +4,8 @@ source 'https://rubygems.org'
 
 group :test do
   llm_base_path = ENV.fetch('LEX_LLM_PATH', File.expand_path('../lex-llm', __dir__))
+  transport_path = ENV.fetch('LEGION_TRANSPORT_PATH', File.expand_path('../../legion-transport', __dir__))
+  gem 'legion-transport', path: transport_path if File.directory?(transport_path)
   gem 'lex-llm', path: llm_base_path if File.directory?(llm_base_path)
 end
 

data/README.md

@@ -2,7 +2,7 @@
 
 LegionIO LLM provider extension for Google Gemini.
 
-This gem lives under `Legion::Extensions::Llm::Gemini` and depends on `lex-llm` for shared provider-neutral routing, fleet, and schema primitives.
+This gem lives under `Legion::Extensions::Llm::Gemini` and depends on `lex-llm >= 0.4.3` for shared provider-neutral routing, response normalization, fleet responder execution, and schema primitives. It does not require or call `legion-llm` at runtime; `legion-llm` owns adapter creation, routing, and registry writes after discovering loaded `lex-llm-*` provider gems.
 
 Load it with `require 'legion/extensions/llm/gemini'`.
 
@@ -21,12 +21,10 @@ Load it with `require 'legion/extensions/llm/gemini'`.
 
 | Path | Purpose |
 |------|---------|
-| `lib/legion/extensions/llm/gemini.rb` | Entry point; provider registration |
+| `lib/legion/extensions/llm/gemini.rb` | Entry point; provider discovery metadata and defaults |
 | `lib/legion/extensions/llm/gemini/provider.rb` | Gemini provider (chat, streaming, models, embeddings) |
-| `lib/legion/extensions/llm/gemini/registry_event_builder.rb` | Builds sanitized lex-llm registry event envelopes |
-| `lib/legion/extensions/llm/gemini/registry_publisher.rb` | Best-effort async publisher for model availability events |
-| `lib/legion/extensions/llm/gemini/transport/exchanges/llm_registry.rb` | `llm.registry` AMQP topic exchange |
-| `lib/legion/extensions/llm/gemini/transport/messages/registry_event.rb` | AMQP message wrapper for registry events |
+| `lib/legion/extensions/llm/gemini/actors/fleet_worker.rb` | Provider-owned fleet subscription actor |
+| `lib/legion/extensions/llm/gemini/runners/fleet_worker.rb` | Fleet runner delegating to `Legion::Extensions::Llm::Fleet::ProviderResponder` |
 | `lib/legion/extensions/llm/gemini/version.rb` | `VERSION` constant |
 
 ## Defaults
@@ -59,21 +57,39 @@ Legion::Extensions::Llm.configure do |config|
 end
 ```
 
+## Fleet Responder
+
+Provider instances can opt in to consuming Legion LLM fleet requests. The provider-owned fleet actor only starts when at least one discovered instance enables `fleet.respond_to_requests`, and execution delegates to `Legion::Extensions::Llm::Fleet::ProviderResponder` from `lex-llm`.
+
+```yaml
+extensions:
+  llm:
+    gemini:
+      instances:
+        local:
+          fleet:
+            enabled: true
+            respond_to_requests: true
+            capabilities:
+              - chat
+              - stream_chat
+              - embed
+```
+
 ## Observability
 
-Every module and class includes or extends `Legion::Logging::Helper`:
+The Gemini entry point and provider use `Legion::Logging::Helper`:
 
-- **Info-level logging** on `list_models` and registry event publishing.
-- **All rescue blocks** call `handle_exception(e, level:, handled:, operation:)` for structured exception telemetry.
-- Registry publishing is best-effort; failures are handled at `:debug` or `:warn` level and never block the caller.
+- `list_models` logs model discovery activity and publishes availability through the shared `lex-llm` registry publisher.
+- Fleet request execution is delegated to the shared responder helper so acking, response publishing, and responder failures stay inside the provider-neutral fleet boundary.
+- Registry publishing is best-effort and must not block provider calls when transport is unavailable.
 
 ## Development
 
 ```bash
 bundle install
-bundle exec rspec       # 0 failures
-bundle exec rubocop -A  # auto-fix
-bundle exec rubocop     # lint check
+bundle exec rspec --format json --out tmp/rspec_results.json --format progress --out tmp/rspec_progress.txt
+bundle exec rubocop -A
 ```
 
 ## License

data/lex-llm-gemini.gemspec

@@ -26,5 +26,6 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'legion-json', '>= 1.2.1'
   spec.add_dependency 'legion-logging', '>= 1.3.2'
   spec.add_dependency 'legion-settings', '>= 1.3.14'
-  spec.add_dependency 'lex-llm', '>= 0.3.0'
+  spec.add_dependency 'legion-transport', '>= 1.4.14'
+  spec.add_dependency 'lex-llm', '>= 0.4.3'
 end

data/lib/legion/extensions/llm/gemini/actors/fleet_worker.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+begin
+  require 'legion/extensions/actors/subscription'
+rescue LoadError => e
+  warn(e.message) if $VERBOSE
+end
+
+unless defined?(Legion::Extensions::Actors::Subscription)
+  raise LoadError, 'LegionIO actor runtime is required for Gemini fleet worker'
+end
+
+require 'legion/extensions/llm/gemini'
+require 'legion/extensions/llm/fleet/provider_responder'
+
+module Legion
+  module Extensions
+    module Llm
+      module Gemini
+        module Actor
+          # Subscription actor for Gemini fleet request consumption.
+          class FleetWorker < Legion::Extensions::Actors::Subscription
+            def runner_class
+              'Legion::Extensions::Llm::Gemini::Runners::FleetWorker'
+            end
+
+            def runner_function
+              'handle_fleet_request'
+            end
+
+            def use_runner?
+              false
+            end
+
+            def enabled?
+              Legion::Extensions::Llm::Fleet::ProviderResponder.enabled_for?(Gemini.discover_instances)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/gemini/runners/fleet_worker.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/llm/fleet/provider_responder'
+require 'legion/extensions/llm/gemini'
+
+module Legion
+  module Extensions
+    module Llm
+      module Gemini
+        module Runners
+          # Runner entrypoint for Gemini fleet request execution.
+          module FleetWorker
+            module_function
+
+            def handle_fleet_request(payload, delivery: nil, properties: nil)
+              Legion::Extensions::Llm::Fleet::ProviderResponder.call(
+                payload: payload,
+                provider_family: Gemini::PROVIDER_FAMILY,
+                provider_class: Gemini::Provider,
+                provider_instances: -> { Gemini.discover_instances },
+                delivery: delivery,
+                properties: properties
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/gemini/version.rb

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Llm
       module Gemini
-        VERSION = '0.3.0'
+        VERSION = '0.3.6'
       end
     end
   end

data/lib/legion/extensions/llm/gemini.rb

@@ -17,16 +17,26 @@ module Legion
         PROVIDER_FAMILY = :gemini
 
         def self.default_settings
-          {
-            enabled: false,
-            default_model: 'gemini-2.0-flash',
-            api_key: nil,
-            model_whitelist: [],
-            model_blacklist: [],
-            model_cache_ttl: 3600,
-            tls: { enabled: false, verify: :peer },
-            instances: {}
-          }
+          ::Legion::Extensions::Llm.provider_settings(
+            family: PROVIDER_FAMILY,
+            instance: {
+              endpoint: 'https://generativelanguage.googleapis.com/v1beta',
+              default_model: 'gemini-2.0-flash',
+              tier: :frontier,
+              transport: :http,
+              credentials: { api_key: 'env://GEMINI_API_KEY' },
+              usage: { inference: true, embedding: true, image: false },
+              limits: { concurrency: 4 },
+              fleet: {
+                enabled: false,
+                respond_to_requests: false,
+                capabilities: %i[chat stream_chat embed],
+                lanes: [],
+                concurrency: 4,
+                queue_suffix: nil
+              }
+            }
+          )
         end
 
         def self.provider_class
@@ -37,7 +47,7 @@ module Legion
           candidates = {}
           discover_from_env(candidates)
           discover_from_settings(candidates)
-          CredentialSources.dedup_credentials(candidates)
+          CredentialSources.dedup_credentials(candidates).transform_values { |config| sanitize_instance_config(config) }
         end
 
         def self.discover_from_env(candidates)
@@ -59,23 +69,46 @@ module Legion
           api_key = cfg[:api_key] || cfg['api_key']
           return if api_key.nil? || api_key.to_s.strip.empty?
 
-          candidates[:settings] = { api_key: api_key, gemini_api_key: api_key, tier: :cloud }
+          candidates[:settings] = normalize_instance_config(cfg).merge(api_key: api_key,
+                                                                       gemini_api_key: api_key,
+                                                                       tier: :cloud)
         end
 
         def self.add_settings_instances(candidates, cfg)
           instances = cfg[:instances] || cfg['instances']
           return unless instances.is_a?(Hash)
 
-          instances.each { |name, config| candidates[name.to_sym] = config.merge(tier: :cloud) }
+          instances.each do |name, config|
+            next unless config.is_a?(Hash)
+
+            normalized = normalize_instance_config(config)
+            next unless normalized[:gemini_api_key]
+
+            normalized[:api_key] = normalized[:gemini_api_key]
+            candidates[name.to_sym] = normalized.merge(tier: :cloud)
+          end
+        end
+
+        def self.normalize_instance_config(config) # rubocop:disable Metrics/AbcSize
+          normalized = config.to_h.transform_keys { |key| key.respond_to?(:to_sym) ? key.to_sym : key }
+          normalized[:gemini_api_key] ||= normalized.delete(:api_key)
+          normalized[:gemini_api_base] ||= normalized.delete(:base_url)
+          normalized[:gemini_api_base] ||= normalized.delete(:api_base)
+          normalized[:gemini_api_base] ||= normalized.delete(:endpoint)
+          normalized.compact.except(:instances)
+        end
+
+        def self.sanitize_instance_config(config)
+          config.except(:api_key)
         end
 
         private_class_method :discover_from_env, :discover_from_settings,
-                             :add_settings_api_key, :add_settings_instances
-      end
+                             :add_settings_api_key, :add_settings_instances, :normalize_instance_config,
+                             :sanitize_instance_config
 
-      Configuration.register_provider_options(Gemini::Provider.configuration_options)
+        Legion::Extensions::Llm::Configuration.register_provider_options(Provider.configuration_options) if
+          Legion::Extensions::Llm::Configuration.respond_to?(:register_provider_options)
+      end
     end
   end
 end
-
-Legion::Extensions::Llm::Gemini.register_discovered_instances

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-gemini
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.6
 platform: ruby
 authors:
 - LegionIO
@@ -51,20 +51,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.14
 - !ruby/object:Gem::Dependency
   name: lex-llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.3
 description: Gemini provider integration for the LegionIO LLM routing framework.
 email:
 - matthewdiverson@gmail.com
@@ -83,7 +97,9 @@ files:
 - README.md
 - lex-llm-gemini.gemspec
 - lib/legion/extensions/llm/gemini.rb
+- lib/legion/extensions/llm/gemini/actors/fleet_worker.rb
 - lib/legion/extensions/llm/gemini/provider.rb
+- lib/legion/extensions/llm/gemini/runners/fleet_worker.rb
 - lib/legion/extensions/llm/gemini/version.rb
 homepage: https://github.com/LegionIO/lex-llm-gemini
 licenses: