lex-llm-gateway 0.2.9 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bce7fb746d14ff63db46cb4fc87613a5a0834c61e5e067dc4e5bf6122dbd251a
-  data.tar.gz: 2d7c0d14bef999fece93d633dd74c700d2594e76d1aae216a2afd3b51f13a534
+  metadata.gz: ec3993ccaff02e74801eabda29562ec7fc052f00bced5691c39979a66ba042c3
+  data.tar.gz: ca9beca2c4aed4be7330d3ff0d1bb7e518baa5cf9eef6143523f9901cf3cfdb2
 SHA512:
-  metadata.gz: 488014e8667b9782d18a56dee95250ce8869aff2f9d9e0a5254d77f3d6a5ffd9a1cea802c66766fa50da1e2fa0b5801fb6b1b17b460dfb39305ddd3eaa2aeb81
-  data.tar.gz: a65be2e6996f18b98cbdafb3f1e6145671a6eb4f37f63e7b6e500e272d8d16ba26e5414f32489cd5569c16c6881c17dab601833f1eae5edf2516c177077e54f3
+  metadata.gz: 749ba30872386e9742164031dcc1406dba20f83b5ce75ff5651a123ad78f40dec00122ec9743b6c40abe8aeaaf6f9c354f279acd2a5b61159025eea185f0a52e
+  data.tar.gz: d441d032fef3841e958c8ded65b6c1f825c042c0b804629fae561ffd268cec2951a1f3babb5ce67d4df0b9776cf35f2dcbb65e7a65d76cfae834f0447bbde542

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.10] - 2026-03-23
+
+### Added
+- ProviderStats runner: health_report, provider_detail, circuit_summary for LLM provider observability
+- Reports circuit breaker state, routing adjustment, and health status per provider
+- 5 specs covering report generation, detail, circuit summary, and fallback behavior
+
 ## [0.2.9] - 2026-03-23
 
 ### Added

data/lib/legion/extensions/llm/gateway/runners/provider_stats.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module LLM
+      module Gateway
+        module Runners
+          module ProviderStats
+            module_function
+
+            def health_report
+              return unavailable_result unless router_available?
+
+              tracker = health_tracker
+              providers = known_providers
+              providers.map { |name| provider_entry(name, tracker) }
+            end
+
+            def provider_detail(provider:)
+              return unavailable_result unless router_available?
+
+              provider_entry(provider, health_tracker)
+            end
+
+            def circuit_summary
+              return unavailable_result unless router_available?
+
+              tracker = health_tracker
+              providers = known_providers
+              {
+                total: providers.size,
+                closed: providers.count { |p| tracker.circuit_state(p) == :closed },
+                open: providers.count { |p| tracker.circuit_state(p) == :open },
+                half_open: providers.count { |p| tracker.circuit_state(p) == :half_open }
+              }
+            end
+
+            def router_available?
+              defined?(Legion::LLM::Router) &&
+                Legion::LLM::Router.respond_to?(:routing_enabled?) &&
+                Legion::LLM::Router.routing_enabled?
+            end
+
+            def health_tracker
+              Legion::LLM::Router.health_tracker
+            end
+
+            def known_providers
+              return [] unless defined?(Legion::Settings)
+
+              providers = Legion::Settings.dig(:llm, :providers)
+              return [] unless providers.is_a?(Hash)
+
+              providers.select { |_, cfg| cfg.is_a?(Hash) && cfg[:enabled] }
+                       .keys
+                       .map(&:to_sym)
+            rescue StandardError
+              []
+            end
+
+            def provider_entry(name, tracker)
+              {
+                provider: name.to_s,
+                circuit: tracker.circuit_state(name).to_s,
+                adjustment: tracker.adjustment(name),
+                healthy: tracker.circuit_state(name) != :open
+              }
+            end
+
+            def unavailable_result
+              { success: false, error: 'router_not_available' }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module LLM
       module Gateway
-        VERSION = '0.2.9'
+        VERSION = '0.2.10'
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-gateway
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.2.10
 platform: ruby
 authors:
 - Esity
@@ -191,6 +191,7 @@ files:
 - lib/legion/extensions/llm/gateway/runners/inference.rb
 - lib/legion/extensions/llm/gateway/runners/metering.rb
 - lib/legion/extensions/llm/gateway/runners/metering_writer.rb
+- lib/legion/extensions/llm/gateway/runners/provider_stats.rb
 - lib/legion/extensions/llm/gateway/runners/usage_reporter.rb
 - lib/legion/extensions/llm/gateway/transport/exchanges/inference.rb
 - lib/legion/extensions/llm/gateway/transport/exchanges/metering.rb