lex-metering 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13443e923c7850c17785f0e750d1bdb995575da237592758c7578de30c321081
-  data.tar.gz: e054cb9fd8222b5d0616f82afb46669541fccfa54c9de4dbd7f83360cb4e7967
+  metadata.gz: 175af45dd831905822683d8890bf498d10acb478310d0d7dd97a3359a74f6d48
+  data.tar.gz: dc29268590deb375eb3d45b46d1ab10361c48563bbda942c37d5def2b9f468ce
 SHA512:
-  metadata.gz: 561748036537315786f810e594f005f58de6f4b2793ec497967dd00ae7488ac7c75a7fd4f7ddfeeea0f5cdd2da9442b3ffe434f4a419d3f083c63c3cea958a47
-  data.tar.gz: 0dfdb4731304dadc64f56c02e3c71edd939137026b51f057cf5c181412edc4b4b23c02d7bae8ae65451ce8e41c222bd5bbc5a9944991bec3c3dc282ee08c4b21
+  metadata.gz: 6268304a7fe42da3b8fba5c5948c4f6da6c26109fbbd7691f52fed79e63505edd6896d1bb648d93c939d69f5e4319ae88c757618b848e71e47b9f71082eab3c7
+  data.tar.gz: 987863af819432d2dbd342c43c82359825274611020d330ab0a05616815d2d1db8622c88c179f3d03a06b8fd0fb8853e241d72f822b96a2ab03bcc7c5364d0f1

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.1.7] - 2026-03-22
+
+### Changed
+- Updated `legionio` dependency constraint to `>= 1.4.123`
+
+## [0.1.6] - 2026-03-21
+
+### Added
+- `Runners::CostOptimizer` module with `analyze_costs` method for weekly LLM cost analysis
+- `Actor::CostOptimizer` periodic actor (runs weekly) to trigger cost analysis
+- Cost rate tables for Anthropic, OpenAI, Bedrock, and Azure AI models
+- LLM-powered recommendation generation for model rightsizing
+
 ## [0.1.5] - 2026-03-20
 
 ### Added

data/lex-metering.gemspec

@@ -28,7 +28,7 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'legionio'
+  spec.add_dependency 'legionio', '>= 1.4.123'
 
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'

data/lib/legion/extensions/metering/actors/cost_optimizer.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Metering
+      module Actor
+        class CostOptimizer < Legion::Extensions::Actors::Every
+          def runner_class
+            'Legion::Extensions::Metering::Runners::CostOptimizer'
+          end
+
+          def runner_function
+            'analyze_costs'
+          end
+
+          def time
+            604_800 # once per week
+          end
+
+          def run_now?
+            false
+          end
+
+          def use_runner?
+            false
+          end
+
+          def check_subtask?
+            false
+          end
+
+          def generate_task?
+            false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/metering/runners/cost_optimizer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Metering
+      module Runners
+        module CostOptimizer
+          def analyze_costs(window_days: 7, top_n: 10)
+            drivers = collect_cost_data(window_days: window_days)
+            return { status: 'no_data', window_days: window_days, cost_drivers: [], recommendations: [] } if drivers.empty?
+
+            top_drivers = drivers.sort_by { |d| -(d[:total_cost] || 0) }.first(top_n)
+            recommendations = generate_recommendations(top_drivers)
+
+            {
+              status:          'analyzed',
+              window_days:     window_days,
+              cost_drivers:    top_drivers,
+              recommendations: recommendations[:recommendations] || []
+            }
+          end
+
+          private
+
+          def collect_cost_data(window_days:)
+            return [] unless defined?(Legion::Data) && Legion::Data.respond_to?(:connection) && Legion::Data.connection
+
+            cutoff = Time.now.utc - (window_days * 86_400)
+            ds = Legion::Data.connection[:metering_records]
+                             .where(::Sequel.lit('recorded_at >= ?', cutoff))
+
+            grouped = ds.group(:provider, :model_id)
+                        .select_append do
+                          [sum(total_tokens).as(total_tokens),
+                           sum(input_tokens).as(input_tokens),
+                           sum(output_tokens).as(output_tokens),
+                           count(Sequel.lit('*')).as(call_count)]
+                        end
+
+            grouped.all.map do |row|
+              {
+                extension:    row[:provider],
+                model:        row[:model_id],
+                total_tokens: row[:total_tokens] || 0,
+                total_cost:   estimate_cost(row[:provider], row[:model_id], row[:total_tokens] || 0),
+                call_count:   row[:call_count] || 0
+              }
+            end
+          rescue StandardError
+            []
+          end
+
+          def estimate_cost(provider, model, total_tokens)
+            rate = cost_rate(provider, model)
+            (total_tokens * rate / 1_000_000.0).round(4)
+          end
+
+          def cost_rate(provider, model)
+            rates = {
+              'anthropic' => { 'claude-opus-4-6' => 15.0, 'claude-sonnet-4-6' => 3.0, 'claude-haiku-4-5' => 0.25 },
+              'openai'    => { 'gpt-4o' => 5.0, 'gpt-4o-mini' => 0.15, 'gpt-4.1' => 2.0 },
+              'bedrock'   => { 'default' => 3.0 },
+              'azure-ai'  => { 'default' => 3.0 }
+            }
+            provider_rates = rates[provider&.to_s] || {}
+            provider_rates[model&.to_s] || provider_rates['default'] || 1.0
+          end
+
+          def generate_recommendations(drivers)
+            return { recommendations: [] } unless defined?(Legion::LLM)
+
+            prompt = build_recommendation_prompt(drivers)
+            result = Legion::LLM.chat(message: prompt)
+            ::JSON.parse(result[:content] || '{}', symbolize_names: true)
+          rescue StandardError
+            { recommendations: [] }
+          end
+
+          def build_recommendation_prompt(drivers)
+            lines = drivers.map do |d|
+              "#{d[:extension]}/#{d[:model]}: #{d[:total_tokens]} tokens, $#{d[:total_cost]}, #{d[:call_count]} calls"
+            end
+
+            <<~PROMPT
+              Analyze these LLM cost drivers from the past week and recommend model rightsizing.
+              Focus on cases where a cheaper model could handle the workload.
+
+              #{lines.join("\n")}
+
+              Return JSON: { "recommendations": [{ "extension": "...", "current_model": "...", "suggested_model": "...", "rationale": "...", "estimated_savings_pct": N }] }
+            PROMPT
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/metering/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Metering
-      VERSION = '0.1.5'
+      VERSION = '0.1.7'
     end
   end
 end

data/lib/legion/extensions/metering.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'legion/extensions/metering/version'
+require 'legion/extensions/metering/runners/cost_optimizer'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-metering
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - Esity
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.123
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.123
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -113,8 +113,10 @@ files:
 - lex-metering.gemspec
 - lib/legion/extensions/metering.rb
 - lib/legion/extensions/metering/actors/cleanup.rb
+- lib/legion/extensions/metering/actors/cost_optimizer.rb
 - lib/legion/extensions/metering/data/migrations/001_add_metering_records.rb
 - lib/legion/extensions/metering/helpers/economics.rb
+- lib/legion/extensions/metering/runners/cost_optimizer.rb
 - lib/legion/extensions/metering/runners/metering.rb
 - lib/legion/extensions/metering/version.rb
 homepage: https://github.com/LegionIO/lex-metering