lex-llm-ledger 0.1.10 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a595a76ee91def4ec66dc3ec9b1daa0c40f872704a73659981b8eecebf5bd48e
-  data.tar.gz: 2f1c5ff38e83093df3c88e39a9a6c376f13f9af97fa000126a2d24c51324e3f3
+  metadata.gz: c2578f6543e89f6517dd169b738f11ef3c0a8e3793ff53db790e57856be4c3be
+  data.tar.gz: 066ad9113ab48db944c88cc9d6eb9bf182ed54e236e2d4da6f3a0c67bd0cb6af
 SHA512:
-  metadata.gz: dd1e3ae7439152285ee97d681d72bf98131504ab81e0107bd1a4c3f254c6dc2b4738a8562725bfc8e16b2a3c5d2fe44eb94e8df418b422f9fb48d1f746a8d026
-  data.tar.gz: aebc36c406ece5b8c4c51e315eccd771dcca1d70589e776c2a64d5e24d7dd4c59ada66139760b5d8874fa6cbbb6ace87cb846cc8a22092daee77afab0272d6d9
+  metadata.gz: 66a82c200a5065aa1940f46a88d1ec362d6e33b2d0ad0de03f24e8676deaa50bd05feef840cd56ca3b111c5ddec4a8008cf728ac137471e946bdbbea046cc27e
+  data.tar.gz: a11134e1bd78a4bcca41494e1fc1b119c56be21525ab180c92332cce0ea4f457f51b5c4ac092b40f6f88a63f058dd3857b72598daa51c9cc14abb31daf3c2f32

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.1.12] - 2026-04-28
+
+### Added
+- Persist provider-neutral `llm.registry` availability event envelopes for offering, worker, lane, model, runtime, capacity, and health diagnostics
+- Add ledger-owned passive `llm.registry` transport exchange, durable registry availability queue, and subscription actor
+
+## [0.1.11] - 2026-04-28
+
+### Fixed
+- Replace the retired `legion-llm` runtime dependency with `lex-llm`
+- Define ledger-owned passive `llm.metering` and `llm.audit` exchange classes for transport bindings
+
 ## [0.1.10] - 2026-04-27
 
 ### Fixed

data/Gemfile

@@ -1,6 +1,12 @@
 # frozen_string_literal: true
 
 source 'https://rubygems.org'
+
+group :test do
+  llm_base_path = ENV.fetch('LEX_LLM_PATH', File.expand_path('../lex-llm', __dir__))
+  gem 'lex-llm', path: llm_base_path if File.directory?(llm_base_path)
+end
+
 gemspec
 
 gem 'rubocop-legion', '~> 0.1', require: false

data/lex-llm-ledger.gemspec

@@ -30,10 +30,10 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'legion-data',      '>= 1.6'
   spec.add_dependency 'legion-json',      '>= 1.2'
-  spec.add_dependency 'legion-llm',       '>= 0.6'
   spec.add_dependency 'legion-logging',   '>= 1.3'
   spec.add_dependency 'legion-settings',  '>= 1.3'
   spec.add_dependency 'legion-transport', '>= 1.4'
+  spec.add_dependency 'lex-llm',          '>= 0.1.5'
 
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rubocop'

data/lib/legion/extensions/llm/ledger/actors/registry_availability_writer.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/subscription'
+require_relative '../helpers/subscription_message'
+
+module Legion
+  module Extensions
+    module Llm
+      module Ledger
+        module Actor
+          class RegistryAvailabilityWriter < Legion::Extensions::Actors::Subscription
+            def runner_class = Legion::Extensions::Llm::Ledger::Runners::RegistryAvailability
+
+            def runner_function
+              'write_registry_availability_record'
+            end
+
+            def use_runner?
+              false
+            end
+
+            def process_message(message, metadata, delivery_info)
+              Helpers::SubscriptionMessage.decode_payload(message, metadata, delivery_info)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/ledger/migrations/004_create_registry_availability_records.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+Sequel.migration do # rubocop:disable Metrics/BlockLength
+  change do
+    create_table(:registry_availability_records) do
+      primary_key :id
+
+      String   :event_id, null: false, unique: true
+      String   :message_id
+      String   :correlation_id
+      String   :routing_key
+      String   :event_type,        null: false
+      String   :occurred_at,       null: false
+      String   :offering_id
+      String   :provider_family
+      String   :provider_instance
+      String   :instance_id
+      String   :model_family
+      String   :model_id
+      String   :canonical_model
+      String   :provider_model
+      String   :usage_type
+      String   :transport
+      String   :lane_key
+      String   :worker_id
+      String   :node_id
+      String   :offering_json,     null: false, text: true
+      String   :runtime_json,      null: false, text: true
+      String   :capacity_json,     null: false, text: true
+      String   :health_json,       null: false, text: true
+      String   :lane_json,         null: false, text: true
+      String   :metadata_json,     null: false, text: true
+      DateTime :inserted_at,       null: false, default: Sequel::CURRENT_TIMESTAMP
+
+      index [:event_type]
+      index [:occurred_at]
+      index [:offering_id]
+      index [:provider_family]
+      index [:provider_instance]
+      index %i[provider_family model_id]
+      index [:lane_key]
+      index [:worker_id]
+      index [:node_id]
+      index [:inserted_at]
+    end
+  end
+end

data/lib/legion/extensions/llm/ledger/runners/registry_availability.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Ledger
+        module Runners
+          module RegistryAvailability
+            extend self
+
+            def write_registry_availability_record(payload = nil, metadata = {}, **message)
+              payload, metadata = normalize_runner_args(payload, metadata, message)
+              props = metadata[:properties] || {}
+
+              body = symbolize(payload)
+              record = build_registry_availability_record(body, props)
+              ::Legion::Data::DB[:registry_availability_records].insert(record)
+              { result: :ok }
+            rescue Sequel::UniqueConstraintViolation => _e
+              { result: :duplicate }
+            rescue StandardError => e
+              Legion::Logging.error("[lex-llm-ledger] write_registry_availability_record failed: #{e.message}") # rubocop:disable Legion/HelperMigration/DirectLogging
+              { result: :error, error: e.message }
+            end
+
+            private
+
+            def normalize_runner_args(payload, metadata, message)
+              Helpers::SubscriptionMessage.runner_args(payload, metadata, message)
+            end
+
+            def build_registry_availability_record(body, props)
+              offering = body[:offering] || {}
+              runtime = body[:runtime] || {}
+              lane = body[:lane]
+
+              {
+                event_id:          body[:event_id],
+                message_id:        props[:message_id],
+                correlation_id:    props[:correlation_id],
+                routing_key:       props[:routing_key],
+                event_type:        body[:event_type].to_s,
+                occurred_at:       body[:occurred_at],
+                offering_id:       offering[:offering_id],
+                provider_family:   offering[:provider_family]&.to_s,
+                provider_instance: offering[:provider_instance]&.to_s,
+                instance_id:       offering[:instance_id]&.to_s,
+                model_family:      offering[:model_family]&.to_s,
+                model_id:          offering[:model],
+                canonical_model:   offering[:canonical_model_alias],
+                provider_model:    offering[:provider_model],
+                usage_type:        offering[:usage_type]&.to_s,
+                transport:         offering[:transport]&.to_s,
+                lane_key:          lane_key(lane),
+                worker_id:         runtime[:worker_id] || runtime[:worker],
+                node_id:           runtime[:node_id] || runtime[:host_id],
+                offering_json:     json_dump(offering),
+                runtime_json:      json_dump(runtime),
+                capacity_json:     json_dump(body[:capacity] || {}),
+                health_json:       json_dump(body[:health] || {}),
+                lane_json:         json_dump(lane || {}),
+                metadata_json:     json_dump(body[:metadata] || {}),
+                inserted_at:       Time.now.utc
+              }
+            end
+
+            def lane_key(lane)
+              if lane.is_a?(String)
+                lane
+              elsif lane.is_a?(Hash)
+                lane[:key] || lane[:lane_key]
+              end
+            end
+
+            def json_dump(value)
+              Legion::JSON.dump(json_safe(value)) # rubocop:disable Legion/HelperMigration/DirectJson
+            end
+
+            def json_safe(value)
+              case value
+              when Hash
+                value.to_h { |key, nested| [key.to_s, json_safe(nested)] }
+              when Array
+                value.map { |nested| json_safe(nested) }
+              when Symbol
+                value.to_s
+              else
+                value
+              end
+            end
+
+            def symbolize(value)
+              case value
+              when Hash
+                value.to_h { |key, nested| [key.to_sym, symbolize(nested)] }
+              when Array
+                value.map { |nested| symbolize(nested) }
+              else
+                value
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/ledger/transport/exchanges/audit.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Ledger
+        module Transport
+          module Exchanges
+            class Audit < ::Legion::Transport::Exchange
+              def exchange_name
+                'llm.audit'
+              end
+
+              def default_type
+                'topic'
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/ledger/transport/exchanges/metering.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Ledger
+        module Transport
+          module Exchanges
+            class Metering < ::Legion::Transport::Exchange
+              def exchange_name
+                'llm.metering'
+              end
+
+              def default_type
+                'topic'
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/ledger/transport/exchanges/registry.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Ledger
+        module Transport
+          module Exchanges
+            class Registry < ::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/ledger/transport/queues/registry_availability.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Llm
+      module Ledger
+        module Transport
+          module Queues
+            class RegistryAvailability < Legion::Transport::Queue
+              def queue_name
+                'llm.registry.availability'
+              end
+
+              def queue_options
+                { durable: true }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/llm/ledger/transport/transport.rb

@@ -1,8 +1,9 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/transport'
-require 'legion/llm/transport/exchanges/metering'
-require 'legion/llm/transport/exchanges/audit'
+require_relative 'exchanges/metering'
+require_relative 'exchanges/audit'
+require_relative 'exchanges/registry'
 
 module Legion
   module Extensions
@@ -14,19 +15,24 @@ module Legion
           def self.additional_e_to_q
             [
               {
-                from:        Legion::LLM::Transport::Exchanges::Metering,
+                from:        Legion::Extensions::Llm::Ledger::Transport::Exchanges::Metering,
                 to:          Legion::Extensions::Llm::Ledger::Transport::Queues::MeteringWrite,
                 routing_key: 'metering.#'
               },
               {
-                from:        Legion::LLM::Transport::Exchanges::Audit,
+                from:        Legion::Extensions::Llm::Ledger::Transport::Exchanges::Audit,
                 to:          Legion::Extensions::Llm::Ledger::Transport::Queues::AuditPrompts,
                 routing_key: 'audit.prompt.#'
               },
               {
-                from:        Legion::LLM::Transport::Exchanges::Audit,
+                from:        Legion::Extensions::Llm::Ledger::Transport::Exchanges::Audit,
                 to:          Legion::Extensions::Llm::Ledger::Transport::Queues::AuditTools,
                 routing_key: 'audit.tool.#'
+              },
+              {
+                from:        Legion::Extensions::Llm::Ledger::Transport::Exchanges::Registry,
+                to:          Legion::Extensions::Llm::Ledger::Transport::Queues::RegistryAvailability,
+                routing_key: '#'
               }
             ]
           end

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Llm
       module Ledger
-        VERSION = '0.1.10'
+        VERSION = '0.1.12'
       end
     end
   end

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

@@ -10,21 +10,21 @@ require_relative 'ledger/runners/prompts'
 require_relative 'ledger/runners/tools'
 require_relative 'ledger/runners/usage_reporter'
 require_relative 'ledger/runners/provider_stats'
+require_relative 'ledger/runners/registry_availability'
 
 if Legion::Extensions.const_defined?(:Core, false)
-  begin
-    require 'legion/llm/transport/exchanges/metering'
-    require 'legion/llm/transport/exchanges/audit'
-  rescue LoadError => _e
-    nil
-  end
+  require_relative 'ledger/transport/exchanges/metering'
+  require_relative 'ledger/transport/exchanges/audit'
+  require_relative 'ledger/transport/exchanges/registry'
   require_relative 'ledger/transport/queues/metering_write'
   require_relative 'ledger/transport/queues/audit_prompts'
   require_relative 'ledger/transport/queues/audit_tools'
+  require_relative 'ledger/transport/queues/registry_availability'
   require_relative 'ledger/transport/transport'
   require_relative 'ledger/actors/metering_writer'
   require_relative 'ledger/actors/prompt_writer'
   require_relative 'ledger/actors/tool_writer'
+  require_relative 'ledger/actors/registry_availability_writer'
   require_relative 'ledger/actors/spool_flush'
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-llm-ledger
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.12
 platform: ruby
 authors:
 - Esity
@@ -38,21 +38,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.2'
 - !ruby/object:Gem::Dependency
-  name: legion-llm
+  name: legion-logging
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
-  name: legion-logging
+  name: legion-settings
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,33 +66,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
-  name: legion-settings
+  name: legion-transport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
-  name: legion-transport
+  name: lex-llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: 0.1.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: 0.1.5
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -193,6 +193,7 @@ files:
 - lib/legion/extensions/llm/ledger.rb
 - lib/legion/extensions/llm/ledger/actors/metering_writer.rb
 - lib/legion/extensions/llm/ledger/actors/prompt_writer.rb
+- lib/legion/extensions/llm/ledger/actors/registry_availability_writer.rb
 - lib/legion/extensions/llm/ledger/actors/spool_flush.rb
 - lib/legion/extensions/llm/ledger/actors/tool_writer.rb
 - lib/legion/extensions/llm/ledger/helpers/decryption.rb
@@ -202,14 +203,20 @@ files:
 - lib/legion/extensions/llm/ledger/migrations/001_create_metering_records.rb
 - lib/legion/extensions/llm/ledger/migrations/002_create_prompt_records.rb
 - lib/legion/extensions/llm/ledger/migrations/003_create_tool_records.rb
+- lib/legion/extensions/llm/ledger/migrations/004_create_registry_availability_records.rb
 - lib/legion/extensions/llm/ledger/runners/metering.rb
 - lib/legion/extensions/llm/ledger/runners/prompts.rb
 - lib/legion/extensions/llm/ledger/runners/provider_stats.rb
+- lib/legion/extensions/llm/ledger/runners/registry_availability.rb
 - lib/legion/extensions/llm/ledger/runners/tools.rb
 - lib/legion/extensions/llm/ledger/runners/usage_reporter.rb
+- lib/legion/extensions/llm/ledger/transport/exchanges/audit.rb
+- lib/legion/extensions/llm/ledger/transport/exchanges/metering.rb
+- lib/legion/extensions/llm/ledger/transport/exchanges/registry.rb
 - lib/legion/extensions/llm/ledger/transport/queues/audit_prompts.rb
 - lib/legion/extensions/llm/ledger/transport/queues/audit_tools.rb
 - lib/legion/extensions/llm/ledger/transport/queues/metering_write.rb
+- lib/legion/extensions/llm/ledger/transport/queues/registry_availability.rb
 - lib/legion/extensions/llm/ledger/transport/transport.rb
 - lib/legion/extensions/llm/ledger/version.rb
 - lib/lex-llm-ledger.rb