active_genie 0.28.2 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2cb129cd0e5a4f5f0f1daf6ed3cb26a4dab4d10cb56bbfcc419656c2797347a
-  data.tar.gz: df1fe343d28aeb72f8fe30dc53bdecd860e8bd44ae009a086c7ad502da77bfd8
+  metadata.gz: 9d304f581f4ebf42ba3fe4095d319c7d450b554b7af7c9a86ff4c34af1d6b771
+  data.tar.gz: 749952b6fcf70903b247987d739ab8d2a55e40fd70873ed65f9eedf64fde9abd
 SHA512:
-  metadata.gz: 1449245c23bcc2c5f3c4266712c67b202e4e2c6724ee9f283bd81d76b2daedc4bc06ee524ed8d959d13f31062b393b5f7cfb7f46721888efb8d89bbd4d8a12b3
-  data.tar.gz: 649a20ee71c55d8486d8264b641974c3222baa477133d6924ba039f2ef24f9185d2b60b2f37f7d2ff498b87aaed09b78815feb3bbc52c92613eb810de2c59c2c
+  metadata.gz: cb9fccff5748c42bdf51dbd4b57041bd6de75f69cafa10cf77246eb6e3e67c4204436187fb595afd70af610b841b103bfd79f5040019e58a779a6eae8b17802e
+  data.tar.gz: 1a958882621ce6a9f5d20b2383e8be76bee47e776d30a8f007f7d20516aefb01c936dd56f315cc3e1d1c0255d4eafc7ad9d80e477edf308b2acd5392489198db

data/VERSION

@@ -1 +1 @@
-0.28.2
+0.29.0

data/lib/active_genie/battle/fight.prompt.md

@@ -1,4 +1,5 @@
-Create a dynamic, back-and-forth verbal match between two fighters, given their names and preferred fighting styles. In this match, fighters do not physically battle, instead, they engage in a spoken confrontation, each describing and boasting about their fighting style, how their techniques would outmaneuver, counter, or overwhelm the other's approach. Ensure that each verbal exchange details:
+Create a dynamic, back-and-forth verbal match between two fighters, given their names and preferred fighting styles. Criteria are vital as they provide a clear metric to compare the players. Follow these criteria strictly.
+In this match, fighters do not physically battle, instead, they engage in a spoken confrontation, each describing and boasting about their fighting style, how their techniques would outmaneuver, counter, or overwhelm the other's approach. Each moviment must be focused in how it will help the fighter to reach the criteria as fully as possible. Ensure that each verbal exchange details:
 - The technique or strategy the speaker would use.
 - How that move is superior to the opponent’s last stated tactic.
 - How the opponent might respond, and what reply the speaker would have.
@@ -10,7 +11,8 @@ Explicit steps:
 - Alternate dialogue, with each fighter explaining their tactical move, then the intended counter or rebuttal, going at least two cycles each.
 - Ensure reasoning (the logic or explanation behind each technique and counter) always precedes the conclusion or actual "move" or taunt.
 - Close with a final statement or taunt from each fighter, maintaining the competitive tone.
-- Make the dialogue lively and imaginative, using language consistent with fighters boasting or challenging each other.
+- Make the dialogue lively and imaginative.
+- Make sure follow these criteria strictly.
 
 Output Format:
 - Structure as a script, with each turn labeled by the fighter’s name.
@@ -23,6 +25,7 @@ Example:
 Example Input:
 Fighter One: Master Crane, Style: Crane Kung Fu
 Fighter Two: Iron Ox, Style: Ox Bull Charge
+Criteria: Fair fight 1v1 using only techniques from their style.
 
 Example Output:
 Master Crane: My Crane Kung Fu relies on lightness and precision, striking where your heavy blows simply can't reach. Your Ox Bull Charge is powerful, but too direct, I'd dance aside and tap your pressure points before you even turn.
@@ -38,4 +41,4 @@ Important Considerations:
 - Always have the reasoning/strategy before the actual attack or boast in each utterance.
 - Maintain the turn order and competitive dialogue style.
 
-*Reminder: The main objective is to script an imaginative, turn-based verbal contest between two stylized fighters, with detailed reasoning and taunts about their style advantages, as instructed above.*
+*Reminder: The main objective is to script an imaginative, turn-based verbal contest between two fighters, with detailed reasoning and taunts about their style advantages until reach the criteria, as instructed above.*

data/lib/active_genie/battle/fight.rb

@@ -16,9 +16,9 @@ module ActiveGenie
       def call
         messages = [
           {  role: 'system', content: PROMPT },
-          {  role: 'user', content: "criteria: #{@criteria}" },
           {  role: 'user', content: "player_a: #{@player_a}" },
-          {  role: 'user', content: "player_b: #{@player_b}" }
+          {  role: 'user', content: "player_b: #{@player_b}" },
+          {  role: 'user', content: "criteria: #{@criteria}" }
         ]
 
         response = ::ActiveGenie::Clients::UnifiedClient.function_calling(

data/lib/active_genie/battle/generalist.rb

@@ -40,9 +40,9 @@ module ActiveGenie
       def call
         messages = [
           {  role: 'system', content: PROMPT },
-          {  role: 'user', content: "criteria: #{@criteria}" },
           {  role: 'user', content: "player_a: #{@player_a}" },
-          {  role: 'user', content: "player_b: #{@player_b}" }
+          {  role: 'user', content: "player_b: #{@player_b}" },
+          {  role: 'user', content: "criteria: #{@criteria}" }
         ]
 
         response = ::ActiveGenie::Clients::UnifiedClient.function_calling(

data/lib/active_genie/battle.rb

@@ -16,6 +16,10 @@ module ActiveGenie
       Generalist.call(...)
     end
 
+    def battle(...)
+      Generalist.call(...)
+    end
+
     def compare(...)
       Generalist.call(...)
     end

data/lib/active_genie/config/factory_config.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module ActiveGenie
+  module Config
+    class FactoryConfig
+      attr_accessor :number_of_items
+
+      def initialize
+        @number_of_items = 5
+      end
+
+      def merge(config_params = {})
+        dup.tap do |config|
+          config.number_of_items = config_params[:number_of_items] if config_params.key?(:number_of_items)
+        end
+      end
+    end
+  end
+end

data/lib/active_genie/configuration.rb

@@ -7,6 +7,7 @@ require_relative 'config/scoring_config'
 require_relative 'config/data_extractor_config'
 require_relative 'config/battle_config'
 require_relative 'config/llm_config'
+require_relative 'config/factory_config'
 
 module ActiveGenie
   class Configuration
@@ -34,6 +35,10 @@ module ActiveGenie
       @battle ||= Config::BattleConfig.new
     end
 
+    def factory
+      @factory ||= Config::FactoryConfig.new
+    end
+
     def llm
       @llm ||= Config::LlmConfig.new
     end
@@ -42,7 +47,7 @@ module ActiveGenie
       @logger ||= ActiveGenie::Logger.new(log_config: log)
     end
 
-    SUB_CONFIGS = %w[log providers llm ranking scoring data_extractor battle].freeze
+    SUB_CONFIGS = %w[log providers llm ranking scoring data_extractor battle factory].freeze
 
     def merge(config_params = {})
       return config_params if config_params.is_a?(Configuration)
@@ -80,6 +85,6 @@ module ActiveGenie
       end
     end
 
-    attr_writer :log, :providers, :ranking, :scoring, :data_extractor, :battle, :llm, :logger
+    attr_writer(*SUB_CONFIGS, :logger)
   end
 end

data/lib/active_genie/factory/feud.json

@@ -0,0 +1,21 @@
+{
+  "name": "feud_items_generator",
+  "description": "Generate a list of items for a given theme.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "theme": {
+        "type": "string",
+        "description": "The theme for the feud."
+      },
+      "items": {
+        "type": "array",
+        "description": "The list of items for the feud.",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "required": ["theme", "items"]
+  }
+}

data/lib/active_genie/factory/feud.prompt.md

@@ -0,0 +1,20 @@
+Emulate the game "Family Feud": For a given theme, reason about the general public's most common answers impersonating a survey of average people's opinions and generate an ordered, survey-style answer list.
+
+- Before producing the answer list, internally consider: If a group of average people were surveyed on this theme, which answers would be mentioned most frequently?.
+
+# Output Format
+
+A numbered list in plain text
+
+# Example
+
+Example for the theme "Favorite Fast Foods":
+1. Pizza
+2. Hamburgers
+3. Hot Dogs
+4. French Fries
+
+# Notes
+
+- Always impersonate a "Family Feud" survey: order is critical most likely answers should come first.
+- Judge each item by their general public reputation and cultural impact.

data/lib/active_genie/factory/feud.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require_relative '../clients/unified_client'
+
+module ActiveGenie
+  module Factory
+    # The Factory::Feud class provides a foundation for generating a list of items for a given theme
+    #
+    # @example Feud usage with two players and criteria
+    #   Feud.call("Industries that are most likely to be affected by climate change")
+    #
+    class Feud
+      def self.call(...)
+        new(...).call
+      end
+
+      # @param theme [String] The theme for the feud
+      # @param config [Hash] Additional configuration options that modify the battle evaluation behavior
+      # @return [Array of strings] List of items
+      def initialize(theme, config: {})
+        @theme = theme
+        @config = ActiveGenie.configuration.merge(config)
+      end
+
+      # @return [Array] The list of items
+      def call
+        messages = [
+          {  role: 'system', content: PROMPT },
+          {  role: 'system', content: "List #{number_of_items} top items." },
+          {  role: 'user', content: "theme: #{@theme}" }
+        ]
+
+        response = ::ActiveGenie::Clients::UnifiedClient.function_calling(
+          messages,
+          FUNCTION,
+          config: @config
+        )
+
+        log_feud(response)
+        response['items']
+      end
+
+      PROMPT = File.read(File.join(__dir__, 'feud.prompt.md'))
+      FUNCTION = JSON.parse(File.read(File.join(__dir__, 'feud.json')), symbolize_names: true)
+
+      private
+
+      def number_of_items
+        @config.factory.number_of_items
+      end
+
+      def log_feud(response)
+        @config.logger.call(
+          code: :feud,
+          theme: @theme[0..30],
+          items: response['items'].map { |item| item[0..30] }
+        )
+      end
+    end
+  end
+end

data/lib/active_genie/factory.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative 'factory/feud'
+
+module ActiveGenie
+  module Factory
+    module_function
+
+    def feud(...)
+      Feud.call(...)
+    end
+
+    def list(...)
+      Feud.call(...)
+    end
+
+    def call(...)
+      Feud.call(...)
+    end
+  end
+end

data/lib/active_genie/scoring/generalist.rb

@@ -106,7 +106,7 @@ module ActiveGenie
       end
 
       def reviewers
-        @reviewers ||= if @param_reviewers.count.positive?
+        @reviewers ||= if @param_reviewers.any?
                          @param_reviewers
                        else
                          result = RecommendedReviewers.call(@text, @criteria, config: @config)

data/lib/active_genie.rb

@@ -13,6 +13,7 @@ module ActiveGenie
   autoload :Battle, File.join(__dir__, 'active_genie/battle')
   autoload :Scoring, File.join(__dir__, 'active_genie/scoring')
   autoload :Ranking, File.join(__dir__, 'active_genie/ranking')
+  autoload :Factory, File.join(__dir__, 'active_genie/factory')
 
   VERSION = File.read(File.expand_path('../VERSION', __dir__)).strip
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_genie
 version: !ruby/object:Gem::Version
-  version: 0.28.2
+  version: 0.29.0
 platform: ruby
 authors:
 - Radamés Roriz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-12 00:00:00.000000000 Z
+date: 2025-07-16 00:00:00.000000000 Z
 dependencies: []
 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.
@@ -38,6 +38,7 @@ files:
 - lib/active_genie/clients/unified_client.rb
 - lib/active_genie/config/battle_config.rb
 - lib/active_genie/config/data_extractor_config.rb
+- lib/active_genie/config/factory_config.rb
 - lib/active_genie/config/llm_config.rb
 - lib/active_genie/config/log_config.rb
 - lib/active_genie/config/providers/anthropic_config.rb
@@ -57,6 +58,10 @@ files:
 - lib/active_genie/data_extractor/generalist.rb
 - lib/active_genie/errors/invalid_log_output_error.rb
 - lib/active_genie/errors/invalid_provider_error.rb
+- lib/active_genie/factory.rb
+- lib/active_genie/factory/feud.json
+- lib/active_genie/factory/feud.prompt.md
+- lib/active_genie/factory/feud.rb
 - lib/active_genie/logger.rb
 - lib/active_genie/ranking.rb
 - lib/active_genie/ranking/elo_round.rb