lex-llm-gemini 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4a35ee0fc2182185d444789b3bd23581e9e2b89cd9998299b5492e2e241236b
-  data.tar.gz: f0c9b84a6fe7bc3889646aeb856ff0484b4cf0216ea8f949cf01247e6d3b0ff0
+  metadata.gz: 3b4d2bbf521fe7cd5757553aff5a6d61c1a9e9ffbe18c683058710ab19a8a6ff
+  data.tar.gz: 98d0db7b428b68d0543682c43a27d77fde00aee8bb02377195c37224e9429fef
 SHA512:
-  metadata.gz: fe8ffa42e7427aaffa21453ae6edc5abfd755d483a9f63a061ef3a839f8dc47374478a4339c212b0891938e4574cd9ac68a53f2c2ff072ff5f59d5f3a1a4a49a
-  data.tar.gz: d56491f783d2d71029aa8cce971d825f1ed5388317f18b8d77883082ad239727c8c1976ccf93d22acb5b5eda5768e15ccd4e0867fecd378f00896e9c227bae87
+  metadata.gz: c40e3408f31507e4de8622e65676a2eb67849a05964dee02585545647563a4655fe808a3673782b1819bc7828a1f9fd3af900aa57ce09f6119ba28caefe01813
+  data.tar.gz: bacceead0f9edceed7da8efb605fe516f0ea7110c57f47cf8b16bad77805e74d8a1a99d37ffec056fa4affdd2c4e6a30f45c7a5812c03221182038373a45c784

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.1.7 - 2026-04-30
+
+- Audit logging, rescue blocks, and README for full observability.
+- Add `Legion::Logging::Helper` to every module and class in lib/.
+- Replace all bare rescue blocks and custom `log_publish_failure` with `handle_exception(e, level:, handled:, operation:)`.
+- Add info-level action logging for model listing and registry publishing.
+- Update README to reflect registry event publishing and observability patterns.
+
+## 0.1.6 - 2026-04-28
+
+- Publish best-effort `llm.registry` discovered-model availability events when transport is already loaded.
+
 ## 0.1.5 - 2026-04-28
 
 - Require current shared Legion JSON, logging, settings, and `lex-llm >= 0.1.5` runtime dependencies.

data/README.md

@@ -1,6 +1,6 @@
 # lex-llm-gemini
 
-LegionIO LLM provider extension for Gemini.
+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.
 
@@ -10,11 +10,24 @@ Load it with `require 'legion/extensions/llm/gemini'`.
 
 - `Legion::Extensions::Llm::Provider` registration as `:gemini`
 - Gemini-native chat requests through `POST /v1beta/{model=models/*}:generateContent`
-- streaming chat support through `POST /v1beta/{model=models/*}:streamGenerateContent?alt=sse`
-- model discovery through `GET /v1beta/models`
-- embeddings through `POST /v1beta/{model=models/*}:embedContent`
-- normalized chat, streaming, vision, function calling, and embedding capability mapping from `supportedGenerationMethods`
-- shared fleet/default settings via `Legion::Extensions::Llm.provider_settings`
+- Streaming chat support through `POST /v1beta/{model=models/*}:streamGenerateContent?alt=sse`
+- Model discovery through `GET /v1beta/models`
+- Embeddings through `POST /v1beta/{model=models/*}:embedContent`
+- Normalized chat, streaming, vision, function calling, and embedding capability mapping from `supportedGenerationMethods`
+- Best-effort `llm.registry` availability events published to AMQP when transport is loaded
+- Shared fleet/default settings via `Legion::Extensions::Llm.provider_settings`
+
+## File Map
+
+| Path | Purpose |
+|------|---------|
+| `lib/legion/extensions/llm/gemini.rb` | Entry point; provider registration |
+| `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/version.rb` | `VERSION` constant |
 
 ## Defaults
 
@@ -45,3 +58,24 @@ Legion::Extensions::Llm.configure do |config|
   config.default_embedding_model = "gemini-embedding-001"
 end
 ```
+
+## Observability
+
+Every module and class includes or extends `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.
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec       # 0 failures
+bundle exec rubocop -A  # auto-fix
+bundle exec rubocop     # lint check
+```
+
+## License
+
+Apache-2.0

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

@@ -8,11 +8,19 @@ module Legion
       module Gemini
         # Gemini provider implementation for the Legion::Extensions::Llm base provider contract.
         class Provider < Legion::Extensions::Llm::Provider # rubocop:disable Metrics/ClassLength
+          include Legion::Logging::Helper if defined?(Legion::Logging::Helper)
+
           class << self
+            attr_writer :registry_publisher
+
             def slug = 'gemini'
             def configuration_options = %i[gemini_api_key gemini_api_base]
             def configuration_requirements = %i[gemini_api_key]
             def capabilities = Capabilities
+
+            def registry_publisher
+              @registry_publisher ||= RegistryPublisher.new
+            end
           end
 
           # Capability predicates for Gemini API models.
@@ -87,6 +95,14 @@ module Legion
             "#{model_path(model)}:embedContent"
           end
 
+          def list_models
+            log.info { 'listing available Gemini models' }
+            super.tap do |models|
+              log.info { "discovered #{models.size} Gemini model(s); publishing to registry" }
+              self.class.registry_publisher.publish_models_async(models, readiness: readiness(live: false))
+            end
+          end
+
           private
 
           def model_path(model)

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

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Gemini
+        # Builds sanitized lex-llm registry envelopes for Gemini provider state.
+        class RegistryEventBuilder
+          include Legion::Logging::Helper if defined?(Legion::Logging::Helper)
+
+          def model_available(model, readiness:)
+            registry_event_class.available(
+              model_offering(model),
+              runtime: runtime_metadata,
+              health: model_health(readiness),
+              metadata: model_metadata(model)
+            )
+          end
+
+          private
+
+          def model_offering(model)
+            {
+              provider_family: :gemini,
+              provider_instance: provider_instance,
+              transport: :http,
+              model: model.id,
+              usage_type: usage_type_for(model),
+              capabilities: Array(model.capabilities).map(&:to_sym),
+              limits: model_limits(model),
+              metadata: { lex: :llm_gemini, model_name: model.name }.compact
+            }
+          end
+
+          def model_health(readiness)
+            ready = readiness.fetch(:ready, true) == true
+            { ready:, status: ready ? :available : :degraded }
+          end
+
+          def model_metadata(model)
+            { extension: :lex_llm_gemini, provider: :gemini, model_type: model.type }
+          end
+
+          def runtime_metadata
+            { node: provider_instance }
+          end
+
+          def model_limits(model)
+            {
+              context_window: model.context_window,
+              max_output_tokens: model.max_output_tokens
+            }.compact
+          end
+
+          def usage_type_for(model)
+            model.type == 'embedding' ? :embedding : :inference
+          end
+
+          def provider_instance
+            configured_node = (::Legion::Settings.dig(:node, :canonical_name) if defined?(::Legion::Settings))
+            value = configured_node.to_s.strip
+            value.empty? ? :gemini : value.to_sym
+          rescue StandardError => e
+            handle_exception(e, level: :debug, handled: true, operation: 'gemini.registry.provider_instance')
+            :gemini
+          end
+
+          def registry_event_class
+            ::Legion::Extensions::Llm::Routing::RegistryEvent
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Gemini
+        # Best-effort publisher for Gemini provider availability events.
+        class RegistryPublisher
+          include Legion::Logging::Helper if defined?(Legion::Logging::Helper)
+
+          APP_ID = 'lex-llm-gemini'
+
+          def initialize(builder: RegistryEventBuilder.new)
+            @builder = builder
+          end
+
+          def publish_models_async(models, readiness:)
+            log.info { "publishing #{Array(models).size} model event(s) to llm.registry" }
+            schedule do
+              Array(models).each do |model|
+                publish_event(@builder.model_available(model, readiness:))
+              end
+            end
+          end
+
+          private
+
+          def schedule(&)
+            return false unless publishing_available?
+
+            Thread.new do
+              Thread.current.abort_on_exception = false
+              yield
+            rescue StandardError => e
+              handle_exception(e, level: :debug, handled: true, operation: 'gemini.registry.schedule_thread')
+            end
+          rescue StandardError => e
+            handle_exception(e, level: :debug, handled: true, operation: 'gemini.registry.schedule')
+            false
+          end
+
+          def publish_event(event)
+            return false unless publishing_available?
+
+            message_class.new(event:, app_id: APP_ID).publish(spool: false)
+          rescue StandardError => e
+            handle_exception(e, level: :warn, handled: true, operation: 'gemini.registry.publish_event')
+            false
+          end
+
+          def publishing_available?
+            return false unless registry_event_available?
+            return false unless transport_message_available?
+            return true unless defined?(::Legion::Transport::Connection)
+            return true unless ::Legion::Transport::Connection.respond_to?(:session_open?)
+
+            ::Legion::Transport::Connection.session_open?
+          rescue StandardError => e
+            handle_exception(e, level: :debug, handled: true, operation: 'gemini.registry.publishing_available?')
+            false
+          end
+
+          def registry_event_available?
+            defined?(::Legion::Extensions::Llm::Routing::RegistryEvent)
+          end
+
+          def transport_message_available?
+            return true if message_class_defined?
+            return false unless defined?(::Legion::Transport::Message) && defined?(::Legion::Transport::Exchange)
+
+            require 'legion/extensions/llm/gemini/transport/messages/registry_event'
+            message_class_defined?
+          rescue LoadError => e
+            handle_exception(e, level: :debug, handled: true, operation: 'gemini.registry.transport_load')
+            false
+          end
+
+          def message_class_defined?
+            defined?(::Legion::Extensions::Llm::Gemini::Transport::Messages::RegistryEvent)
+          end
+
+          def message_class
+            ::Legion::Extensions::Llm::Gemini::Transport::Messages::RegistryEvent
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/gemini/transport/exchanges/llm_registry.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Gemini
+        module Transport
+          module Exchanges
+            # Topic exchange for Gemini provider availability events.
+            class LlmRegistry < ::Legion::Transport::Exchange
+              def exchange_name
+                'llm.registry'
+              end
+
+              def default_type
+                'topic'
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/gemini/transport/messages/registry_event.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/llm/gemini/transport/exchanges/llm_registry'
+
+module Legion
+  module Extensions
+    module Llm
+      module Gemini
+        module Transport
+          module Messages
+            # Publishes lex-llm RegistryEvent envelopes to the llm.registry exchange.
+            class RegistryEvent < ::Legion::Transport::Message
+              def initialize(event:, **options)
+                super(**event.to_h.merge(options))
+              end
+
+              def exchange
+                Transport::Exchanges::LlmRegistry
+              end
+
+              def routing_key
+                @options[:routing_key] || "llm.registry.#{@options.fetch(:event_type)}"
+              end
+
+              def type
+                'llm.registry.event'
+              end
+
+              def app_id
+                @options[:app_id] || RegistryPublisher::APP_ID
+              end
+
+              def persistent # rubocop:disable Naming/PredicateMethod
+                false
+              end
+            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.1.5'
+        VERSION = '0.1.7'
       end
     end
   end

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

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/llm'
+require 'legion/extensions/llm/gemini/registry_event_builder'
+require 'legion/extensions/llm/gemini/registry_publisher'
 require 'legion/extensions/llm/gemini/provider'
 require 'legion/extensions/llm/gemini/version'
 
@@ -10,6 +12,7 @@ module Legion
       # Gemini provider extension namespace.
       module Gemini
         extend ::Legion::Extensions::Core if ::Legion::Extensions.const_defined?(:Core, false)
+        extend Legion::Logging::Helper if defined?(Legion::Logging::Helper)
 
         PROVIDER_FAMILY = :gemini
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-gemini
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - LegionIO
@@ -84,6 +84,10 @@ files:
 - lex-llm-gemini.gemspec
 - lib/legion/extensions/llm/gemini.rb
 - lib/legion/extensions/llm/gemini/provider.rb
+- lib/legion/extensions/llm/gemini/registry_event_builder.rb
+- lib/legion/extensions/llm/gemini/registry_publisher.rb
+- lib/legion/extensions/llm/gemini/transport/exchanges/llm_registry.rb
+- lib/legion/extensions/llm/gemini/transport/messages/registry_event.rb
 - lib/legion/extensions/llm/gemini/version.rb
 homepage: https://github.com/LegionIO/lex-llm-gemini
 licenses: