lex-llm-bedrock 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59c2c3fda768fc58435dbe327fd8314e4b9dbfdbdf978e9220e3ad4999e42bc1
-  data.tar.gz: 8b448d4dbb18e1c8d2d3dde0c817cc49591142d5bc88c6057cf8f8f28d3cab8d
+  metadata.gz: 5ec33f1d698328146833876f1b61387ad6523c88cd10c582c98202bb4f8dc72e
+  data.tar.gz: 0a4d8b1318967238535525779f4f37d623ae9c34db3f420a9f38869b4caddcf1
 SHA512:
-  metadata.gz: 47d5d1f35bd64d93db2e068b988a4ff9bb3d8622726f23cfe897b282f8cd1c4f454a44b82c170c04831c108226f373869121ac9a61f574bf023a13a8d9c92c8b
-  data.tar.gz: 2c9679fabbce22abde6a5f7e58da92c34e113afe5b6f166e3956ee6c91034f7178737e95897a93ba348750c85358822b3dc464841dfcbbf37d74ceb66469ef03
+  metadata.gz: 5ec0f51f96ded0783c297eec606e003a9f09c94dd83f351877fdeee5652eb0778d60842b7d43cebf505391fdd734d7bea071080e2c9d15268a746ecdeb984715
+  data.tar.gz: 55ac1281aabe5f8592ea643aebf457e79de527fdad49e47c8c7d685d30dfd0a04a86b09f3aaca27f0a3b8f4ae8211bf8c07d7fe27f8bae79b1167bba736a06e7

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.2 - 2026-04-28
+
+- Publish best-effort `llm.registry` live readiness and live foundation-model availability events using `lex-llm` registry envelopes when transport is already available.
+
+## 0.1.1 - 2026-04-28
+
+- Require `lex-llm >= 0.1.5` for the shared model offering, alias, readiness, and fleet lane contract used by Bedrock routing metadata.
+
 ## 0.1.0 - 2026-04-28
 
 - Initial Legion::Extensions::Llm Bedrock provider extension scaffold.

data/README.md

@@ -2,7 +2,7 @@
 
 Amazon Bedrock provider extension for `Legion::Extensions::Llm`.
 
-This gem adds a hosted Bedrock provider surface for Legion LLM routing without depending on the old `legion-llm` gem. It uses the official AWS SDK for Ruby and keeps discovery offline by default, so loading the extension or running tests does not require live AWS credentials.
+This gem adds a hosted Bedrock provider surface for Legion LLM routing without depending on the old `legion-llm` gem. It uses the official AWS SDK for Ruby and keeps discovery offline by default, so loading the extension or running tests does not require live AWS credentials. It requires `lex-llm >= 0.1.5` for the shared model offering, alias, readiness, and fleet lane contract.
 
 ## Install
 

data/lex-llm-bedrock.gemspec

@@ -28,5 +28,5 @@ 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.1.3'
+  spec.add_dependency 'lex-llm', '>= 0.1.5'
 end

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

@@ -26,6 +26,8 @@ module Legion
           ALIASES = STATIC_MODELS.to_h { |entry| [entry.fetch(:alias), entry.fetch(:model)] }.freeze
 
           class << self
+            attr_writer :registry_publisher
+
             def slug = 'bedrock'
 
             def configuration_options
@@ -43,6 +45,10 @@ module Legion
             def configuration_requirements = []
             def capabilities = Capabilities
 
+            def registry_publisher
+              @registry_publisher ||= RegistryPublisher.new
+            end
+
             def resolve_model_id(model_id, config: nil) # rubocop:disable Lint/UnusedMethodArgument
               ALIASES.fetch(model_id.to_s, model_id.to_s)
             end
@@ -83,7 +89,9 @@ module Legion
             return static_offerings(**filters) unless live
 
             response = bedrock_client.list_foundation_models(**filters)
-            Array(value(response, :model_summaries)).map { |summary| offering_from_summary(summary) }
+            Array(value(response, :model_summaries)).map { |summary| offering_from_summary(summary) }.tap do |offerings|
+              self.class.registry_publisher.publish_offerings_async(offerings, readiness: readiness(live: false))
+            end
           end
 
           def offering_for(model:, model_family: nil, instance_id: :default, **metadata)
@@ -116,7 +124,10 @@ module Legion
           end
 
           def readiness(live: false)
-            health(live: live).merge(local: false, remote: true, api_base: api_base, endpoints: endpoint_manifest)
+            health(live: live).merge(local: false, remote: true, api_base: api_base,
+                                     endpoints: endpoint_manifest).tap do |metadata|
+              self.class.registry_publisher.publish_readiness_async(metadata) if live
+            end
           end
 
           def list_models

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

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Bedrock
+        # Builds sanitized lex-llm registry envelopes for Bedrock provider state.
+        class RegistryEventBuilder
+          def readiness(readiness)
+            registry_event_class.public_send(
+              readiness[:ready] ? :available : :unavailable,
+              provider_offering(readiness),
+              runtime: runtime_metadata,
+              health: readiness_health(readiness),
+              metadata: readiness_metadata(readiness)
+            )
+          end
+
+          def offering_available(offering, readiness:)
+            registry_event_class.available(
+              offering,
+              runtime: runtime_metadata,
+              health: offering_health(readiness),
+              metadata: offering_metadata
+            )
+          end
+
+          private
+
+          def provider_offering(readiness)
+            {
+              provider_family: :bedrock,
+              provider_instance: provider_instance,
+              transport: :aws_sdk,
+              model: 'provider-readiness',
+              usage_type: :inference,
+              capabilities: [],
+              health: readiness_health(readiness),
+              metadata: { lex: :llm_bedrock, provider_readiness: true }
+            }
+          end
+
+          def readiness_health(readiness)
+            health = {
+              ready: readiness[:ready] == true,
+              status: readiness[:ready] ? :available : :unavailable,
+              checked: readiness[:checked] != false
+            }
+            add_readiness_error(health, readiness)
+          end
+
+          def add_readiness_error(health, source)
+            error_class = source[:error] || source['error']
+            error_message = source[:message] || source['message']
+            health[:error_class] = error_class if error_class
+            health[:error] = error_message if error_message
+            health
+          end
+
+          def offering_health(readiness)
+            ready = readiness.fetch(:ready, true) == true
+            { ready:, status: ready ? :available : :degraded, checked: readiness[:checked] != false }
+          end
+
+          def readiness_metadata(readiness)
+            {
+              extension: :lex_llm_bedrock,
+              provider: :bedrock,
+              configured: readiness[:configured] == true,
+              live: readiness[:live] == true
+            }
+          end
+
+          def offering_metadata
+            { extension: :lex_llm_bedrock, provider: :bedrock }
+          end
+
+          def runtime_metadata
+            { node: provider_instance }
+          end
+
+          def provider_instance
+            :bedrock
+          end
+
+          def registry_event_class
+            ::Legion::Extensions::Llm::Routing::RegistryEvent
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Bedrock
+        # Best-effort publisher for Bedrock provider availability events.
+        class RegistryPublisher
+          APP_ID = 'lex-llm-bedrock'
+
+          def initialize(builder: RegistryEventBuilder.new)
+            @builder = builder
+          end
+
+          def publish_readiness_async(readiness)
+            schedule { publish_event(@builder.readiness(readiness)) }
+          end
+
+          def publish_offerings_async(offerings, readiness:)
+            schedule do
+              Array(offerings).each do |offering|
+                publish_event(@builder.offering_available(offering, 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
+              log_publish_failure(e, level: :debug)
+            end
+          rescue StandardError => e
+            log_publish_failure(e, level: :debug)
+            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
+            log_publish_failure(e)
+            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
+            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/bedrock/transport/messages/registry_event'
+            message_class_defined?
+          rescue LoadError
+            false
+          end
+
+          def message_class_defined?
+            defined?(::Legion::Extensions::Llm::Bedrock::Transport::Messages::RegistryEvent)
+          end
+
+          def message_class
+            ::Legion::Extensions::Llm::Bedrock::Transport::Messages::RegistryEvent
+          end
+
+          def log_publish_failure(error, level: :warn)
+            message = "[lex-llm-bedrock] llm.registry publish failed: #{error.class}: #{error.message}"
+            logger = ::Legion::Extensions::Llm.logger if defined?(::Legion::Extensions::Llm)
+            if logger.respond_to?(level)
+              logger.public_send(level, message)
+            elsif logger.respond_to?(:debug)
+              logger.debug(message)
+            end
+          rescue StandardError
+            nil
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Bedrock
+        module Transport
+          module Exchanges
+            # Topic exchange for Bedrock 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/bedrock/transport/messages/registry_event.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/llm/bedrock/transport/exchanges/llm_registry'
+
+module Legion
+  module Extensions
+    module Llm
+      module Bedrock
+        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/bedrock/version.rb

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Llm
       module Bedrock
-        VERSION = '0.1.0'
+        VERSION = '0.1.2'
       end
     end
   end

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

@@ -2,6 +2,8 @@
 
 require 'legion/extensions/llm'
 require 'legion/extensions/llm/bedrock/provider'
+require 'legion/extensions/llm/bedrock/registry_event_builder'
+require 'legion/extensions/llm/bedrock/registry_publisher'
 require 'legion/extensions/llm/bedrock/version'
 
 module Legion

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-bedrock
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - LegionIO
@@ -85,14 +85,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.5
 description: Amazon Bedrock provider integration for the LegionIO LLM routing framework.
 email:
 - matthewdiverson@gmail.com
@@ -112,6 +112,10 @@ files:
 - lex-llm-bedrock.gemspec
 - lib/legion/extensions/llm/bedrock.rb
 - lib/legion/extensions/llm/bedrock/provider.rb
+- lib/legion/extensions/llm/bedrock/registry_event_builder.rb
+- lib/legion/extensions/llm/bedrock/registry_publisher.rb
+- lib/legion/extensions/llm/bedrock/transport/exchanges/llm_registry.rb
+- lib/legion/extensions/llm/bedrock/transport/messages/registry_event.rb
 - lib/legion/extensions/llm/bedrock/version.rb
 homepage: https://github.com/LegionIO/lex-llm-bedrock
 licenses: