active_genie 0.30.0 → 0.30.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3798199139490fc67b7bd1e154c74ff7c53411bd035cd9e2fd1d9b46e676a90
-  data.tar.gz: 5d9be13a369c0a6116257822f75365241ea7f628e0bdc11af085ecb267cef806
+  metadata.gz: 5673a34f1cd8c2b2a9a884a73ded1bf12e28f4d29ab5f351ecb3374bc9ca0617
+  data.tar.gz: 7ca0bc8d8bdc8b6d3618bd5f22bd13f80a9ac4399fa0282e6b11a461beb1cc1d
 SHA512:
-  metadata.gz: 1929da5851c827ef6b693aa4f66b6118a2cda72c1b7996e602e0b0abd0537d3ac8de4fcd58d55c34fcb30ac798b237e0dea2f42e1f2431f6b61594e74807a2fd
-  data.tar.gz: 4d8a653613a1782f8542a531abf23d0171e5e30d36d42bee1d756963d645113b9ee151206ae81ba34a053b408df945d4f98e1ef35e23fc2fc47023776961dee8
+  metadata.gz: f174076b72df558ef82d3834043ae3299ab1aa41d235d6b547cbee45d21804295b87729a92dda51910d37a076f954fb8b4e2460443c1814f73221b5663255d96
+  data.tar.gz: 503840469d6a67206d67d3f5b27f73803cb736cd4c826e7ea4b4575f1f702b7875fdeb979a875c29e88d5b06d9d18b49c94ae4f957f13563289428bdc1d83cd0

data/VERSION

@@ -1 +1 @@
-0.30.0
+0.30.1

data/lib/active_genie/configs/llm_config.rb

@@ -4,7 +4,7 @@ module ActiveGenie
   module Config
     class LlmConfig
       attr_accessor :model, :temperature, :max_tokens, :max_retries, :retry_delay,
-                    :model_tier, :read_timeout, :open_timeout, :provider
+                    :model_tier, :read_timeout, :open_timeout, :provider, :max_fibers
       attr_reader :provider_name
 
       def initialize
@@ -18,6 +18,7 @@ module ActiveGenie
         @model_tier = 'lower_tier'
         @read_timeout = nil
         @open_timeout = nil
+        @max_fibers = 10
       end
 
       def provider_name=(provider_name)

data/lib/active_genie/configs/providers_config.rb

@@ -11,7 +11,7 @@ module ActiveGenie
       attr_reader :all
 
       def default
-        @default || valid.keys.first
+        @default || ENV.fetch('PROVIDER_NAME', nil) || valid.keys.first
       end
 
       def default=(provider)

data/lib/active_genie/extractor/litote.rb

@@ -35,10 +35,10 @@ module ActiveGenie
       end
 
       def call
-        response = Generalist.call(@text, extract_with_litote, config: @config)
+        response = Explanation.call(@text, extract_with_litote, config: @config)
 
         if response[:message_litote]
-          response = Generalist.call(response[:litote_rephrased], @data_to_extract, config: @config)
+          response = Explanation.call(response[:litote_rephrased], @data_to_extract, config: @config)
         end
 
         response
@@ -47,7 +47,7 @@ module ActiveGenie
       private
 
       def extract_with_litote
-        parameters = JSON.parse(File.read(File.join(__dir__, 'with_litote.json')), symbolize_names: true)
+        parameters = JSON.parse(File.read(File.join(__dir__, 'litote.json')), symbolize_names: true)
 
         @data_to_extract.merge(parameters)
       end

data/lib/active_genie/lister/feud.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../clients/unified_client'
+require_relative '../providers/unified_provider'
 
 module ActiveGenie
   module Lister
@@ -30,7 +30,7 @@ module ActiveGenie
           {  role: 'user', content: "theme: #{@theme}" }
         ]
 
-        response = ::ActiveGenie::Clients::UnifiedClient.function_calling(
+        response = ::ActiveGenie::Providers::UnifiedProvider.function_calling(
           messages,
           FUNCTION,
           config: @config

data/lib/active_genie/lister/juries.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../clients/unified_client'
+require_relative '../providers/unified_provider'
 
 module ActiveGenie
   module Lister
@@ -71,7 +71,7 @@ module ActiveGenie
       private
 
       def client
-        ::ActiveGenie::Clients::UnifiedClient
+        ::ActiveGenie::Providers::UnifiedProvider
       end
 
       def prompt

data/lib/active_genie/providers/base_provider.rb

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
+require 'net/http'
+
 module ActiveGenie
   module Providers
     class BaseProvider
-      class ProviderError < StandardError; end
+      class ProviderUnknownError < StandardError; end
+      class ProviderServerError < StandardError; end
 
       DEFAULT_HEADERS = {
         'Content-Type': 'application/json',
@@ -81,7 +84,7 @@ module ActiveGenie
 
         response = http_request(request, uri)
 
-        raise ProviderError, "Unexpected response: #{response.code} - #{response.body}" unless response.is_a?(Net::HTTPSuccess)
+        raise ProviderUnknownError, "Unexpected response: #{response.code} - #{response.body}" unless response.is_a?(Net::HTTPSuccess)
 
         parsed_response = parse_response(response)
 
@@ -143,7 +146,7 @@ module ActiveGenie
         begin
           JSON.parse(response.body)
         rescue JSON::ParserError => e
-          raise ProviderError, "Failed to parse JSON response: #{e.message}"
+          raise ProviderUnknownError, "Failed to parse JSON response: #{e.message}"
         end
       end
 
@@ -169,8 +172,12 @@ module ActiveGenie
         retries = 0
 
         begin
-          yield
-        rescue Net::OpenTimeout, Net::ReadTimeout, ProviderError => e
+          response = yield
+
+          raise ProviderServerError, "Provider server error: #{response.code} - #{response.body}" if !response.is_a?(Net::HTTPSuccess) && response.code.to_i >= 500
+
+          response
+        rescue Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNREFUSED, ProviderServerError => e
           raise if retries > max_retries
 
           sleep_time = retry_delay * (2**retries)

data/lib/active_genie/providers/unified_provider.rb

@@ -10,7 +10,7 @@ module ActiveGenie
   module Providers
     class UnifiedProvider
       class << self
-        PROVIDER_NAME_TO_CLIENT = {
+        PROVIDER_NAME_TO_PROVIDER = {
           openai: OpenaiProvider,
           anthropic: AnthropicProvider,
           google: GoogleProvider,
@@ -19,7 +19,7 @@ module ActiveGenie
 
         def function_calling(messages, function, config: {})
           provider_name = config.llm.provider_name || config.providers.default
-          provider = PROVIDER_NAME_TO_CLIENT[provider_name.to_sym]
+          provider = PROVIDER_NAME_TO_PROVIDER[provider_name.to_sym]
 
           raise ActiveGenie::InvalidProviderError, provider_name if provider.nil?
 

data/lib/active_genie/ranker/elo.rb

@@ -23,9 +23,9 @@ module ActiveGenie
         @config.log.add_observer(observers: ->(log) { log_observer(log) })
         @config.log.additional_context = { elo_id: }
 
-        matches.each do |player_a, player_b|
-          # TODO: debate can take a while, can be parallelized
+        ActiveGenie::FiberByBatch.call(matches, config: @config) do |player_a, player_b|
           winner, loser = debate(player_a, player_b)
+
           update_players_elo(winner, loser)
         end
 
@@ -105,6 +105,7 @@ module ActiveGenie
           players_in: players_in.map(&:id),
           debates_count: matches.size,
           total_tokens: @total_tokens,
+          players_in_round: players_in.map(&:id),
           previous_highest_elo: @previous_highest_elo,
           highest_elo:,
           highest_elo_diff: highest_elo - @previous_highest_elo,

data/lib/active_genie/ranker/free_for_all.rb

@@ -8,7 +8,7 @@ module ActiveGenie
       end
 
       def initialize(players, criteria, config: nil)
-        @players = Players.new(players)
+        @players = Entities::Players.new(players)
         @criteria = criteria
         @config = config || ActiveGenie.configuration
         @start_time = Time.now
@@ -19,7 +19,7 @@ module ActiveGenie
         @config.log.add_observer(observers: ->(log) { log_observer(log) })
         @config.log.additional_context = { free_for_all_id: }
 
-        matches.each do |player_a, player_b|
+        ActiveGenie::FiberByBatch.call(matches, config: @config) do |player_a, player_b|
           winner, loser = debate(player_a, player_b)
 
           update_players_score(winner, loser)
@@ -39,7 +39,7 @@ module ActiveGenie
       def debate(player_a, player_b)
         log_context = { player_a_id: player_a.id, player_b_id: player_b.id }
 
-        result = ActiveGenie::Comparator.debate(
+        result = ActiveGenie::Comparator.by_debate(
           player_a.content,
           player_b.content,
           @criteria,

data/lib/active_genie/ranker/scoring.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../utils/fiber_by_batch'
+
 module ActiveGenie
   module Ranker
     class Scoring
@@ -8,7 +10,7 @@ module ActiveGenie
       end
 
       def initialize(players, criteria, juries: [], config: nil)
-        @players = Players.new(players)
+        @players = Entities::Players.new(players)
         @criteria = criteria
         @config = ActiveGenie.configuration.merge(config)
         @juries = Array(juries).compact.uniq
@@ -17,7 +19,7 @@ module ActiveGenie
       def call
         @config.log.additional_context = { ranker_scoring_id: }
 
-        players_without_score.each do |player|
+        ActiveGenie::FiberByBatch.call(players_without_score, config: @config) do |player|
           player.score = generate_score(player)
         end
       end
@@ -29,7 +31,7 @@ module ActiveGenie
       end
 
       def generate_score(player)
-        score, reasoning = ActiveGenie::Scorer.jury_bench(
+        score, reasoning = ActiveGenie::Scorer.by_jury_bench(
           player.content,
           @criteria,
           @juries,

data/lib/active_genie/ranker/tournament.rb

@@ -35,12 +35,11 @@ module ActiveGenie
         new(...).call
       end
 
-      def initialize(players, criteria, reviewers: [], config: {})
-        @players = Players.new(players)
+      def initialize(players, criteria, juries: [], config: {})
+        @players = Entities::Players.new(players)
         @criteria = criteria
-        @reviewers = Array(reviewers).compact.uniq
+        @juries = Array(juries).compact.uniq
         @config = ActiveGenie.configuration.merge(config)
-        @players = nil
       end
 
       def call
@@ -51,7 +50,7 @@ module ActiveGenie
 
         while @players.elo_eligible?
           elo_report = run_elo_round!
-          eliminate_relegation_players!
+          eliminate_lower_tier_players!
           rebalance_players!(elo_report)
         end
 
@@ -69,7 +68,7 @@ module ActiveGenie
         Scoring.call(
           @players,
           @criteria,
-          reviewers: @reviewers,
+          juries: @juries,
           config: @config
         )
       end
@@ -88,8 +87,8 @@ module ActiveGenie
         )
       end
 
-      def eliminate_relegation_players!
-        @players.calc_relegation_tier.each { |player| player.eliminated = ELIMINATION_RELEGATION }
+      def eliminate_lower_tier_players!
+        @players.calc_lower_tier.each { |player| player.eliminated = ELIMINATION_RELEGATION }
       end
 
       def rebalance_players!(elo_report)

data/lib/active_genie/scorer/jury_bench.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../clients/unified_client'
+require_relative '../providers/unified_provider'
 
 module ActiveGenie
   module Scorer
@@ -44,7 +44,7 @@ module ActiveGenie
           {  role: 'user', content: "Text to score: #{@text}" }
         ]
 
-        result = ::ActiveGenie::Clients::UnifiedClient.function_calling(
+        result = ::ActiveGenie::Providers::UnifiedProvider.function_calling(
           messages,
           build_function,
           config: @config

data/lib/active_genie/utils/fiber_by_batch.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'async'
+
+module ActiveGenie
+  module FiberByBatch
+    module_function
+
+    def call(items, config:, &block)
+      items.each_slice(config.llm.max_fibers).to_a.each do |batch|
+        Async do
+          tasks = batch.map do |item|
+            Async { block.call(item) }
+          end
+
+          tasks.each(&:wait)
+        end.wait
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_genie
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.30.1
 platform: ruby
 authors:
 - Radamés Roriz
@@ -9,9 +9,23 @@ autorequire:
 bindir: bin
 cert_chain: []
 date: 2025-08-15 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: |
-  ActiveGenie is a Ruby gem that helps developers build reliable, future-proof GenAI features without worrying about changing models, prompts, or providers. Like Lodash for GenAI, it offers simple, reusable modules for tasks like data extraction, scoring, and ranking, so you can focus on your app’s logic, not the shifting AI landscape.
+  ActiveGenie is a Ruby gem that helps developers build reliable, future-proof GenAI features without worrying about changing models, prompts, or providers. Like Lodash for GenAI, it offers simple, reusable modules for tasks like extractor, comparator, scorer, and ranker, so you can focus on your app’s logic, not the shifting AI landscape.
   Behind the scenes, a custom benchmarking system keeps everything consistent across LLM vendors and versions, release after release.
 email:
 - radames@roriz.dev
@@ -73,8 +87,9 @@ files:
 - lib/active_genie/ranker/scoring.rb
 - lib/active_genie/ranker/tournament.rb
 - lib/active_genie/scorer.rb
-- lib/active_genie/scorer/jury_bench.md
+- lib/active_genie/scorer/jury_bench.prompt.md
 - lib/active_genie/scorer/jury_bench.rb
+- lib/active_genie/utils/fiber_by_batch.rb
 - lib/tasks/benchmark.rake
 - lib/tasks/install.rake
 - lib/tasks/templates/active_genie.rb